How-to guides

Pick the guide that matches the phase you are in. If you are blocked, start with stack-ops status, then read Handle blockers.

Phase	Task	Use when
Setup	Initialize a project	.pi/stack-ops/ does not exist or status is missing.
Decision	Draft a spec or ADR	You have an idea but no approved durable artifact.
Planning	Generate a plan	A spec or ADR is approved and implementation slices need definition.
Implementation	Implement a slice	You are ready to build exactly one approved slice.
Recovery	Resume work	A session ended, context changed, or state needs inspection.
Recovery	Handle blockers	Status, CI, review, or validation reports a blocker.
PR prep	Prepare PRs	Slice work is complete and PRs need bodies/readiness checks.
Validation	Validate a stack	You need evidence before review, iteration, or merge readiness.

Each guide is intentionally narrow. Use Your first stack for the tutorial flow.