Agentic Workflows Book

A living book about agentic workflows, agent orchestration, and agentic scaffolding

View the Project on GitHub arivero/agentbook

Agentic Workflow Playbook for Agentbook

This playbook defines the active GH-AW issue-management lifecycle used in this repository.

Canonical Issue Lifecycle

[opened] -> acknowledged -> triaged-fast-track
                         \-> triaged-for-research -> researched-waiting-opinions
                             -> opinion-copilot-strategy-posted + opinion-copilot-delivery-posted -> assigned -> closed

At any stage, any agent may reject by explaining the reason, adding rejected, and closing the issue.

Active workflow matrix

Stage Trigger Workflow file Labels in Labels out Result
Intake + triage issues.opened .github/workflows/issue-intake-triage.lock.yml (none) acknowledged + route label Issue acknowledged and routed
Fast-track delivery issues.labeled .github/workflows/issue-fast-track-close.lock.yml triaged-fast-track (optional rejected) PR opened and issue closed
Research pass issues.labeled .github/workflows/issue-research-pass.lock.yml triaged-for-research researched-waiting-opinions Research comment posted
Opinion A (Copilot strategy model) issues.labeled .github/workflows/issue-opinion-copilot-strategy.lock.yml researched-waiting-opinions opinion-copilot-strategy-posted Copilot strategy perspective comment posted
Opinion B (Copilot delivery model) issues.labeled .github/workflows/issue-opinion-copilot-delivery.lock.yml researched-waiting-opinions opinion-copilot-delivery-posted Copilot delivery perspective comment posted
Assignment + close issues.labeled .github/workflows/issue-assignment-close.lock.yml opinion-copilot-strategy-posted or opinion-copilot-delivery-posted assigned Closes only when both opinion labels exist

Routing rules

Source of truth and compilation rule

Workflow source files are maintained in .github/workflows/*.md and must be compiled to .lock.yml with gh aw commands.

When a workflow source file changes:

  1. Re-compile to the matching .lock.yml.
  2. Commit source and lock file together.
  3. Keep this matrix updated in the same PR.