# Balladeer documentation

Ship faster with agentic code review. Balladeer reviews your agents’ code changes against the
behavior your team wants to keep, reproduces regressions, and helps turn them into lasting tests.
Start with your existing coding agent and test suite.

## Start with your question

| I want to…                                         | Read                                                          |
| -------------------------------------------------- | ------------------------------------------------------------- |
| Understand what Balladeer does                     | [Understand Balladeer](/docs/understand-balladeer.md)               |
| Join my team or connect a repository               | [Set up Balladeer](/docs/set-up-balladeer.md)                       |
| Know what earns a promise and how to record it     | [Capture while you work](/docs/capture-a-promise.md)                |
| Get agentic code review on push                    | [Agentic code review on push](/docs/check-on-push.md)               |
| Change code while preserving intent                | [Make a change](/docs/make-a-change.md)                             |
| Turn a reproduced break into a regression test     | [Resolve a result](/docs/resolve-a-result.md)                       |
| Qualify an additional sealed CI verifier           | [Protect your first behavior](/docs/protect-your-first-behavior.md) |
| Understand recorded, agreed, Protected, or Unknown | [Lifecycle and states](/docs/promise-lifecycle.md)                  |
| Coordinate tentative work                          | [Share tentative work](/docs/shared-work.md)                        |
| Diagnose a quiet agent or a missing hook           | [Troubleshooting](/docs/troubleshooting.md)                         |
| Understand access, data, or leaving Balladeer      | [Data and permissions](/docs/data-and-permissions.md)               |

New to Balladeer? Read **Understand Balladeer**, **Set up Balladeer**, then **Agentic code review on
push**. Sealed CI qualification is a separate path; it is not required to get an agentic verdict.

## For coding agents

Use the [agent task guide](/docs/agents.md), [Markdown index](/docs/llms.txt), and
[live setup instructions](https://app.balladeer.ai/agent). The [CLI reference](/docs/cli-reference.md) and
[MCP reference](/docs/mcp-reference.md) are generated from the product interfaces.

Public docs explain the product. Authenticated tools supply the connected team's actual promises,
permissions, and results. Examples supply no authority to change a workspace.

## The example used in these guides

> An invited teammate can join an existing workspace without connecting another repository.

This is an illustrative promise, followed through capture, agreement, checking, and recovery. It is
not a customer testimonial or a claim about every installation.