Document architecture decisions as ADRs matching repository conventions.
npx skills add https://github.com/0xdeafcafe/skills --skill write-adr-0xdeafcafe
Please help me install this Agent Skill. Skill: write-adr Source: https://github.com/0xdeafcafe/skills/tree/main/skills/write-adr Command: npx skills add https://github.com/0xdeafcafe/skills --skill write-adr-0xdeafcafe
This Skill helps teams capture important architecture and design decisions in a durable ADR instead of leaving the reasoning buried in chats, meetings, or memory. It reduces the risk of future confusion about why one option was chosen over another and keeps decision records consistent with the repository's existing conventions.
Ask the assistant to use write-adr to document a specific architecture decision and include the decision, the alternatives considered, and why the change is happening now.
High-intent search queries and answers about installing and using this skill.
Architecture decisions are documented as ADRs by discovering repository conventions, clarifying the decision context, and drafting a reviewable record directly into the codebase. This ensures the rationale is captured durably instead of being lost in chats.
An ADR is an Architecture Decision Record used to capture important design choices like library selection, database strategy, or deployment topology. You need one when a team decides on an architectural direction and wants a clear written record of the reasoning.
To write an ADR that matches repository formatting, the skill first discovers your project's ADR folder, naming pattern, numbering scheme, and document style before drafting a concise record that fits local conventions and linking practices.
Yes, you can supersede older ADRs when documenting a new architecture decision. The skill handles status conventions and cross-links related records, ensuring the new decision document properly references and supersedes prior architecture records.
Yes, this skill has no external dependencies and works by discovering your repository's existing conventions on the fly. It requires no predefined templates because it analyzes your local folder structure and document style to draft a matching ADR.
When drafting an architecture decision record, you should include the decision, the alternatives considered, the forcing function for the change, and the consequences. The skill interactively frames these elements to ensure the ADR reflects an actual decision.
codewithmukesh...
giuseppe-trisciuoglioGenerate TypeScript API references and ADRs with TypeDoc and JSDoc.
g-zenrAnalyze dependency graphs and propose architecture improvements with impact and risk.
qte77Generate MADR/ADR, RFC, and design documents from input topics.
