Concepts

This section explains the ideas behind pi-stack-ops. Read it when you want to understand why the workflow is shaped around specs, slices, local state, and human checkpoints.

Core ideas

The package uses a small set of concepts to keep AI-assisted stacked work reviewable.

• Stack Ops methodology explains the end-to-end workflow.
• Stacks and slices explains how large work becomes smaller pull requests.
• Specs, ADRs, and plans explains durable and disposable artifacts.
• Agents and roles explains how focused subagents support the workflow.
• State and artifacts explains what lives under .pi/stack-ops/.

Next steps

After you understand the concepts, follow the Quickstart or browse How-to guides.