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
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"metadata": {
"description": "A complete Archon-powered AI development lifecycle as an installable DLC pack",
"description": "A config-driven AI development lifecycle as an installable Claude Code plugin",
"homepage": "https://github.com/unic/unic-agents-plugins"
},
"name": "unic-archon-dlc",
Expand All @@ -13,15 +13,15 @@
"name": "Unic AG"
},
"category": "productivity",
"description": "A complete Archon-powered AI development lifecycle — explore, specs, tickets, build, pr-review, qa, triage, and cleanup workflows as installable YAML DAGs with human approval gates.",
"description": "A config-driven 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.",
"displayName": "Unic Archon DLC",
"homepage": "https://github.com/unic/unic-agents-plugins",
"keywords": ["archon", "workflow", "lifecycle", "tdd", "unic"],
"license": "LGPL-3.0-or-later",
"name": "unic-archon-dlc",
"source": "./",
"tags": ["productivity", "workflow", "ai-development"],
"version": "0.11.0"
"version": "0.12.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.11.0",
"description": "A complete Archon-powered AI development lifecycle as an installable DLC pack — explore, specs, tickets, build, pr-review, qa, triage, improve-architecture, and cleanup workflows.",
"version": "0.12.0",
"description": "A config-driven 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
10 changes: 10 additions & 0 deletions apps/claude-code/unic-archon-dlc/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,16 @@
### Fixed
- (none)

## [0.12.0] — 2026-07-03

### Added
- **Regenerated the vision diagram** to the two-axis target architecture (redesign step 13, final). The new canonical pair is `docs/20260703-Unic-dlc.{mmd,excalidraw}`, hand-authored to show the main line (`/specs → /tickets → /build → /pr-review → /qa`), `/triage` + `/qa` findings + humans as on-ramps into `/tickets`, and the off-line boxes (`/setup`, `/explore`, `/improve-architecture`, `/cleanup`; `/handoff` + `/prototype` referenced), with the container (Archon vs command/skill) and HITL/AFK gate axes encoded. The superseded draft is archived as `docs/20260703-Unic-dlc-draft.{mmd,excalidraw}`; a dated `yyyymmdd-` snapshot scheme replaces the single canonical filename (newest date wins).
- **Documented the "deterministic output" property** in `CONTEXT.md` as an _emergent_ consequence of the fresh-slice-reads-committed-repo discipline ([ADR-0012](docs/adr/0012-fresh-context-red-green-separation.md) / [ADR-0013](docs/adr/0013-tracker-single-source-of-truth.md) / [ADR-0015](docs/adr/0015-workflows-slug-artifact-home.md)) — it needs no workflow.

### Changed
- **Swept the plugin docs to the shipped model** (redesign step 13). Rewrote the stale `README.md` — the old six-workflow diagram + node table, the `ROADMAP.md`/`HANDOFF.md` `docs/workflow/` layout, `yaml-gen`/`build-<slug>.yaml`, and the `Archon ≥ 0.10` requirement were all pre-redesign — into the two-axis box set, the four actual Archon workflow pipelines, a `<artifacts_dir>/<slug>/` session-artifact layout (no `ROADMAP.md`/`HANDOFF.md`), and `Archon ≥ 0.5.0`. Fixed `CONTEXT.md` (stale `unic-dlc-plan.md` example → `unic-dlc-build.md`; dropped the dissolved `yaml-gen`/`build-<slug>.yaml` relationships per [ADR-0023](docs/adr/0023-build-generic-red-green-refactor-loop.md)). Tidied the `plugin.json` / `marketplace.json` descriptions so only `build`/`qa`/`pr-review`/`explore` are called Archon workflows and `improve-architecture` is listed.
- **Marked the redesign complete** in `docs/redesign/README.md` (step 13 → done); the directory is kept as the historical record.

## [0.11.0] — 2026-07-03

