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.

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 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.
• 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.
• HiLL Checkpoints - Human-in-the-Loop Lifecycle configuration and approval behavior.
• Artifacts - What lives in state.md, discovery.md, plan.md, implementation.md, and related files.
• 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 Analysis - Repo-wide PR comment collection and triage workflows.