arcforge
arcforge is a skill-based autonomous agent toolkit for Claude Code, Codex, Gemini CLI, and OpenCode. It moves orchestration into the session so agents follow disciplined workflows from design to implementation.
Why arcforge
AI coding agents are powerful but undisciplined. Left to their defaults, they skip design, ignore review, and lose context across sessions. The result is code that works in the moment but accumulates debt fast.
arcforge solves this by embedding a skill-based workflow directly into the agent's session. Skills trigger automatically based on context — the agent doesn't need to remember commands or follow a manual checklist. Design, planning, TDD, and review happen because the workflow enforces them.
The outcome: your agent behaves like a disciplined engineer. It designs before building, plans before coding, tests before shipping, and learns from every session.
How it works
When your coding agent starts a session, arcforge's hooks inject available skills into context. Instead of jumping into code, it activates skills that guide you through design, planning, and execution.
Once a design is approved, it builds a clear implementation plan and then executes tasks with a two-stage review (spec compliance, then code quality). For larger work, it can create parallel git worktrees so epics can run in isolation.
Because skills trigger automatically, you do not need to remember commands. The workflow is enforced by the skills themselves.
Installation
Note: Installation differs by platform. Claude Code has a built-in plugin system. Codex and OpenCode require manual setup.
Claude Code (Plugin Marketplace)
Register the marketplace:
/plugin marketplace add arcforge
Install the plugin:
/plugin install arcforge@arcforge
Verify Installation
Check that commands appear:
/help
# Should see:
# /arcforge:arc-brainstorming - Design exploration
# /arcforge:arc-writing-tasks - Break epics or features into executable tasks
# /arcforge:arc-executing-tasks - Execute tasks with checkpoints
Codex
Tell Codex:
Fetch and follow instructions from https://github.com/GregoryHo/arcforge/blob/master/.codex/INSTALL.md
Detailed docs: docs/README.codex.md
Gemini CLI
Tell Gemini CLI:
Fetch and follow instructions from https://github.com/GregoryHo/arcforge/blob/master/.gemini/INSTALL.md
Detailed docs: docs/README.gemini.md
OpenCode
Tell OpenCode:
Clone https://github.com/GregoryHo/arcforge to ~/.config/opencode/arcforge, then create directory ~/.config/opencode/plugin, then symlink ~/.config/opencode/arcforge/.opencode/plugin/arcforge.js to ~/.config/opencode/plugin/arcforge.js, then restart opencode.
Detailed docs: docs/README.opencode.md
Quick Start: Common Commands
These are the most frequently used commands:
| Command | Purpose | When to Use |
|---|---|---|
/arcforge:arc-brainstorming | Design exploration | When starting new work or clarifying requirements |
/arcforge:arc-writing-tasks | Break down into tasks | When you have a clear spec and need executable steps |
/arcforge:arc-executing-tasks | Run task list | When tasks are ready and you want to implement |
/arcforge:arc-journaling | Session journaling | At end of session to capture reflections |
/arcforge:arc-reflecting | Analyze patterns | After 5+ journal entries to summarize learnings |
How Skills Connect
┌─────────────┐
│ arc-using │ ← routes by context
└──────┬───────┘
┌──────────────┬──────┴──────┬──────────────┐
▼ ▼ ▼ ▼
┌─────────────┐ ┌──────────┐ ┌──────────┐ ┌─────────────┐
│brainstorming│ │ writing- │ │executing-│ │ debugging │
│ │ │ tasks │ │ tasks │ │ │
└──────┬──────┘ └──────────┘ └──────────┘ └─────────────┘
▼
┌─────────────┐
│ refining │ ┌──────────────────────────┐
└──────┬──────┘ │ Available at any point: │
▼ │ • arc-journaling │
┌─────────────┐ │ • arc-verifying │
│ planning │ │ • arc-debugging │
└──────┬──────┘ └──────────────────────────┘
▼
┌─────────────┐
│ coordinating│
└─────────────┘