Galley Documentation
July 19, 2026 ยท View on GitHub
Start with the main README to install Galley and set up a repository with the Galley skill. The documents here explain how to configure, operate, and troubleshoot the resulting workflow.
The Workflow
- Use the Galley skill to inspect the repository and create its quality and environment profiles.
- Ask the skill to draft a task, then review its acceptance criteria, scope, executor settings, and loop budget.
- Queue the approved task. The daemon runs the executor in an isolated worktree.
- A separately configured supervisor reviews acceptance criteria first, then repository quality policy. Verified passes carry forward so later attempts can focus on unresolved work and regression risks.
- Accepted work is either left in the local worktree or committed and opened as a pull request, depending on the environment profile.
Documentation Map
| Goal | Read |
|---|---|
| Choose an executor or supervisor, set model and effort, or understand retries | Models and supervision |
| Review or hand-write a task file | Task YAML reference |
Understand or tune quality.yaml and environment.yaml | Profiles |
| Start and stop the daemon, inspect the queue, or configure notifications | Operations |
| Understand a failed or stalled task and resume it safely | Troubleshooting |
| Configure pull requests, comment requeues, and cleanup | PR automation |
| Understand security and trust boundaries | Security policy |
| Build, test, or contribute to Galley | Contributing |
Configuration Files
Galley keeps settings at the scope where they apply:
| File | Scope | Contains |
|---|---|---|
| Task YAML | One task | Goal, acceptance criteria, implementation scope, executor overrides, attempt budget, and worktree |
quality.yaml | One repository | Required checks, review dimensions, evidence expectations, and pass policy |
environment.yaml | One repository | Executor and supervisor defaults, commands, constraints, PR behavior, and worktree cleanup |
daemon.yaml | One Galley daemon | Concurrency, polling, timeouts, daemon-level supervisor default, provider credentials, and notifications |
The Galley skill is the recommended way to create task and profile files. The reference documents describe the resulting contracts for review, manual adjustment, and troubleshooting.