ktg-plugin-marketplace/plugins/ultra-cc-architect/CHANGELOG.md
Kjell Tore Guttormsen ab504bdf8c refactor(marketplace): split cc-architect from ultraplan-local into its own plugin
Extract `/ultra-cc-architect-local` and `/ultra-skill-author-local` plus all 7
supporting agents, the `cc-architect-catalog` skill (13 files), the
`ngram-overlap.mjs` IP-hygiene script, and the skill-factory test fixtures
from `ultraplan-local` v2.4.0 into a new `ultra-cc-architect` plugin v0.1.0.

Why: ultraplan-local had drifted into containing two distinct domains — a
universal planning pipeline (brief → research → plan → execute) and a
Claude-Code-specific architecture phase. Keeping them together forced users
to inherit an unfinished CC-feature catalog (~11 seeds) when they only
wanted the planning pipeline, and locked the catalog and the pipeline into
the same release cadence. The architect was already optional and decoupled
at the code level — only one filesystem touchpoint remained
(auto-discovery of `architecture/overview.md`), which already handles
absence gracefully.

Plugin manifests:
- ultraplan-local: 2.4.0 → 3.0.0 (description + keywords updated)
- ultra-cc-architect: new at 0.1.0 (pre-release; catalog is thin, Fase 2/3
  of skill-factory unbuilt, decision-layer empty, fallback list still
  needed)

What stays in ultraplan-local: brief/research/plan/execute commands, all
19 planning agents, security hooks, plan auto-discovery of
`architecture/overview.md` (filesystem-level contract, not code-level).

What moved (28 files via git mv, R100 — full history preserved):
- 2 commands, 8 agents, 1 skill catalog (13 files), 2 scripts, 8 fixtures

Documentation updates: plugin CLAUDE.md and README.md for both plugins,
root README.md (added ultra-cc-architect section, updated ultraplan-local
section), root CLAUDE.md (added ultra-cc-architect to repo-struktur),
marketplace.json (registered ultra-cc-architect), ultraplan-local
CHANGELOG.md (v3.0.0 entry with migration guidance).

Test verification: ngram-overlap.test.mjs passes 23/23 from new location.

Memory updated: feedback_no_architect_until_v3.md now points at the new
plugin and reframes the threshold around catalog maturity rather than an
ultraplan-local milestone.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-30 17:18:47 +02:00

3.6 KiB

Changelog

All notable changes to ultra-cc-architect are documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.1.0] — 2026-04-30

Initial release — extracted from ultraplan-local v2.4.0

ultra-cc-architect is the CC-specific architecture phase pulled out of the ultraplan-local plugin. The split decouples the universal planning pipeline (brief → research → plan → execute) from the Claude-Code-specific feature-matching logic, so users can adopt the planning pipeline without inheriting an unfinished CC-feature catalog and skill-factory.

Why pre-release (0.1.0):

  • Catalog is thin: 11 seed skills across 8 features, decision-layer intentionally empty.
  • Skill-factory has only Fase 1 (one source → one draft, manual promotion). Fase 2 (CC-changelog watcher) and Fase 3 (cross-feature decision skills) are unbuilt.
  • feature-matcher falls back to a hardcoded list when the catalog is sparse — this fallback should disappear before v1.0.
  • Slug convention is stable but catalog-growth tooling (batch authoring, automated taxonomy updates) is not.

Inherited from ultraplan-local v2.4.0

Commands (2):

  • /ultra-cc-architect-local — feature matching with brief-anchored rationale and explicit coverage gaps. Modes: --project (required), --quick (skip critic), --no-gaps, --fg (no-op alias).
  • /ultra-skill-author-local — skill-factory Fase 1 manual authoring. Modes: default, --quick (skip IP-hygiene), --fg (no-op alias).

Agents (8):

  • architect-orchestrator (opus) — inline reference for the architect workflow
  • feature-matcher (sonnet) — match brief+research to CC features with brief-anchored rationale
  • gap-identifier (sonnet) — surface catalog/pattern/decision/outside-CC-scope gaps
  • architecture-critic (sonnet) — adversarial review with hallucination gate (BLOCKER)
  • skill-author-orchestrator (opus) — inline reference for the 3-stage authoring pipeline
  • concept-extractor (sonnet) — read source, output concept JSON with cc_feature/layer/slug
  • skill-drafter (sonnet) — write .drafts/<slug>.md with 9-field frontmatter
  • ip-hygiene-checker (sonnet) — run ngram-overlap.mjs, stamp verdict or delete

Skill catalog: skills/cc-architect-catalog/ (13 files: SKILL.md manifest + 11 seeds + .drafts/.gitkeep)

Scripts: scripts/ngram-overlap.mjs + scripts/ngram-overlap.test.mjs (zero-dependency Node)

Test fixtures: tests/fixtures/skill-factory/ (calibration prose for verdict bands) + tests/fixtures/skill-drafter/slug-collision-expected.md

Slug-convention version

Inherits the v2.3.1 slug convention from ultraplan-local: <cc_feature>[-<qualifier>]-<layer>.md. Unqualified slug = canonical baseline per (feature, layer); qualified slugs cover specific sub-patterns. Slug-collision hint in skill-drafter (v2.3.2) preserved.

Breaking changes

None at the command level — /ultra-cc-architect-local and /ultra-skill-author-local keep their names and flag surfaces. Users who installed ultraplan-local v2.4.0 must additionally install ultra-cc-architect v0.1.0+ to keep using these commands. See ultraplan-local v3.0.0 CHANGELOG for migration steps.

Filesystem contract

Both plugins write into .claude/projects/{YYYY-MM-DD}-{slug}/. The directory contract is owned by ultraplan-local; this plugin opt-in writes to the architecture/ subdirectory. No code-level dependency between plugins — the contract is filesystem-level documentation only.