Conventions
Opinionated engineering conventions shared across every project in the portfolio. Humans read them here; the PR review agent fetches the raw markdown from GitHub. Same source of truth for both.
Clean code
Principles for code humans and AI agents can keep reading. Small functions, honest names, one level of abstraction, and the discipline to leave duplication alone until it earns its abstraction.
Documentation
Every app has a README, every tech decision has an ADR, every external dependency is documented, and stale docs are deleted on sight. Reading the code is not documentation.
Testing
Integration tests over unit tests with heavy mocks. Test behaviour, not lines. Mock the edges, not code you own. Flaky tests are bugs, not weather.
Git and pull requests
Small PRs, imperative commit messages that explain the why, one logical change per branch, squash on merge, and nothing destructive on shared history.