cc-os/plugins/cc-architect/templates/audit-checklist-template.md

CC-Architect Audit Checklist

Model: Haiku (mechanical verification, no judgment)

Instructions

Run this checklist against any cc-architect output (plugin, skill, workflow). Check each item and mark pass/fail. If any CRITICAL items fail, escalate to Sonnet for severity analysis.

---

Universal Attributes (All Outputs)

Structure

#	Check	Command/Method	Pass	Fail
1	Directory exists	ls -d {target_path}	☐	☐
2	Required files present	See per-type checklist below	☐	☐
3	No empty files	find {path} -empty -type f returns nothing	☐	☐
4	Naming convention	All files/dirs are kebab-case	☐	☐

Frontmatter

#	Check	Validation	Pass	Fail
5	Description present	description: field in frontmatter	☐	☐
6	Description passes escape hatch	Would user skip reading full file?	☐	☐
7	No placeholder text	No TODO, FIXME, [PLACEHOLDER]	☐	☐

Cross-References

#	Check	Validation	Pass	Fail
8	All paths resolve	Every references/ path exists	☐	☐
9	No broken links	Every [text](path) link resolves	☐	☐

Model Annotations

#	Check	Validation	Pass	Fail
10	Tasks have model tier	Each task annotated with Haiku/Sonnet/Opus	☐	☐
11	Pre-planning present	Orchestrator-invoked skills have pre-planning step	☐	☐

---

Plugin-Specific Attributes

Required Files

• CLAUDE.md exists
• .claude-plugin/plugin.json exists and valid JSON
• At least one skill in skills/ OR workflow in workflows/

Plugin Manifest (plugin.json)

• name field present
• description field present
• skills array lists all skills in skills/ directory

---

Skill-Specific Attributes

Required Files

• SKILL.md exists
• invariants.md exists (may be empty if no invariants yet)
• examples/golden/ directory exists

SKILL.md Content

• Has frontmatter with description
• Has "When to use" section
• Has phase structure (Setup → Process → Synthesize or equivalent)
• References to shared docs use relative paths

Invariants

• At least 1 invariant defined OR explicit "no invariants yet" note
• Invariants are testable (not vague)

---

Workflow-Specific Attributes

Required Frontmatter Fields

---
name: required
description: required
triggers: required (array)
model_tier: required (haiku|sonnet|opus)
complexity: optional (1-5)
requires_user_input: optional (true|false)
depends_on: optional (array of workflow names)
---

Workflow Content

• "When to use" section present
• "Inputs required" section present
• "Phases" or "Steps" section present
• Each phase has model tier annotation

---

Domain Plugin Attributes (Specialized Fields)

Only applies to domain-specialist plugins (e.g. plugins that encode a professional discipline's frameworks and heuristics, not general-purpose tooling).

• Domain expertise documented in references/
• Professional frameworks captured
• Heuristics are specific, not generic
• Workflow categories identified (if applicable)

---

Escalation Criteria

Escalate to Sonnet if:

• More than 2 FAIL items in Universal Attributes
• Any CRITICAL item fails (marked below)
• Subjective judgment needed (e.g., "is description good enough?")

CRITICAL Items (must pass):

• #2 (Required files present)
• #5 (Description present)
• #10 (Tasks have model tier)

---

Output Format

## Audit Report: {target_name}

**Date**: {date}
**Auditor**: Haiku
**Target**: {path}

### Summary
- Universal: {X}/11 passed
- Type-specific: {Y}/{Z} passed
- **Status**: PASS | FAIL | ESCALATE

### Failed Items
1. #{number}: {description}
   - Expected: {what should exist}
   - Actual: {what was found}

### Recommendations
- {If ESCALATE, note what Sonnet should review}