Concepts
ASF50 has its own vocabulary. Most of these terms are defined directly in code (scripts/goal-runner/*.py). The pages below are the canonical mental model.
| Term | One-liner | See |
|---|---|---|
| Goal | A bounded unit of work, durable and Git-tracked. | Goals |
| Program | A long-running goal that orchestrates many IMPs. | Goals |
| Phase | Either a PHASE-XX program-roadmap phase or an IMP-XX execution phase. | Phases |
| Task | A declared unit of work inside a goal. | Goals |
| Run | A single dispatched attempt to complete a task. | Goals |
| Agent | A role-bound actor (Planner, Builder, Tester, Auditor, …). | Agents |
| Role | The named capability set a run is dispatched under. | Agents |
| Worktree | A detached Git working tree used to isolate dispatch. | Agents |
| Receipt | A durable artifact written when a task transitions. | Receipts |
| Evidence | Any file in evidence/<GOAL_ID>/ that proves an assertion. | Receipts |
| Runtime state | The SQLite-backed state owned by RuntimeStore. | State |
| Canonical state | The Git-tracked source of truth (contracts, evidence). | State |
| Human gate | A scoped owner decision required before a destructive step. | Human Gates |
| Owner authorization | The provenance channel for an approval. | Owner Authorization |
| Gate scope | What kind of decision a gate represents. | Human Gates |
| Gate source | Where the approval came from (GitHub, signed ticket, CLI). | Owner Authorization |
| Dispatch consumption | A gate is consumed by a run; consumption is recorded. | Human Gates |
| Production subject | The exact subject_sha a release is bound to. | Signed Tickets |
| Promotion | A signed-ticket-driven production authorization. | Signed Tickets |
| Signed ticket | An OpenSSH-signed authorization payload. | Signed Tickets |
| Deviation | A recorded non-blocking event that must be accounted for. | Deviations |
| Rollback | A governed undo of a release. | Playbooks → Rollback |
Continue with Goals.