The agent crew
Agents draft, check, build and run the course. People review and decide. Each role has a brief in agents/; a session, routine or agent working on this repo reads its role's brief first.
Two rules for every agent
- The writer is never the checker. A session that wrote or edited a module may not source-check, red-team or review it.
- Every role stops at a named human gate. Nothing becomes public, and no module changes status past
draft, without the person named below.
Also: agents never appear in review.yml as reviewers, never invent a source, and write "not checked" rather than guess.
Roles
| Role | Runs on | Brief | Produces | Human gate |
|---|---|---|---|---|
| Program lead | Claude, weekly routine | agents/program-lead.md | STATUS.md; a line in the daily runbook | Bob and Ken say yes to each phase gate |
| Curriculum architect | Claude | agents/curriculum-architect.md | levels/<n>/objectives.yml | Ken signs each level's map |
| Lesson writer | Claude | agents/lesson-writer.md | Module gears and sources.yml | None: drafts only |
| Item writer | Claude | agents/item-writer.md | quiz.json, workbook.md, placement items | Reviewers check items with the lesson |
| Source checker | A separate Claude session | agents/source-checker.md | checks/source-check.md; checked dates in sources.yml | Unsupported claims block review |
| Red-team agent | Devin (Claude, same-system, under Bob's 21 Nov 2026 exception while Devin is out: design/decisions-2026-11-21-bob.md) | agents/red-team.md | checks/red-team.md | Human red-team lead rules on each finding |
| Red-team auditor | Claude, in a session that never wrote, source-checked or red-teamed the audited modules | agents/red-team-auditor.md | checks/red-team-audit.md; levels/<n>/art-red-team-audit.md | Human red-team lead rules on each audit finding; Bob merges |
| Builder | Devin | agents/builder.md | Placement test, lesson viewer, CI | Devin Review and Claude review; Bob merges |
| Designer | Claude | agents/designer.md | levels/<n>/art-plan.md; layout PRs in the Wren Café system | Bob approves each level's look |
| Illustrator | Devin, with its image tool | agents/illustrator.md | Scene art in figures/, figures.yml | Red team checks it; Bob approves each level's look |
| Infographic maker | Claude | agents/infographic-maker.md | Infographics and workflow diagrams in figures/, figures.yml | Source checker checks every fact; red team checks it |
| Visual reviewer | Devin and Claude, independently | agents/visual-reviewer.md | levels/<n>/visual-review.md and a visual gaps list | Bob approves each level's look |
| Review clerk | Claude routine | agents/review-clerk.md | Review packets; review.yml | Two human reviewers; the board signs the level |
| Errata and freshness | Claude, weekly routine | agents/errata-freshness.md | Errata PRs; ERRATA.md | One reviewer re-signs the changed passage |
| Cohort agent | Fo | agents/cohort.md | Pilot invites, reminders, agendas, feedback | Bob's single go |
| Credential agent | Beacon and the practice mark | (existing) | Level badge as a signed receipt | A host marks the project |
| Cert-prep agent | Fo's cert agent | agents/cert-prep.md | Prep rails toward vendor-proctored exams, 300 up | Bob clears each vendor name |
| Publisher | The Foundation site's content pipeline | (existing) | Academy page cards, launch story | Bob's publish yes |
People
- Bob and Ken co-chair the review board. Ken hosts the pilot's Thursday calls.
- Bob decides phase gates and merges.
- Two reviewers per module: one subject expert, one audience reader.
- Red-team lead: a person who rules on red-team findings.
Floorplan: a map of this repo
Agents on Claude Code or Codex keep a Floorplan map: a plain-English, clickable map of the repo's parts and how they connect.
- Install once (Node.js 18+), then start a new session:
claude plugin marketplace add CoreyScherrer/CS-Agent-Toolsandclaude plugin install floorplan@cs-agent-tools. - First map: ask for "a floorplan of this project". To see the whole publishing flow (lesson writer → checks →
tools/build_site.py→ Pages → the Foundation site's Academy card and story), open the folder that holds this repo and the Foundation site repo side by side. - After each piece of work: "update the floorplan".
- The map stays private.
floorplan/is kept out of git. Never commit it, and never export it to or link it from a public page: it describes the system, and this repo is private. - Health findings are leads, not verdicts. Open the file and line before acting, never paste a secret's value into chat, and rotate a real secret in a tracked file.
- A map is not a check. It never replaces
tools/check_modules.py, CI or a human gate.