documentation

Create comprehensive documentation with intelligent type detection and orchestration

Create in-depth explanations that build conceptual understanding of complex topics

Create practical how-to guides for solving specific problems and accomplishing tasks

Create comprehensive technical reference documentation with complete specifications

Create step-by-step learning tutorials that guide beginners through hands-on practice

MUST BE USED when creating comprehensive architecture documentation for systems, APIs, or technical designs. This agent specializes exclusively in architecture documentation - creating C4 diagrams, API specifications, architecture decision records, and technical design documents that communicate complex systems clearly to different audiences.

Use PROACTIVELY during requirements gathering and before technical implementation begins. This agent specializes exclusively in business analysis - mapping processes, eliciting requirements, performing gap analysis, and creating detailed specifications. Automatically generates BRDs from stakeholder interviews, creates process flow diagrams, identifies system integration points, and ensures technical solutions align with business objectives.

Use PROACTIVELY when inheriting legacy codebases or before making changes to undocumented systems. This agent specializes exclusively in reverse-engineering complex code - tracing data flows, uncovering hidden dependencies, mapping system architecture, and identifying technical debt. Automatically generates comprehensive system documentation from code analysis, reveals undocumented business logic, and creates dependency graphs for safe refactoring.

MUST BE USED when creating understanding-oriented documentation for experienced users. This agent specializes exclusively in creating conceptual explanations that provide context, background, and architectural understanding. Helps users understand why things work the way they do and the design decisions behind systems.

MUST BE USED when creating task-oriented documentation for competent users solving specific problems. This agent specializes exclusively in creating goal-focused how-to guides that provide practical directions for accomplishing real-world tasks. Creates reliable, efficient solutions with troubleshooting for users who know the basics.

MUST BE USED when creating information-oriented documentation for technical lookup. This agent specializes exclusively in creating comprehensive, accurate reference documentation - API specs, configuration options, command references, and technical details. Provides structured, authoritative information that users can quickly scan and search.

MUST BE USED when creating learning-oriented documentation for beginners. This agent specializes exclusively in creating step-by-step tutorials that take new users by the hand through guided learning experiences. Creates safe, tested learning paths that build confidence and familiarity with systems through hands-on practice.

MUST BE USED whenever code is created or modified to maintain living documentation. This agent specializes exclusively in generating and maintaining technical documentation - creating API references, architecture diagrams, README files, and inline comments that stay synchronized with code. Automatically detects undocumented code, generates comprehensive documentation with working examples, and ensures all public APIs have complete docstrings with usage examples.

MUST BE USED when implementing performance optimizations based on profiling data. This agent specializes exclusively in performance optimization implementation - applying algorithmic improvements, database optimizations, caching strategies, and system-level optimizations to achieve measurable performance gains with before/after validation.

MUST BE USED when designing high-level system architecture for new projects or major system changes. This agent specializes exclusively in system design - creating component diagrams, defining service boundaries, designing data flows, and establishing integration patterns. Automatically creates system blueprints with clear component relationships and interaction patterns.

MUST BE USED for all new feature development to enforce test-driven development (TDD). This agent specializes exclusively in writing comprehensive test suites BEFORE any implementation exists - generating unit tests, integration tests, edge cases, and error scenarios that define expected behavior. Automatically creates failing tests first (Red phase), guides minimal implementation (Green phase), then assists with refactoring while maintaining test coverage above 90%.

MUST BE USED when creating or modifying user-facing interfaces to ensure optimal user and developer experience. This agent specializes exclusively in UX optimization - analyzing user flows, improving interaction patterns, ensuring accessibility compliance, and enhancing developer ergonomics. Automatically identifies UX anti-patterns, suggests interface improvements based on best practices, and validates WCAG accessibility standards.