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:
parent
23aaaa6e6c
commit
2da95b3cd3
24 changed files with 2325 additions and 28 deletions
|
|
@ -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`
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue