Start here
Requirements
Check your Mac, services, and coding agents before setup.
Your first Night
Connect a Project, check readiness, and review its results.
How it fits together
Linear holds your Features, Work Cards, questions, and Night Summary. Orca ADE creates the Worktrees where your local agent CLIs work. GitHub holds the resulting pull requests. You make decisions in Linear and choose what to merge in GitHub. Each Project has its own repositories, specification source, schedule, and limits. A Night can progress through multiple Features as work finishes, subject to those limits. Work Cards for the same repository run in order; different repositories can advance independently.Planned relationship diagram
Yellowhammer product mapShow how a Project connects its specification, Linear, repositories, local agent CLIs, and the Night Summary.