Skip to content
Kitbay
Skill

architecture-decision-records

MITUpdated on Nov 18, 202642,668GitHub stars

A skill in Seth Hobson's agents collection for writing and maintaining architecture decision records, short documents that capture why a significant technical choice was made.

What the skill teaches

A skill in Seth Hobson's agents collection for writing and maintaining architecture decision records, short documents that capture why a significant technical choice was made. Each record states the context, the decision and its consequences, and moves through proposed, accepted, deprecated, superseded or rejected states. The skill says which decisions deserve a record, such as framework, database or API choices, and which do not, like bug fixes or minor upgrades. It sets out a docs/adr folder with a numbered index and template, optional automation with adr-tools, a review process with checks before and after acceptance, and practices such as keeping records to one or two pages and superseding rather than editing accepted ones.

Capabilities

  • Decide when a decision needs a record
  • Write records in standard templates
  • Keep a numbered decision index
  • Supersede outdated decisions