MCAF: ADR Writing

Trigger On

• a dependency, boundary, platform, contract, or data model is changing
• a design decision has meaningful trade-offs that should be recorded
• a repo-wide engineering policy needs a durable rationale

Value

• produce a concrete project delta: code, docs, config, tests, CI, or review artifact
• reduce ambiguity through explicit planning, verification, and final validation skills
• leave reusable project context so future tasks are faster and safer

Do Not Use For

• feature-level behaviour details without an architecture decision
• generic architecture overview content