Initial commit

commands/style-check.md

@@ -0,0 +1,185 @@
+---
+description: Review blog article against editorial style guide using 8 specialized agents
+argument-hint: [brand-name] [article-path] [--auto-apply]
+---
+
+# Style Check: Multi-Agent Article Review
+
+Review the article at **$2** against the **$1** brand style guide using 8 specialized agents running in parallel.
+
+## Step 1: Validate Inputs
+
+Before proceeding:
+- Verify style guide exists at `brands/$1/style-guide.md`
+  - If missing: Error and suggest running `/generate-style-guide $1 [source]`
+- Verify article exists at $2
+  - If missing: Error with clear message
+- Check if $3 is `--auto-apply` (determines whether to apply corrections automatically)
+
+## Step 2: Read Required Files
+
+Read the following files:
+- Article to review: $2
+- Brand style guide: `brands/$1/style-guide.md`
+- All 8 agent prompts from `.claude/prompts/`:
+  - voice-tone-agent.md
+  - grammar-usage-agent.md
+  - punctuation-agent.md
+  - formatting-agent.md
+  - technical-standards-agent.md
+  - content-patterns-agent.md
+  - industry-terms-agent.md
+  - quick-reference-agent.md
+
+## Step 3: Launch 8 Specialized Agents in Parallel
+
+**CRITICAL: Use Task tool to launch ALL 8 agents simultaneously in a SINGLE message.**
+
+Each agent should receive:
+- The agent prompt from `.claude/prompts/[agent-name].md`
+- The complete article content from $2
+- The relevant section(s) from `brands/$1/style-guide.md`
+
+**Launch these 8 agents in parallel:**
+
+1. **Agent 1 - Voice & Tone**: Review against Section 1 of style guide
+2. **Agent 2 - Grammar & Usage**: Review against Section 2 of style guide
+3. **Agent 3 - Punctuation**: Review against Section 3 of style guide
+4. **Agent 4 - Formatting**: Review against Section 4 of style guide
+5. **Agent 5 - Technical Standards**: Review against Section 5 of style guide
+6. **Agent 6 - Content Patterns**: Review against Section 6 of style guide
+7. **Agent 7 - Industry Terms**: Review against Section 7 of style guide
+8. **Agent 8 - Quick Reference**: Final comprehensive check against Section 8
+
+**Each agent must return:**
+- List of violations with line numbers
+- Specific corrections for each issue
+- Citation of relevant style guide rules
+
+## Step 4: Aggregate Findings
+
+Once all 8 agents complete:
+- Collect all violation reports
+- Remove duplicate findings (if multiple agents caught same issue)
+- Sort violations by line number (top to bottom)
+- Calculate total violations by category
+- Determine severity (High/Medium/Low)
+
+## Step 5: Generate Review Report
+
+Create a structured report:
+
+```markdown
+# Style Check Report: $1
+
+**Article:** $2
+**Brand:** $1
+**Review Date:** [current date]
+**Total Violations:** [number]
+
+---
+
+## Summary by Section
+
+- Voice & Tone: [X] violations
+- Grammar & Usage: [X] violations
+- Punctuation: [X] violations
+- Formatting: [X] violations
+- Technical Standards: [X] violations
+- Content Patterns: [X] violations
+- Industry Terms: [X] violations
+- Additional (Quick Check): [X] violations
+
+---
+
+## Detailed Findings
+
+### Agent 1 - Voice & Tone
+[Paste agent findings]
+
+### Agent 2 - Grammar & Usage
+[Paste agent findings]
+
+### Agent 3 - Punctuation
+[Paste agent findings]
+
+### Agent 4 - Formatting
+[Paste agent findings]
+
+### Agent 5 - Technical Standards
+[Paste agent findings]
+
+### Agent 6 - Content Patterns
+[Paste agent findings]
+
+### Agent 7 - Industry Terms
+[Paste agent findings]
+
+### Agent 8 - Quick Reference Check
+[Paste agent findings]
+
+---
+
+## Priority Recommendations
+
+**High Priority** (Brand voice/structural issues):
+[List critical violations]
+
+**Medium Priority** (Consistency/formatting):
+[List standard violations]
+
+**Low Priority** (Minor polish):
+[List minor violations]
+
+---
+
+## Next Steps
+
+- Review findings above
+- To apply corrections automatically: `/article-edit $1 $2`
+- To apply manually: Edit the article at $2 using the corrections provided
+```
+
+## Step 6: Conditional Auto-Apply
+
+**If $3 is `--auto-apply`:**
+- Proceed to apply all corrections automatically
+- Work through violations from top to bottom by line number
+- Use the Edit tool to apply each correction
+- Save result to same path with `_edited` suffix (unless already in `edited/` folder)
+- Generate before/after summary
+
+**If $3 is NOT `--auto-apply`:**
+- Display the report
+- Prompt user: "Review complete. Run `/article-edit $1 $2` to apply corrections."
+
+## Step 7: Save Report
+
+Save the review report to:
+- `docs/logs/[YYYY-MM-DD]_style-check_$1_[article-name].md`
+
+## Usage Examples
+
+```bash
+# Review only (no auto-apply)
+/style-check animalz brands/animalz/articles/original/my-article.md
+
+# Review and automatically apply corrections
+/style-check animalz brands/animalz/articles/original/my-article.md --auto-apply
+
+# Review article from different location
+/style-check hubspot /Users/name/Documents/draft-article.md
+```
+
+## Error Handling
+
+- **Style guide missing**: Provide helpful error with suggestion to generate one
+- **Article not found**: Check path and provide clear error
+- **Agent failures**: If any agent fails, continue with others and note the failure
+- **No violations found**: Celebrate! Report that article is fully compliant
+
+## Performance Notes
+
+- 8 agents running in parallel: ~5-10 minutes
+- Sequential would take: ~40+ minutes
+- Speedup factor: 4-5x