# Neutron Engineering Handbook

> How Neutron engineers build software with AI agents: the rules we hold, the workflow from ticket to release, and safeguards for costly mistakes.

Every page is available as markdown by adding .md to its path. Requirements have stable IDs (e.g. VAL-3); all of them, with risk and how each is enforced, are in /requirements.json. Chinese version: /zh/llms.txt.

## The basics

- [The rules](/index.md)
- [Develop with agents](/agent-development.md): Frame the problem. Let the agent investigate, recommend and prove the result.

## Start a project assignment

- [Start on a project](/new-project.md): Understand the part of the project your assignment touches.
- [Branching strategy](/branching-strategy.md): Know where to start, where to merge and what ships.

## Develop and review

- [Deliver a change](/deliver-a-change.md): Turn a Jira ticket into a tested change ready for review.
- [Code review](/code-review.md): Check the outcome, resolve findings and approve the change that will merge.

## Deploy and release

- [Release and close out](/release-mgmt.md): Whatever the client's process, ship the version you verified, know how to undo it, and leave the docs true.

## Operate and recover

- [Investigate and recover](/incidents.md): Find the evidence, stop the harm, and restore the affected flow and records.

## Engineering safeguards

- [Access, secrets and data](/security.md): Prevent unauthorized access, exposed data and changes to the wrong environment.
- [Database changes](/migrations.md): Keep old code working while the schema changes.
- [Money and rewards](/value-abuse.md): Prevent duplicate value, unbounded issuance and unexplained balances.
- [Jobs and external calls](/jobs.md): Keep work safe across crashes and retries, and call external services without hanging, flooding or repeating them.
- [SMS, OTP and paid endpoints](/otp.md): Stop abusive requests before they become a bill.
- [Security acceptance (SSAT)](/ssat.md): Check every SSAT item with evidence before go-live or a major release.

## Optional

- [Full text](/llms-full.txt)
- [Requirements](/requirements.json)