Engineering handbook

The workflows, standards and defaults humans and coding agents use to design, build and review software.

Use this handbook by task. Follow a how-to guide while doing the work, open a standard when you need the rule, and read the rationale when you need to understand or challenge it.

Choose the task in front of you

Goal	Start here
Start a client project	Write the brief
Structure a project's documentation	Document a project
Design a system from the brief	Follow the design method
Establish the entities and use cases	Model the domain
Write one module's normative product rules	Write the module reference
Turn accepted rules into delivery	Plan delivery
Review an existing design	Run the red-flag review

Browse every how-to guide

Find the rule

Need	Open
Working contract, evidence, reporting, secrets or Git	Start here
Architecture and dependency direction	Engineering standards
Technology selection and stack defaults	Stack choices
Artefact ownership, tools or terminology	Reference
Reasons, boundaries and trade-offs	Rationale

Coding agents

Start at /llms.txt, then load only the pages selected by the repository and task. Do not load the complete handbook unless the index is insufficient.

This handbook is a cross-project strong prior. A direct instruction, the repository's own instructions and the running code outrank it; the full order is defined in How to read this.