docs(unic-archon-dlc): redesign handoff plan + per-step session docs#259
Merged
Conversation
… docs Why: the plugin's 7 Archon workflows drifted from both Matt Pocock's "idea -> ship" methodology and the Unic-DLC vision diagram. A grilling session locked an umbrella design (one workflow per box, artifact-as-baton, HITL-default gates, anti-cheating fresh-context red/green) that is too large for a single implementation session. This adds docs/redesign/ as the durable umbrella: PLAN.md (the approved spec), README.md (shared context + per-step invocation prompts), and 14 ordered, self-contained handoff docs (00 schema pre-work -> 13 finalize). Each is a prompt for a fresh Claude Code session, so the refactor proceeds one gated PR at a time with state living in the repo/tracker, not conversation memory. No workflow/code behaviour changes yet — docs only. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Way16CEwyskjYmnGEbK3V4
Apply Prettier/markdown formatting to the redesign handoff docs. No content changes. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Way16CEwyskjYmnGEbK3V4
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The plugin's 7 Archon workflows (
explore, plan, build, qa, cleanup, triage, review) drifted from the two reference points we want to honour: Matt Pocock's "idea → ship" methodology (installed under.agents/skills/) and the Unic-DLC vision diagram (docs/Unic-dlc.mmd). A grilling session produced an umbrella design that's too large for one implementation pass, so this PR lands the plan + handoff scaffolding only — no workflow/code behaviour changes.What
apps/claude-code/unic-archon-dlc/docs/redesign/:PLAN.md— the approved umbrella spec (in-repo copy, canonical reference).README.md— shared locked context + a per-step invocation prompt table.00–13— ordered, self-contained prompts, one per fresh Claude Code session.Locked decisions captured
/specs → /tickets → /build → /pr-review → /qa; ON-RAMPS:/triage,/qafindings, humans; OFF-LINE:/setup,/explore,/improve-architecture,/cleanup,/handoff.plan→/specs+/tickets; renamereview→/pr-review./triage= Matt's intake on-ramp; old state-snapshottriage+HANDOFF.md/ROADMAP.mddropped (tracker is source of truth).cleanupsplits →/improve-architecture(arch-health + ADR superseding) + new/cleanup(worktree/branch/PR janitor)./handoffadded./setup.Notes / follow-ups
type:-style vs the live CLI'sapproval:/loop:schema) and writes the answer back intoPLAN.md. Everything downstream depends on it.AGENTS.md/CONTEXT.mdedits) is scheduled in step 01, executed in its own session.docs/Unic-dlc.mmdis referenced by these docs but is currently untracked in the repo; step 13 updates it to match the locked decisions.Docs only — safe to merge independently of implementation.
🤖 Generated with Claude Code