Choosing The Right Repo

Picking the right repo first prevents a lot of confusion.

Use agirunner

For:

• the top-level product Compose stack
• bootstrap .env.example and first-run setup
• the docs site
• roadmap and top-level project guidance
• product-level documentation and architecture narrative

Use agirunner-platform

For:

• dashboard UX
• platform API
• workflows, work items, approvals, and control-plane logic
• integrations and operator settings

Use agirunner-runtime

For:

• task execution loops
• workspace and container handling
• tools and MCP transport
• runtime security and observability

Use agirunner-playbooks

For:

• curated community playbooks, specialists, and skills
• catalog manifests and schema references
• playbook README authoring and import guidance
• shared authoring quality bar for reusable workflow content

Boundary Check

If a change depends on workflow meaning, it usually belongs in platform. If it depends on execution mechanics, it usually belongs in runtime.