principal-workflow

Workflow orchestration coordinates multi-phase automation from kickoff through task generation, dispatch, result checking, and PR review. Start with `awkit kickoff`, then follow the main loop to route tasks via NEXT_ACTION, execute them through dispatch_worker, and automatically trigger PR review on completion.

Contract-driven routing validates required fields and task structure before dispatch using analyze_next.sh. It enforces a standardized contract—ensuring tasks meet specifications—and returns to the main loop on violations, preventing malformed tasks from reaching execution.

Yes, the workflow integrates GitHub PR review as a final governance phase. After task execution completes, review_pr automatically processes pull requests, enabling end-to-end automation from code generation through merge within Claude Code environments.

Loop safety limits enforce a maximum iteration count before the workflow returns to the main loop or halts. This prevents infinite loops during task generation and execution, ensuring the orchestration terminates cleanly even if dispatch or check phases cycle unexpectedly.

The main loop loads phase instructions, validates task contracts, and waits for NEXT_ACTION routing decisions. Advance NEXT_ACTION after each phase completes—kickoff loads initial tasks, dispatch_worker executes them, check_result verifies outcomes, and review_pr handles merge logic.

The workflow runs standalone with no external dependencies listed. It operates entirely within Claude Code and AWK environments, using built-in phase scripts (analyze_next.sh, dispatch_worker.sh) and standardized logging for orchestration across automation phases.