Write lightweight Architecture Decision Records for small teams: context → decision → consequences → status.
概要
Write lightweight Architecture Decision Records for small teams: context → decision → consequences → status. 小型团队 ADR（背景→决策→后果→状态）。 — 详见 README.zh.md. - You produce short, durable ADRs small teams actually maintain - Scope: Small-team software architecture & tooling choices - Deliverable: One ADR page with status + consequences - Triggers: ADR, architecture decision record, tech decision log, RFC-lite ADR. Local monorepo: point your agent at skills/adr-writer/ (this folder). Runtime output language follows lang (default ). Skill docs stay EN-primary. - Stack/library/protocol decisions - Cross-team “why we chose X” - Superseding an old decision - Daily task tickets - Full multi-option RFC (use rfc-outline) - Inventing decisions without stakeholders Full workflow, hard rules, and QA: see SKILL.md.
README
ADR Writer
Write lightweight Architecture Decision Records for small teams: context → decision → consequences → status.
中文简介： 小型团队 ADR（背景→决策→后果→状态）。 — 详见 README.zh.md.
What this skill does
- You produce short, durable ADRs small teams actually maintain
- Scope: Small-team software architecture & tooling choices
- Deliverable: One ADR page with status + consequences
- Triggers: ADR, architecture decision record, tech decision log, RFC-lite ADR.
Install
After this package is on GitHub:
npx skills add / --skill adr-writer
Local monorepo: point your agent at skills/adr-writer/ (this folder).
Options
| Option | Values | Default |
|---|---|---|
lang |
en · zh · bilingual |
en |
format |
madr · nygard · onepager |
nygard |
status |
proposed · accepted · deprecated · superseded |
proposed |
id_style |
sequential · date · none |
sequential |
depth |
lite · standard |
standard |
Runtime output language follows lang (default en). Skill docs stay EN-primary.
When to use
| Use | Don’t |
|---|---|
| (see bullets) | (see bullets) |
Use
- Stack/library/protocol decisions
- Cross-team “why we chose X”
- Superseding an old decision
Don’t
- Daily task tickets
- Full multi-option RFC (use rfc-outline)
- Inventing decisions without stakeholders
Deliverable
One ADR page with status + consequences
Full workflow, hard rules, and QA: see SKILL.md.
Example
Monorepo sample (if present): ../../output/samples/adr-writer-example-01.md
License
MIT — see LICENSE.
Attribution
Forged with skill-github (local package; push via external tool). Upstream notes may live in workspace AUTHORS.md / sources/.
推奨ツール
別のキーワードを試すか、フィルタを外してください。
インストール
npx skillfish add pixeldeer8046-m9hb4/adr-writer