Governance
Process and quality rules for fairway development. All agents must read these before submitting changes.
| Document | Covers |
|---|---|
| coding-standards.md | Go style, package layout, error handling, naming, comments, SQL, CSS. |
| testing.md | Unit / integration / golden tests. Test DB strategy. Coverage expectations. |
| review-guards.md | Pre-merge checks, reviewer routing, verdict semantics, no-self-review rule. |
| commits.md | Subject format, body conventions, trailers, merge style. |
| release.md | Versioning, tags, changelog, goreleaser, distribution. |
Quick checklist before opening a PR
-
go test ./...passes. -
golangci-lint runis clean. - Tests cover the new behavior (see testing.md).
- Commit subjects follow commits.md.
- If schema or state machine changed: a design doc in
docs/design/is updated. - If public CLI / config surface changed:
docs/config-reference.mdordocs/design/cli.mdis updated. - Review routing per review-guards.md is correct.