breadcrumb-the-shire/docs/reference-agents-overview.md

Agent Workflow Overview

Letzte Aktualisierung: 2026-03-09

This project uses a multi-role workflow for issue and feature delivery.

Roles:

• Planner
• Executor
• Reviewer (guards and best practices)
• Reviewer (feature acceptance)
• Finalizer

Primary goals:

• predictable handovers
• strict quality gates
• fast retry loop from reviewers back to executor
• explicit guard and gate IDs (GR-*, QG-*) across all roles

Source of truth:

• guardrails and planning standards in tools/codex-skills/
• contracts and templates in agent-system/
• guard catalog: agent-system/checks/guard-catalog.json
• quality gates: agent-system/checks/quality-gates.json

Entry points:

• roles: /docs/reference-agents-roles.md
• workflow: /docs/reference-agents-flow.md
• schemas and prompts: agent-system/