Forge - AI Development Orchestration

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

Quick Start

# 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.

Features

• 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

Demo

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.

KnowledgeForge as Claude Project

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.

Documentation

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.

CLI Commands

# 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

Requirements

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

License

MIT — See LICENSE

Links

• Documentation
• Demo Repository
• KnowledgeForge Specs
• GitHub Issues

---

Built with Claude by SEMalytics

---

About 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.}