---
document_type: adr
status: accepted
---

# Use Markdown Contracts

## Context

The problem is that plain heading counts do not explain whether content is
useful. Authors and agents need a contract that names the expected sections and
the job each section must do.

## Decision

We will use markdown-native document contracts with deterministic diagnostics as
the foundation for generation, validation, and later semantic assessment.

## Consequences

The tool can check author intent before generation or review work continues.
Future adapters can add form prefill and LLM rubrics without replacing the core
diagnostic model.