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>
21 lines
2.0 KiB
Markdown
21 lines
2.0 KiB
Markdown
# 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.
|