adr-drafting
ADR Drafting helps teams document significant architectural decisions by creating new Architecture Decision Record files with a standard structure. It inspects your repository for existing ADR conventions, then drafts a new record with Title, Status, Context, Decision, and Consequences sections—defaulting to `docs/architecture/adr` when no convention exists.
ADR Drafting creates new Architecture Decision Record documents to document architectural choices with consistent templates and repository-aware naming.
AI-generated summary based on this skill's SKILL.md
Install
giuseppe-trisciuoglio/developer-kit/adr-drafting · repository language: Python
git clone https://github.com/giuseppe-trisciuoglio/developer-kit
cp -r developer-kit/plugins/developer-kit-core/skills/adr-drafting ~/.claude/skills/adr-draftingnpx skillfed install giuseppe-trisciuoglio/developer-kit/adr-draftingFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I document an architectural choice with adr-drafting?
ADR Drafting helps you create a new Architecture Decision Record by generating a structured file with standard sections. The skill inspects your repository for existing ADR conventions, then drafts a record with Title, Status, Context, Decision, and Consequences sections. If no convention exists, it defaults to storing the ADR in `docs/architecture/adr`.
What sections does adr-drafting include in a new ADR?
ADR Drafting structures each Architecture Decision Record with five key sections: Title (the decision name), Status (such as Proposed or Accepted), Context (background and problem statement), Decision (the chosen solution), and Consequences (trade-offs and impacts). This standard format ensures consistent documentation across your team's architectural decisions.
Can adr-drafting generate ADR template for database migration?
Yes, ADR Drafting can generate an ADR template tailored to your needs, including database migration decisions. It creates a properly named and located file following your repository's conventions, with all standard sections ready for you to fill in the specific context, rationale, and consequences of your database choice.
How does adr-drafting preserve architectural decisions for team knowledge?
ADR Drafting creates markdown files that document your technical rationale and trade-offs, preserving architectural decision history in a structured, searchable format within your repository. This enables team members to understand why past decisions were made and reference them when evaluating future architectural changes.
What naming convention does adr-drafting use for new records?
ADR Drafting follows your repository's existing ADR naming conventions when detected. If no convention exists, it defaults to sequential numbering (like ADR 0001) and stores files in `docs/architecture/adr`. The skill generates properly formatted filenames that integrate seamlessly with your project's documentation structure.
Does adr-drafting help document why we chose our tech stack?
Yes, ADR Drafting is designed to document technical decisions like technology stack choices. It helps you capture the Context (why the decision was needed), Decision (which tech stack was chosen), and Consequences (benefits and trade-offs), creating a permanent record that explains your architectural choices to current and future team members.
SKILL.md
rendered from the published skill — quoted content, verbatim
ADR Drafting
Creates new Architecture Decision Record (ADR) documents for major architectural choices so teams can keep a clear history of why important technical decisions were made.
Overview
This skill helps create a new ADR from discovery to final markdown file. It confirms the decision details, inspects the repository for any existing ADR conventions, and drafts a new ADR with the standard sections Title, Status, Context, Decision, and Consequences.
When the repository does not already have an ADR convention, default to storing ADRs in docs/architecture/adr and use a zero-padded filename such as 0001-use-postgresql-for-primary-database.md.
See references/template.md for the default ADR template and references/examples.md for example ADRs
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 3 files
plugins/developer-kit-core/skills/adr-drafting/SKILL.md
plugins/developer-kit-core/skills/adr-drafting/references/examples.md
plugins/developer-kit-core/skills/adr-drafting/references/template.md