Skip to main content
Run a Yellowhammer Rehearsal Night to exercise setup, board updates, Worktrees, and reporting before scheduling real work.

​
Before you begin

Complete Project setup. A rehearsal uses a separate Linear project and a separate Journal. Board writes and Worktree operations are real. It never dispatches an agent CLI, pushes code, or opens a pull request. In the Project’s TOML file under ~/.config/yellowhammer/projects/, declare the rehearsal Linear project as rehearsal_project in the existing [board.linear] section, and declare the rehearsal Journal in [rehearsal]. The following values are illustrative; replace the Linear project id and path for your Mac:
The rehearsal project must differ from the real Linear project. The Journal must resolve to an absolute path outside the real Journals directory and must differ from the real Journal. A relative path does not qualify. Keep the rehearsal board in the workspace reached through this Project’s Board Connection.

​
Run the rehearsal

  1. Open Settings, choose the Project, and select Recalibrate.
  2. In Rehearsal Night, choose Run a Rehearsal Night….
  3. Read the confirmation and choose Run Rehearsal Night. The engine runs author, build, and land in that order; it keeps running if you quit the app.
  4. Use Show Log after launch to inspect the output. Review the Night Card and Summary in the rehearsal Linear project.
With the command-line tool installed, the equivalent invocation for the illustrative Project id is:

​
Confirm it worked

Inspect the rehearsal log and the rehearsal board’s Night records. Resolve reported configuration or board failures before real scheduling. A successful rehearsal exercises coordination and reporting; it cannot establish that a real agent will implement the Feature, that its Check will pass, or that publication will succeed.

​
Common problems

If the button is unavailable, read the reason beside it. Missing rehearsal_project, a reused real Linear project, a missing Journal declaration, or a Journal among the real Journals are refused before any Act writes. Correct the named declaration and refresh the Project settings. If a rehearsal stops later, preserve its log and review the failed Act and linked Linear records. Use setup diagnostics to repair the underlying connection or repository problem.

​
Next steps

Configure the schedule · The lifecycle of a Night