# Archon | Cole Medin | Knowledge Base | Instagit

The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.

GitHub Stars: 14.7k

Repository: https://github.com/coleam00/Archon

---

## Articles

### [Archon Error Classification System for Isolation Operations](/coleam00/Archon/archon-error-classification-system-isolation-operations)

Explore Archon's error classification system for isolation operations. Learn how infrastructure errors are handled, converted to user-friendly messages, or escalated for efficient debugging.

- Tags: internals
- Published: 2026-04-10

### [How to Implement Loop Nodes in Archon to Iterate Until Completion Signals Are Received](/coleam00/Archon/how-implement-loop-nodes-iterate-completion-signals-archon)

Learn how to implement Archon loop nodes to repeatedly execute AI prompts until completion signals are received. Streamline your workflows efficiently.

- Tags: how-to-guide
- Published: 2026-04-10

### [What Is the Archon Isolation Resolver and How Does It Manage Environment Requests?](/coleam00/Archon/what-archon-isolation-resolver-manages-environment-requests)

Discover the Archon isolation resolver, a deterministic engine managing environment requests by assigning workflows to Git worktrees. Learn its efficient reuse strategy and fallback creation process.

- Tags: how-to-guide
- Published: 2026-04-10

### [How GitHub Webhook Signature Verification Works in Archon](/coleam00/Archon/how-github-webhook-signature-verification-works-archon)

Learn how Archon verifies GitHub webhook signatures using HMAC-SHA-256 digest and constant-time comparison for secure incoming requests.

- Tags: how-to-guide
- Published: 2026-04-10

### [How to Create Custom Platform Adapters for Archon: A Complete Implementation Guide](/coleam00/Archon/process-for-creating-custom-platform-adapters-archon)

Learn to create custom platform adapters for Archon by implementing the IPlatformAdapter interface and wiring it into the server. This guide details the full implementation process.

- Tags: how-to-guide
- Published: 2026-04-10

### [How to Customize MCP Server Configuration per Workflow Node in Archon](/coleam00/Archon/how-configure-mcp-server-config-files-per-workflow-node-archon)

Customize MCP server settings per workflow node in Archon. Inject unique configurations into Claude SDK instances by defining an optional mcp field in your workflow node.

- Tags: how-to-guide
- Published: 2026-04-10

### [Archon Workflow Router Name Resolution and Fallback Logic Explained](/coleam00/Archon/what-archon-workflow-router-name-resolution-fallback-logic)

Understand Archon workflow router name resolution and its four-tier fallback logic: exact match, case-insensitive, suffix, and substring. Learn how Archon finds your workflows.

- Tags: deep-dive
- Published: 2026-04-10

### [How the Archon Cleanup Service Manages Old Workflow Runs and Associated Worktrees](/coleam00/Archon/how-archon-cleanup-service-handles-old-workflow-runs-worktrees)

Learn how the Archon cleanup service automatically manages old workflow runs and worktrees, reclaiming disk space while preserving active sessions. Manual purge commands are also available.

- Tags: how-to-guide
- Published: 2026-04-10

### [How to Define and Use Retry Logic in Archon Workflow Nodes](/coleam00/Archon/how-define-use-retry-logic-archon-workflow-nodes)

Learn how to define and use retry logic in Archon workflow nodes for automatic re-execution with exponential backoff on transient errors and immediate failure on fatal errors.

- Tags: how-to-guide
- Published: 2026-04-10

### [Per-Node SDK Callbacks in Archon Workflows: Complete Hook Reference](/coleam00/Archon/what-hooks-available-per-node-sdk-callbacks-archon-workflows)

Explore 21 per-node SDK callback hooks in Archon workflows like PreToolUse and SessionStart. Intercept Claude Agent SDK events with regex matchers & static JSON responses for powerful control.

- Tags: api-reference
- Published: 2026-04-10

### [How the Archon Port Allocation System for Worktree Servers Enables Deterministic Multi-Instance Development](/coleam00/Archon/how-archon-port-allocation-system-works-worktree-servers)

Learn how Archon deterministically allocates TCP ports for worktree servers using MD5 hashing. Discover unique ports in the 3190-4089 range for reliable multi-instance development.

- Tags: internals
- Published: 2026-04-10

### [Archon Prompt Builder Architecture for AI Assistant Interactions](/coleam00/Archon/what-is-prompt-builder-architecture-ai-assistant-interactions)

Explore Archon's prompt builder architecture. Discover how it creates deterministic system prompts using project metadata, workflow definitions, and routing rules via modular formatters.

- Tags: architecture
- Published: 2026-04-10

### [How the Archon Conversation Lock Manager Prevents Concurrent Message Processing](/coleam00/Archon/how-archon-conversation-lock-manager-prevents-concurrent-messages)

The Archon conversation lock manager uses per-conversation semaphores to prevent concurrent message processing, allowing one handler per conversation while enabling parallel processing across multiple conversations.

- Tags: internals
- Published: 2026-04-10

### [Archon Slash Commands: Complete Reference for the Command Handler](/coleam00/Archon/what-slash-commands-are-available-in-archon-command-handler)

Explore Archon slash commands with this complete reference. Learn about help status commands reset worktree workflow and init for efficient command handling without AI.

- Tags: api-reference
- Published: 2026-04-10

### [How the Archon Workflow Event Emitter Tracks Step-by-Step Execution](/coleam00/Archon/how-archon-workflow-event-emitter-tracks-step-by-step-execution)

Discover how the Archon workflow event emitter tracks step-by-step execution with typed events like workflow_started and node_started. Understand execution phases without blocking the main thread.

- Tags: internals
- Published: 2026-04-10

### [How the Archon Env-Leak Scanner Detects Sensitive Variables in .env Files](/coleam00/Archon/how-archon-env-leak-scanner-detects-sensitive-variables-env-files)

Discover how the Archon env-leak scanner identifies sensitive variables in .env files. This utility parses key-value pairs, flagging exposed API keys and other secrets to enhance your security.

- Tags: how-to-guide
- Published: 2026-04-10

### [Archon Session State Machine: How It Manages AI-Assistant Lifecycle Transitions](/coleam00/Archon/what-is-archon-session-state-machine-handles-transitions)

Explore the Archon session state machine to understand how it deterministically manages AI-assistant lifecycle transitions like creation, deactivation, and preservation with type safety. Learn more.

- Tags: internals
- Published: 2026-04-10

### [How to Implement Approval Gates with Human Review in Archon Workflows](/coleam00/Archon/how-to-implement-approval-gates-human-review-archon-workflows)

Learn how to implement approval gates with human review in Archon workflows. Pause execution, get reviewed, and approve or reject via CLI commands for seamless process control.

- Tags: how-to-guide
- Published: 2026-04-10

### [How Archon Implements the Platform Adapter Pattern for Slack, Telegram, and Discord](/coleam00/Archon/how-platform-adapter-pattern-works-for-slack-telegram-discord)

Discover how Archon leverages the platform adapter pattern to seamlessly integrate Slack, Telegram, and Discord. Learn about unified message schemas and type-safe adapters.

- Tags: architecture
- Published: 2026-04-10

### [Archon Database Schema: Unified Design for SQLite and PostgreSQL Integrations](/coleam00/Archon/what-database-schema-does-archon-use-for-sqlite-postgresql)

Discover Archon's unified database schema for seamless SQLite and PostgreSQL integrations. Learn about its flexible design and migration management.

- Tags: architecture
- Published: 2026-04-10

### [How Archon's Worktree Isolation Provider Creates and Manages Git Worktrees](/coleam00/Archon/how-archon-worktree-isolation-provider-creates-manages-git-worktrees)

Learn how Archon's worktree isolation provider deterministically names branches, creates git worktrees for workflow execution, and manages their lifecycle via the WorktreeProvider class in its TypeScript package.

- Tags: how-to-guide
- Published: 2026-04-10

### [How Claude and Codex Models Are Configured for Validation in Archon Workflows](/coleam00/Archon/how-to-configure-claude-codex-model-validation-in-archon-workflows)

Discover how Archon configures Claude and Codex models for validation using a three-tiered system with utility helpers, Zod schemas, and workflow checks. Ensure robust model integration.

- Tags: how-to-guide
- Published: 2026-04-10

### [Archon Workflows Variable Substitution Syntax: Complete Reference Guide](/coleam00/Archon/what-is-archon-workflow-variable-substitution-syntax)

Master Archon workflows variable substitution syntax for flexible prompts. Learn `$1` through `$9`, `$ARGUMENTS`, `$WORKFLOW_ID`, and more for dynamic runtime context.

- Tags: api-reference
- Published: 2026-04-10

### [How the Archon Workflow DAG Executor Handles Concurrent Node Execution](/coleam00/Archon/how-archon-workflow-dag-executor-handles-concurrent-node-execution)

Discover how Archon's DAG executor achieves concurrent node execution. Learn how it uses Promise.allSettled with topological layers to maximize throughput while respecting dependencies.

- Tags: internals
- Published: 2026-04-10