# Workflow Catalog

This catalog lists all workflows available in cc-architect. Use it to select the right workflow for your task.

---

## Plugin Architect Workflows

### create-plugin
**Path**: `workflows/create-plugin.md`
**Triggers**: create plugin, new plugin, scaffold plugin, plugin from scratch
**Complexity**: Medium
**Model tier**: Main (scope), Haiku (scaffolding), Sonnet (skill creation if included), Opus (validation)
**Description**: Creates a complete Claude Code plugin with manifest, directory structure, CLAUDE.md, and optionally an initial skill (via the plugin-add-skill workflow). Detects git author for plugin.json.

### plugin-add-skill
**Path**: `workflows/plugin-add-skill.md`
**Triggers**: add skill to plugin, create skill in plugin, plugin skill
**Complexity**: High
**Model tier**: Haiku (research/scaffold), Sonnet (processing/content), Opus (synthesis/review), Haiku (cleanup)
**Description**: Creates a skill within an existing plugin. Three-phase workflow: Research (domain understanding, structure design), Processing (write workflows, references, knowledge docs), Synthesis (quality review, friction reflection). Follows progressive disclosure patterns.

### audit-plugin
**Path**: `workflows/audit-plugin.md`
**Triggers**: audit plugin, review plugin, check plugin compliance, plugin quality
**Complexity**: High
**Model tier**: Haiku (research), Sonnet (deep analysis), Opus (synthesis/report), Haiku (cleanup)
**Description**: Comprehensive plugin evaluation against standards. Checks manifest, documentation, component structure, config infrastructure, and reversion protection artifacts. Can delegate to component-specific audits. Produces verdict (Ready/Not Ready) with severity-classified findings.

### improve-plugin-docs
**Path**: `workflows/improve-plugin-docs.md`
**Triggers**: improve docs, update documentation, doc friction, harvest learnings, periodic maintenance
**Complexity**: Medium
**Model tier**: Haiku (research), Sonnet (prioritize/patch), Opus (review), Haiku (apply/cleanup)
**Description**: Harvests friction notes from task documents and applies targeted improvements to knowledge docs. Filters noise, ranks by impact, proposes patches, splits docs exceeding 150 lines. Includes checkpoint for user approval before applying changes.

---

## Skill Architect Workflows

### create-skill
**Path**: `workflows/create-skill.md`
**Triggers**: create skill, new skill, build skill, skill from scratch
**Complexity**: High
**Model tier**: Haiku (research/scaffold), Sonnet (processing/content), Opus (synthesis), Haiku (cleanup)
**Description**: Creates a complete skill with SKILL.md, workflows, references, templates, and scripts. Three-phase approach: Research (domain understanding, structure plan, scaffold), Processing (write all content), Synthesis (validate, generate description, cleanup). Includes reversion protection scaffolding.

### audit-skill
**Path**: `workflows/audit-skill.md`
**Triggers**: audit skill, review skill, check skill compliance, skill quality, evaluate skill
**Complexity**: High
**Model tier**: Haiku (research), Sonnet (analysis), Opus (synthesis), Haiku (cleanup)
**Description**: Evaluates skill against standards including structure, progressive disclosure, description compliance, and skippability risk. Checks reversion protection artifacts. Detects novel patterns worth adding to patterns library. Produces verdict with severity-classified findings.

### improve-skill
**Path**: `workflows/improve-skill.md`
**Triggers**: improve skill, fix skill, skill friction, update skill, skill maintenance
**Complexity**: Medium
**Model tier**: Main/Haiku (gather), Opus (prioritize), varies (apply), Main (verify)
**Description**: Addresses friction encountered when using a skill. Collects friction data from task docs and user, prioritizes by frequency/impact, applies targeted edits to knowledge docs and workflows.

---

## Workflow Architect Workflows

### create-workflow
**Path**: `workflows/create-workflow.md`
**Triggers**: create workflow, new workflow, define process, workflow document
**Complexity**: Medium
**Model tier**: Main (requirements/design/verify), Haiku (create file)
**Description**: Creates a workflow document that defines a repeatable process for subagents. Includes "When to use", "Inputs required", "Output", and "Subtasks" sections. Each subtask specifies ownership (main vs subagent) and required reads.

### audit-workflow
**Path**: `workflows/audit-workflow.md`
**Triggers**: audit workflow, review workflow, check workflow, workflow quality
**Complexity**: Medium
**Model tier**: Haiku (research), Sonnet (analysis), Opus (synthesis), Haiku (cleanup)
**Description**: Evaluates workflow for structure, ownership clarity, and completeness. Checks required sections exist, steps have clear ownership, verification included if modifying files. Produces verdict with findings classified by severity (significant/minor/polish).

