devforgeai

DevForgeAI

Transform vague business ideas into production-ready code with zero technical debt.

DevForgeAI is a development framework for Claude Code that enforces TDD, quality gates, and architectural constraints across the entire software lifecycle. It works with any technology stack.

Interactive Demo | Full Documentation

Quick Start

# Install into your project
npx devforgeai install

# Open in Claude Code Terminal, then:

/create-context my-project        # Set up architectural constraints
/create-story user-authentication # Create a spec'd user story
/dev STORY-001                    # Build it with enforced TDD
/qa STORY-001 deep                # Validate quality

Or start from scratch with a vague idea:

/brainstorm "I want to build a marketplace for local artisans"
# The framework guides you from idea -> requirements -> architecture -> code -> release

See It in Action

Explore the full development pipeline, TDD cycle, quality gates, and architecture — all interactive, right in your browser.

https://devforgeai.com/

Why DevForgeAI?

AI coding assistants are powerful but undisciplined. Without guardrails, they make autonomous technology decisions, skip tests, and accumulate technical debt faster than any human team.

DevForgeAI fixes this with three mechanisms:

1. Constitutional Context Files — 6 immutable documents define your approved technologies, directory structure, dependencies, coding standards, architecture constraints, and forbidden anti-patterns. The AI cannot deviate without an approved Architecture Decision Record.

2. Mandatory TDD — Every feature goes through a 10-phase cycle: write failing tests first, implement minimum code to pass, refactor, verify acceptance criteria, run integration tests. No shortcuts.

3. Quality Gates — 4 checkpoints block progression until standards are met. Coverage thresholds (95% business logic, 85% application, 80% infrastructure) are enforced as blockers, not warnings.

Key Features

• Technology Agnostic — Works with any stack. Your context files define the rules, not the framework.
• 44 Specialized Subagents — Single-responsibility AI agents: test-automator, backend-architect, security-auditor, code-reviewer, and 40 more.
• 46 Slash Commands — From /brainstorm to /release, every workflow step has a dedicated command.
• Root Cause Analysis — Built-in /rca command with 5 Whys methodology when things go wrong.
• Test Integrity Protection — Only designated agents can write tests during designated phases, preventing implementation agents from weakening assertions.
• Cross-AI Collaboration — /collaborate generates portable documents for sharing issues with other LLMs.

Installation

Prerequisites: Node.js >= 18, npm >= 8, Git, Claude Code Terminal

# Recommended
npx devforgeai install

# From source
git clone https://github.com/bankielewicz/DevForgeAI.git
cd DevForgeAI && npm install
node bin/devforgeai.js install /path/to/your-project

# Global
npm install -g devforgeai
devforgeai install

After installing, run /create-context my-project in Claude Code to generate your constitutional context files interactively.

How the Workflow Fits Together

/brainstorm     Vague idea -> structured problem discovery
      |
/ideate         Problem -> requirements (functional + non-functional)
      |
/create-context Requirements -> 6 constitutional constraint files
      |
/create-epic    Constraints -> feature decomposition
      |
/create-story   Features -> implementable stories with acceptance criteria
      |
/dev            Story -> TDD implementation (10 phases, enforced)
      |
/qa             Code -> quality validation (coverage, security, patterns)
      |
/release        Validated code -> production deployment

Documentation

Topic	Location
All 46 commands	Commands Reference
Architecture & subagents	Architecture Guide
API documentation	API Reference
Troubleshooting	Troubleshooting Guide
Project roadmap	Roadmap
Competitive analysis	Research

Contributing

• Fork the repository
• Create a feature branch
• Use the DevForgeAI workflow: /create-story -> /dev -> /qa
• Push and open a Pull Request

See CONTRIBUTING.md for full guidelines.

Support

If DevForgeAI has been useful, consider buying me a coffee!

License

MIT License — see LICENSE for details.

Built with Claude Code — Spec-driven development with 44 subagents, 26 skills, and zero tolerance for technical debt.