Getting Started

Access — checklist

• Access to the repo you’ll work in (see table below).
• Access to poktalabs/pokta-care-monorepo — the benchmark scripts and scoring live there, even if your main work is in another repo.
• Signed up in the app (app.poktacare.com) — signup is open, you just need to log in with Gmail, no allowlist for basic access. Access to the research surfaces (the study dashboard and the BIOBADAMEX console) is gated by a separate email allowlist — if your work needs it, ask whoever onboarded you.
• Access to the “grader persona” document in Google Drive (relevant if you’re working on the Grader’s extraction/retrieval).
• Access to the chat group with Dr. Erick Zamora, to coordinate technical handoffs with the person who made most of the rheumatology modifications.
• Access to this site (docs.poktacare.com) — you already have it if you’re reading this.

If any of these is still pending, say so directly to whoever onboarded you — this isn’t something you should work around.

Where to start

You’re working on the Grader (extraction, prompts, retrieval, arm 3): Start at pokta-grader-bioagent/CONTRIBUTING.md. That file has repo-specific context, your first concrete task, and environment setup (dev/SETUP.md). Come back to Architecture here to understand how your work fits into the full study.

You’re working on RheumaAI (arm 2): Start at the README.md of rheuma-ai-bioagent. The Grader repo is a fork of this one — if you already know one, the other will feel familiar (same Bun runtime, same LLM library, same tools architecture).

You’re working on the study harness, scoring, or the product app: Start at pokta-care-monorepo, specifically apps/api/scripts/biobadamex-*.ts for the benchmark and apps/api/src/services/biobadamex-eval.ts for scoring. Read Architecture first — it has the full map of how this repo calls the other two.

Not sure / your work crosses several repos: Read the full Architecture page before touching code. It’s the only page that explains the system end to end.

The honest starting point

The Grader and RheumaAI are forks of a framework called BioAgents (Bio/Dezy team) that no longer has active upstream maintenance. The infrastructure was set up and handed to Dr. Erick Zamora, who built the rheumatology modifications (full homomorphic encryption, specialized articles) on top of it. No one on the team fully understands 100% of this code today — part of your real job, in either repo, is reverse-engineering inherited pieces. That’s normal, not a sign of poor prior documentation.

You’re not training or fine-tuning a model — everything here today is orchestration of already-trained LLMs with prompts, extraction schemas, and (optionally) context retrieval via embeddings.