cc-os/plugins/cc-architect/workflows/audit-workflow.md

# Workflow: Audit Workflow

Evaluate workflow documents for quality, compliance, and completeness against workflow-architect standards.

## Who should do this work

- **Haiku subagent**: Research phase (setup, context loading, structure audit)
- **Sonnet subagent**: Analysis phase (evaluation, quality assessment)
- **Opus subagent**: Synthesis phase (classification, verdict, report)
- **Haiku subagent**: Cleanup phase

## When to use

- Evaluating workflow for quality and compliance
- Checking workflow-architect standards
- Reviewing structure, clarity, completeness

## Inputs required

- **workflow_path** - Path to workflow file (e.g., `plugin/skills/my-skill/workflows/my-workflow.md`)

## Output

- `.claude/plugin-data/workflow-architect/audits/<workflow-name>-audit.md` (gitignored)
- Summary with verdict (Ready / Not Ready)
- Delete report after user acts on findings

---

## Phase 1: Research

Subagent: haiku.
Read: `${CLAUDE_PLUGIN_ROOT}/references/layout/workflow-structure.md`

**Setup:**
- Verify `workflow_path` exists, is `.md` file
- Verify in `workflows/` directory
- Create scratch workspace
- Extract workflow name

**Context loading:**
- Check for `invariants.md` in workflow's plugin root
- Check for `.decisions/` directory
- Check for `examples/golden/`
- Record: invariants list, prior decisions count/topics, golden examples list (or "none" for each)

**Structure audit:**
- Has "When to use"
- Has "Inputs required"
- Has "Output"
- Has "Subtasks" or "Phase" sections with clear steps
- Each subtask/phase: "Who" (main/subagent)
- Each subtask/phase: "Must read" if applicable
- Each subtask/phase: clear "Do" instructions

**Read workflow file:**
- Full workflow content
- Note all referenced files

Write: `scratch/research-findings.md`

---

## Phase 2: Analysis

Subagent: sonnet.
Read: `scratch/research-findings.md`, `${CLAUDE_PLUGIN_ROOT}/references/layout/workflow-structure.md`

**Ownership clarity evaluation:**
- Each subtask/phase clearly assigns ownership (main vs subagent)
- Subagent tasks reference model if specified
- Main tasks don't delegate subagent work
- No ambiguous ownership

**Completeness evaluation:**
- Clear purpose and trigger conditions
- Inputs well-defined
- Output format specified
- All subtasks/phases have necessary context
- Verification steps if modifies files
- No missing steps in workflow flow

**Quality assessment:**
- Logical step ordering
- Appropriate subagent model assignments
- File artifacts properly passed between phases
- No redundant steps

Write: `scratch/analysis-findings.md`

---

## Phase 3: Synthesis

Subagent: opus.
Read: `scratch/analysis-findings.md`, `${CLAUDE_PLUGIN_ROOT}/references/tool-patterns/severity-guide.md`, `references/tool-patterns/catalog.md`

**Classify findings:**
- Classify by severity (significant/minor/polish)
- Verdict: Ready (0 significant) or Not Ready (1+ significant)

**Severity for workflows:**
- **Significant:** Missing sections, ambiguous ownership, incomplete flow, missing verification
- **Minor:** Unclear wording, missing optional context, suboptimal structure
- **Polish:** Style, formatting

**Impact analysis per recommendation:**
- What could degrade?
- Invariant conflict?
- Golden example impact?

If contradicts invariant or affects golden example: note and require user approval.

Write: `.claude/plugin-data/workflow-architect/audits/<workflow-name>-audit.md`

**Present report to user:**
- Walk through significant findings first
- Offer to fix or let user handle
- After user confirms: invoke cleanup

**Cleanup (haiku):**
- Delete scratch workspace
- Delete audit report
- Record decisions if needed:
  - Template: `references/tool-patterns/templates/decision-record-template.md`
  - Write: `<plugin_path>/.decisions/YYYY-MM-DD-<topic>.md`
  - When: non-standard structures, exceptions to best practices, complex delegation patterns
  - Prompt: "Were any significant decisions made? (structure exceptions, pattern decisions, best practice deviations)"