How mickbourgois/agentic-workflow works
agentic-workflow packages a risk-adaptive, one-card delivery process plus an idempotent installer/updater and a French presentation/documentation site. The primary path hardens a tracker card, runs isolated implementation and exact-head review/rework contexts, then ships through repository gates. The graph preserves the documented phases and capabilities; unsampled skills and adapters are represented by their exact directories, and their edges rely on README statements rather than inspected implementation.
Components 22
Delivery workflow
- Harden card
workflow/skills/harden-card - Phase skills
workflow/skills - Codex agents
workflow/agents/codex - Claude adapters
workflow/commands/claude
Orchestration runtime
- One-card runner
workflow/orchestrator/run-card.mjs - Backlog loop
workflow/orchestrator/backlog-loop.mjs - Start-card orchestration
workflow/orchestrator - Delivery state machine
workflow/orchestrator/delivery-state.mjs - Durable card state
Configuration and install
- Config loader
workflow/orchestrator/config.mjs - Defaults and routes
workflow/config/defaults.mjs - Installer and updater
scripts/agent-workflow.mjs
Presentation website
- Site server
website/server.mjs - Static site builder
website/build.mjs - Home page
website/home.mjs - Documentation pages
website/docs.mjs - Shared UI
website/ui.mjs
Other components
- Developer
- Linear tracker
- Git, PR and gates
- Tracker result
- Website visitor
Connections 26
- Developer → Harden card: hardens card
README.md - Harden card → Linear tracker: reads and routes
README.md - Harden card → One-card runner: starts delivery
README.md - Developer → One-card runner: runs one card
README.md - Backlog loop → One-card runner: runs selected cards
workflow/orchestrator/backlog-loop.mjs - Backlog loop → Linear tracker: selects eligible card
workflow/orchestrator/backlog-loop.mjs - One-card runner → Start-card orchestration: launches fresh process
workflow/orchestrator/run-card.mjs - Start-card orchestration → Config loader: loads project config
workflow/orchestrator/agent-workflow.mjs - Config loader → Defaults and routes: merges defaults
workflow/orchestrator/config.mjs - Start-card orchestration → Delivery state machine: reconciles durable state
workflow/orchestrator/agent-workflow.mjs - Delivery state machine → Durable card state: reads and writes
workflow/orchestrator/delivery-state.mjs - Start-card orchestration → Phase skills: dispatches phases
README.md - Phase skills → Codex agents: uses fresh agents
README.md - Phase skills → Claude adapters: adapts contracts
README.md - Phase skills → Git, PR and gates: implements reviews ships
README.md - Git, PR and gates → Tracker result: records delivery
README.md - Installer and updater → Phase skills: installs managed copies
README.md - Developer → Installer and updater: installs or updates
README.md - Website visitor → Site server: requests pages
website/server.mjs - Site server → Static site builder: builds site
website/server.mjs - Static site builder → Home page: renders home
website/build.mjs - Static site builder → Documentation pages: renders docs
website/build.mjs - Static site builder → Shared UI: uses shared UI
website/build.mjs - Home page → Shared UI: renders with
website/home.mjs - Documentation pages → Shared UI: renders with
website/docs.mjs - Documentation pages → Home page: reuses skill content
website/docs.mjs