cc-os/plugins/cc-architect/skills/cc-architect/SKILL.md

3.6 KiB

name description
cc-architect Model-tier-optimized execution plans, scaffolding, and configuration operations for building and managing Claude Code extensions (plugins, skills, workflows)

CC Architect

Model-tier-optimized execution plans, scaffolding, and configuration operations for building and managing Claude Code extensions (plugins, skills, workflows).

Trigger

Use this skill when creating, auditing, or improving any Claude Code extension component, or when managing plugin configuration (enable, disable, register, unregister, audit config, list plugins).

Dispatch

Before building an execution plan, check if the request matches a fast-path operation. Fast-path operations bypass ${CLAUDE_PLUGIN_ROOT}/workflows/build-plan.md and route directly to the appropriate workflow.

Pattern match the user's request against these keywords:

Keywords Operation Route
enable plugin, turn on plugin, activate plugin enable workflows/plugin-config.md
disable plugin, turn off plugin, deactivate plugin disable workflows/plugin-config.md
register plugin, add to marketplace, add plugin to marketplace register workflows/plugin-config.md
unregister plugin, remove from marketplace, remove plugin from marketplace unregister workflows/plugin-config.md
audit config, check config, plugin config status, debug plugin, why isn't plugin working audit workflows/plugin-config.md
list plugins, show plugins, installed plugins, what plugins list workflows/plugin-config.md

If a fast-path match is found:

  1. Extract the operation and parameters from the user's request.
  2. Dispatch a Haiku subagent with: "Read workflow at ${CLAUDE_PLUGIN_ROOT}/workflows/plugin-config.md and execute with operation=<op>, plugin_name=<name>, and other relevant parameters."
  3. Skip Step 1 (Build Execution Plan) and proceed directly to Step 2 execution with the single workflow step.

If no fast-path match: Continue to Step 1 (Build Execution Plan) as normal.

Execution

Step 1: Build Execution Plan

Dispatch a Sonnet subagent:

  • Read: workflows/catalog.md
  • Input: User's request
  • Task: Select workflows and build structured execution plan with model tiers
  • Write plan to: .claude/plugin-data/cc-architect/plans/current-plan.md

Step 2: Execute Plan

For each step in the execution plan:

  1. Read the step metadata from plan file (model tier, workflow path, input, output)
  2. Dispatch subagent using Task tool:
    • Use subagent_type="general-purpose"
    • Pass instructions: "Read workflow at {workflow_path} and execute with inputs: {input_context}. Write results to {output_path}"
    • The SUBAGENT reads the workflow document and executes it (NOT you)
  3. Wait for subagent completion
  4. Verify output file exists at specified location (do NOT read contents)
  5. Continue to next step

Example dispatch for a scaffolding step:

Plan metadata: Model=haiku, Workflow=workflows/create-plugin.md, Output=.claude/plugin-data/cc-architect/tasks/step-1-scaffold.md
Dispatch: Task tool with instructions="Read workflow at ${CLAUDE_PLUGIN_ROOT}/workflows/create-plugin.md and execute. Write results to .claude/plugin-data/cc-architect/tasks/step-1-scaffold.md"

ANTI-PATTERNS - DO NOT:

  • Read workflow documents yourself
  • Interpret workflow logic in main thread
  • Assemble context before dispatching
  • Read subagent output files (except final synthesis in Step 3)

ONLY read: plan file, final output. ONLY verify: intermediate files exist. ONLY pass: file paths to subagents.

Step 3: Present Results

Read the final output file specified in the plan. Present to user.