Transform natural language descriptions into production-ready code with intelligent task decomposition, distributed generation, and automated testing.

# Install
git clone https://github.com/SEMalytics/forge.git
cd forge
poetry install
pip install -e .
# Verify
forge --version
forge doctor
# Build a project
forge init my-project
forge chat
forge build --project my-project
forge iterate --project my-project

See Installation Guide for detailed setup.

• 12-Agent Review System — Security, performance, architecture experts vote on code (8/12 approval threshold)
• Automated Iteration — Detects issues, generates fixes, loops until tests pass
• Multi-Framework Testing — pytest, jest, go test with Docker isolation
• Pattern-Based Generation — 40+ engineering patterns via KnowledgeForge
• Git Integration — Conventional commits, branch management, PR creation
• Multi-Platform Deploy — fly.io, Vercel, AWS, Docker, Kubernetes

Try Forge with intentionally vulnerable code:

git clone https://github.com/SEMalytics/forge-demo.git
cd forge-demo
forge review panel # Show 12 expert agents
forge review directory demos # Detect vulnerabilities
forge init "Demo" -i demo -d "Demo"
forge iterate -p demo -d demos # Auto-fix loop

See forge-demo for full documentation.

The knowledgeforge/ directory can be deployed as a standalone Claude Project:

1. Go to claude.ai → Create Project
2. Paste 00_Project_Instructions.md into Project Instructions
3. Upload remaining .md files to Project Knowledge
4. Start chatting with PDIA method, 4 agent modes, and coordination patterns

See knowledgeforge/README.md or browse on GitHub.

Getting Started:

• Installation — Setup and requirements
• Quick Start — Get running in 5 minutes
• CLI Reference — All commands
• Configuration — Config options

Guides:

• Existing Projects — Add Forge to existing codebases
• Using CodeGen — CodeGen API integration
• Troubleshooting — Common issues

Architecture & API:

• Architecture — System design (6-layer pipeline)
• API Reference — Python API
• Failure Analysis — How auto-fix works
• Git Workflows — Git integration

Development:

• Developer Guide — Contributing
• Development Notes — Internal docs

See docs/README.md for complete index.

# Core workflow
forge init <project> # Initialize project
forge chat # Interactive planning
forge build -p <id> # Generate code
forge test -p <id> # Run tests
forge iterate -p <id> # Auto-fix loop
# Review
forge review panel # Show 12 agents
forge review file <path> # Review single file
forge review directory <dir> # Review directory
# Utilities
forge status # Project status
forge doctor # Check dependencies
forge deploy -p <id> # Generate deploy config

• Python 3.11 or 3.12 (not 3.13+)
• Docker (optional, for isolated testing)
• ANTHROPIC_API_KEY environment variable

MIT — See LICENSE

• Documentation
• Demo Repository
• KnowledgeForge Specs
• GitHub Issues

Built with Claude by SEMalytics

Forge is built by SEMalytics—applying cognitive science and AI orchestration to real development problems.

Related Projects:

• KnowledgeForge — The multi-agent methodology powering Forge's 12-agent review system
• Concept Clarity — Measure message clarity across communications
• Communications Optimization System (COS) — Personality-aware B2B content analysis

Learn more at SEMalytics →

_{Built by SEMalytics · AI that ships.}