# ampm docs

Pick the guide that matches what you're doing. Each one covers a single job, so you can load one page and leave the rest. Every page has a plain markdown copy at the same address with `.md` on the end. The links below go to those markdown copies.

## Guides

- [Concepts and board columns](https://ampm.dev/docs/concepts.md): Use this when you need to explain what someone sees on the board: what a column means and where a task goes next.
- [Glossary: on-screen names and agent names](https://ampm.dev/docs/glossary.md): Use this when you have a word from the screen and need the tool, field or key to use, or have a tool or key name and need the words the user sees.
- [Approvals](https://ampm.dev/docs/approvals.md): Use this when a task is waiting on someone and you need to know what each button on its approval card does.
- [Settings and Agent Access](https://ampm.dev/docs/settings.md): Use this when you want to change how a workspace behaves, or grant, reduce or revoke an outside agent's access.
- [Working with tasks](https://ampm.dev/docs/task-operations.md): Use this when you know what should happen to a task and need the clicks that do it.
- [Common questions](https://ampm.dev/docs/faqs.md): Use this when someone is puzzled by something ampm did, or didn't do, and wants the short answer.
- [Tell ampm's agents how your repository works](https://ampm.dev/docs/guidance-files.md): Use this when you want ampm's agents to follow your repository's rules for a role or a step, or need to know which .ampm/ file wins.
- [Give each step the sandbox it needs](https://ampm.dev/docs/sandbox-environment.md): Use this when a step needs a database, a browser or another system tool, or you are writing or fixing .ampm/environment.json.
- [Decide what a step's sandbox is missing](https://ampm.dev/docs/missing-environment.md): Use this when a step has reported something missing from its environment and you need to approve it, refuse it or set a variable.
- [Land pull requests that always collide one at a time](https://ampm.dev/docs/serializing-paths.md): Use this when two kinds of change in your repository always conflict, such as migration numbering, and you want them to land one at a time.
- [Choose what Autopilot trusts before it merges](https://ampm.dev/docs/landing-policy.md): Use this when you want to say which CI checks Autopilot may merge on, or which changed paths make a merge higher risk.
- [Customize ampm's agents from your repository](https://ampm.dev/docs/repo-customization.md): Use this when you followed a link to the older single-page guide, or want a map of every file a repository can add under .ampm/.
- [Connect an outside agent to your workspace](https://ampm.dev/docs/agent-access-connect.md): Use this when you want an agent outside ampm, such as a coding assistant in your own terminal, to read your workspace or act in it, or when its access has ended and you need to reconnect it.
- [How ampm decides what an agent may do](https://ampm.dev/docs/agent-access-permissions.md): Use this when you need to know why an agent was allowed or refused something: what a grant covers, which approvals stay with you, and how the Assistant, Autopilot and outside agents share the same rules.
- [Agent Access tools](https://ampm.dev/docs/agent-access-tools.md): Use this when your agent is calling ampm's tools: what each read returns, how to page through results, and what each action tool does, needs and refuses.
- [Approval categories an agent can be granted](https://ampm.dev/docs/agent-access-approvals.md): Use this when you're choosing which approvals an agent may answer, or your agent is answering one: what each category allows, what needs a second category, and what stays with you.