Start here: root README for the project overview and quick start.
Deep-dive guides, grouped by audience.
- Getting Started — full walkthrough from install to running a pipeline, using the dashboard, and working with approval gates.
- Testing Guide — dry-runs without an API key, real pipeline runs, troubleshooting.
- Architecture — domain model, ports & adapters, artifact flow, how the control plane drives the execution plane.
- Pipeline Execution Flows — sequence diagrams for pipeline start, agent execution, gate actions, artifact chaining, and resume.
- Platform Architecture — distributed scheduling, recovery, reconciliation, rate limiting, worker nodes.
- Multi-Provider Execution — routing agents to Anthropic, OpenAI, Gemini, or Ollama; executor vs provider.
- Templates — catalog of bundled pipeline templates (
simple-sdlc,api-builder,code-review,content-generation,data-pipeline,seo-review) with use-case guidance. - pi-coding-agent Extensions — adding custom tools and lifecycle hooks to coding agents.
See CONTRIBUTING.md at the repo root for development setup, commit conventions, and the PR workflow.