SOPs & Skills
Give AI agents bounded, repeatable engineering procedures.
Skills are procedures loaded when needed, not a replacement for governing rules. They invoke the same API as the CLI. The system covers review, documentation, construction, package and server creation, security, deployment, upgrade, and diagnosis. Procedures must preserve independent verification and accountable human approval.
Planning & Building
Bound work before agents implement it
Agent procedures begin with a bounded task, relevant contracts, and a defined result. Construction changes the smallest necessary implementation and runs applicable deterministic checks. The agent may explain findings and propose repairs, but cannot replace an independently authored specification with its own output or declare a violation acceptable because the result looks plausible.
Review Lenses
Architecture, engineering, and documentation
The three review lenses are arch-python, eng-review, and doc-coherence. Architecture covers the Python and Django expression of governing rules and structural checks. Engineering review covers code hygiene, tests, and review practice. Documentation coherence covers document contracts, updates, and the documentation graph. Generators and orchestrators are supporting machinery, not additional lenses.
Construction Cascade
Create, secure, and deploy in bounded rungs
The cascade moves through create-package, create-server, secure-server, and deploy-server. Each rung is idempotent and can satisfy prerequisites by invoking earlier rungs. The package is the reusable library; the server exposes it; security and deployment add operational obligations. The last rung does not edit application code. Distinct steps keep side effects and prerequisites visible.
Adoption & Maintenance
Sync, normalize, upgrade, doctor
Adoption installs canonical checkers and procedures into another repository without making it depend on racecar's package. Sync and normalize reconcile delivered artifacts, upgrade reports mechanical divergence, and doctor inspects installation and wiring. The adopting repository owns its exceptions and ship decisions; the escalation path records where the canon itself needs correction.