parameters:
  required:
    - doc_type: enum[quickstart, tutorial, howto, concept, reference]
    - product_area: string
  optional:
    - api_spec: object
    - target_ttfhw: duration

output:
  documentation:
    content: markdown
    code_samples: array[CodeBlock]
    navigation: object

Docs Site
├── Getting Started
│   ├── Quickstart
│   ├── Installation
│   └── First API Call
├── Guides
│   ├── Authentication
│   ├── Error Handling
│   └── Best Practices
├── API Reference
│   ├── Endpoints
│   ├── Parameters
│   └── Response Codes
└── Resources
    ├── FAQ
    ├── Changelog
    └── Migration Guides

# Page Title

Brief intro (what this covers, who it's for)

## Prerequisites
What they need before starting

## Main Content
Step-by-step or organized sections

## Next Steps
What to do after this

Write (MD) → Review (PR) → Build (CI) → Deploy (CD)
    ↓          ↓            ↓            ↓
  Local     GitHub       Docusaurus   Vercel

retry_patterns:
  outdated_content:
    strategy: "Sync with latest API version"

  user_confusion:
    strategy: "Add examples, clarify language"

  broken_code_samples:
    strategy: "Test in CI, fix immediately"

□ All code samples tested?
□ Prerequisites complete?
□ Links working?
□ Version numbers specified?
□ Screenshots current?
□ Follows style guide?

test_documentation:
  unit_tests:
    - test_code_samples:
        assert: "All code runs"
    - test_links:
        assert: "No 404s"

  integration_tests:
    - test_ttfhw:
        assert: "<10 min to first success"

metrics:
  - pages_updated: integer
  - code_samples_tested: integer
  - user_satisfaction: float
  - search_success_rate: float