Model or dataset
sangrokjung/claude-forge avatar
sangrokjung/claude-forge

Claude Forge: A Configuration Kit for Claude Code, Reviewed Against Its Own v4 Claims

oh-my-zsh for Claude Code — 16 agents, 35 commands, 32 skills, 21 safety hooks in one install. v4.0 adds an adversarial review loop: a second agent that never sees the first one's reasoning. MIT.

837 stars177 forksShellMIT

At a glance

What is it?
Claude Forge packages 16 agents, 35 commands, 33 skills, 22 hooks and 14 rule files into one install for Claude Code. The interesting part is not the count, it is the adversarial verification loop added in v4.0 and the context budget problem v4.1 was written to fix.
Who is it for?
Adopt Claude Forge if you already run Claude Code daily and want a pre-wired pipeline of agents, hooks and rules rather than assembling your own. Skip it if you use a different assistant, or if you need a single-purpose tool rather than a full configuration layer.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 13 days ago.
What is it written in?
Mainly Shell, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 15, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

The gap Claude Forge Targets: Bare Claude Code With No Procedures

Claude Code ships as a terminal coding assistant with no project conventions attached. The README frames this as a new employee who can code but has no company procedures, no safety checklists and no templates. Claude Forge is the equipment pack for that employee: 16 agents, 35 slash commands, 33 skills, 22 hooks, 14 rule files and 4 MCP connections, installed as one unit. The stated audience is people already using Claude Code who want the surrounding scaffolding without writing it themselves. The oh-my-zsh comparison in the README is accurate in one respect and misleading in another. Accurate: it is an add-on layer that changes how the underlying tool behaves without replacing it. Misleading: oh-my-zsh is mostly cosmetic and cheap to remove, while this project installs hooks that intercept commands before they run. That is a different risk profile, and the README's own framing of a 6-layer hook system that blocks risky actions before they happen should be read as a commitment, not a theme.

Two Install Paths and What Each One Actually Delivers

The README documents two routes. Option A runs inside a Claude Code session and takes two commands: /plugin marketplace add sangrokjung/claude-forge followed by /plugin install claude-forge. The README is explicit that this is a partial install. Commands and most skills arrive; agents, hooks, rules and MCP connections do not. Updates go through /plugin update claude-forge. Option B is the full install, described as a single curl line in the terminal, and the README marks it as recommended because it includes everything. The README text supplied here is truncated mid-URL, so the exact install command cannot be reproduced from this material; the homepage at sangrokjung.github.io/claude-forge is linked as the setup guide and is where the literal command should be taken from. That distinction matters for evaluation: if you only run Option A, you are testing a command pack, not the hook layer, and the hook layer is where most of the safety claims live. A reviewer who installs via the plugin marketplace and reports on the hooks would be describing something they never loaded.

The Adversarial Verification Loop: Maker and Checker Kept Separate

Version 4.0.0 introduced the piece worth examining. Every behavioral change is checked by a second, independent agent that did not write the code and never sees the first agent's reasoning. The loop runs until the checker issues APPROVE. This is a maker-checker split applied to generated code, and the design constraint is the information barrier: if the verifying agent can read the authoring agent's rationale, it inherits the authoring agent's blind spots, and the check degrades into agreement. Keeping the reasoning hidden is the mechanism, not a detail. The README reports that while building v4.0 itself, the loop caught three real defects in the maintainer's own pull requests, referencing #58 and #61, with a worked example in docs/VERIFICATION-LOOP.md. Those are the maintainer's own numbers about the maintainer's own process, so treat them as a design rationale rather than independent evidence. What can be assessed without running anything is the shape of the idea: a second pass with a deliberately narrowed view is a reasonable way to catch errors that a single pass rationalizes away. What cannot be assessed from this material is how often the checker approves something it should have rejected, which is the failure mode that matters most for a verification loop.

Hooks, Reliability Pack and the Cost of an Always-Loaded Harness

