Docs: promote the shipped review stage into docs/architecture and reconcile CLAUDE.md #271
Notifications
Due Date
No due date set.
Depends on
Reference: sam/archie#271
Reference in new issue
Block a user
Under the scope-discipline rule merged as PR #533, a design is promoted into docs/architecture/ only once it is built and true. This is that promotion, and it is deliberately a separate bead so it is not lost when the feature lands and attention moves on.
Do three things once the stage ships:
CLAUDE.md's own rule: a comment or doc that contradicts its code is worse than none, because the next reader trusts it.
Acceptance criteria
docs/architecture/ describes the shipped stage; ARCHITECTURE.md's lifecycle includes the review stage and the waiting_human diversion; CLAUDE.md distinguishes the manual contributor pass from archied's automated one; no doc still claims review is only manual.
Close reason
Promoted docs/prds/adversarial-self-review.md to docs/architecture/adversarial-review.md (as shipped), added the review stage to ARCHITECTURE.md's task lifecycle, and reconciled CLAUDE.md's Development Protocol (contributor opt-in vs archied's automatic pass). PR #785. Documented parked, not waiting_human (h019.1 resolved the state).
Imported from beads
archie-core-h019.7· GitHub #557 · type task · priority P2 · created 2026-08-21 · closed 2026-09-09