For teams going agentic

AI FORGING

The counterpoint to vibe coding.

What if your codebase is getting worse with every feature you ship? Going agentic is easy — going agentic without wrecking quality is the hard part. AI Forging is the discipline for handing AI whole units of work while quality and velocity compound instead of collapse.

The landscape

Four ways to build with AI.

Autonomy and discipline are two different axes. "Agentic" means you hand the AI a whole unit of work. "Vibe" means little discipline wraps it. Cross them and you get four very different places to live — including the trap almost nobody names: agentic vibe coding.

A map for agentic software development: autonomy versus discipline. Vibe Coding (low autonomy, low discipline), Disciplined AI-Assist (high discipline, low autonomy), Agentic Vibe Coding (low discipline, high autonomy), and AI Forging (high discipline, high autonomy — the goal).

Click the map to open it full-size ↗

Layer 1 — The Why

Speed got cheap. Quality didn't.

AI makes producing code nearly free. Without structure, every feature shipped makes the codebase worse — and eventually the AI itself starts hallucinating against the mess it helped create. This is the problem worth solving, and it outlives any single tool.

Quality drift compounds

AI output silently diverges from your conventions. Small drift today becomes structural debt in six months — hidden behind a green CI badge.

Velocity masks debt

Features ship fast while the codebase rots underneath. The rework cycle begins invisibly, then velocity collapses.

Knowledge evaporates

Hard-won decisions live in chat transcripts and individuals' heads. Nothing is codified. Turnover resets the clock.

No audit trail

No record of what was built, why, or by whose approval. Governance and regulatory blind spots.

The idea

AI Forging is layered.

It isn't a single tool. It's a philosophy, a methodology that serves it, and a concrete implementation of that methodology — three layers with very different lifecycles.

1
The Why — Philosophy

The problems worth solving

What goes wrong when we build with agentic AI, and why quality has to compound instead of decay. Tool-agnostic and the part that endures longest.

2
The How — Methodology

One way to solve them

Spec → plan → test-first execution → refactoring in isolated sub-agents → knowledge captured so it scales. Framed as one approach, not the only one — others are welcome.

3
The Implementation — Open Source

A tool that runs the method

The open-source Claude Code plugin — with strong, opinionated bets on architecture. One implementation of the methodology. You could disagree with every opinion and still hold the philosophy.

Layer 2 — The Method

Fire. Hammer. Tempering.

A metallurgy metaphor: raw material becomes stronger through structured transformation — not by hoping for the best. Each pass through the forge leaves the codebase stronger than it started.

Fire

Test before you code

AI-powered TDD. Tests capture intent before a line of implementation exists — the double-entry accounting of software.

Intent, verified — not eyeballed.

Hammer

Refactor against patterns

After the tests pass, one fresh-context sub-agent per pattern reworks just the changed code — in parallel, no drift, no fatigue.

Consistency without human fatigue.

Tempering

Capture knowledge that scales

One correction, one pattern file. Adding the 50th costs no more than the 5th. No monolith, no context ceiling.

The system gets smarter, not heavier.

Governance

AI Forges. Humans decide.

Nothing autonomous, nothing silent. Every proposal passes a human gate before it merges — reviewed at feature completion, not one step at a time.

1Review the tests — do they capture your intent?
2Code review at the PR
3Architecture decisions
4Deployment authorization
The Movement

One philosophy. Many ways to live it.

The most important layer is the Why, and it belongs to everyone. The methodology below it is one route through the problem — yours might be better. The plugin is one implementation — there could be others, for other tools, stacks, and architectures. Take the ideas, build your own, and share what you learn.

Vibe Coding

  • Prompt → hope → ship
  • Quality is a snapshot
  • Knowledge lives in the chat history
  • Best practices are whatever the AI recalls
  • Works until it doesn't

AI Forging

  • Specify → prove → capture
  • Quality compounds every cycle
  • Knowledge lives in reusable files
  • Best practices enforced automatically
  • Each piece makes the next one better
Layer 3 — The Implementation
Open source · Claude Code plugin · v0.2.0

Install the reference implementation.

A Claude Code plugin that runs the whole method — spec, TDD, pattern-driven refactoring, knowledge capture — with opinionated, domain-driven architecture on top. Built for established codebases that already feel the AI-generated sprawl. Prescriptive on purpose.

# Install superpowers (the TDD + sub-agent foundation)
/plugin marketplace add obra/superpowers
/plugin install superpowers@superpowers-dev

# Install AI Forging
/plugin marketplace add aiforging/aiforging
/plugin install aiforging@aiforging

# Then bootstrap a workspace
/aiforging:setup

Symfony / PHP / Doctrine is the happy path today; other stacks work to the degree the conventions apply. Research preview — try it on something real and open an issue about what broke.