Start here if you want the public docs for stack.
If you are starting a clean stack and want the normal branch-by-branch flow:
- read usage.md
If you already have a PR pile and want one explicit landing PR:
- read landing-workflow.md
If you first need to make an existing PR graph explicit before either path:
- install.md for Homebrew, release artifacts, and source builds
- usage.md for the standard stacked-PR loop
- landing-workflow.md for landing-branch composition, verification, superseded PRs, queue handoff, and closeout
- adopting-existing-prs.md for turning an existing PR set into an explicit graph
- how-it-works.md for the core model and workflow shape
- troubleshooting.md for repair paths when state drifts
- cli/stack.md for generated command reference
- testing.md for unit, fixture, and live sandbox verification
- releasing.md for release automation and Homebrew publishing
- demo/README.md if you need to regenerate the README demos
- landing-workflow-followups.md for the historical feature request that drove the landing-orchestration work