### improve-workflow
**Path**: `workflows/improve-workflow.md`
**Triggers**: improve workflow, fix workflow, workflow friction, update workflow
**Complexity**: Medium
**Model tier**: Main/Haiku (gather), Opus (prioritize), varies (apply), Main (verify)
**Description**: Refines workflow based on friction encountered during use. Focus areas: step clarity, missing steps, ownership ambiguity, missing required reads, inadequate verification. Offers follow-up audit after improvements.

---

## Slash Command Architect Workflows (LEGACY)

> **Note**: Slash commands are legacy. Prefer skills for new functionality.

### create-command
**Path**: `workflows/create-command.md`
**Triggers**: create command, new command, slash command, command file
**Complexity**: Low
**Model tier**: Main (requirements/design), Haiku (implementation)
**Status**: LEGACY - maintenance only
**Description**: Creates a slash command with frontmatter (name, description, allowed-tools), context section, and instructions. Commands are simpler than skills - single-purpose tools for specific actions.

### audit-command
**Path**: `workflows/audit-command.md`
**Triggers**: audit command, review command, check command, command quality
**Complexity**: Low
**Model tier**: Main (setup/frontmatter/instructions/report), Opus (description), Haiku (cleanup)
**Status**: LEGACY - maintenance only
**Description**: Lightweight audit for slash commands. Checks frontmatter validity, description compliance (no escape hatches), instruction completeness, and tool permissions. Produces verdict with severity-classified findings.

### improve-command
**Path**: `workflows/improve-command.md`
**Triggers**: improve command, fix command, command friction, update command
**Complexity**: Low
**Model tier**: Main (gather/prioritize/apply/verify)
**Status**: LEGACY - maintenance only
**Description**: Refines command based on friction. Focus areas: description triggers, instruction clarity, tool permissions. Lightweight workflow for simpler command artifacts.

---

## Configuration Workflows

### plugin-config
**Path**: `workflows/plugin-config.md`
**Triggers**: enable plugin, disable plugin, register plugin, unregister plugin, audit config, list plugins, debug plugin config
**Complexity**: Low
**Model tier**: Haiku (execute script), Sonnet (self-healing if needed), Main (interpret & report)
**Description**: Single flexible workflow for all plugin configuration operations. Runs a deterministic Ruby script (`scripts/plugin_config/plugin_config.rb`) with operation-parameter routing, handles verification failures with self-healing, and presents results to the user. Supports enable, disable, register, unregister, audit, and list operations.

---

## Orchestration Workflows (Internal)

> **Note**: These workflows are used internally by the cc-architect orchestrator. They are not invoked directly by users.

### build-plan
**Path**: `workflows/build-plan.md`
**Triggers**: (internal) First step when orchestrator receives any request
**Complexity**: Medium
**Model tier**: Sonnet (always executed by Sonnet subagent)
**Description**: Builds a structured execution plan that orchestrates cc-architect workflows. Reads the catalog, analyzes user request, selects workflows, determines step sequence, assigns model tiers, applies batching optimization, and writes the plan to `plugin-data/cc-architect/plans/current-plan.md`.

### synthesize
**Path**: `workflows/synthesize.md`
**Triggers**: (internal) Final step after all execution subagents complete
**Complexity**: Medium
**Model tier**: Opus (requires intelligent synthesis and quality judgment)
**Description**: Reads all previous step outputs, synthesizes into a coherent deliverable, and produces the final user-facing artifact. Handles different artifact types (plugin, skill, workflow, command, description, audit) with appropriate templates. Includes quality checks for completeness, coherence, and actionability.

### cleanup
**Path**: `workflows/cleanup.md`
**Triggers**: (internal) Runs after synthesis, as final orchestration step
**Complexity**: Low
**Model tier**: Haiku (mechanical file operations, no judgment required)
**Description**: Removes temporary task files from `plugin-data/cc-architect/tasks/` while preserving final outputs in `output/`. Optionally archives execution plans. Includes safety rules to never delete files outside `plugin-data/` or touch the output directory.

---

## Description Architect Workflows

### generate-description
**Path**: `workflows/generate-description.md`
**Triggers**: write description, generate description, frontmatter description, description for skill/agent/command/plugin
**Complexity**: Low
**Model tier**: Main (inline, no subagent needed)
**Description**: Creates compliant frontmatter descriptions using the formula: "[Action verb] [what]. [Unambiguous trigger]." Applies escape hatch test to ensure AI cannot rationalize skipping the component while still doing the task. Returns only the description string, no explanation.
