Manage Architecture Decision Records across their lifecycle with MADR workflows.
npx skills add https://github.com/shishi/dotfiles --skill adr-shishi
Please help me install this Agent Skill. Skill: adr Source: https://github.com/shishi/dotfiles/tree/main/claude/skills/adr Command: npx skills add https://github.com/shishi/dotfiles --skill adr-shishi
Manage Architecture Decision Records (ADRs) across their lifecycle.
Draft an ADR for the upcoming architectural decision following the template.md, then commit with a message that references the ADR.
High-intent search queries and answers about installing and using this skill.
An Architecture Decision Record (ADR) captures architectural choices and their context. You should document one whenever a structural decision impacts feature work or refactors, ensuring architecture stays aligned with current development.
To draft and manage ADRs, apply the MADR template.md to structure your decision record. You can then read, update its status from proposed to accepted, or deprecate it, while using operations.md and queries.md to organize and locate records.
You reference architecture decision records in git commits by including the ADR identifier in your commit messages. This enforces a workflow where architectural decisions explicitly guide and align with the committed feature work and refactors.
Yes, you can supersede outdated architecture decisions rather than deleting them. The ADR lifecycle management supports moving decisions to a deprecated status and linking them to the new accepted records to preserve historical context.
Yes, the ADR workflow enforces specific naming conventions for decision records. By leveraging the MADR template.md alongside operations.md and queries.md, it standardizes file naming to ensure ADRs are easily located and organized.
adolfoaranaes12Translate requirements into architecture documentation with ADR creation and project-type detection.
joestumpCreate sequential Architecture Decision Records in MADR format with required sections and Mermaid diagrams.
dorrioConfigure Husky, lint-staged, commitlint, and Python pre-commit hooks.
HermeticOrmusGenerate Markdown-based ADRs using MADR and Y-Statement templates.
