This directory contains shared conventions and formatting rules.
Conventions are normative agreements intended to be referenced from specs and skills.
Technology-specific conventions live under ../ergo/tech/.
ea-principles.md— EA principles as top-level review criteria.contracts.md— Contract and source-of-truth rules across surfaces.markdown.md— Documentation style rules.diagrams.md— Diagram conventions (Mermaid, structure, and notation).git.md— Git conventions for changes.code-hygiene.md— Universal rules to reduce duplication and dead complexity.