Generate Architecture Decision Records using the Y-statement template.
npx skills add https://github.com/sunLeee/optimization --skill doc-adr-sunleee
Please help me install this Agent Skill. Skill: doc-adr Source: https://github.com/sunLeee/optimization/tree/main/.claude/skills/scaffolding/docs/doc-adr Command: npx skills add https://github.com/sunLeee/optimization --skill doc-adr-sunleee
Architecture decisions are often scattered, ambiguous, or hard to trace. This Skill creates Architecture Decision Records (ADRs) in a consistent format using the Y-statement structure to capture context, choices, and outcomes.
Create a new ADR document with the given title using the Y-statement format.
High-intent search queries and answers about installing and using this skill.
An architecture decision record (ADR) documents an architectural choice and its context. The Y-statement format structures this by capturing alternatives, the decision, and consequences for clear project traceability.
To write an architecture decision record, provide a title and context. The Y-statement format structures the body with alternatives, the decision, consequences, and optional linked references for traceability.
You track the lifecycle of architectural decisions by using versioned status tracking within the decision record. This monitors state changes like Proposed, Accepted, Deprecated, or Superseded alongside the change history.
Yes, you can link related architecture decisions. The Y-statement decision record format supports optional linked references to maintain traceability across related documents and architectural contexts.
Yes, architecture decision record files require YAML frontmatter with name and description in SKILL.md, followed by a structured body following the Y-statement template to capture the architectural choice.
zircoteTransform architectural decisions into standardized Y-Statements with context, options, and trade-offs.
testdoubleCreate, extract, and convert Architectural Decision Records to standard templates.
arbiterForgeAuthor and track numbered, dated architecture decision records with user attribution.
shishiManage Architecture Decision Records across their lifecycle with MADR workflows.
