write-adr
Write ADR captures architectural decisions from your conversation and generates formatted Architecture Decision Records automatically. It orchestrates the full workflow—extracting decisions, confirming selections with you, writing ADRs in parallel, and verifying output against quality standards.
Write ADR generates Architecture Decision Records from decisions made during your current session.
AI-generated summary based on this skill's SKILL.md
Install
existential-birds/beagle/write-adr · repository language: TypeScript
git clone https://github.com/existential-birds/beagle
cp -r beagle/plugins/beagle-analysis/skills/write-adr ~/.claude/skills/write-adrnpx skillfed install existential-birds/beagle/write-adrFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What does write-adr do with my session decisions?
Write-adr captures architectural decisions from your conversation and generates formatted Architecture Decision Records automatically. The skill orchestrates the full workflow—extracting decisions, confirming selections with you, writing ADRs in parallel, and verifying output against quality standards.
Can write-adr generate architecture decision records from our discussion?
Yes. Write-adr generates Architecture Decision Records directly from your session discussion. It extracts decisions you've made, presents them for your confirmation, then creates MADR-formatted ADR files in parallel while validating each record against a Definition of Done.
How does write-adr document architectural choices?
Write-adr documents architectural choices by first extracting decision points from your conversation, requesting your confirmation on each selection, then writing the confirmed choices into structured ADR format. You retain control—only decisions you confirm become part of the generated records.
Does write-adr verify the ADRs it creates?
Yes. Write-adr validates generated ADRs against a Definition of Done to ensure quality. It performs this verification as part of its orchestrated workflow, checking that each decision record meets your standards before final output.
What format does write-adr use for decision records?
Write-adr creates decision records in MADR (Markdown Architecture Decision Records) format. This structured approach ensures consistency across all generated ADRs and makes them easy to version control and integrate into your documentation systems.
Can write-adr create multiple ADR files at once?
Yes. Write-adr creates MADR-formatted decision records in parallel, allowing it to generate multiple ADR files simultaneously from your session decisions. This parallel processing speeds up documentation while maintaining quality through validation.
SKILL.md
rendered from the published skill — quoted content, verbatim
Write ADR
Generate Architecture Decision Records (ADRs) from decisions made during the current session.
Workflow Overview
- Context - Gather repository context and existing ADRs
- Extract - Analyze conversation for decisions using a subagent
- Confirm - Present decisions to user for selection
- Write - Generate ADRs in parallel using subagents
- Report - Summarize created files and status
- Verify - Validate generated ADRs against Definition of Done
Gates (objective pass conditions)
Advance only when the pass condition holds. These are checkable without “I verified
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
plugins/beagle-analysis/skills/write-adr/SKILL.md