arcforge-dev

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│
        └─────────────┘