Principles#
The ideas underneath how we work — with each other and with our agents. These are evergreen; everything else on this site refers back to them.
Principles are grouped by theme; each theme is its own page so an agent can load only the one it needs. Start here, then follow the theme that fits the task.
| Page | Description |
|---|---|
| Purpose and direction | Why we build, who we build for, and the least-privilege stance under every decision. |
| AI-first development | Agents as first-class participants, determinism before intelligence, and how humans and agents share the work. |
| Software design | SOLID, extensibility, smart defaults with local overrides, DRY with judgment, and making change easy before making the change. |
| Engineering practices | Write it down, everything as code, evergreen docs, test-driven development, and shift-left quality. |
| Planning and delivery | Roadmapping, lean delivery, and the loops that keep iteration fast. |
| References | The literature behind these principles. |
Why these principles matter#
These are the assumptions every agent decision rests on. When an agent's behaviour is unclear or contested, the answer comes from here. When something here turns out to be wrong, update this page — not just one agent.