Documentation & ADRs
Records architectural decisions and engineering context to ensure maintainable, transparent codebases for both humans and AI agents.
The Documentation and ADRs skill enables AI coding agents to capture the 'why' behind technical choices, ensuring that the reasoning, constraints, and trade-offs of a project are never lost. By implementing standardized Architecture Decision Records (ADRs), it provides a historical log of significant changes—such as framework selections or database schemas—while guiding the creation of structured READMEs and intent-focused inline comments. This skill is essential for maintaining long-term project health, as it provides future developers and AI agents with the necessary context to understand existing architectural patterns and avoid repeating past mistakes.