Create concise Architecture Decision Records (ADRs) using Backlog.md that fit on one DIN A4 page
This skill explains how to create concise Architecture Decision Records (ADRs) using the Backlog.md system (MCP server). Every ADR must fit on one DIN A4 page when printed.
Keep headings short. Use the exact order below to maximize readability and fit on one page.
Title: ADR-XXX - <short-descriptive-title>
Status: <Accepted|Proposed|Rejected|Deprecated>
Date: <YYYY-MM-DD>
Context:
Decision:
Consequences:
Alternatives Considered:
Authors:
References:
If using the MCP server API (programmatic / agent): call the document-create endpoint with the ADR content as the document body. Example payload concept (pseudo-JSON):
{ "title": "<short-descriptive-title>", "content": "---\nTitle: <title>\nStatus: <status>\nDate: <date>\n\nContext:\n- ...\n\nDecision:\n- ...\n\nConsequences:\n- ...\n\nAlternatives Considered:\n- ...\n\nAuthors:\n- ...\n\nReferences:\n- ...\n" }
End.