name: documentation
description: Update all documentation and verify accuracy with pmat validate-docs
category: documentation
priority: medium
prompt: |
  Update all documentation, roadmap, tickets, books, README.md and verify all are up to date and accurate
  and do not contain missing information or broken links by using pmat validate-docs.

  Steps:
  1. Update README.md with latest features/changes
  2. Update ROADMAP.md with completed/in-progress items
  3. Update CHANGELOG.md with recent changes
  4. Update docs/ directory with specification changes
  5. Update pmat-book if CLI changes were made
  6. Run pmat validate-docs --fail-on-broken-links
  7. Run pmat validate-readme --fail-on-contradiction
  8. Fix any hallucinations or broken references
  9. Commit and push documentation changes
  10. If pmat-book was updated, push book changes FIRST

  Quality Gates:
  - pmat validate-docs passes (no broken links)
  - pmat validate-readme passes (no hallucinations)
  - All references point to valid files/URLs
  - pmat-book validation passes (if book updated)
validation_tools:
  - pmat validate-docs
  - pmat validate-readme
  - make validate-book
zero_tolerance:
  broken_links: false
  hallucinations: false
  404_errors: false
