feat(ultraplan-local): v2.2.0 — /ultra-cc-architect-local

New optional command between /ultraresearch-local and /ultraplan-local that
matches brief+research against Claude Code features (hooks, subagents, skills,
output-styles, MCP, plan-mode, worktrees, background-agents) and produces an
architecture note with brief-anchored rationale plus explicit gaps.

Added:
- commands/ultra-cc-architect-local.md (--project, --fg, --quick, --no-gaps)
- agents/architect-orchestrator.md (opus) — 6-phase background orchestrator
- agents/feature-matcher.md (sonnet) — fallback-ranked feature proposals
- agents/gap-identifier.md (sonnet) — 4 gap classes with issue-ready drafts
- agents/architecture-critic.md (sonnet) — hallucination gate as BLOCKER
- skills/cc-architect-catalog/ — SKILL.md + 10 seed entries (reference/pattern)

Changed (non-breaking):
- commands/ultraplan-local.md — auto-discovers architecture/overview.md
- agents/planning-orchestrator.md — cross-references cc_features_proposed
- plugin.json — 2.1.0 → 2.2.0, description, cc-architecture keyword
- CHANGELOG, README, CLAUDE.md (plugin + marketplace root)

Pipeline becomes brief → research → architect → plan → execute. Architect is
optional; existing project dirs keep working unchanged.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-04-18 12:38:06 +02:00
commit 2da95b3cd3
24 changed files with 2325 additions and 28 deletions

View file

@ -4,6 +4,90 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
## [2.2.0] - 2026-04-18
### Added — `/ultra-cc-architect-local` optional pipeline step
New optional command that sits between `/ultraresearch-local` and
`/ultraplan-local`. Reads the task brief plus any research briefs, matches the
task against available Claude Code features (Hooks, Subagents, Skills, Output
Styles, MCP, Plan Mode, Worktrees, Background Agents), and produces an
**architecture note** with brief-anchored rationale and an explicit coverage-
gap section.
Pipeline position (5-steg):
```
/ultrabrief-local → /ultraresearch-local → /ultra-cc-architect-local (optional)
→ /ultraplan-local → /ultraexecute-local
```
The architecture note is designed as *priors* for planning, not mandates —
`/ultraplan-local` still runs its own exploration and may override proposals
with evidence.
**New files:**
- `commands/ultra-cc-architect-local.md` — command entry point (7 faser:
parse → background → read inputs → feature matching → synthesize → review
→ present).
- `agents/architect-orchestrator.md` (opus) — background orchestrator.
- `agents/feature-matcher.md` (sonnet) — matches CC features against brief +
research, with brief-anchored rationale per feature and a documented fallback
minimum list when the catalog is empty.
- `agents/gap-identifier.md` (sonnet) — emits issue-ready gap drafts (no
auto-posting; no auto-generation).
- `agents/architecture-critic.md` (sonnet) — adversarial review with a
hallucination gate (features outside catalog + fallback list → blocker).
- `skills/cc-architect-catalog/SKILL.md` — manifest + frontmatter contract.
- 10 seed skills in `skills/cc-architect-catalog/`:
`hooks-reference`, `hooks-pattern`, `subagents-reference`, `subagents-pattern`,
`skills-reference`, `output-styles-reference`, `mcp-reference`,
`plan-mode-reference`, `worktrees-reference`, `background-agents-reference`.
All handwritten (no third-party content copied, per brief §4.4).
**New flags:**
- `--project <dir>` (required) — reads `{dir}/brief.md` + `{dir}/research/*.md`,
writes to `{dir}/architecture/`.
- `--fg` — foreground execution.
- `--quick` — skip adversarial review.
- `--no-gaps` — do not write `gaps.md` (gap-section remains inside
`overview.md`).
**New stats file:** `${CLAUDE_PLUGIN_DATA}/ultra-cc-architect-local-stats.jsonl`.
### Changed — `/ultraplan-local` auto-discovers architecture notes
Brief §5 of the `ultra-cc-architect` design said "no changes to existing
commands". This release makes one permitted, documented exception:
`/ultraplan-local` now auto-discovers `{project_dir}/architecture/overview.md`
when running in project mode. The file is additive context — missing file
produces no error, and behavior when the file is absent is identical to
v2.1.0. Non-breaking.
**Minimal edits:**
- `commands/ultraplan-local.md` — Phase 1 `--project` branch sets
`has_architecture_note` / `architecture_note_path` when the file exists.
Phase 3 launch prompt passes `Architecture note: {path or "none"}` to the
orchestrator.
- `agents/planning-orchestrator.md` — Input section documents the new
optional field. Phase 4 synthesis cross-references proposed features with
exploration findings and carries the note's Coverage gaps into Risks and
Mitigations when relevant.
### Non-goals (explicit)
- **Skill-factory is not part of this release.** Cataloging, n-gram
computation, auto-generation from CC changelog, concept extraction from
reference repos — all deferred to a separate development process. Together
with v2.2.0's architect command, that process will eventually land as v3.0.
- No `/ultra-auto` chaining.
- No auto-creation of Forgejo/GitHub issues from gap drafts.
- No changes to `/ultrabrief-local`, `/ultraresearch-local`, or
`/ultraexecute-local`.
## [2.1.0] - 2026-04-18
### Changed — Dynamic, quality-gated interview in `/ultrabrief-local`