Architecture

Architecture

System Overview

autopilot-core is the org-level control plane for the CI Autopilot system.

Workflows

Workflow	Runner	Schedule	Purpose
ci.yml	ubuntu-latest	push/PR	Portfolio CI - YAML validation
autopilot-operator.yml	self-hosted Windows	every 10 min + dispatch	Core fix operator
autopilot-org-installer.yml	self-hosted	hourly + dispatch	Org-wide workflow installer
autopilot-create-issue.yml	ubuntu-latest	workflow_run failure	Intake issue creator
autopilot-docs-daily.yml	ubuntu-latest	daily	Dashboard status update

Issue Lifecycle

CI Failure -> autofix+queued issue created -> operator scans -> Codex invoked -> fix PR opened -> merged/reviewed

Data Flow

1. autopilot-create-issue.yml watches for workflow_run events with conclusion: failure in opted-in repos.
2. On failure, it creates or updates a GitHub issue with labels autofix and queued.
3. autopilot-operator.yml runs on schedule, fetching all open autofix+queued issues via gh issue list.
4. For each issue, it invokes Codex with the issue body as context.
5. Codex outputs a fix which is committed and pushed as a PR branch.
6. A pull request is opened in the target repo for review or auto-merge.

Safety model

Label	Effect
autofix + queued	Eligible for automated fix
risky	Operator skips - needs human review
needs-design	Operator skips - architectural decision required
in-progress	Operator skips - already being worked