Instruction file imported from MarkZither/bookstack-mcp-server-dotnet (
.github/instructions/adrs.instructions.md). Copyright stays with the author.
ADR Instructions
applyTo
docs/architecture/decisions/*.md
Rules for Architecture Decision Records
- Use the template at
docs/architecture/decisions/ADR-TEMPLATE.mdfor every new ADR. - File naming:
ADR-NNNN-short-title.mdwith zero-padded four-digit number (e.g.,ADR-0001-use-dotnet10.md). - Status values:
Proposed→Accepted→Deprecated/Superseded by ADR-NNNN. - Never delete an ADR; mark it
DeprecatedorSupersededinstead. - Context section: describe the problem without a preferred solution.
- Decision section: state the decision clearly in active voice ("We will use…").
- Consequences section: list both positive and negative consequences honestly.
- Link related ADRs using relative Markdown links.
- Consult existing ADRs before creating a new one to avoid duplicates.