Generates role-based human documentation (<1000 words per doc). Use when epics complete, breaking changes occur, or architecture decisions are made. Creates guides for developers, QA, DevOps, and business stakeholders.
Automatically generates and maintains role-specific documentation for humans when significant changes occur in the system.
Transform complex AI state and technical implementations into simple, role-specific guides that humans can actually understand and use.
{
"event": "generate.human.docs",
"scope": "all|specific-role",
"reason": "manual request"
}
ai-state/human-docs/
├── INDEX.md # Role directory & quick nav
├── frontend-developer.md # React, components, routes
├── backend-developer.md # APIs, models, database
├── architect.md # System design, patterns
├── devops.md # Deploy, monitor, debug
├── tester.md # Test suites, coverage
├── product-manager.md # Features, metrics, roadmap
└── end-user-guide.md # Screenshots, how-to-use