Workflow & Projects

Use this section when you want the detailed lifecycle and artifact model behind tracked OAT projects.

Projects are where the workflow layer becomes concrete: lifecycle phases, state.md, plan.md, review gates, PR flow, and repository-analysis helpers all live here.

Contents

• Lifecycle - End-to-end flow from discovery through completion.
• Design Modes - How full design balances collaborative, selective collaborative, and draft-and-review interaction.
• HiLL Checkpoints - Human-in-the-Loop Lifecycle configuration and approval behavior.
• Dispatch Policy - Managed capped tiers, managed Uncapped, Inherit Host Defaults, and provider-specific enforcement.
• Orchestration Model - The layered dispatch model: roles, selection flow, and per-harness topology.
• Review Flavors - The four review flavors and who resolves each one's target.
• Evidence Layers - The three-layer dispatch evidence model behind records and smoke verification.
• Programmatic Execution - Per-harness headless/CLI execution surfaces and where OAT uses them.
• Project Artifacts - What lives in state.md, discovery.md, plan.md, implementation.md, and related files.
• Implementation Execution - Phase dispatch, runtime selection, review/fix loop, and dry-run behavior.
• Project Splitting - How broad discoveries or brainstorms become coordination parents and child projects.
• State Machine - Lifecycle and review status transitions across a project.
• Reviews - How review request/receive loops work inside OAT projects.
• PR Flow - Progress and final PR generation expectations.
• Repository PR Comment Analysis - Repo-wide PR comment collection and triage workflows.

What This Section Is

This sub-section is the deep technical surface for how tracked OAT projects execute and how their artifacts, reviews, and PR states fit together.

Start Here

• Start with Lifecycle for the end-to-end flow.
• Read Artifacts once you need the file contract behind project execution.
• Use Project Splitting when one discovery or brainstorm should become coordinated child projects.
• Use HiLL Checkpoints when you want to understand pause/approval behavior.

Common Tasks

• Understand lifecycle order and alternate lanes in Lifecycle.
• Learn the artifact system of record in Artifacts.
• Split broad scopes into coordination parents and focused children in Project Splitting.
• Understand lifecycle and review transitions in State Machine.
• Learn review and PR expectations in Reviews and PR Flow.

Go Deeper

• Lifecycle - End-to-end flow from discovery through completion.
• Design Modes - How full design balances collaborative, selective collaborative, and draft-and-review interaction.
• HiLL Checkpoints - Human-in-the-Loop Lifecycle configuration and approval behavior.
• Dispatch Policy - Managed capped tiers, managed Uncapped, Inherit Host Defaults, legacy dispatch-ceiling compatibility, and provider-specific enforcement.
• Orchestration Model - The layered dispatch model: roles, selection flow, and per-harness topology.
• Review Flavors - The four review flavors and who resolves each one's target.
• Evidence Layers - The three-layer dispatch evidence model behind records and smoke verification.
• Programmatic Execution - Per-harness headless/CLI execution surfaces and where OAT uses them.
• Artifacts - What lives in state.md, discovery.md, plan.md, implementation.md, and related files.
• Project Splitting - How broad discoveries or brainstorms become coordination parents and child projects.
• State Machine - Lifecycle and review status transitions across a project.
• Reviews - How review request/receive loops work inside OAT projects.
• PR Flow - Progress and final PR generation expectations.
• Repository PR Comment Analysis - Repo-wide PR comment collection and triage workflows.