Skip to content

docs(unic-archon-dlc): finalize redesign — reconcile diagram + docs (step 13, v0.12.0)#273

Merged
orioltf merged 3 commits into
developfrom
feature/unic-archon-dlc-finalize
Jul 3, 2026
Merged

docs(unic-archon-dlc): finalize redesign — reconcile diagram + docs (step 13, v0.12.0)#273
orioltf merged 3 commits into
developfrom
feature/unic-archon-dlc-finalize

Conversation

@orioltf

@orioltf orioltf commented Jul 3, 2026

Copy link
Copy Markdown
Member

Final step (13) of the unic-archon-dlc redesign. Steps 00–12 (#262#272) are all merged to develop; 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: /triage inline on the main line, ROADMAP.md/HANDOFF.md as live artefacts, yaml-gen/build-<slug>.yaml, and Archon ≥ 0.10. None of that matches the two-axis architecture the ADRs (0011–0029) and AGENTS.md/CONTEXT.md already describe. This step closes that gap so the outward-facing docs match the implementation.

What

  • Vision diagram regenerated to the two-axis box set. The old .mmd/.excalidraw were an untracked, out-of-date Excalidraw export, so per the maintainer's call they're archived under a dated yyyymmdd- scheme and a fresh pair is authored:
    • canonical: docs/20260703-Unic-dlc.{mmd,excalidraw}
    • archived draft: docs/20260703-Unic-dlc-draft.{mmd,excalidraw}
    • The new diagram shows the main line (/specs → /tickets → /build → /pr-review → /qa), /triage + /qa findings + humans as on-ramps into /tickets, the off-line boxes (/setup, /explore, /improve-architecture, /cleanup; /handoff + /prototype referenced), and encodes both axes (container Archon vs command/skill, HITL/AFK gates).
    • Note: the .excalidraw was 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.
  • README rewritten to the shipped model: box-set table, the four actual Archon workflow pipelines, <artifacts_dir>/<slug>/ session-artifact 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” stakeholder note (emergent from fresh-slice-reads-committed-repo, needs no workflow).
  • plugin.json / marketplace.json descriptions tidied — only build/qa/pr-review/explore are called Archon workflows, and improve-architecture is listed.
  • Redesign marked complete in docs/redesign/README.md (row 13 → done); directory kept as historical record.

Dogfood (lightweight structural)

  • All 4 plugin workflow YAMLs parse and use the key-discriminated schema (build=9, explore=11, pr-review=14, qa=9 nodes; zero legacy type: declarations).
  • Command stubs present (4 Archon + 6 interactive); core config keys (gates.*, artifacts_dir, tracker) present.
  • Behavioural gate confirmation was done per-box in steps 06/08/09/12.

Follow-up (out of scope here)

The repo-root .archon/workflows/ dogfood install is stale (old May-era plan/review/triage/cleanup YAMLs + a broken unic-archon-pr-review.yaml), and the repo-root .archon/unic-dlc.config.yaml predates 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)
  • root pnpm ci:check ✓ (exit 0; the 5 Biome infos are pre-existing in unic-pr-review)

Notes

  • Version manually promoted in plugin.json (the unic-bump tool was blocked by an unrelated dirty working tree — a skills sync outside this plugin); sync-version mirrored it to marketplace.json + package.json.

🤖 Generated with Claude Code

orioltf and others added 2 commits July 3, 2026 13:45
…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>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.md and updates CONTEXT.md to 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.

Comment thread apps/claude-code/unic-archon-dlc/docs/20260703-Unic-dlc.excalidraw Outdated
Comment thread apps/claude-code/unic-archon-dlc/docs/20260703-Unic-dlc-draft.excalidraw Outdated
Comment thread apps/claude-code/unic-archon-dlc/docs/20260703-Unic-dlc-draft.mmd Outdated
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>
@orioltf

orioltf commented Jul 3, 2026

Copy link
Copy Markdown
Member Author

Addressed the Copilot review in 767f247:

  1. Internal Excalidraw source URL (both the canonical and draft .excalidraw) → replaced http://192.168.200.10:41000 with a neutral public value. Note: the canonical diagram was opened + re-saved in Excalidraw (now 83 elements, real appState), which re-stamps the local server URL on save — scrubbed at commit time. If it's re-exported from that server later it'll return.
  2. enforcemet typo → fixed to enforcement in the archived draft (.mmd + .excalidraw text). The canonical diagram doesn't carry that label.

@orioltf
orioltf merged commit d7dd452 into develop Jul 3, 2026
8 checks passed
@orioltf
orioltf deleted the feature/unic-archon-dlc-finalize branch July 3, 2026 12:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants