Document engineering decisions as ADRs with rationale and decision logs.
npx skills add https://github.com/Cygnusfear/claude-stuff --skill the-archivist
Please help me install this Agent Skill. Skill: the-archivist Source: https://github.com/Cygnusfear/claude-stuff/tree/main/skills/the-archivist Command: npx skills add https://github.com/Cygnusfear/claude-stuff --skill the-archivist
The Archivist enforces decision documentation for architectural and design choices, ensuring rationale is captured as ADRs and linked to code decisions.
When choosing a significant design approach, add an inline decision or a full ADR in .plans/decisions or .plans/ to capture context and rationale.
High-intent search queries and answers about installing and using this skill.
Documenting architectural decisions captures the rationale behind technology choices, design patterns, and trade-offs, creating an immutable historical record that helps team members understand context and avoid repeating past deliberations.
An ADR documents a significant design choice by recording the decision, context, alternatives considered, and rationale. Store ADRs in a structured log or .plans/decisions directory alongside your codebase to maintain traceability with implemented code.
Use inline comments for micro-decisions within modules, brief ADRs for module-level architectural choices, and full ADRs for system-wide decisions affecting multiple components or technology selection.
Yes. ADR documentation integrates with decision logs and templates, allowing you to capture rationale at decision-trigger moments—when selecting frameworks, evaluating security approaches, or planning major refactors—as part of your standard design process.
Record rejected alternatives and the reasoning behind each choice in your ADRs and decision logs. This documentation prevents revisiting the same trade-offs and preserves institutional knowledge about past evaluations.
racciolyDocument architectural decisions with ADRs to capture rationale and trade-offs.
emptistCreate, store, and reference Architectural Decision Records and technical documentation.
linuxfoundationRecord architectural decisions with context, decision, and consequences in docs/adr.
jfrometaGenerate ADR documentation and recommended patterns for architectural decisions.
