cc-os/plugins/cc-architect/CLAUDE.md

81 lines
2.9 KiB
Markdown
Raw Normal View History

# 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.