Capture architecture decisions as ADR entries with YAML frontmatter.
npx skills add https://github.com/Saturate/agents --skill documentation-adrs
Please help me install this Agent Skill. Skill: documentation-adrs Source: https://github.com/Saturate/agents/tree/main/skills/documentation-adrs Command: npx skills add https://github.com/Saturate/agents --skill documentation-adrs
Documents architecture decisions and rationale so teams can understand why a choice was made, preserving context beyond code.
Record an architecture decision as an ADR entry with the problem, decision, alternatives, and consequences.
High-intent search queries and answers about installing and using this skill.
To record architecture decisions, you capture the problem, final decision, alternatives, and consequences into an ADR entry with lightweight YAML frontmatter, which is then stored to a memory provider for easy retrieval during future software work.
An ADR is an Architecture Decision Record that documents why a specific choice was made. You need an ADR when making decisions about dependencies, patterns, infrastructure, and security to preserve context beyond the code for teams.
You store ADRs to a memory provider by applying a clear storage directive within the ADR entry. This directive ensures the lightweight YAML frontmatter and decision rationale are saved for quick retrieval during future work.
When writing architecture documentation, you need to include a concise Decision section, an Alternatives considered section, and lightweight YAML frontmatter. This structure captures the context, decision, alternatives, and consequences effectively.
Yes, you can use ADRs for infrastructure and security decisions across software projects. The format applies broadly to capturing decisions about dependencies and patterns, ensuring the rationale is preserved in memory regardless of the specific project.
dimsourAutomates .NET solution documentation with problem descriptions, root causes, and fixes.
AndreaCadonnaCreate standardized ADR documents with required sections and naming.
pazdedavGenerate formal Azure Architecture Decision Records with WAF pillar mapping.
tillysosoDraft new Architecture Decision Records as standards-compliant Markdown files.