### Breaking
Expand Down
24 changes: 18 additions & 6 deletions apps/claude-code/unic-archon-dlc/CONTEXT.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,11 +37,23 @@ holding all tracker/tenant/OS/template specifics; boxes read it and compose acco
CLI-fallback). See `docs/adr/0018-generic-core-config-compose.md`.
_Avoid_: config.json (the retired thin form)

**Deterministic output** (emergent — not a workflow):
The stakeholder-facing property that "the same component, fed the same inputs, produces the same
output." The DLC needs **no workflow** for it — it is **emergent** from the
_fresh-slice-reads-committed-repo_ discipline. Each `/build` slice runs in fresh context against the
**committed** repo (`docs/adr/0012-fresh-context-red-green-separation.md`), and every artefact (PRD,
Issues JSON, Findings, code) is durable on disk or in the tracker rather than in conversation memory
(`docs/adr/0013-tracker-single-source-of-truth.md`, `docs/adr/0015-workflows-slug-artifact-home.md`).
So a re-run over the same committed inputs converges on the same result, and feedback from shipped
**Component Assets** flows back into the specs the same way each iteration (the diagram's "deterministic
output" edge). It is a consequence of the architecture, not a feature to build.
_Avoid_: reproducibility workflow, determinism gate, output-caching

### Session lifecycle

**Slug**:
A short identifier chosen at the start of a Session that scopes all session artefacts
(e.g. `workflows/<slug>/`, `.archon/workflows/build-<slug>.yaml`).
(e.g. `workflows/<slug>/findings.md`, `PRD.md`, `issues.json`, `build-state.json`).
_Avoid_: session name, run id, job id

**Session**:
Expand Down Expand Up @@ -139,7 +151,7 @@ Rendered by Claude at user-invocation time. `commands/setup.md` becomes `/unic-a
_Avoid_: command, command template (which means something else here)

**Archon workflow command template**:
A markdown file under `.archon/commands/` (e.g. `unic-dlc-plan.md`). Rendered by the Archon
A markdown file under `.archon/commands/` (e.g. `unic-dlc-build.md`). Rendered by the Archon
workflow engine inside a workflow node, not by Claude directly. Same file extension as a slash
command, completely different runtime.
_Avoid_: slash command, workflow command (ambiguous)
Expand Down Expand Up @@ -199,10 +211,10 @@ _Avoid_: reviewer, agent, check

## Relationships

- A **Session** is scoped by a **Slug** and produces **Findings**, a **PRD**, **Issues JSON**, and a `build-<slug>.yaml`, all under `workflows/<slug>/`
- **yaml-gen** depends on **Nyquist map** completing without errors
- Every issue in **yaml-gen** output gets exactly one **code-red** node and one **code-green** node, run in **red/green fresh-context** isolation
- **code-green** depends on **code-red** within the same issue; independent issues run in parallel
- A **Session** is scoped by a **Slug** and produces **Findings**, a **PRD**, **Issues JSON**, `build-state.json`, and a build **report**, all under `<artifacts_dir>/<slug>/` (default `workflows/<slug>/`)
- The **Nyquist map** gate — every issue carrying a `test_command` — runs in `/tickets` before `/build` consumes the build-ready `issues.json` (ADR-0022)
- `/build` runs a generic **red → green → refactor** loop over each issue in `issues.json`; RED and GREEN run in **fresh-context** isolation so GREEN never sees RED's reasoning (ADR-0012 / ADR-0023 — no per-slice DAG codegen; `dag-builder` / `yaml-gen` are dissolved)
- Within an issue, **green** depends on **red**; the loop processes issues in order on the current linear path
- **adr-consolidation** (in `/improve-architecture`) sources candidates from the "Decisions Made" section of `report.md` and "Accept as ADR" items from **arch-review**
- The **issue tracker** is the single source of truth for project state; there is no `HANDOFF.md`/`ROADMAP.md`
- The **Setup** slash command writes `.archon/unic-dlc.config.yaml`, registers the team's system-skills, and refreshes the `## Agent skills` block in `CLAUDE.md` in the target project
Loading
Loading