Ведение архитектурных решений (ADR)

★ 8.7 · documentation

documentation-and-adrs is a Claude Code skill that records architectural decisions and captures the context future engineers and agents need to understand the codebase. It is designed for moments when choosing between competing technical approaches, changing a public API, shipping user-facing features, or preserving reasoning that would otherwise be lost over time. The core artifact is an Architecture Decision Record (ADR): documents stored in `docs/decisions/` with sequential numbering, covering Context, Decision, Alternatives Considered, and Consequences, following the lifecycle PROPOSED → ACCEPTED → SUPERSEDED. Before generating a new ADR, the skill inspects the repository for existing conventions — directory, file format, numbering scheme, and section headings — and matches them rather than imposing its own template. Inline documentation guidance is also included, emphasizing comments that explain *why* rather than restating what the code already shows.