doctrine-primer
Skill0 starsChanged 9 days agoMITView on GitHub
Use when starting cold in a repo, when the user asks to prime, orient, or get a situation report, or when an agent has never seen this repo. Restores session state exactly as doctrine-resume does, then explains the project.
In this repository14 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- doctrine-auditSkill
- doctrine-backupSkill
- doctrine-codeSkill
- doctrine-debugSkill
- doctrine-docsSkill
- doctrine-gauntletSkill
- doctrine-handoffSkill
- doctrine-paneSkill
- doctrine-projectSkill
- doctrine-researchSkill
- doctrine-resumeSkill
- doctrineSkill
- doctrine-writeSkill
The file
Files
Doctrine Primer — cold-start orientation
Restore the session's state, then explain the project to an agent that has never seen this repo.
Need state only, not a codebase tour? doctrine-resume is the cheap path: say so and stop.
Your host loaded one project instruction file for you, which the hub's host reference names. Read the other if present, and read the loaded one yourself where your host stops short of its end. AGENTS.md is usually where issue-tracking and session-completion norms live.
1. Restore state
Load doctrine-resume first, as your host loads a skill (the hub's host reference says how), and make no call before it but the reads of the instruction files above: its step 1b orders everything that comes before the phase's wrapper, and a recon read made alongside it comes too early. Then run its steps 1 to 4 as written there: read the memory file, act on the kickoff's first
line, check drift, hydrate Active Work, and produce its report. Put that report at the very top of
your reply, ahead of everything else; the kickoff in it is a live instruction from the prior session,
not history. Where it finds drift or an interrupted backup, take its step 5 as written there. Those steps are written there once and not restated here.
Where doctrine-resume would stop because no memory file exists, do not stop: say there is none,
offer doctrine-backup at session end, run doctrine-resume step 2's batch anyway for the
branch, dirty work, PRs and build, and continue to step 2. Where the file exists but its
## Next Session Kickoff is absent, say so plainly: doctrine-backup is contracted to write it, so
its absence means the last handoff was lost.
2. Recon
Discover the project's shape; never assume src/. Batch these, then read what the listing reveals:
lsthe root, thenlsthe two or three real source directories it showscommand -v treebefore reaching for a tree; on many hosts it is absentgh issue list --state open --limit 200 --json number --jq 'length'for the count, written as "200+" when it returns 200, since the limit caps the fetch. Only pull titles for the handful the kickoff names: some repos carry thousands of open issues.
Then read README.md if it exists, and any docs/ index: the root README is usually the product, the
docs index the engineering map.
Several plausible build workflows (large repos often have a dozen): name the one doctrine-resume's
drift check picked and mark the verdict as based on that pick, or say it is ambiguous. Never let a guess
become a silent "built ✓".
3. Explain the project
- Structure: the real directories you listed, never a guessed layout
- Purpose and goals
- Key files and what each is for
- Important dependencies
- Important configuration files
- Open work: the issue count from step 2, and whatever the kickoff points at
Done when
doctrine-resume's report leads the reply, with the kickoff quoted or its absence flagged, and every
step 3 bullet is covered.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

