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>
5.6 KiB
| name | description | layer | cc_feature | source | concept | last_verified | ngram_overlap_score | review_status |
|---|---|---|---|---|---|---|---|---|
| cc-architect-catalog | Internal catalog for ultra-cc-architect-local — not invoked directly. Indexes CC-feature reference and pattern skills. | manifest | meta | https://docs.claude.com/en/docs/claude-code | catalog-index | 2026-04-18 | null | approved |
CC Architect Catalog — Manifest
This file is the catalog index consumed by the feature-matcher and
gap-identifier agents inside /ultra-cc-architect-local. It is NOT
intended to be auto-invoked by Claude Code's skill system — the
description above exists only so the skill loader has something to
display if it indexes this directory.
Purpose
The catalog enumerates which Claude Code features the architect command can reason about, and at which layer of abstraction. Each feature gets one or more skill files in this directory. A skill is a self-contained note about one feature at one layer.
Layers (frontmatter layer field)
| Layer | Purpose | Kilde |
|---|---|---|
reference |
Facts, API, syntax. What the feature is. | CC changelog, official docs |
pattern |
When and how to use it. Typical shapes, pitfalls. | Synthesized from practice |
decision |
Operational decision tree across features. | Synthesized. (No seeds yet.) |
Lag representeres som frontmatter-felt, ikke mappestruktur. Rationale: one feature can have skills at multiple layers without relocation, and future skill-factory output can target a specific layer without moving files.
Frontmatter contract (per skill file)
Every skill file in this directory MUST have this frontmatter. The fields are load-bearing for the architect command.
---
name: <skill-id> # unique, kebab-case
description: <one-line matcher hint> # used by feature-matcher
layer: reference | pattern | decision
cc_feature: <feature-id> # see table below
source: <URL> # canonical upstream source
concept: <short phrase> # 3–6 word concept handle
last_verified: <YYYY-MM-DD> # when a human last checked against upstream
ngram_overlap_score: null # reserved for skill-factory IP-hygiene
review_status: approved | pending | auto-merged
---
ngram_overlap_score is reserved. This command respects it (will flag
non-null values > threshold) but does not compute it. Skill-factory (a
separate later process) populates that field.
review_status: approved is the default for seeds (approved by
construction — handwritten, no third-party text copied). Future
skill-factory output will start as pending (channel 2) or
auto-merged (channel 1).
Canonical cc_feature values
| Value | Coverage |
|---|---|
hooks |
Event hooks (UserPromptSubmit, PreToolUse, PostToolUse, Stop, Notification, SessionStart, etc.) |
subagents |
Task-tool sub-agents, delegation patterns |
skills |
Claude Code skill system (not Agent SDK skills) |
output-styles |
Output style configuration |
mcp |
Model Context Protocol servers and tools |
plan-mode |
Built-in plan mode |
worktrees |
Git worktree integration |
background-agents |
run_in_background, Monitor, long-running agents |
meta |
This manifest only — not a real feature |
If a future skill covers a feature not in this list, add the row above and surface the extension in the relevant CHANGELOG entry.
Current seed coverage (v2.2.0)
| Feature | reference | pattern | decision |
|---|---|---|---|
| hooks | hooks-reference | hooks-pattern | — |
| subagents | subagents-reference | subagents-pattern | — |
| skills | skills-reference | — | — |
| output-styles | output-styles-reference | — | — |
| mcp | mcp-reference | — | — |
| plan-mode | plan-mode-reference | — | — |
| worktrees | worktrees-reference | — | — |
| background-agents | background-agents-reference | — | — |
Total: 10 seed skills, 8 features, 2 layers. Decision-layer is intentionally empty — decisions cross features and require broader synthesis than a single seed pass can provide. Skill-factory populates decision-layer later.
How feature-matcher uses this file
- Read this file to learn the
cc_featuretaxonomy. - Glob the directory for
*.mdfiles (excluding SKILL.md). - Parse each skill's frontmatter.
- For each feature mentioned in the brief or research, match against
cc_featurefield. Preferpatternoverreferencewhen both exist (pattern is richer). - When no skill exists for a mentioned feature, fall back to the
hardcoded minimum-list inside the
feature-matcherprompt and mark the gap in stats (fallback_used: true).
How gap-identifier uses this file
- Collect every feature referenced in
feature-matcher's output. - For each feature, check whether the catalog has at least one skill at each expected layer (reference always; pattern when complexity warrants; decision for cross-feature choices).
- Emit a gap entry for every missing (feature × layer) pair.
- Label with
skill-layer:<layer>andcc-feature:<feature>.
Non-goals for this file
- No skill-factory logic. That is a separate later process.
- No auto-discovery of new CC features.
- No n-gram computation.
- No triggering Claude Code auto-invocation (description deliberately says "not invoked directly").
Modification rules
- Adding a new skill: create
<feature>-<layer>.mdwith the frontmatter above and bump the coverage table in this file. - Renaming
cc_featurevalues: update both this file AND every skill using the old value in the same commit. - Removing a skill: document in CHANGELOG under the version that drops it.