← ClaudeAtlas

manage-adrlisted

Create, update, and validate Architecture Decision Records (ADRs) following MADR 4.0 format. Use when the user mentions ADR, architecture decision, decision record, or asks to document a technical decision. Also use when creating new files in docs/decisions/. Handles numbering, frontmatter, section structure, and README index updates. Do NOT use for general documentation or non-architectural decisions.
sergeyklay/.agents · ★ 5 · AI & Automation · score 80
Install: claude install-skill sergeyklay/.agents
# Managing Architecture Decision Records This project stores ADRs in `docs/decisions/` following [MADR 4.0](https://adr.github.io/madr/) with project-specific conventions documented below. ## File Conventions - Path: `docs/decisions/NNNN-kebab-case-title.md` - Numbering: zero-padded four digits, sequential. See "Get Sequence Number" below. - Index: `docs/decisions/README.md` contains a table of all ADRs. Update it after every create, rename, or status change. ## Running scripts bundled with this skill Script paths in this document (e.g. `scripts/`) are resolved relative to **this** SKILL.md file, not to your current working directory. If a relative command fails to resolve, prefix it with the path your platform loaded this SKILL.md from. **Fallback.** If `python3` cannot be located, analyze the script's purpose and logic and execute its intent with available tools, but warn the user that python is not available and the logic was executed with a fallback approach that may not be perfect. ## Running scripts bundled with this skill Script paths in this document (e.g. `scripts/`) are resolved relative to **this** SKILL.md file, not to your current working directory. If a relative command fails to resolve, prefix it with the path your platform loaded this SKILL.md from. ## ADR Template Use [assets/adr-template.md](assets/adr-template.md) as the starting point. The template contains the exact frontmatter and section structure. Copy it, fill in the content, remove sections