docs(unic-archon-dlc): finalize redesign — reconcile diagram + docs (step 13, v0.12.0)#273
Merged
Merged
Conversation
…step 13)
Last step of the unic-archon-dlc redesign (steps 00-12 all merged). No code
changes — reconciles the vision diagram and plugin docs with what shipped, and
bumps to v0.12.0.
Why: after 12 box PRs the vision diagram and README still described the old
seven-workflow model (triage inline on the main line, ROADMAP.md/HANDOFF.md as
current artefacts, yaml-gen/build-<slug>.yaml, Archon >= 0.10), which no longer
matches the two-axis architecture the ADRs and AGENTS.md/CONTEXT.md describe.
- Vision diagram regenerated to the two-axis box set. New canonical pair
docs/20260703-Unic-dlc.{mmd,excalidraw}; the superseded draft is archived as
-draft (dated yyyymmdd- scheme, newest date wins).
- README rewritten: box-set table + the four actual Archon workflow pipelines,
<artifacts_dir>/<slug>/ session layout (no ROADMAP.md/HANDOFF.md), Archon
>= 0.5.0.
- CONTEXT.md: stale unic-dlc-plan.md example -> unic-dlc-build.md; dropped the
dissolved yaml-gen/build-<slug>.yaml relationships (ADR-0023); added the
"deterministic output" note (emergent, not a workflow).
- plugin.json/marketplace.json descriptions tidied (only build/qa/pr-review/
explore are Archon workflows; improve-architecture listed).
- Lightweight dogfood pass: the 4 workflow YAMLs parse under the
key-discriminated schema; stubs + core config keys present.
- Redesign marked complete in docs/redesign/README.md.
Version manually promoted (unic-bump blocked by unrelated dirty tree); marketplace
+ package versions via sync-version.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
This PR finalizes the unic-archon-dlc redesign by reconciling the plugin’s outward-facing documentation and vision diagram with the already-shipped two-axis architecture, and bumps the plugin to v0.12.0.
Changes:
- Rewrites
README.mdand updatesCONTEXT.mdto reflect the shipped “box set” model (main line + on-ramps + off-line boxes), artifact layout, and Archon version floor. - Adds a regenerated vision diagram (Mermaid + Excalidraw) and archives the previous draft under a dated naming scheme.
- Marks redesign step 13 complete and updates versioning + changelog entries for
0.12.0.
Reviewed changes
Copilot reviewed 9 out of 11 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| apps/claude-code/unic-archon-dlc/README.md | Updates public docs to the shipped two-axis model (box set, pipelines, artifacts, deps). |
| apps/claude-code/unic-archon-dlc/CONTEXT.md | Refreshes vocabulary/relationships and adds deterministic-output note aligned with ADRs. |
| apps/claude-code/unic-archon-dlc/docs/20260703-Unic-dlc.mmd | Adds new canonical Mermaid vision diagram. |
| apps/claude-code/unic-archon-dlc/docs/20260703-Unic-dlc.excalidraw | Adds new canonical Excalidraw diagram export. |
| apps/claude-code/unic-archon-dlc/docs/20260703-Unic-dlc-draft.mmd | Archives the prior draft Mermaid diagram. |
| apps/claude-code/unic-archon-dlc/docs/20260703-Unic-dlc-draft.excalidraw | Archives the prior draft Excalidraw export. |
| apps/claude-code/unic-archon-dlc/docs/redesign/README.md | Marks redesign step 13 as complete in the progress table. |
| apps/claude-code/unic-archon-dlc/CHANGELOG.md | Adds the 0.12.0 release notes describing diagram + doc reconciliation. |
| apps/claude-code/unic-archon-dlc/package.json | Bumps package version to 0.12.0. |
| apps/claude-code/unic-archon-dlc/.claude-plugin/plugin.json | Bumps plugin version + updates marketplace-facing description. |
| apps/claude-code/unic-archon-dlc/.claude-plugin/marketplace.json | Updates marketplace metadata + bumps version to 0.12.0. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Address Copilot review on PR #273: - Replace the private/local Excalidraw server URL (http://192.168.200.10:41000) in the source field of both the canonical and archived-draft .excalidraw files with a neutral public value. (Excalidraw re-stamps this on save from that server; scrubbed at commit time.) - Fix the "enforcemet" -> "enforcement" typo carried in the archived draft diagram. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Member
Author
|
Addressed the Copilot review in
|
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
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.
Final step (13) of the
unic-archon-dlcredesign. Steps 00–12 (#262–#272) are all merged todevelop; this reconciles the vision diagram and plugin docs with what actually shipped, does a lightweight dogfood check, and bumps to v0.12.0. No code changes.Why
After 12 box PRs the diagram and README still described the old seven-workflow model as current:
/triageinline on the main line,ROADMAP.md/HANDOFF.mdas live artefacts,yaml-gen/build-<slug>.yaml, andArchon ≥ 0.10. None of that matches the two-axis architecture the ADRs (0011–0029) andAGENTS.md/CONTEXT.mdalready describe. This step closes that gap so the outward-facing docs match the implementation.What
.mmd/.excalidrawwere an untracked, out-of-date Excalidraw export, so per the maintainer's call they're archived under a datedyyyymmdd-scheme and a fresh pair is authored:docs/20260703-Unic-dlc.{mmd,excalidraw}docs/20260703-Unic-dlc-draft.{mmd,excalidraw}/specs → /tickets → /build → /pr-review → /qa),/triage+/qafindings + humans as on-ramps into/tickets, the off-line boxes (/setup,/explore,/improve-architecture,/cleanup;/handoff+/prototypereferenced), and encodes both axes (container Archon vs command/skill, HITL/AFK gates)..excalidrawwas machine-generated from a node/edge spec (straight unbound arrows). It's valid and opens, but a maintainer may want to nudge the layout in Excalidraw for polish.<artifacts_dir>/<slug>/session-artifact layout (noROADMAP.md/HANDOFF.md),Archon ≥ 0.5.0.unic-dlc-plan.mdexample →unic-dlc-build.md; dropped the dissolvedyaml-gen/build-<slug>.yamlrelationships (ADR-0023); added the “deterministic output” stakeholder note (emergent from fresh-slice-reads-committed-repo, needs no workflow).build/qa/pr-review/exploreare called Archon workflows, andimprove-architectureis listed.docs/redesign/README.md(row 13 → done); directory kept as historical record.Dogfood (lightweight structural)
build=9,explore=11,pr-review=14,qa=9 nodes; zero legacytype:declarations).gates.*,artifacts_dir,tracker) present.Follow-up (out of scope here)
The repo-root
.archon/workflows/dogfood install is stale (old May-eraplan/review/triage/cleanupYAMLs + a brokenunic-archon-pr-review.yaml), and the repo-root.archon/unic-dlc.config.yamlpredates the later config blocks (cleanup, etc.). That's the consumer install, not plugin source — worth a separate refresh.Verification
pnpm --filter unic-archon-dlc typecheck✓pnpm --filter unic-archon-dlc test✓ (100 pass)pnpm --filter unic-archon-dlc verify:changelog✓ (0.12.0)pnpm ci:check✓ (exit 0; the 5 Biome infos are pre-existing inunic-pr-review)Notes
plugin.json(theunic-bumptool was blocked by an unrelated dirty working tree — a skills sync outside this plugin);sync-versionmirrored it tomarketplace.json+package.json.🤖 Generated with Claude Code