ADR 0002 ยท Shared generated rule matrix
Statusโ
Accepted
Contextโ
The README and preset overview page both communicate preset membership.
Maintaining separate renderers for that same information invites drift, inconsistent labels, and broken trust in docs.
Decisionโ
Use one generator as the source of truth for preset-matrix output and reuse it for both:
- the preset overview page
- the repository README rules section
Consequencesโ
Positiveโ
- less duplication
- fewer formatting drifts between surfaces
- tests can validate one generator instead of parallel hand-maintained output
Negativeโ
- generator changes need broader review because they affect multiple published surfaces at once