generated from coulomb/repo-seed
24 lines
630 B
Markdown
24 lines
630 B
Markdown
---
|
|
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.
|