Skip to content

feat(unic-archon-dlc): initial plugin — 6 workflows, 4 tested modules, install hook#35

Draft
orioltf wants to merge 14 commits into
mainfrom
archon/task-archon-ralph-dag-1778803509692
Draft

feat(unic-archon-dlc): initial plugin — 6 workflows, 4 tested modules, install hook#35
orioltf wants to merge 14 commits into
mainfrom
archon/task-archon-ralph-dag-1778803509692

Conversation

@orioltf
Copy link
Copy Markdown
Member

@orioltf orioltf commented May 15, 2026

Summary

  • New Claude Code plugin unic-archon-dlc shipping six Archon YAML workflows covering the full AI development lifecycle (explore → plan → build → qa → cleanup → triage) with human approval gates at every phase boundary
  • Idempotent install hook (scripts/install.mjs) that auto-detects issue tracker, prompts for minimal config, and writes CLAUDE.md integration
  • Four fully tested core modules (53 tests, 0 failures): config loader, project state explorer, dependency tree builder, issue tracker adapter
  • Archon workflow YAML generator with CLI wrapper

Test plan

  • pnpm install succeeds from workspace root
  • pnpm test passes (53 tests across 5 modules)
  • pnpm typecheck clean
  • Install hook runs idempotently: node scripts/install.mjs
  • Six workflow YAMLs are valid Archon DAG definitions

🤖 Generated with Claude Code via archon-ralph-dag (run 875716fa)

orioltf and others added 14 commits May 15, 2026 02:16
…hon-dlc plugin

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Implements US-001 from PRD.

Changes:
- .claude-plugin/plugin.json with name, version 0.1.0, author Unic AG, license LGPL-3.0-or-later
- .claude-plugin/marketplace.json with displayName, category, tags, source fields
- package.json with type module, private true, all required scripts, catalog: and workspace:* devDeps
- CHANGELOG.md with [Unreleased] and initial [0.1.0] sections
- CLAUDE.md with project overview, commands, tech stack, code conventions, scope guard
- CONTEXT.md with DlcConfig, IssueTracker, BranchingStrategy, Workflow, WorkflowNode, Gate, Artifact, Slug vocabulary
- PROMPT.md with Ralph orchestrator loop prompt referencing docs/plans/
- ralph.yml with backend claude, LOOP_COMPLETE promise, max_iterations 100
- tsconfig.json extending @unic/tsconfig base with scripts/**/*.mjs and tests/**/*.mjs
- README.md skeleton with title
Implements US-002 from PRD.

Changes:
- scripts/lib/config.mjs: exports loadConfig(path) returning ConfigResult discriminated union
- tests/config.test.mjs: 8 tests covering valid config, missing fields, unknown keys, missing file, e2eCommand, modelProfile fallback
Implements US-003 from PRD.

Changes:
- scripts/lib/explorer.mjs: exports exploreProject(projectRoot) returning ProjectSnapshot
- tests/explorer.test.mjs: 7 tests covering empty dir, file detection, valid/invalid/missing config, archon detection, git remote
Implements US-004 from PRD.

Changes:
- scripts/lib/dep-tree.mjs: exports buildDepTree(issues) using Kahn's algorithm for topological sort
- tests/dep-tree.test.mjs: 8 tests covering linear chains, parallel groups, mixed, cycles, unknown IDs, empty, diamond
Implements US-005 from PRD.

Changes:
- scripts/lib/tracker.mjs: exports createTrackerAdapter(config) returning TrackerAdapter for github/ado/jira/local backends
- tests/tracker.test.mjs: 19 tests covering all 4 backends, createIssue/updateLabels/closeIssue/mergePr, label resolution
Implements US-006 from PRD.

Changes:
- scripts/lib/yaml-gen.mjs: exports generateBuildYaml(slug, groups) producing Archon-compatible YAML with code-red/slopcheck/code-green per issue, plus global verification/goals-check/report/human-review-gate nodes
- scripts/yaml-gen-cli.mjs: CLI wrapper that reads issues.json, builds dep-tree, writes .archon/workflows/build-<slug>.yaml
- tests/yaml-gen.test.mjs: 11 tests covering single-group, multi-group, sequential deps, global nodes, valid YAML
Implements US-007 from PRD.

Changes:
- scripts/install.mjs: ESM install hook with archon PATH check, project exploration, interactive prompts for issueTracker/branchingStrategy/e2eCommand, writes .archon/unic-dlc.config.json and docs/agents/ 5-file set, appends Agent skills block to CLAUDE.md; all writes idempotent
Implements US-008, US-009, US-010, US-011, US-012, US-013, US-014 from PRD.

Changes:
- .archon/workflows/explore.yaml: 4 parallel research nodes, synthesize, prototype, code-preserve-gate, save-findings, create-ticket
- .archon/workflows/plan.yaml: load-context, specs (interactive), write-adrs, to-prd, prd-gate, to-issues, nyquist-map, plan-checker loop, stall-gate, yaml-gen, plan-gate
- .archon/workflows/build-template.yaml: annotated reference template with per-issue code-red/slopcheck/code-green + global verification/goals-check/report/review/human-review-gate
- .archon/workflows/qa.yaml: run-e2e (skips if unconfigured), coverage-gate (80% threshold), uat-gate, merge-pr
- .archon/workflows/cleanup.yaml: arch-review, adr-consolidation (interactive), write-adrs, triage, write-handoff, update-roadmap
- .archon/workflows/triage.yaml: collect-state, generate-handoff, write-handoff, update-roadmap
- .archon/commands/review.md: self-contained 4-aspect review (code quality, test coverage, silent failures, type design) with Pass/Needs Work/Fail verdicts
Implements US-015 from PRD.

Changes:
- README.md: Mermaid flowchart of all 6 workflows with human gate markers, full node reference table, 3-step quick start, complete configuration reference for all DlcConfig keys, docs/workflow/ layout tree, dependencies section
Implements US-016 from PRD.

Changes:
- CHANGELOG.md [0.1.0]: full Added section listing 8 delivered features (6 workflows, install hook, review command, 4 tested modules)
- verify:changelog passes, typecheck passes, 53 tests pass
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.

1 participant