Skip to content

v0.6.0 — Community Release

Choose a tag to compare

View all tags
@MountainUnicorn MountainUnicorn released this 12 Apr 21:09
· 140 commits to main since this release
v0.6.0
7fb6371

This release is shaped significantly by community contributions. Thank you.

Added

  • /add:docs — Project-type-agnostic documentation skill. Generates architecture diagrams, API/interface docs, and README/CLAUDE.md drift detection for any project archetype (web APIs, libraries, CLIs, data pipelines, monorepos). Archetype detection from config or codebase inference. Validated against Home Assistant core. Thanks to Caleb Dunn (#2).
  • /add:roadmap, /add:milestone, /add:promote — Milestone and maturity management surface. Interactive horizon management (Now/Next/Later), tactical milestone operations (list/switch/split/rescope), and evidence-based maturity promotion with 14-category gap analysis and 50% readiness floor. Thanks to Piotr Pawluk (#3).
  • /add:ux — Design sign-off gate before implementation. Iterates on wireframes with the human and blocks UI feature implementation at Alpha+ without an approved UX artifact. Prevents the most expensive class of rework: building the right thing wrong. Thanks to David Giambarresi (#4).

Added (Compliance Machinery)

Driven by the agentVoice dog-food retrospective (40 days, 412 commits, 30 specs, ~0 retros pre-bug): ADD's checkpoint machinery was opt-in and got silently skipped at sprint pace. v0.6.0 adds the enforcement layer.

  • rules/add-compliance.md — Retro cadence enforcement (BLOCKs /add:away, /add:cycle --plan, /add:back when >7 days, >3 away sessions, or >15 new learnings since last retro). SDLC watchdog checks (spec/plan/UX artifact presence). Handoff freshness flag. Micro-retro enforcement after parallel dispatch.
  • rules/registry-sync.md — Detects drift between project ground truth and ~/.claude/add/projects/{name}.json. Auto-bumps on checkpoints.
  • /add:retro Phase 7 — Auto-proposes workstation promotion candidates in a single batch, closing the gap where universal lessons sat in project markdown for weeks without promotion.
  • Spec template Section 9 — Infrastructure Prerequisites (env vars, registry images, cloud quotas, network reachability, CI status, secrets, migrations). Prevents "code right, environment wrong" failure class.
  • knowledge/global.md — New entries: Competing Swarm Pattern (when/how/anti-patterns), Infrastructure Prerequisites checklist, E2E quality protocol (browser-only, never skip on error).

Changed

  • /add:cycle pre-flight now includes a milestone health check and supports --milestone for inline selection (from #3).
  • /add:spec now nudges toward /add:ux for UI features (from #4).
  • rules/maturity-loader.md matrix updated: registry-sync active at all maturities; add-compliance active at Alpha+.

Field Evidence

The agentVoice dog-food project (voice platform, 40 days of active development, 9 away sessions, 30 specs across 4 informal phases) was the validation case for most of this release — particularly the UX gate (3 competing UX swarms for a training progress UI), the milestone commands (milestones tracked informally in away logs rather than via /add:cycle), and the compliance rule (zero retros for 40 days of heavy work).

Plugin Size

  • Commands/skills: 21 (was 18)
  • Rules: 15 (was 13)
  • Total plugin size: ~600KB

Plugin loading remains ~14K tokens at alpha maturity. Individual skill files targeted at <15KB (the /add:docs skill will be split in v0.7.0 to hit this target).

Assets 2
Loading