SOPs & Skills

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.

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.

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 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.