docs: remove agent-coordination docs, canonical README + docs structure #72

Closed
opened 2026-10-24 18:41:42 -05:00 by Ghost · 0 comments

The agent-coordination docs (CONTRACT/HANDOFF/TASKS) were scaffolding for the parallel contest build; they're now stale. Target structure follows yuuhikaze/fire-extinguisher-turret and yuuhikaze/remote-pad.

Scope

  • Delete docs/HANDOFF.md (0 refs) and docs/TASKS.md; salvage the clippy no-unwrap policy + tern docs policy into a new docs/development.md
  • Fold docs/CONTRACT.md → docs/reference.md (de-crufted wire format + limits table); re-point the ~25 code-comment references
  • Rewrite README.md canonical-style: pitch → Screens table (real screenshots, from demo.md scenarios) → docs index → repo layout → quick start; replace all TASKS/CONTRACT links
  • .tern/config.toml: two-profile override so the README also compiles to docs-html (turret pattern); docs/img copied into docs-html
  • Re-render docs-html/ (committed); update docs/index.md to current scope (CFG/PDA/TM/dojo/ES)
  • Close PR #67 + delete branch docs/handoff2 (disposable HANDOFF rows only)

Acceptance

  • grep -rn "HANDOFF\|TASKS.md\|CONTRACT.md" → no dangling refs
  • nix develop -c tern --update && nix develop -c tern renders clean; docs-html committed
  • README has ≥4 linked screenshots in docs/img/
The agent-coordination docs (CONTRACT/HANDOFF/TASKS) were scaffolding for the parallel contest build; they're now stale. Target structure follows yuuhikaze/fire-extinguisher-turret and yuuhikaze/remote-pad. **Scope** - Delete `docs/HANDOFF.md` (0 refs) and `docs/TASKS.md`; salvage the clippy no-unwrap policy + tern docs policy into a new `docs/development.md` - Fold `docs/CONTRACT.md` → `docs/reference.md` (de-crufted wire format + limits table); re-point the ~25 code-comment references - Rewrite `README.md` canonical-style: pitch → Screens table (real screenshots, from demo.md scenarios) → docs index → repo layout → quick start; replace all TASKS/CONTRACT links - `.tern/config.toml`: two-profile override so the README also compiles to docs-html (turret pattern); docs/img copied into docs-html - Re-render `docs-html/` (committed); update `docs/index.md` to current scope (CFG/PDA/TM/dojo/ES) - Close PR #67 + delete branch `docs/handoff2` (disposable HANDOFF rows only) **Acceptance** - `grep -rn "HANDOFF\|TASKS.md\|CONTRACT.md"` → no dangling refs - `nix develop -c tern --update && nix develop -c tern` renders clean; docs-html committed - README has ≥4 linked screenshots in docs/img/
Ghost referenced this issue from a commit 2026-10-24 19:02:42 -05:00
Ghost closed this issue 2026-10-24 19:04:33 -05:00
Ghost added this to the SCRUM project 2026-10-24 20:48:21 -05:00
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
k8s-services/rgxr#72
No description provided.