Voice Reviewer

How It Works

1. Find the voice guide: Look for

   docs/brand-voice-guidelines.md

   ,

   .voice-lint.json

   , or similar files in the project root.
2. Read the rules: Extract sentence limits, forbidden words, tone requirements, bilingual policies, and structural patterns.
3. Audit the content: Check each file against every rule.
4. Report: List violations with line numbers, the rule violated, and a suggested fix.

What to Check

Sentence Structure

• Maximum sentence length (word count per the guide, typically 20-30 words)
• One observation per sentence
• Prefer contractions
• Short to medium sentences

Forbidden Patterns

• Superlatives (best, top, must-visit, amazing, incredible)
• Exclamation points
• Emojis
• Trend slang (hits different, no cap, lowkey, vibe check as a verb)
• Hashtag energy
• Adjective stacking (cozy, intimate, must-visit spot)
• Expert/authority claims (everyone knows, locals say, the best)

Tone

• Observational over promotional
• Specific over vague
• Curious before confident
• Human, not performative
• "It felt like..." not "The best..."

Bilingual Policy (if applicable)

• Check the EN:ES ratio target (e.g., 85:15 for loops, 95:5 for rituals)
• Spanish asides stay under the word limit (typically 6 words max)
• No full content repetition in Spanish
• No Spanish in H1/H2 headings

Structural Patterns

• Arrival -> Detail -> Shift -> Release arc
• Show instead of tell
• At least one concrete sensory detail per section
• Could this paragraph exist in another city unchanged? (if yes, it needs rewriting)

Output Format

## Voice Review: [filename]

### Violations

1. **Line 23**: "This amazing, must-visit hidden gem is perfect for date night!"
   - **Rule**: No superlatives, no adjective stacking
   - **Fix**: "The place looks quiet until you sit down."

2. **Line 45**: Sentence is 31 words (max: 24)
   - **Rule**: Max sentence length
   - **Fix**: Split into two sentences.

3. **Line 67**: Spanish aside "entonces vamos a intentar algo nuevo juntos" (7 words)
   - **Rule**: Spanish asides max 6 words
   - **Fix**: Trim to "vamos a intentar algo nuevo" (5 words)

### Summary
- 3 violations found
- 0 critical (forbidden terms)
- 2 structural (sentence length, adjective stacking)
- 1 bilingual (Spanish aside too long)

Agentic Workflow & Vibe Coding

• Iterative Refinement: Do not expect a perfect voice review on the first pass. Draft the initial review, check if it correctly applies the guidelines without being overly pedantic, isolate any specific misapplication of a rule, and refine the critique. Adjust one rule interpretation at a time.
• Vibe Coding: Commit your working review notes or proposed content changes locally before sending final feedback or attempting to rewrite large sections of the document.

Usage as a Subagent

1. The file(s) to review
2. The path to the voice guide
3. The path to

   .voice-lint.json

   (if it exists)