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
Decision gist · record as of 2026-07-21
Write ADR generates Architecture Decision Records from decisions made during your current session. 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.
Use it when
- Yes.
- Write-adr documents architectural choices by first extracting decision points from your conversation.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
existential-birds/beagle/write-adr · repository language: TypeScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently 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)
File tree — 1 file
plugins/beagle-analysis/skills/write-adr/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Generate Architecture Decision Records from session decisions”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
This skill scans conversations, session transcripts, and design discussions to isolate architectural decisions—capturing problem statements, chosen options, alternatives considered, and decision drivers. It recognizes explicit `[ADR]` tags alongside implicit choice patterns and trade-off debates, then rates each decision's confidence level. Output feeds directly into ADR writing tools rather than generating documents itself.
adr-writing creates and formats architectural decision records using the MADR structure, applying E.C.A.D.R. quality criteria to ensure completeness. It sequences numbering, explores related decisions and code context, fills template sections, and marks gaps for investigation where data is unavailable.
This skill walks you through the complete ADR lifecycle—from evaluating whether a decision is ready to record, through structured creation using the MADR template, to quality checks and ongoing log management. It grounds decisions in proven frameworks like START (readiness criteria) and ECADR (completion criteria), helping teams capture architectural rationale rather than just outcomes.
This skill guides you through writing Architecture Decision Records—concise documents that capture the shape of load-bearing choices, why you made them, and what trade-offs you considered. Use it when a decision is hard to reverse, surprising without context, or the result of genuine alternatives. ADRs live in docs/adr/ with sequential numbering and a simple template; most need just a paragraph.
This skill streamlines creation and organization of temporary project work products like architecture decision records, research investigations, spike analyses, and implementation plans. It provides templated Python scripts, standardized naming conventions, and a date-based directory structure within `.claude/artifacts/` to keep artifacts organized and discoverable.
Architecture Designer guides you through system design from requirements to documented decisions. It creates architecture diagrams, evaluates technology trade-offs, and produces Architecture Decision Records for key choices. Use it to structure microservices, plan scalability, and validate designs with stakeholders.
More skills architecture-decision-records (MIT) · adr-writer (MIT) · adr-writer (MIT) · adr-author (MIT) · doc-adr-autopilot (MIT)