From c8c7d1dcdc194871e6a09c429a41c4597901b87a Mon Sep 17 00:00:00 2001 From: Oriol Torrent Florensa Date: Sun, 27 Sep 2026 23:29:27 +0200 Subject: [PATCH 1/6] docs(unic-archon-dlc): show a PNG preview of each command Box diagram in the README The command Box rows linked their diagrams as HTML only, while each Archon workflow diagram already had a preview per colour scheme. Closes #610 Co-Authored-By: Claude Opus 5.5 --- apps/claude-code/unic-archon-dlc/CHANGELOG.md | 1 + apps/claude-code/unic-archon-dlc/README.md | 53 ++++++++++++++++++- 2 files changed, 53 insertions(+), 1 deletion(-) diff --git a/apps/claude-code/unic-archon-dlc/CHANGELOG.md b/apps/claude-code/unic-archon-dlc/CHANGELOG.md index a608acaa..80e483d5 100644 --- a/apps/claude-code/unic-archon-dlc/CHANGELOG.md +++ b/apps/claude-code/unic-archon-dlc/CHANGELOG.md @@ -9,6 +9,7 @@ - An architecture diagram, `docs/architecture/20260925-unic-dlc-architecture.html` with its Archify source JSON, linked from the README next to the vision diagram, with a PNG preview per colour scheme. It shows what the plugin ships, what `/setup` installs into a Consumer, where each Box runs, and which parts the Harness decides, which the team owns, and which are seams between the two (#563). - A box-set diagram and one pipeline diagram for each Archon Box (`/build`, `/pr-review`, `/qa`, `/explore`), in `docs/architecture/` with their Archify source JSON and a PNG preview per colour scheme, linked from the README's box-set section and from each row of its pipelines table. Every pipeline diagram follows its workflow YAML (#564). - One diagram for each command Box (`/setup`, `/specs`, `/tickets`, `/triage`, `/improve-architecture`, `/cleanup`, `/archon-upgrade`), in `docs/architecture/` with its Archify source JSON and a PNG preview per colour scheme, linked from that Box's row of the README's box-set table. Each one shows the Methods the command reads, what it writes, and every point where it waits for a human. The box-set ASCII line now says `/triage` takes QA findings a person brings, not the `/qa` reject path (#565). +- The README now shows a PNG preview of each command Box diagram, one per colour scheme, after the box-set table and in the order of its rows, the way it already shows each Archon workflow diagram (#610). ### Fixed - (none) diff --git a/apps/claude-code/unic-archon-dlc/README.md b/apps/claude-code/unic-archon-dlc/README.md index 97fc27cb..a085b683 100644 --- a/apps/claude-code/unic-archon-dlc/README.md +++ b/apps/claude-code/unic-archon-dlc/README.md @@ -80,7 +80,58 @@ OFF-LINE /setup · /explore · /improve-architecture · /cleanup · /archon-u > Each command row links an Archify diagram drawn from that command's text. > It shows the Methods the command reads, the files it reads and writes, its tracker writes, and > every point where it waits for a human. `/specs`, `/tickets` and `/setup` group their steps into -> phases so that each diagram fits one screen. Each source JSON sits beside its HTML. +> phases so that each diagram fits one screen. Each source JSON sits beside its HTML. The previews +> below are PNG exports from each diagram's own viewer, one per colour scheme; export both again +> whenever the JSON changes. + + + + + /setup command: read the Archon version, the project and the tools, discover the stack, install the Methods and workflows, write the config and the tracker contract after the operator confirms each gap, then patch CLAUDE.md and print a summary + + + + + + + /specs command: prepare, understand the input through the to-spec, grilling and domain-modeling Methods, write PRD.md and a design contract per component, then open the PRD gate as a PR to develop, with each point where it halts for a human + + + + + + + /tickets command: prepare, slice the PRD and check the slices with the to-tickets Method, write issues.json and publish one tracker item per slice, then open the tickets gate as a PR to develop, with each point where it halts for a human + + + + + + + /triage command: load the config and the Methods, read the tracker contract, follow the triage Method with the human, apply the agreed state, type, comment or close to the tracker item, then print a summary + + + + + + + /improve-architecture command: load the config and the Methods, pick a mode, check technical drift with the human and then intent drift, write arch-review.md, consolidate the ADRs with the human deciding each one, then print a summary + + + + + + + /cleanup command: load the config, pick a mode, enumerate stale worktrees, PRs and slug dirs, report them, prune only under --apply with a yes or no per category, then print a summary + + + + + + + /archon-upgrade command: compare the installed Archon with the floor, fetch the upstream release notes, classify each change, re-assert the traps, probe the config keys in a throwaway repo, then print the report + + Archon boxes gate via config (`gates.: hitl | afk`, HITL default); interactive skill boxes are inherently HITL. `/handoff` and `/prototype` are **referenced** Matt skills, named in prose for a From 999c26ece39c11b1cdccb1f1821ee41898c0abb3 Mon Sep 17 00:00:00 2001 From: Oriol Torrent Florensa Date: Sun, 27 Sep 2026 23:31:31 +0200 Subject: [PATCH 2/6] docs(unic-archon-dlc): name the human halts in the /setup and /archon-upgrade preview alts Co-Authored-By: Claude Opus 5.5 --- apps/claude-code/unic-archon-dlc/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/apps/claude-code/unic-archon-dlc/README.md b/apps/claude-code/unic-archon-dlc/README.md index a085b683..05d6230b 100644 --- a/apps/claude-code/unic-archon-dlc/README.md +++ b/apps/claude-code/unic-archon-dlc/README.md @@ -87,7 +87,7 @@ OFF-LINE /setup · /explore · /improve-architecture · /cleanup · /archon-u - /setup command: read the Archon version, the project and the tools, discover the stack, install the Methods and workflows, write the config and the tracker contract after the operator confirms each gap, then patch CLAUDE.md and print a summary + /setup command: read the Archon version, the project and the tools, discover the stack, install the Methods and workflows, write the config and the tracker contract, then patch CLAUDE.md and print a summary, with each point where it halts for a human @@ -129,7 +129,7 @@ OFF-LINE /setup · /explore · /improve-architecture · /cleanup · /archon-u - /archon-upgrade command: compare the installed Archon with the floor, fetch the upstream release notes, classify each change, re-assert the traps, probe the config keys in a throwaway repo, then print the report + /archon-upgrade command: compare the installed Archon with the floor, discover the upstream repository and fetch its release notes, classify each change, re-assert the traps, probe the config keys in a throwaway repo, then print the report, with each point where it halts for a human From 4e4d41875ed948d5a3ac3af99e560442128c181e Mon Sep 17 00:00:00 2001 From: Oriol Torrent Florensa Date: Sun, 27 Sep 2026 23:34:17 +0200 Subject: [PATCH 3/6] chore(unic-archon-dlc): release 0.29.0 Co-Authored-By: Claude Opus 5.5 --- .../unic-archon-dlc/.claude-plugin/marketplace.json | 2 +- .../unic-archon-dlc/.claude-plugin/plugin.json | 4 ++-- apps/claude-code/unic-archon-dlc/CHANGELOG.md | 11 +++++++++++ apps/claude-code/unic-archon-dlc/package.json | 2 +- 4 files changed, 15 insertions(+), 4 deletions(-) diff --git a/apps/claude-code/unic-archon-dlc/.claude-plugin/marketplace.json b/apps/claude-code/unic-archon-dlc/.claude-plugin/marketplace.json index eb2c2d2b..1d4c1e35 100644 --- a/apps/claude-code/unic-archon-dlc/.claude-plugin/marketplace.json +++ b/apps/claude-code/unic-archon-dlc/.claude-plugin/marketplace.json @@ -21,7 +21,7 @@ "name": "unic-archon-dlc", "source": "./", "tags": ["productivity", "workflow", "ai-development"], - "version": "0.28.0" + "version": "0.29.0" } ] } diff --git a/apps/claude-code/unic-archon-dlc/.claude-plugin/plugin.json b/apps/claude-code/unic-archon-dlc/.claude-plugin/plugin.json index cf94254d..8b06b199 100644 --- a/apps/claude-code/unic-archon-dlc/.claude-plugin/plugin.json +++ b/apps/claude-code/unic-archon-dlc/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "unic-archon-dlc", - "version": "0.28.0", - "description": "A config-driven Harness for the SDLC \u2014 the AI development lifecycle \u2014 as an installable Claude Code plugin \u2014 main line /specs \u2192 /tickets \u2192 /build \u2192 /pr-review \u2192 /qa, plus /triage, /explore, /improve-architecture, and /cleanup. Four Archon workflows (build, qa, pr-review, explore) with human approval gates; the rest are commands/skills composing Matt Pocock's methods.", + "version": "0.29.0", + "description": "A config-driven Harness for the SDLC — the AI development lifecycle — as an installable Claude Code plugin — main line /specs → /tickets → /build → /pr-review → /qa, plus /triage, /explore, /improve-architecture, and /cleanup. Four Archon workflows (build, qa, pr-review, explore) with human approval gates; the rest are commands/skills composing Matt Pocock's methods.", "author": { "name": "Unic AG", "url": "https://www.unic.com" diff --git a/apps/claude-code/unic-archon-dlc/CHANGELOG.md b/apps/claude-code/unic-archon-dlc/CHANGELOG.md index 80e483d5..ba17ae0a 100644 --- a/apps/claude-code/unic-archon-dlc/CHANGELOG.md +++ b/apps/claude-code/unic-archon-dlc/CHANGELOG.md @@ -5,6 +5,17 @@ ### Breaking - (none) +### Added +- (none) + +### Fixed +- (none) + +## [0.29.0] — 2026-09-27 + +### Breaking +- (none) + ### Added - An architecture diagram, `docs/architecture/20260925-unic-dlc-architecture.html` with its Archify source JSON, linked from the README next to the vision diagram, with a PNG preview per colour scheme. It shows what the plugin ships, what `/setup` installs into a Consumer, where each Box runs, and which parts the Harness decides, which the team owns, and which are seams between the two (#563). - A box-set diagram and one pipeline diagram for each Archon Box (`/build`, `/pr-review`, `/qa`, `/explore`), in `docs/architecture/` with their Archify source JSON and a PNG preview per colour scheme, linked from the README's box-set section and from each row of its pipelines table. Every pipeline diagram follows its workflow YAML (#564). diff --git a/apps/claude-code/unic-archon-dlc/package.json b/apps/claude-code/unic-archon-dlc/package.json index b09356aa..9755d0d1 100644 --- a/apps/claude-code/unic-archon-dlc/package.json +++ b/apps/claude-code/unic-archon-dlc/package.json @@ -1,6 +1,6 @@ { "name": "unic-archon-dlc", - "version": "0.28.0", + "version": "0.29.0", "private": true, "license": "LGPL-3.0-or-later", "type": "module", From a769afef9806519e3ec171b6b39ac9f6de3980d8 Mon Sep 17 00:00:00 2001 From: Oriol Torrent Florensa Date: Sun, 27 Sep 2026 23:36:21 +0200 Subject: [PATCH 4/6] chore(repo): stop tracking the Claude Code scheduled-tasks lock The lock entered git in 367d907c through a merge in an Archon worktree. It holds one session id and pid, and every session that takes or drops the lock leaves the tree dirty, which makes pnpm bump refuse to run. Co-Authored-By: Claude Opus 5.5 --- .claude/scheduled_tasks.lock | 1 - .gitignore | 3 +++ 2 files changed, 3 insertions(+), 1 deletion(-) delete mode 100644 .claude/scheduled_tasks.lock diff --git a/.claude/scheduled_tasks.lock b/.claude/scheduled_tasks.lock deleted file mode 100644 index 8004b493..00000000 --- a/.claude/scheduled_tasks.lock +++ /dev/null @@ -1 +0,0 @@ -{"sessionId":"2b838c27-9362-438f-8839-e0fa666363d6","pid":4521,"procStart":"Wed Jun 3 10:33:56 2026","acquiredAt":1780484406442} \ No newline at end of file diff --git a/.gitignore b/.gitignore index c0360e71..35779bc7 100644 --- a/.gitignore +++ b/.gitignore @@ -355,3 +355,6 @@ vite.config.ts.timestamp-* # Orchestrator coordination artefacts: STATE names the client Consumer repo, and this repo is public. .orchestration/ + +# Claude Code runtime lock for scheduled tasks: holds one session id and pid, never content. +.claude/scheduled_tasks.lock From 38976d1b4b7b4984a99d7a3fc6296e87b6f55fbe Mon Sep 17 00:00:00 2001 From: Oriol Torrent Florensa Date: Sun, 27 Sep 2026 23:45:33 +0200 Subject: [PATCH 5/6] docs(unic-archon-dlc): title each command and pipeline diagram preview in the README A preview shows no name, so a reader could not tell which Box a diagram is for without opening it. The two paragraphs that followed the command previews move above them, so they do not sit under the last heading. Co-Authored-By: Claude Opus 5.5 --- apps/claude-code/unic-archon-dlc/CHANGELOG.md | 2 +- apps/claude-code/unic-archon-dlc/README.md | 38 +++++++++++++++---- 2 files changed, 31 insertions(+), 9 deletions(-) diff --git a/apps/claude-code/unic-archon-dlc/CHANGELOG.md b/apps/claude-code/unic-archon-dlc/CHANGELOG.md index ba17ae0a..d527e461 100644 --- a/apps/claude-code/unic-archon-dlc/CHANGELOG.md +++ b/apps/claude-code/unic-archon-dlc/CHANGELOG.md @@ -20,7 +20,7 @@ - An architecture diagram, `docs/architecture/20260925-unic-dlc-architecture.html` with its Archify source JSON, linked from the README next to the vision diagram, with a PNG preview per colour scheme. It shows what the plugin ships, what `/setup` installs into a Consumer, where each Box runs, and which parts the Harness decides, which the team owns, and which are seams between the two (#563). - A box-set diagram and one pipeline diagram for each Archon Box (`/build`, `/pr-review`, `/qa`, `/explore`), in `docs/architecture/` with their Archify source JSON and a PNG preview per colour scheme, linked from the README's box-set section and from each row of its pipelines table. Every pipeline diagram follows its workflow YAML (#564). - One diagram for each command Box (`/setup`, `/specs`, `/tickets`, `/triage`, `/improve-architecture`, `/cleanup`, `/archon-upgrade`), in `docs/architecture/` with its Archify source JSON and a PNG preview per colour scheme, linked from that Box's row of the README's box-set table. Each one shows the Methods the command reads, what it writes, and every point where it waits for a human. The box-set ASCII line now says `/triage` takes QA findings a person brings, not the `/qa` reject path (#565). -- The README now shows a PNG preview of each command Box diagram, one per colour scheme, after the box-set table and in the order of its rows, the way it already shows each Archon workflow diagram (#610). +- The README now shows a PNG preview of each command Box diagram, one per colour scheme, after the box-set table and in the order of its rows, the way it already shows each Archon workflow diagram. A heading names the Box above each command and pipeline preview (#610). ### Fixed - (none) diff --git a/apps/claude-code/unic-archon-dlc/README.md b/apps/claude-code/unic-archon-dlc/README.md index 05d6230b..f635c4d0 100644 --- a/apps/claude-code/unic-archon-dlc/README.md +++ b/apps/claude-code/unic-archon-dlc/README.md @@ -84,6 +84,16 @@ OFF-LINE /setup · /explore · /improve-architecture · /cleanup · /archon-u > below are PNG exports from each diagram's own viewer, one per colour scheme; export both again > whenever the JSON changes. +Archon boxes gate via config (`gates.: hitl | afk`, HITL default); interactive skill boxes are +inherently HITL. `/handoff` and `/prototype` are **referenced** Matt skills, named in prose for a +human to run and deliberately not bundled (see [Dependencies](#dependencies)). + +Run `/specs` and `/tickets` in one Claude Code conversation. `/specs` grills you to write `PRD.md`, +and `/tickets` uses what that grilling left in the conversation to slice the PRD into vertical +slices. A new conversation starts `/tickets` with only the PRD. + +### `/setup` command diagram + @@ -91,6 +101,8 @@ OFF-LINE /setup · /explore · /improve-architecture · /cleanup · /archon-u +### `/specs` command diagram + @@ -98,6 +110,8 @@ OFF-LINE /setup · /explore · /improve-architecture · /cleanup · /archon-u +### `/tickets` command diagram + @@ -105,6 +119,8 @@ OFF-LINE /setup · /explore · /improve-architecture · /cleanup · /archon-u +### `/triage` command diagram + @@ -112,6 +128,8 @@ OFF-LINE /setup · /explore · /improve-architecture · /cleanup · /archon-u +### `/improve-architecture` command diagram + @@ -119,6 +137,8 @@ OFF-LINE /setup · /explore · /improve-architecture · /cleanup · /archon-u +### `/cleanup` command diagram + @@ -126,6 +146,8 @@ OFF-LINE /setup · /explore · /improve-architecture · /cleanup · /archon-u +### `/archon-upgrade` command diagram + @@ -133,14 +155,6 @@ OFF-LINE /setup · /explore · /improve-architecture · /cleanup · /archon-u -Archon boxes gate via config (`gates.: hitl | afk`, HITL default); interactive skill boxes are -inherently HITL. `/handoff` and `/prototype` are **referenced** Matt skills, named in prose for a -human to run and deliberately not bundled (see [Dependencies](#dependencies)). - -Run `/specs` and `/tickets` in one Claude Code conversation. `/specs` grills you to write `PRD.md`, -and `/tickets` uses what that grilling left in the conversation to slice the PRD into vertical -slices. A new conversation starts `/tickets` with only the PRD. - ## Archon workflow pipelines The Archon boxes ship as key-discriminated workflow YAMLs in `.archon/workflows/` @@ -170,6 +184,8 @@ JSON sits alongside. Each diagram shows the nodes in run order, the nodes that r workflow writes. The previews below are PNG exports from each diagram's own viewer, one per colour scheme; export both again whenever the JSON changes. +### `unic-dlc-build` pipeline diagram, for `/build` + @@ -177,6 +193,8 @@ scheme; export both again whenever the JSON changes. +### `unic-dlc-pr-review` pipeline diagram, for `/pr-review` + @@ -184,6 +202,8 @@ scheme; export both again whenever the JSON changes. +### `unic-dlc-qa` pipeline diagram, for `/qa` + @@ -191,6 +211,8 @@ scheme; export both again whenever the JSON changes. +### `unic-dlc-explore` pipeline diagram, for `/explore` + From 84c3bdabadbfd61a85afb8ee1bd7495adf35a269 Mon Sep 17 00:00:00 2001 From: Oriol Torrent Florensa Date: Sun, 27 Sep 2026 23:54:58 +0200 Subject: [PATCH 6/6] docs(unic-archon-dlc): match four command preview alts to their diagrams The /cleanup alt now names its halts, the /triage alt the out-of-scope record, the /setup alt reads the tools in the discover step, and the /specs and /tickets alts open a PR only in open-pr mode. The note that introduces the previews now sits right above them. Co-Authored-By: Claude Opus 5.5 --- apps/claude-code/unic-archon-dlc/README.md | 24 +++++++++++----------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/apps/claude-code/unic-archon-dlc/README.md b/apps/claude-code/unic-archon-dlc/README.md index f635c4d0..2f8fb4bd 100644 --- a/apps/claude-code/unic-archon-dlc/README.md +++ b/apps/claude-code/unic-archon-dlc/README.md @@ -77,13 +77,6 @@ OFF-LINE /setup · /explore · /improve-architecture · /cleanup · /archon-u | `/cleanup` ([diagram](docs/architecture/20260925-unic-dlc-cleanup-command.html)) | command | HITL | Repo-global janitor: prune stale worktrees / branches / PRs / slug dirs, report-first (ADR-0028) | | `/archon-upgrade` ([diagram](docs/architecture/20260925-unic-dlc-archon-upgrade-command.html)) | command | — | Report what a new Archon release means for this Plugin; writes nothing here, probes config keys in a throwaway repo (ADR-0035) | -> Each command row links an Archify diagram drawn from that command's text. -> It shows the Methods the command reads, the files it reads and writes, its tracker writes, and -> every point where it waits for a human. `/specs`, `/tickets` and `/setup` group their steps into -> phases so that each diagram fits one screen. Each source JSON sits beside its HTML. The previews -> below are PNG exports from each diagram's own viewer, one per colour scheme; export both again -> whenever the JSON changes. - Archon boxes gate via config (`gates.: hitl | afk`, HITL default); interactive skill boxes are inherently HITL. `/handoff` and `/prototype` are **referenced** Matt skills, named in prose for a human to run and deliberately not bundled (see [Dependencies](#dependencies)). @@ -92,12 +85,19 @@ Run `/specs` and `/tickets` in one Claude Code conversation. `/specs` grills you and `/tickets` uses what that grilling left in the conversation to slice the PRD into vertical slices. A new conversation starts `/tickets` with only the PRD. +> Each command row links an Archify diagram drawn from that command's text. +> It shows the Methods the command reads, the files it reads and writes, its tracker writes, and +> every point where it waits for a human. `/specs`, `/tickets` and `/setup` group their steps into +> phases so that each diagram fits one screen. Each source JSON sits beside its HTML. The previews +> below are PNG exports from each diagram's own viewer, one per colour scheme; export both again +> whenever the JSON changes. + ### `/setup` command diagram - /setup command: read the Archon version, the project and the tools, discover the stack, install the Methods and workflows, write the config and the tracker contract, then patch CLAUDE.md and print a summary, with each point where it halts for a human + /setup command: read the Archon version and the project, discover the tools and the stack, install the Methods and workflows, write the config and the tracker contract, then patch CLAUDE.md and print a summary, with each point where it halts for a human @@ -106,7 +106,7 @@ slices. A new conversation starts `/tickets` with only the PRD. - /specs command: prepare, understand the input through the to-spec, grilling and domain-modeling Methods, write PRD.md and a design contract per component, then open the PRD gate as a PR to develop, with each point where it halts for a human + /specs command: prepare, understand the input through the to-spec, grilling and domain-modeling Methods, write PRD.md and a design contract per component, then open the PRD gate, as a PR to develop in open-pr mode, with each point where it halts for a human @@ -115,7 +115,7 @@ slices. A new conversation starts `/tickets` with only the PRD. - /tickets command: prepare, slice the PRD and check the slices with the to-tickets Method, write issues.json and publish one tracker item per slice, then open the tickets gate as a PR to develop, with each point where it halts for a human + /tickets command: prepare, slice the PRD and check the slices with the to-tickets Method, write issues.json and publish one tracker item per slice, then open the tickets gate, as a PR to develop in open-pr mode, with each point where it halts for a human @@ -124,7 +124,7 @@ slices. A new conversation starts `/tickets` with only the PRD. - /triage command: load the config and the Methods, read the tracker contract, follow the triage Method with the human, apply the agreed state, type, comment or close to the tracker item, then print a summary + /triage command: load the config and the Methods, read the tracker contract, follow the triage Method with the human, apply the agreed state, type, comment or close to the tracker item or record a rejected enhancement in the out-of-scope dir, then print a summary @@ -142,7 +142,7 @@ slices. A new conversation starts `/tickets` with only the PRD. - /cleanup command: load the config, pick a mode, enumerate stale worktrees, PRs and slug dirs, report them, prune only under --apply with a yes or no per category, then print a summary + /cleanup command: load the config, pick a mode, enumerate stale worktrees, PRs and slug dirs, report them, prune only under --apply with a yes or no per category, then print a summary, with each point where it halts for a human