architecture-decision-records
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
About
- Publisher
- Seth Hobson
- Tool
- Documentation
Install
The project doesn't document install steps that we could confirm. See the project's own instructions
What's inside
- references/decision-templates.md
- references/deprecation-rfc-templates.md
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Documentation | |
| Publisher | Seth Hobson | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 18, 202642,668 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Other copies of this skill (7)
These differ from this skill's text. They may be adapted copies or older versions.
- architecture-decision-recordsrmyndharis/antigravity-skills
- architecture-decision-recordsdokhacgiakhoa/agent-skills-4-vibe-coding-cli
- architecture-decision-recordsagent-skills-hub/agent-skills-hub
- architecture-decision-recordsfridrichmethod/awesome-skills
- architecture-decision-recordsokhp3/skillz
- architecture-decision-recordsokhp3/skillz
- architecture-decision-recordsc3sc0-v4113/scaffold
More from Seth Hobson
21 skills
- github-actions-templates (Skill)
- gitlab-ci-patterns (Skill)
- multi-cloud-architecture (Skill)
- terraform-module-library (Skill)
- godot-gdscript-patterns (Skill)
- unity-ecs-patterns (Skill)
Also listed under: Documentation
Sources
- Skill file (SKILL.md)github.com/wshobson/agentsNov 19, 2026
- GitHub repositorygithub.com/wshobson/agents · Backs: Licence, Publisher, ActivityNov 19, 2026
- Folder in the repository (architecture-decision-records)github.com/wshobson/agents · Backs: Includes scriptsNov 19, 2026