archon

Execute Archon workflows in isolated git worktrees with background execution.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/jrmatherly/spacebot --skill archon-jrmatherly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archon
Source: https://github.com/jrmatherly/spacebot/tree/main/.claude/skills/archon
Command: npx skills add https://github.com/jrmatherly/spacebot --skill archon-jrmatherly

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Archon lets teams and individuals run AI-driven development workflows reliably without polluting the main checkout, enabling parallel work in isolated git worktrees and preventing context/noise bleed across sessions.

Core Features & Use Cases

  • Manage and execute Archon workflows in background worktrees to run long-running AI tasks without blocking the shell or main branch.
  • Author and validate workflow YAML and command Markdown files, including node types (command, prompt, bash, loop), retry policies, and structured outputs.
  • Configure and initialize repository-level Archon settings (.archon/), set up MCP/skills hooks for Claude, and use interactive workflows for human-in-the-loop approvals and guided PRDs.
  • Use cases: fix multiple GitHub issues in parallel, run interactive PR reviews, implement feature plans via loop nodes, and automate PR creation from workflow artifacts.

Quick Start

Ask Archon to run a workflow in an isolated worktree in the background by requesting something like "Use archon to fix issue #42" and the system will create a branch worktree, run the appropriate workflow, and report progress.

Frequently Asked Questions about archon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run AI workflows in isolated git worktrees without blocking my main branch?

AI workflows run in isolated git worktrees by executing tasks in the background via branch isolation, preventing context bleed and keeping your main checkout clean. You can author workflow YAML files to define command, prompt, bash, and loop nodes for automated execution.

What is the best way to automate fixing multiple GitHub issues in parallel using AI?

Automating parallel GitHub issue fixes is handled by running isolated AI workflows in background git worktrees. This allows multiple tasks to execute simultaneously without blocking your shell or creating branch conflicts.

How do I author and validate command files for human-in-the-loop AI workflows?

Authoring command files involves writing Markdown and workflow YAML that define node types like command, prompt, bash, and loop. You configure retry policies, structured outputs, and interactive relay protocols to manage human-in-the-loop approvals.

Does this workflow automation tool support integration with Claude and MCP hooks?

Yes, the workflow automation supports integration with Claude and MCP hooks. You can configure repository-level settings, set up skills hooks, and use interactive workflows to guide PRDs and automate PR creation from workflow artifacts.

Can I execute long-running development tasks in the background while continuing other work?

You can execute long-running development tasks in the background by running workflows in isolated worktrees. This prevents tasks from blocking your shell, allowing you to continue other work while the workflow reports progress upon completion.