# Customizing ampm's agents from your repo (`.ampm/`)

Any repository ampm works on can tune the agents that work on it, without touching ampm. Add files under `.ampm/` in the repository root, and the agents read them from the checked-out working tree. Each job has its own short page, listed below. This address stays as the hub, so older links keep working.

## Pages

- [Tell ampm's agents how your repository works](/docs/guidance-files) ([markdown](/docs/guidance-files.md)): use this when you want to add guidance for a role or a step in `.ampm/personas/` and `.ampm/steps/`.
- [Give each step the sandbox it needs](/docs/sandbox-environment) ([markdown](/docs/sandbox-environment.md)): use this when a step needs a database, a browser or another system tool, declared in `.ampm/environment.json`.
- [Decide what a step's sandbox is missing](/docs/missing-environment) ([markdown](/docs/missing-environment.md)): use this when a step has reported a missing tool, service or variable and you need to approve or refuse it.
- [Land pull requests that always collide one at a time](/docs/serializing-paths) ([markdown](/docs/serializing-paths.md)): use this when two kinds of change in your repository always conflict, declared in `.ampm/serializing-paths.json`.
- [Choose what Autopilot trusts before it merges](/docs/landing-policy) ([markdown](/docs/landing-policy.md)): use this when you want to name the checks that count as CI or the paths that make a merge riskier, in `.ampm/ci-evidence.json` and `.ampm/diff-risk.json`.

## Where each older section went

The older single-page guide had these sections. Each heading below links to the page and section that now holds that content.

### [Layout](/docs/guidance-files#layout)

### [Recognized names](/docs/guidance-files#role-and-step-names)

### [Precedence — who says what](/docs/guidance-files#how-your-files-combine-with-ampms-prompts)

### [What to put there](/docs/guidance-files#what-to-write)

### [Giving a phase its own sandbox (`.ampm/environment.json`)](/docs/sandbox-environment#write-the-file)

### [When a step's environment is missing something](/docs/missing-environment#what-you-are-asked)

### [Declaring PRs that always collide (`.ampm/serializing-paths.json`)](/docs/serializing-paths#declare-a-group)

### [You don't have to declare the migration-numbering case yourself](/docs/serializing-paths#collisions-ampm-finds-without-a-declaration)

### [ampm also learns from a conflict it already hit](/docs/serializing-paths#collisions-ampm-learns-from-a-past-conflict)

### [Landing policy files (`.ampm/ci-evidence.json`, `.ampm/diff-risk.json`)](/docs/landing-policy#where-ampm-reads-these-files)

### [Choosing which checks count as CI](/docs/landing-policy#choose-which-checks-count-as-ci)

### [Classifying changed paths (`.ampm/diff-risk.json`)](/docs/landing-policy#classify-changed-paths)

### [Limits and failure behavior](/docs/guidance-files#limits)