The Socratic Forge
Self-healing autonomous software development. Instead of giving AI agents instructions, give them questions.
The Socratic Forge is a complete operating system for AI-driven software development. The inquiry builds context, the context becomes a plan, and the plan becomes software. v4.0 adds a self-healing autonomous execution pipeline where AI agents build, verify, review, repair, and integrate code with ~99% autonomy and ~1% human intervention.
The Cardinal Rule
Never put the answer in the question. A bad question gets you one solution. A good question gets you a system. The Forge teaches AI agents to reason through six types of Socratic questions (boundary, inversion, constraint discovery, precedent, tension, and cLaw gates) so they build better software than you could specify.
The Evolution
Inquiry-driven development. Ask questions, get better code.
Six layers: Methodology, Gap Map, Tracks, Phases, Orchestrator, Identity File.
Four verification gates between phases. Contract checking, test verification, parallel coordination.
Review Agent, Repair Agent, Integration Test Agent, Plan Verification. Full autonomous pipeline.
The v4.0 Self-Healing Pipeline
Every phase passes through a self-healing pipeline: BUILD → VERIFY → REVIEW → REPAIR → CONTINUE. Three new agents close the gaps that previously required human judgment.
Review Agent
Reads actual code diffs and evaluates pattern adherence, complexity, reimplementation, extensibility, scope match, and test quality. Verdicts: PASS, REFACTOR, or WARN.
Repair Agent
When the Review Agent returns REFACTOR, a surgical repair session applies each fix with file paths and line ranges. Maximum 2 repair cycles per phase.
Integration Test Agent
At sprint boundaries where parallel chains merge, writes and runs integration tests across all chain boundaries. Classifies failures as PASS, FIXABLE, or BLOCKING.
Six Socratic Question Types
The methodology teaches agents to reason through six categories of questions that build understanding before building code.
Boundary
Define edges before solving. “What must be true about X before Y can safely happen?”
Inversion
Think like an attacker. “If you wanted to break this, what would you exploit?”
Constraint Discovery
Find rules, don't receive them. “What is the minimal set of permissions that satisfies both constraints?”
Precedent
Prevent wheel reinvention. “Module X already solves this. What pattern did it use?”
Tension
Navigate real tradeoffs. “Two legitimate needs conflict. How do you serve both?”
cLaw Gate
Non-negotiable safety review. “Walk through each law. Where could this cause harm?”
Platform Support
The Socratic Forge works with any AI coding platform including Claude Code, Google Antigravity, Replit, or anything else that gives an AI agent access to your codebase. Templates for each platform's identity file are included.
Get Started
The easiest way to start using the Socratic Forge is to point your AI coding agent at the repository and ask how it can help your project. The agent will read the methodology and begin applying it.
claude "Read https://github.com/FutureSpeakAI/the-socratic-forge and tell me how it can help this project"
Or browse the repo directly:
View on GitHub →By Stephen C. Webster, MIT License © 2025–2026