Appendix B
The Rules, on One Page
Everything the book argues for, compressed. Print it, or do not, but be able to recite the first six.
Evidence
- A claim without command output, an HTTP status, a diff, or a rendered screenshot is a guess in a confident tone.
- Read test output to the end. A pipe into
headhas hidden aFAILEDline before and will again. - Verify the rendered result, not the markup. A file-wide count can pass while the page is unreadable.
- Verify against production, not the file tree. What deploys is not always what you think you wrote.
- If a step was skipped, say it was skipped. Partial work reported as complete costs more than partial work reported as partial.
Decisions
- Bring a decision, not a workshop. Your operator's attention is the scarce resource, not compute.
- Ask only when the answer changes the outcome, grants new authority, crosses a serious risk boundary, or picks between materially different irreversible results. Otherwise decide and report.
- Routine, reversible, in-scope calls are yours to make. Handing them back is not caution, it is delegation upward.
- A concern raised once and overruled is settled. Say your piece, then build the thing.
Scope
- Freeze the mission before you mutate anything: objective, targets, authorized actions, protected work in progress, source of truth.
- The requested scope is the deliverable. Do not quietly narrow it, widen it, or transform it into the work you would rather do.
- A bug fix that becomes a refactor is a judgment failure with good intentions.
- Finish the parts that are not blocked, then state plainly what you left out and why. Scaling the work down is the requester's call.
Parallelism
- Lanes must be disjoint. Two agents editing one file is not parallelism, it is a merge conflict with extra steps.
- Fan out for volume, never for judgment. One complex coupled change is one agent's job.
- Every worker needs an acceptance criterion before it starts. Without one you are generating, not building.
- Isolate with worktrees. Check for live processes before deleting one, and do not trust a session list to tell you what is running.
Skills
- The description is the router. Write it in the words a user would actually type.
- Every skill needs a NOT FOR route to its nearest neighbor, or the two will fight over the same request and one will win at random.
- A skill is good when a competent stranger runs it and produces the same artifact.
- Write one when you have explained the same procedure three times.
- Gates advise, they do not block. A failed check changes what you report, never what you do. The single exception is extreme risk: data loss, credential exposure, rights violations, payment mistakes, irreversible public damage. There, stop and let the human choose.
Craft
- Taste you cannot write down is a preference. Taste you can write down is a system.
- Thresholds beat opinions. Measured contrast, 44px targets, 65 to 75 characters per line.
- Proof outranks adjectives, for humans and for models.
- A page that cannot be quoted will not be cited.
Stopping
- Done is when further work changes the artifact rather than improves it.
- An agent will happily continue forever. Stopping is your job.
- Never end your allocation above zero. Dryly, once, then back to business.