adr-decision-extraction
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-decision-extraction mines conversations and transcripts for architectural decisions, surfacing problem-solution pairs and trade-offs to feed ADR writing.
AI-generated summary based on this skill's SKILL.md
Install
existential-birds/beagle/adr-decision-extraction · repository language: TypeScript
git clone https://github.com/existential-birds/beagle
cp -r beagle/plugins/beagle-analysis/skills/adr-decision-extraction ~/.claude/skills/adr-decision-extractionnpx skillfed install existential-birds/beagle/adr-decision-extractionFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What architectural decisions can adr-decision-extraction find?
adr-decision-extraction scans conversations and transcripts 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 from design discussions, then rates each decision's confidence level for use in ADR documentation.
How do I extract architectural decisions from conversation?
Feed adr-decision-extraction your conversation, transcript, or design meeting notes. The skill identifies both explicit [ADR] tags and implicit architectural choices embedded in planning sessions. It extracts problem-solution pairs, technology selections, and trade-off debates, then outputs structured decision data ready for ADR writing tools.
Does adr-decision-extraction find implicit decisions?
Yes. adr-decision-extraction mines implicit decisions from planning sessions alongside explicit [ADR] tags. It detects architectural choices woven through design discussions—technology preferences, alternatives debated, and drivers behind selections—even when not formally tagged, preparing all findings for ADR documentation.
What output does adr-decision-extraction produce?
adr-decision-extraction extracts decision context, problem-solution pairs, and trade-offs from transcripts, then assigns confidence levels to each detected choice. Output feeds directly into ADR writing tools rather than generating documents itself, giving you structured input ready for formal architectural decision records.
Can adr-decision-extraction identify alternatives discussed?
Yes. adr-decision-extraction identifies alternatives discussed in meetings and captures trade-off debates from planning sessions. It extracts decision drivers, technology choices, and rationale alongside the options considered, helping you document the full context of architectural choices for ADR preparation.
What are the main intents of adr-decision-extraction?
adr-decision-extraction prioritizes extracting architectural decisions from transcripts for ADR input, identifying problem-solution pairs and trade-offs, finding explicit [ADR] tags, mining implicit decisions from planning, and assessing confidence levels of detected choices. Each intent supports preparing comprehensive, well-sourced architectural decision records.
SKILL.md
rendered from the published skill — quoted content, verbatim
ADR Decision Extraction
Extract architectural decisions from conversation context for ADR generation.
Detection Signals
| Signal Type | Examples |
|---|---|
| Explicit markers | [ADR], "decided:", "the decision is" |
| Choice patterns | "let's go with X", "we'll use Y", "choosing Z" |
| Trade-off discussions | "X vs Y", "pros/cons", "considering alternatives" |
| Problem-solution pairs | "the problem is... so we'll..." |
Extraction Rules
Explicit Tags (Guaranteed Inclusion)
Text marked with [ADR] is always extracted:
``` [ADR] Using
(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/adr-decision-extraction/SKILL.md