# CC Architect

Build Claude Code extensions: plugins, skills, workflows, commands, and descriptions.

## Entry Point

**Use `/cc-architect` for everything.** It analyzes your request and orchestrates the appropriate workflows automatically.

Examples:
- "Create a new plugin for X"
- "Add a skill to the Y plugin"
- "Audit my skill for compliance"
- "Write a description for this component"

The orchestrator reads the workflow catalog, builds an execution plan with optimal model tiers, and coordinates subagents to complete your request.

## Architecture

```
User request
     |
     v
/cc-architect (reads SKILL.md)
     |
     v
Planner subagent (Sonnet)
  - Reads workflows/catalog.md
  - Builds execution plan with model tiers
     |
     v
Execution subagents (per plan)
  - Haiku: scaffolding, validation, cleanup
  - Sonnet: drafting, analysis
  - Opus: synthesis, quality decisions
     |
     v
Final output presented to user
```

## Available Workflows

The orchestrator can invoke any of these (see `workflows/catalog.md` for details):

| Category | Workflows |
|----------|-----------|
| Plugin | create-plugin, plugin-add-skill, audit-plugin, improve-plugin-docs |
| Skill | create-skill, audit-skill, improve-skill |
| Workflow | create-workflow, audit-workflow, improve-workflow |
| Description | generate-description |
| Command (legacy) | create-command, audit-command, improve-command |

## Shared References

**Knowledge philosophy** (`references/knowledge-philosophy.md`)
Document what AI doesn't know from training: rubrics, templates, process steps, custom conventions.

**Progressive disclosure** (`references/progressive-disclosure/`)
Knowledge architecture for non-code files. Creates navigable tree structure for just-in-time discovery.

**Self-improvement** (`references/self-improvement/`)
Reflection step for every workflow. After completing any task, identify friction for future improvements.

**Tool patterns** (`references/tool-patterns/catalog.md`)
Patterns for robust tools: audit, verification, brainstorming, reversion protection.

---

## Legacy Skills (Removed)

The following individual architect skills have been **removed**; their functionality was folded into `/cc-architect`'s workflows. Some workflow docs still reference these by their old names (`skill-architect`, `slash-command-architect`) — treat any such reference as a pointer to the replacement workflow below, not to a live skill directory.

| Legacy Skill | Replacement |
|--------------|-------------|
| `/plugin-architect` | `/cc-architect` + create-plugin workflow |
| `/skill-architect` | `/cc-architect` + create-skill workflow |
| `/workflow-architect` | `/cc-architect` + create-workflow workflow |
| `/slash-command-architect` | `/cc-architect` + create-command workflow |
| `/description-architect` | `/cc-architect` + generate-description workflow |

These no longer exist at `skills/{name}/SKILL.md`; only `skills/cc-architect/SKILL.md` remains.
