deep-dive

Archon Workflow Router Name Resolution and Fallback Logic Explained

April 10, 2026 coleam00/Archon ↗

Archon resolves workflow names through a deterministic four‑tier fallback hierarchy—exact match, case‑insensitive match, suffix match, and substring match—implemented in packages/workflows/src/router.ts.

The coleam00/Archon repository implements a sophisticated routing layer that maps user‑provided workflow identifiers to actual workflow definitions. Understanding this workflow router name resolution and fallback logic is essential for developers extending the system or troubleshooting routing failures.

Four-Tier Fallback Hierarchy

The resolveWorkflowName function in packages/workflows/src/router.ts (lines 27‑

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:

curl -s "https://instagit.com/install.md"

Add to your MCP client configuration:

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}

Ask your agent:

"Use Instagit MCP to understand how coleam00/Archon works."

Works with

Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →