Archon
The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.
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.
How to Implement Loop Nodes in Archon to Iterate Until Completion Signals Are ReceivedLearn how to implement Archon loop nodes to repeatedly execute AI prompts until completion signals are received. Streamline your workflows efficiently.
What Is the Archon Isolation Resolver and How Does It Manage 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.
How GitHub Webhook Signature Verification Works in ArchonLearn how Archon verifies GitHub webhook signatures using HMAC-SHA-256 digest and constant-time comparison for secure incoming requests.
How to Create Custom Platform Adapters for Archon: A Complete Implementation GuideLearn 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.
How to Customize MCP Server Configuration per Workflow Node in ArchonCustomize 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.
Archon Workflow Router Name Resolution and Fallback Logic ExplainedUnderstand Archon workflow router name resolution and its four-tier fallback logic: exact match, case-insensitive, suffix, and substring. Learn how Archon finds your workflows.
How the Archon Cleanup Service Manages Old Workflow Runs and Associated WorktreesLearn 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.
How to Define and Use Retry Logic in Archon Workflow NodesLearn 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.
Per-Node SDK Callbacks in Archon Workflows: Complete Hook ReferenceExplore 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.
How the Archon Port Allocation System for Worktree Servers Enables Deterministic Multi-Instance DevelopmentLearn 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.
Archon Prompt Builder Architecture for AI Assistant InteractionsExplore Archon's prompt builder architecture. Discover how it creates deterministic system prompts using project metadata, workflow definitions, and routing rules via modular formatters.
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:
curl -s "https://instagit.com/install.md" 
Maintain an open-source project? Get it listed too →