Marcos Paulo
ab2308441c
The repository had two skill directories. `skills/` held the four written for this project; `.agents/skills/` held the ones the agent context refers to. Nothing said which an agent should read, and `.agents/ORCHESTRATOR.md` only ever pointed at the second. Move the first four into `.agents/skills/` so there is one location, and add the vendored packages this chapter work used: `animation-vocabulary` and `improve-animations` (emilkowalski/skills), `teach` (mattpocock/skills), plus a local `translation` skill and `audit-translations.mjs` for the EN/PT pairs. `skills-lock.json` pins the vendored three by source and content hash, so a later re-vendor is a diff rather than a guess. `.claude/skills/` is symlinks into `.agents/skills/`, which is what makes them loadable here without a second copy on disk. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
Interview source map
This map records the implementation inspected for the rules case study. Reconfirm paths when the source repository changes.
| Concern | Source | Role |
|---|---|---|
| Shared context | AGENTS.md |
Stack, commands, product shape, conventions, and verification expectations. |
| Reusable procedures | .agents/skills/ |
Focused workflows such as gates, frontend, Go API, repo DB, and skill writing. |
| Machine-readable routing | .agents/db/commands.json |
Canonical checks and code-generation commands. |
| UI enforcement | scripts/check-ui-contract.mjs |
Ratchet for buttons, catches, headings, colors, and duplicate components. |
| Ratchet state | scripts/ui-contract-baseline.json |
Baseline counts that new violations cannot exceed. |
| Commit boundary | .husky/pre-commit |
Runs lint-staged and the UI contract check. |
| Commit message boundary | .husky/commit-msg |
Runs commitlint. |
| Staged-file tools | .lintstagedrc.cjs |
Biome, ESLint, Prettier, and Buf formatting by file type. |
| Independent review | .pr-review.json |
Review focus, exclusions, security constraints, and test expectations. |
| Agent roles | .claude/agents/ |
Prior-art scout, scoped implementer, and verifier responsibilities. |
The source of truth is the repository. This table is a teaching map, not a replacement for reading the files.