Skip to content

Contributing Overview

Agirunner is a multi-repo public project.

Use this split as your guide:

  • agirunner for product docs, roadmap, and top-level project guidance
  • agirunner-platform for the dashboard, API, and control plane
  • agirunner-runtime for the execution runtime
  • agirunner-playbooks for the shared community catalog of importable playbooks, specialists, and skills

For most outside contributors, the first step is picking the correct repository and the correct layer:

  • product docs and information architecture work usually belongs here in agirunner
  • operator UX, API, control-plane logic, and workflow records belong in agirunner-platform
  • execution behavior, tools, containers, workspace handling, and runtime observability belong in agirunner-runtime
  • curated catalog content and playbook-authoring guidance belong in agirunner-playbooks

Both first-time and experienced contributors are useful here.

Examples:

  • clarify docs or fix broken guidance
  • tighten configuration examples
  • improve tests around supported behavior
  • improve control-plane contracts in platform
  • improve execution boundaries or tooling in runtime