Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion .claude/scheduled_tasks.lock

This file was deleted.

3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -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
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
"name": "unic-archon-dlc",
"source": "./",
"tags": ["productivity", "workflow", "ai-development"],
"version": "0.28.0"
"version": "0.29.0"
}
]
}
4 changes: 2 additions & 2 deletions apps/claude-code/unic-archon-dlc/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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"
Expand Down
12 changes: 12 additions & 0 deletions apps/claude-code/unic-archon-dlc/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,10 +5,22 @@
### 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).
- 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. A heading names the Box above each command and pipeline preview (#610).

### Fixed
- (none)
Expand Down
83 changes: 78 additions & 5 deletions apps/claude-code/unic-archon-dlc/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,11 +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.

Archon boxes gate via config (`gates.<box>: 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)).
Expand All @@ -90,6 +85,76 @@ 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

<a href="docs/architecture/20260925-unic-dlc-setup-command.html">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/architecture/20260925-unic-dlc-setup-command.dark.png">
<img alt="/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" src="docs/architecture/20260925-unic-dlc-setup-command.light.png">
</picture>
</a>

### `/specs` command diagram

<a href="docs/architecture/20260925-unic-dlc-specs-command.html">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/architecture/20260925-unic-dlc-specs-command.dark.png">
<img alt="/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" src="docs/architecture/20260925-unic-dlc-specs-command.light.png">
</picture>
</a>

### `/tickets` command diagram

<a href="docs/architecture/20260925-unic-dlc-tickets-command.html">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/architecture/20260925-unic-dlc-tickets-command.dark.png">
<img alt="/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" src="docs/architecture/20260925-unic-dlc-tickets-command.light.png">
</picture>
</a>

### `/triage` command diagram

<a href="docs/architecture/20260925-unic-dlc-triage-command.html">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/architecture/20260925-unic-dlc-triage-command.dark.png">
<img alt="/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" src="docs/architecture/20260925-unic-dlc-triage-command.light.png">
</picture>
</a>

### `/improve-architecture` command diagram

<a href="docs/architecture/20260925-unic-dlc-improve-architecture-command.html">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/architecture/20260925-unic-dlc-improve-architecture-command.dark.png">
<img alt="/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" src="docs/architecture/20260925-unic-dlc-improve-architecture-command.light.png">
</picture>
</a>

### `/cleanup` command diagram

<a href="docs/architecture/20260925-unic-dlc-cleanup-command.html">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/architecture/20260925-unic-dlc-cleanup-command.dark.png">
<img alt="/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" src="docs/architecture/20260925-unic-dlc-cleanup-command.light.png">
</picture>
</a>

### `/archon-upgrade` command diagram

<a href="docs/architecture/20260925-unic-dlc-archon-upgrade-command.html">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/architecture/20260925-unic-dlc-archon-upgrade-command.dark.png">
<img alt="/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" src="docs/architecture/20260925-unic-dlc-archon-upgrade-command.light.png">
</picture>
</a>

## Archon workflow pipelines

The Archon boxes ship as key-discriminated workflow YAMLs in `.archon/workflows/`
Expand Down Expand Up @@ -119,27 +184,35 @@ 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`

<a href="docs/architecture/20260925-unic-dlc-build-pipeline.html">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/architecture/20260925-unic-dlc-build-pipeline.dark.png">
<img alt="unic-dlc-build pipeline: bootstrap and slopcheck, the run-build loop, the review precheck, verification, goals-check and evidence, then report, open-pr and build-pr-gate" src="docs/architecture/20260925-unic-dlc-build-pipeline.light.png">
</picture>
</a>

### `unic-dlc-pr-review` pipeline diagram, for `/pr-review`

<a href="docs/architecture/20260925-unic-dlc-pr-review-pipeline.html">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/architecture/20260925-unic-dlc-pr-review-pipeline.dark.png">
<img alt="unic-dlc-pr-review pipeline: bootstrap, prep, review, synthesize and reconcile, then review-gate and post" src="docs/architecture/20260925-unic-dlc-pr-review-pipeline.light.png">
</picture>
</a>

### `unic-dlc-qa` pipeline diagram, for `/qa`

<a href="docs/architecture/20260925-unic-dlc-qa-pipeline.html">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/architecture/20260925-unic-dlc-qa-pipeline.dark.png">
<img alt="unic-dlc-qa pipeline: bootstrap, test, e2e, coverage-gate, uat-prep and uat-gate, then verify-pr-base, merge-gate and merge" src="docs/architecture/20260925-unic-dlc-qa-pipeline.light.png">
</picture>
</a>

### `unic-dlc-explore` pipeline diagram, for `/explore`

<a href="docs/architecture/20260925-unic-dlc-explore-pipeline.html">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/architecture/20260925-unic-dlc-explore-pipeline.dark.png">
Expand Down
2 changes: 1 addition & 1 deletion apps/claude-code/unic-archon-dlc/package.json
Original file line number Diff line number Diff line change
@@ -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",
Expand Down
Loading