Capture and standardize architecture decision records in markdown.
npx skills add https://github.com/skylarsabo/code-ops --skill adr-skylarsabo
Please help me install this Agent Skill. Skill: adr Source: https://github.com/skylarsabo/code-ops/tree/main/plugins/code-ops-suite/skills/adr Command: npx skills add https://github.com/skylarsabo/code-ops --skill adr-skylarsabo
The Skill addresses the issue of unclear and difficult-to-reverse architecture decisions within codebases, providing a standardized process for capturing and documenting such decisions for future reference and to aid new contributors.
Start a new ADR to document the reasoning behind an architecture decision using /code-ops-suite:adr --new.
High-intent search queries and answers about installing and using this skill.
Architecture decision records are captured using standardized markdown files that enforce decision-making criteria around cost, context, and trade-offs. They are maintained in an indexed directory for easy navigation and future reference.
Past architecture decisions can be backfilled by mining existing code and documentation to present historical choices alongside their original context, options, and reasoning, aiding new contributors in understanding the codebase.
You need architecture decision records when managing and scaling large codebases to prevent unclear and difficult-to-reverse architectural choices. They ensure every decision is backed by evidence and weighed options for future reference.
You can start a new architecture decision record by initiating a new ADR entry to document the rationale for a decision in progress. This ensures documentation is thorough and captures the reasoning behind current architecture choices.
Yes, this architecture decision process is specifically aimed at software engineers managing and scaling large codebases. It provides a standardized process for capturing and documenting decisions to aid new contributors and prevent irreversible mistakes.
abdullah1854Generate dated Markdown ADRs with Context, Decision, Consequences, Alternatives, and References.
chicanoandres702Create and maintain Architecture Decision Records with standardized templates and an index.
soloamenteCreate and manage Architecture Decision Records and software documentation.
robit-manBuild weighted decision matrices and generate Architecture Decision Records.