The hook count grew across releases: 21 in the v3.0.1 alignment notes, 22 with session-time-report in v4.2.0. That hook measures each session as it closes and reports at the next start when the session ended, how long it ran and how much was completed. The README notes it is resume-aware, so a session resumed days later reports that sitting rather than a bogus 400-hour total. v4.3.0 extends the same hook to read Codex rollout logs as well as Claude Code transcripts, wired through two entries in ~/.codex/hooks.json. The reliability pack in v4.0 adds API-error auto-resume, session relay across /compact and a doom-loop guard, documented in docs/RELIABILITY.md. Then v4.1.0 shipped harness-diet, the 33rd skill, which measures always-loaded context (CLAUDE.md plus rules) and shrinks it back under budget. That release is the most informative one in the list. A configuration pack that accumulates 14 rule files and dozens of skills steadily increases the context every session pays for before any work starts, and the maintainer shipped a tool to fight it. The release title itself frames the goal as putting always-loaded context back under budget. If you adopt this, that overhead is a recurring cost, not a one-time install fee, and harness-diet is the instrument for watching it.

Where the Design Gets in the Way

The first limitation is version coupling. The README badge specifies Claude Code 2.1.110 or later, and the v3.0.1 notes describe alignment with an Anthropic 2026 standard covering Hooks events, Subagent frontmatter v2, a Skills/Commands hybrid policy and a 4-server MCP minimum. A pack that tracks a moving upstream standard breaks when upstream moves, and the README itself records a concrete instance: an install that showed failed to load with the message Hook load failed: expected record, received undefined, tracked in issues #52 and #57 and fixed as of v4.0.0. That is the characteristic failure of this category of tool. The second limitation is scope. This is not a library you import into one project. It installs agents, rules and hooks that shape every session, which means a team that wants a narrow linting helper is buying a governance layer instead. The third is that the safety claims are architectural rather than measured. The README says a 6-layer hook system blocks risky actions before they happen; it does not state a false-positive rate, and this material gives no way to judge how often a legitimate command gets stopped. The fourth is that most of the documentation is in the repository rather than in this summary, so the install command, the hook configuration keys and the rule file contents have to be read at the source before you can evaluate them properly.

Compared With Writing Your Own CLAUDE.md and Hooks

The real alternative is not another product. It is the manual route: write your own CLAUDE.md, add a handful of hooks, and define the two or three slash commands your team actually repeats. That approach gives you a small, legible configuration where every rule has a known author and a known reason, and nothing loads that you did not put there. The difference in approach is breadth versus traceability. Claude Forge arrives with 14 rule files and 33 skills whose contents you did not write and must read to understand, in exchange for not having to build the pipeline from scratch. The loop-forge skill added in v3.1.0 sits between the two positions: it turns a repetitive task into a reusable, self-guarding slash command, which is the manual route with tooling attached. If your team has one or two well-understood workflows, loop-forge plus a short CLAUDE.md is likely the better fit. If you want the full plan, test, review, verify, ship chain connected out of the box and are willing to read the rule files, the pack saves real assembly time.

Licence, Upgrades and What Maintenance Looks Like

The project is MIT licensed, which permits commercial use, modification and redistribution provided the copyright notice and permission notice are retained. That is a permissive arrangement and it is the same licence most Claude Code configuration packs use, so it is unlikely to be the deciding factor. Note only that MIT covers the repository contents, not any third-party material the hooks or MCP connections reach at runtime. On upgrades, the README states that the full install updates with git pull, and the plugin route uses /plugin update claude-forge. The release history suggests upgrades are not always cosmetic: v4.0.0 changed the verification model and shipped a reliability pack, and the project maintains a MIGRATION.md for the v3 to v4 transition. Anyone running v3 should read that file before pulling. Maintenance cost falls on the user in one specific way. Because the pack tracks an upstream Anthropic standard and a minimum Claude Code version, a Claude Code release can invalidate assumptions the hooks were written against, and the fix arrives on the maintainer's schedule. The repository also carries README translations and a setup guide in 13 languages, which is a maintenance surface in its own right.

Editorial conclusion

Adopt Claude Forge if you already run Claude Code daily and want a pre-wired pipeline of agents, hooks and rules rather than assembling your own. Skip it if you use a different assistant, or if you need a single-purpose tool rather than a full configuration layer. Before installing, read MIGRATION.md for the v3 to v4 changes, check the hook load failure described in issues #52 and #57 to confirm your Claude Code version is past it, and run harness-diet after install to see what your always-loaded context actually costs.

Official sources

  1. License: MIT
  2. Project website
  3. README
  4. Releases
  5. sangrokjung/claude-forge on GitHub
Community notes

Community notes