Initialize, create, supersede, link, and report Architecture Decision Records with Mermaid diagrams.
npx skills add https://github.com/yu-iskw/dbt-heros --skill manage-adr-yu-iskw
Please help me install this Agent Skill. Skill: manage-adr Source: https://github.com/yu-iskw/dbt-heros/tree/main/.claude/skills/manage-adr Command: npx skills add https://github.com/yu-iskw/dbt-heros --skill manage-adr-yu-iskw
This Skill streamlines the process of documenting significant technical decisions, ensuring that the rationale behind architectural choices is preserved and accessible for future reference.
Initialize ADRs in your project by running 'adr init docs/adr'.
High-intent search queries and answers about installing and using this skill.
Architecture Decision Records document technical design choices by creating structured files detailing the context, decision, and consequences of architectural choices, which you can initialize and manage within your project directory.
Tracking the evolution of technical decisions involves superseding and linking existing records to establish relationships between past and new choices, ensuring the rationale behind architectural changes is preserved and accessible for future reference.
Yes, you can integrate Mermaid diagrams within Architecture Decision Records to visually represent complex technical decisions and system designs, optionally generating diagram outputs using Graphviz.
Yes, installing adr-tools is required to manage Architecture Decision Records, and Graphviz is optionally needed if you want to generate visual diagrams from your technical documentation.
Initializing an ADR directory structure involves running the initialization command to set up a dedicated folder, such as 'docs/adr', where your architecture decision records and their associated metadata will be stored.
When superseding architecture decision records, ensure relationships between old and new records are properly linked to maintain context, as the workflow relies on adr-tools and may require Graphviz for diagram generation.
simonheimlicherCreate Architecture Decision Records for TypeScript architecture decisions.
wilfozCreate architecture decision records in MADR, Nygard, or Y-Statement formats.
Logos-LiberCompare static site generators and documentation platforms for technical documentation workflows.
EngineerWithAICreate and manage Architecture Decision Records in multiple formats.
