docs(unic-archon-dlc): PRD, research, and 14-issue decomposition for Archon-powered DLC plugin#33
Merged
Merged
Conversation
…cycle plugin Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…e to-issues mapping Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…he gap Archon distributes workflows filesystem-only — no registry or community hub. Document that the Claude Code plugin marketplace is the delivery channel for unic-archon-dlc and that schema version drift is the plugin's responsibility. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Why: turn the unic-archon-dlc PRD into independently-grabbable tracer-bullet slices so AFK agents can execute the lifecycle plugin one vertical slice at a time. Slices cover scaffold/install (01–02), triage + tracker adapter (03), explore (04–05), plan (06–08), build (09–11), qa (12), cleanup (13), and README (14), each with explicit blocked_by edges and the unic-dlc- command prefix locked in. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Bridges our markdown issue format to Archon's prd.json so the existing archon-ralph-dag workflow can implement the 14 unic-archon-dlc slices without first having to build the plugin that would otherwise do this. Zero-dependency Node ESM with @ts-check + JSDoc, tested with node:test. Generated prd.json committed for traceability per the plan. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This reverts commit 275a014.
Contributor
There was a problem hiding this comment.
Pull request overview
This PR lands planning artifacts (no plugin code yet) for a new unic-archon-dlc Claude Code plugin that will ship six Archon-powered workflows (explore / plan / build / qa / cleanup / triage). It adds a PRD, two research notes documenting the Archon-vs-native-skills decision and the mapping between local markdown issues and Archon's native archon-ralph-dag story format, and 14 decomposed vertical-slice issues with explicit Blocked by edges. The intent is to feed these inputs to Archon's existing archon-ralph-dag workflow to bootstrap the plugin from develop.
Changes:
- New PRD describing the six workflows, install hook, state separation, label tiers, and other implementation decisions.
- Two research docs justifying keeping Archon as runtime vs going native, and mapping to Archon's native decomposition workflow.
- 14 issue markdowns (
01-…through14-…) forming a DAG from plugin scaffold through QA, cleanup, and README.
Reviewed changes
Copilot reviewed 17 out of 17 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| docs/issues/unic-archon-dlc/PRD.md | Plugin PRD covering problem, six workflows, install hook, label tiers, state separation. |
| docs/issues/unic-archon-dlc/01-plugin-scaffold-and-tracer-install.md | Tracer slice: plugin manifest, install hook, setup explorer, config loader. |
| docs/issues/unic-archon-dlc/02-full-install-hook-and-agent-docs.md | Expanded install hook tiers and docs/agents/ outputs. |
| docs/issues/unic-archon-dlc/03-triage-workflow-and-tracker-adapter.md | Triage workflow + tracker adapter for 4 backends. |
| docs/issues/unic-archon-dlc/04-explore-parallel-research-and-synthesize.md | Explore: 4 parallel research nodes + synthesize to findings.md. |
| docs/issues/unic-archon-dlc/05-explore-prototype-and-spike-gate.md | Explore: prototype node, VALIDATED/INVALIDATED/PARTIAL verdicts, spike branch gate. |
| docs/issues/unic-archon-dlc/06-plan-specs-and-to-prd.md | Plan: grill-with-docs specs, live ADR writes, to-prd, first PR gate. |
| docs/issues/unic-archon-dlc/07-plan-to-issues-and-nyquist.md | Plan: to-issues vertical slicing, nyquist test-command mapping. |
| docs/issues/unic-archon-dlc/08-plan-checker-and-yaml-gen.md | Plan: plan-checker loop, runtime build YAML generation, second PR gate. |
| docs/issues/unic-archon-dlc/09-build-tdd-core-and-slopcheck.md | Build: red→green DAG enforcement, slopcheck gate. |
| docs/issues/unic-archon-dlc/10-build-verification-goals-check-and-report.md | Build: verification, goals-check matrix, consolidated report, PR gate. |
| docs/issues/unic-archon-dlc/11-build-self-contained-review-command.md | Self-contained /unic-dlc-review covering 4 review aspects. |
| docs/issues/unic-archon-dlc/12-qa-workflow.md | QA: e2e, coverage gate, UAT, tracker-driven merge. |
| docs/issues/unic-archon-dlc/13-cleanup-workflow.md | Cleanup: arch-review, ADR consolidation, triage reuse. |
| docs/issues/unic-archon-dlc/14-readme-and-documentation.md | Plugin README with Mermaid flowchart, node reference, config reference. |
| docs/research/archon-vs-native-skills.md | Native primitives inventory and gap analysis vs Archon. |
| docs/research/archon-native-to-issues.md | Mapping of to-issues behaviour onto native Archon workflows. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Move Status/Plugin/Category metadata to bolded lines after the H1, matching the Pattern A convention used by 9 of 15 PRDs in docs/issues/. Replaces the bare `Plugin: unic-archon-dlc` shorthand with the full `apps/claude-code/unic-archon-dlc` path and drops the placeholder `Specs: N/A` in favour of a `Category: plugin` line. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…er and README deps Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…decision note in research Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…, clarify gate rejection Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…ify cleanup ROADMAP criterion Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
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.
Summary
Lands the planning artifacts for
unic-archon-dlc, a Claude Code plugin that ships an Archon-powered AI development lifecycle (six workflows: explore / plan / build / qa / cleanup / triage). No plugin code yet — this PR is the inputs Ralph needs to start implementing.docs/issues/unic-archon-dlc/PRD.md) describing the six workflows and their integration points.docs/research/archon-vs-native-skills.md,docs/research/archon-native-to-issues.md) documenting the decision to keep Archon as the runtime rather than replatform onto native Claude Code skills, and the field-level mapping between our markdown issues and Archon's nativearchon-ralph-daginput format.docs/issues/unic-archon-dlc/01-*.mdthrough14-*.md), each a vertical tracer-bullet slice with explicitBlocked bydependencies and acceptance criteria.Why
unic-archon-dlccan't bootstrap itself (the plugin doesn't exist yet, so we can't use it to build itself). Instead we plan to feed this PRD to Archon's existingarchon-ralph-dagworkflow, which already knows how to implement vertical-slice stories in dependency order. Landing the PRD ondevelopis the prerequisite — Ralph will branch fromdevelopintoralph/unic-archon-dlcand consume the PRD from there.Note on the revert commit
275a014(the converter) and its revert61c1b99are kept in history as an honest record. We initially planned a markdown-to-prd.json converter (plan 18) on the assumption that Archon would accept our markdown directly; once we inspected the actualarchon-ralph-dagschema we found it wants its own shape (userStories,passes/notes,technicalNotesgrounded in codebase exploration). Rather than retrofitting our converter to match, we'll letarchon-ralph-generateproduce theprd.jsonnatively from this PRD — preserving Archon's codebase-exploration phase. The reverted commit pair documents that decision.What's NOT in this PR
unic-archon-dlcplugin code (that's Ralph's job, post-merge)pr-review/and unrelated dirs in my local checkout (they belong to other branches)Test plan
pnpm check,pnpm typecheck, per-package tests)Blocked byreferences resolving to real files)Blocked byreferences form a DAG (no cycles)After merge
Branch from updated
develop, runarchon workflow run archon-ralph-dag docs/issues/unic-archon-dlc/PRD.md, let Ralph implement the 14 (or however-many-Archon-re-slices-into) stories.🤖 Generated with Claude Code