outfitter-dev/agents-internal/docs-review

Documentation Review

Review the current document against Outfitter standards for voice, style, and structure.

Review Direction

$ARGUMENTS

If direction is provided above, focus on that specific aspect. Otherwise, perform a general review across all dimensions.

Review Criteria

Voice

Does it sound like Outfitter?

• Confident, opinionated stance
• Agents as first-class consumers
• Plain language over jargon

Style

Is the craft right?

• Punch-and-flow rhythm (short + long sentences)
• Earned enthusiasm (backed by substance)
• Strong opening and closing

Structure

Does it follow documentation patterns?

• Appropriate template usage
• Complete, runnable examples
• Correct heading hierarchy (h1 > h2 > h3)

Output Format

Provide your review in this format:

Status: Ready | Needs Work

Summary: One sentence overall assessment.

Issues (if any):

• [Location] Issue description and suggested fix

Strengths:

• What works well

If the document is ready, say so briefly. If it needs work, be specific about locations and fixes.