BLOCKWERK
◢ CATALOG / solution architecture

ADR Author

PRO

Turn a decision into a clean, defensible record in minutes.

Generate and maintain Architecture Decision Records in MADR format, capturing context, decision drivers, options considered, the decision, and its consequences. Use when asked to record, document, or justify a technical or architectural decision or trade-off.

Ask for it in plain English, e.g.

“write an ADR”“document this decision”“capture this trade-off”“why did we choose”

Works in

AGENTS.mdClaudeGitHub CopilotCursorOllamaOpenAI GPTs
◢◢ EXAMPLE OUTPUT

You ask: We need to decide how internal services authenticate to our API gateway. Options on the table: mutual TLS, OIDC client-credentials via our existing identity provider, or static API keys. Drivers: public-sector security posture, we already run a central identity provider, and we want to minimise custom code. Write the ADR.

Example output from the ADR Author skill

Example output shown for illustration. Your assistant produces this live from your own request once the skill is installed.