Guides
How-to guides for building and running AI coding workflows with Archon.
Workflow Authoring
Section titled “Workflow Authoring”- Authoring Workflows — Create multi-step YAML workflows with DAG nodes, conditional branching, and parallel execution
- Authoring Commands — Write prompt templates that serve as building blocks for workflow nodes
Node Types
Section titled “Node Types”- Loop Nodes — Iterative AI execution with completion conditions and deterministic exit checks
- Approval Nodes — Human review gates with optional AI rework on rejection
Node Features (Claude only)
Section titled “Node Features (Claude only)”- Per-Node Hooks — Attach Claude SDK hooks for tool control, context injection, and input modification
- Per-Node MCP Servers — Connect external tools (GitHub, Postgres, etc.) to individual nodes
- Per-Node Skills — Preload specialized knowledge into node agents
Bundled Workflows
Section titled “Bundled Workflows”Archon ships with ready-to-use workflows that cover common coding tasks. You do not need to write any YAML to use these — just describe what you want and the router picks the right one.
| Workflow | What It Does |
|---|---|
archon-assist | General Q&A, debugging, exploration — the catch-all |
archon-fix-github-issue | Investigate, root cause, implement fix, validate, PR |
archon-smart-pr-review | Complexity-adaptive PR review |
archon-comprehensive-pr-review | Multi-agent PR review (5 parallel reviewers) |
archon-feature-development | Implement feature from plan, validate, create PR |
archon-create-issue | Investigate a problem and create a GitHub issue |
archon-validate-pr | Thorough PR validation testing |
archon-resolve-conflicts | Detect and resolve merge conflicts in PRs |
archon-remotion-generate | Generate or modify Remotion video compositions with AI |
archon-interactive-prd | Create a PRD through guided conversation |
archon-piv-loop | Guided Plan-Implement-Validate with human-in-the-loop |
archon-adversarial-dev | Build a complete application from scratch using adversarial development |
For the full list with descriptions, see the Available Workflows table in the Overview.
To customize any bundled workflow, copy it from .archon/workflows/defaults/ into your project’s .archon/workflows/ and modify it — same-named files override the defaults.
Advanced
Section titled “Advanced”- Global Workflows — User-level workflows that apply to every project
- Remotion Video Generation — End-to-end video creation with skills and bash render nodes