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

2.9 KiB

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.