MMCPMarkets
PM

pixeldeer8046-m9hb4/adr-writer

Productivity workflow
54 stars Quality 40 Trend 40
Repository Install

Write lightweight Architecture Decision Records for small teams: context → decision → consequences → status.

Overview

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/.

View this README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add pixeldeer8046-m9hb4/adr-writer