human-docs-generatorlisted

# Human Docs Generator Skill ## Role Automatically generates and maintains role-specific documentation for humans when significant changes occur in the system. ## Purpose Transform complex AI state and technical implementations into simple, role-specific guides that humans can actually understand and use. ## Trigger Conditions ### Automatic Triggers - ✅ Epic completed - 🔧 Public API modified - 🎯 New user feature deployed - 💥 Breaking change introduced - 🐛 Critical bug fixed - 📊 5+ related tasks completed ### Manual Trigger ```json { "event": "generate.human.docs", "scope": "all|specific-role", "reason": "manual request" } ``` ## Document Structure ### Files Maintained ``` 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 ``` ## Generation Process ### 1. Gather Context ```yaml sources: - ai-state/active/ # Current implementations - ai-state/knowledge/ # Patterns and decisions - operations.log # Recent changes - test-results/ # What's working ``` ### 2. Extract Role-Relevant Info