document-review

/document-review — Brand Document Audit

You audit the brand/ directory for quality: completeness, consistency, and freshness. You report problems — you never fix them. Fixes belong to domain skills (e.g., /audience-research fixes audience.md).

For brand memory protocol, see /cmo rules/brand-memory.md.

On Activation

1. Verify brand/ directory exists. If it does not exist, report Overall Health as Not Started and recommend mktg init. Skip all phases.
2. Read all 9 brand/ files (or confirm which are missing).
3. Determine audit scope based on user request.
4. Run all four phases sequentially.

Phase 0: Assess Scope

For single-file reviews, still cross-reference against other brand files for consistency.

Phase 1: Completeness Check

For each of the 10 brand files, assess status:

Profile Files (7)

These should contain substantive content beyond the template scaffold.

Scoring:

How to detect template-only content:

• Look for lines like - **Tone:** with no value after the colon
• Look for empty table rows
• Look for <!-- Generated by mktg init. Fill in or let /cmo build this. --> as the only substantive comment
• Profile files with fewer than 5 lines of real content (excluding headers and comments) are likely empty

Append-Only Files (2)

Scoring:

Append-only files are never "partial" — they either have entries or they don't.

Phase 2: Consistency Check

Cross-reference files for contradictions. Only check files that are complete or partial (skip empty and missing).

Cross-References to Check

Contradiction Severity

Phase 3: Freshness Check

Flag files that may be outdated.

Freshness Rules

• Profile files: Check file modification date. Flag as stale if older than 30 days.
• Append-only files: Always considered current if they exist (they accumulate, not expire).
• No modification date available: Flag as "freshness unknown — recommend re-running owner skill."

Staleness Signals (Beyond Date)

• File references a competitor that no longer exists or has rebranded
• Positioning mentions a feature the product no longer has
• Keywords target trends that have passed
• Audience describes a persona the product has pivoted away from

Note these as "content staleness" separately from "date staleness."

Phase 4: Audit Report

Output a structured audit report. This is the primary deliverable.

Report Format

# Brand Audit Report

**Date:** YYYY-MM-DD
**Scope:** [Full audit | Single file | Consistency only | Freshness only]
**Overall Health:** [Healthy | Needs Attention | Incomplete | Not Started]

## Summary

- **Files:** X/9 complete, Y partial, Z empty, W missing
- **Contradictions:** X found (H high, M medium, L low)
- **Stale files:** X flagged

## Completeness

| File | Score | Notes |
|------|-------|-------|
| voice-profile.md | complete | All sections populated |
| positioning.md | partial | Missing "Unlike" differentiator |
| audience.md | missing | — |
| competitors.md | empty | Template only |
| keyword-plan.md | complete | 12 keywords mapped |
| creative-kit.md | partial | Colors defined, typography missing |
| stack.md | complete | 5 tools configured |
| assets.md | complete | 8 entries |
| learnings.md | empty | No entries yet |

## Contradictions

### [Severity]: [Short description]
- **Files:** file-a.md ↔ file-b.md
- **Detail:** [What contradicts what]
- **Recommendation:** [Which file to update and how]

## Freshness

| File | Last Modified | Status | Action |
|------|--------------|--------|--------|
| voice-profile.md | 15 days ago | current | — |
| positioning.md | 45 days ago | stale | Re-run /positioning-angles |

## Recommended Next Steps

Priority-ordered list of skills to run:

1. **Run `/audience-research`** — audience.md is missing. This blocks positioning and copy quality.
2. **Run `/positioning-angles`** — positioning.md is stale (45 days) and missing differentiator.
3. **Run `/competitive-intel`** — competitors.md is still template-only.

Overall Health Scoring

Recommended Next Steps Logic

Priority order for recommendations:

1. Missing foundation files (audience, positioning, voice-profile) — these unlock everything else
2. High-severity contradictions — these corrupt downstream output
3. Stale foundation files — outdated context is worse than no context
4. Missing strategy files (keywords, competitors) — these improve targeting
5. Empty append-only files — nice to have, build over time
6. Missing creative files — needed for visual output skills

Always map recommendations to specific skills:

Anti-Patterns

Related Skills

• /cmo — Orchestrates skills including document-review for health checks
• /brand-voice — Fixes voice-profile.md issues
• /positioning-angles — Fixes positioning.md issues
• /audience-research — Fixes audience.md issues
• /competitive-intel — Fixes competitors.md issues
• /keyword-research — Fixes keyword-plan.md issues
• /creative — Fixes creative-kit.md issues