documentation-and-adrs

Create ADRs and technical documentation following established templates.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/reez455G/my-ai-agents --skill documentation-and-adrs-reez455g
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-and-adrs
Source: https://github.com/reez455G/my-ai-agents/tree/main/.omp/skills/documentation-and-adrs
Command: npx skills add https://github.com/reez455G/my-ai-agents --skill documentation-and-adrs-reez455g

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill aids in maintaining a comprehensive record of architectural decisions, documentation, and ADRs (Architecture Decision Records), ensuring clarity and understanding for future engineers and agents.

Core Features & Use Cases

  • Record Decisions: Capture the rationale behind significant technical decisions.
  • Architectural Decisions: Store ADRs for major technical decisions.
  • Documentation: Maintain inline documentation and API documentation.
  • Quick Start: Implement ADRs and documentation following the established template.

Quick Start

Use the documentation-and-adrs skill to create a new ADR for the decision to use PostgreSQL as the primary database.

Frequently Asked Questions about documentation-and-adrs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an Architecture Decision Record for a new database choice?

To create an Architecture Decision Record, use the skill to generate a structured entry following the established ADR template, capturing the technical rationale and implementation details for your database choice. This ensures future engineers understand the context.

What is the best way to document architectural decisions for future engineers?

The best way to document architectural decisions is by maintaining Architecture Decision Records and inline documentation. This records the rationale behind technical choices, ensuring clarity and structured references for future engineers and agents.

When do I need to use ADRs in my codebase management workflow?

You need to use ADRs in your codebase management workflow when your project requires structured records of major technical decisions, implementation details, and rationale to maintain adherence to documentation standards for future reference.

Can I maintain inline and API documentation alongside decision documentation?

Yes, you can maintain inline documentation and API documentation alongside architectural decisions. The skill manages technical documentation comprehensively, ensuring all implementation details and decision rationale are stored together.

Does this approach to technical documentation require specific templates?

Yes, this approach requires adherence to established documentation standards and ADR templates. Following these templates ensures that architectural decisions and technical rationale are recorded consistently for future reference.