Zing Forum

Reading

Arcforge: A Skill-Based Workflow Engine for AI Programming Assistants

A skill-based workflow tool designed for AI programming assistants such as Claude Code, Codex, and Gemini CLI. It enforces design, planning, TDD, and code reviews through an auto-triggered skill system, enabling AI assistants to behave like well-trained engineers.

arcforgeAI编程助手Claude CodeCodexGemini CLI工作流引擎TDD技能系统代码审查会话学习
Published 2026-04-19 21:46Recent activity 2026-04-19 21:51Estimated read 6 min
Arcforge: A Skill-Based Workflow Engine for AI Programming Assistants
1

Section 01

Arcforge Project Overview

Arcforge is a skill-based workflow engine for AI programming assistants like Claude Code, Codex, and Gemini CLI, aiming to solve the problem of AI assistants' lack of discipline. Through an auto-triggered skill system, it embeds standardized software engineering practices (such as design, planning, TDD, and code reviews) into AI assistants' conversations, guiding them to work like well-trained engineers and improving code quality and maintainability.

2

Section 02

Project Background and Problem Awareness

AI programming assistants have seen rapid improvement in capabilities, but they share a common issue: lack of discipline. When directly asked to implement features, AI often skips design, ignores reviews, and loses context, leading to code that works but accumulates technical debt quickly (e.g., design flaws, improper boundary handling, insufficient test coverage). Thus, the GregoryHo/arcforge project was born—it is not a tool to replace AI assistants, but a workflow engine that embeds standardized engineering practices into conversations via a skill system.

3

Section 03

Core Concept: Skill-Driven Workflow

What is a Skill-Based Workflow?

Traditional AI assistants rely on users to remember commands and best practices. Arcforge encapsulates these practices into skills that are auto-triggered based on context, guiding AI to complete design, planning, TDD, review, and other steps, structuring conversations and reusing knowledge.

How Do Skills Work?

When a conversation starts, Arcforge hooks inject available skills and activate different skills based on task nature (e.g., arc-brainstorming for vague requirements, execution skills for defined tasks).

4

Section 04

Core Skill System

Workflow Pipeline

Covers the full process from design to delivery: arc-brainstorming (design exploration) → arc-refining (refine requirements into specifications) → arc-planning (break down tasks and build dependency graphs) → arc-coordinating (parallel Git worktrees for large projects) → arc-implementing (enforce TDD).

Quality Gates

After task completion, two stages of review are required: specification compliance review (functional completeness, boundary handling, etc.) and code quality review (style, design patterns, performance, etc.).

Learning System

arc-journaling records conversation work, issues, and experiences; arc-reflecting analyzes logs to extract reusable patterns and form instincts.

5

Section 05

Typical Use Cases

Scenario 1: New Feature Development

For vague requirements, first activate arc-brainstorming to clarify requirements and produce design documents; after approval, break down tasks.

Scenario 2: Large-Scale Project Refactoring

arc-planning builds task dependency graphs, and arc-coordinating creates isolated Git worktrees to support parallel development.

Scenario 3: Bug Fixing

arc-debugging initiates a systematic debugging process, and arc-tdd ensures fixes include regression tests.

Scenario 4: Knowledge Transfer

arc-reflecting analyzes logs to extract experience patterns (e.g., time zone handling) and applies them to future conversations.

6

Section 06

Platform Support and Installation

Arcforge supports multiple platforms: Claude Code can install the plugin via marketplace sources; Codex and Gemini CLI require manual configuration; OpenCode requires cloning the repository and creating symbolic links.

7

Section 07

Summary and Outlook

Arcforge pushes AI programming assistants from an ad-hoc Q&A mode to a structured engineering workflow. It does not replace creativity but ensures high-quality, maintainable code through discipline. For teams using Claude Code, Codex, or Gemini CLI, it provides a way to integrate AI into standardized processes. In the future, such tools will become key infrastructure to improve AI collaboration efficiency.