forge-dev 0.1.0

AI-Native Development Workflow Engine

Forge — AI-Native Development Workflow Engine

Forge is a development workflow system that transforms requirements into production-ready, audited, observable code. It is designed exclusively for AI-assisted development, optimizing every step for how AI coding agents work.

Philosophy

Forge encodes a complete development paradigm — from receiving a vague requirement to deploying a fully observable SaaS application. It handles all the non-functional requirements (security, observability, auth, API design, compliance) so you can focus on business logic.

Core principles:

• Requirements in, production code out
• Strong defaults, flexible overrides
• Every project starts with everything (observability, auth, CI/CD, IaC)
• AI-coding-agent-first task ordering
• Continuous auditing — not just at the end
• API-first, MCP-ready, repackageable microservices
• The workflow evolves and versions itself

Installation

pip install forge-dev

Or install from source:

git clone https://github.com/<org>/forge.git
cd forge
pip install -e .

Quick Start

# New project — empty folder
cd my-new-project
forge init

# New project — with requirements doc
cd my-new-project
cp ~/requirements.md .
forge init

# Existing project — assess maturity
cd my-existing-project
forge assess

# Upgrade Forge to latest version
forge upgrade

Commands

Command	Description
forge init	Initialize Forge in a project (detects context automatically)
forge intake <file>	Process a requirement document into a Forge Brief
forge plan	Generate AI-optimized implementation plan
forge audit	Run all audit agents against current code
forge assess	Evaluate existing project against current standards
forge upgrade	Update Forge core from upstream
forge journal	Add learnings/nuances to project journal
forge status	Show current project state and plan progress
forge standards	View, add, or modify standards
forge mcps	View or configure recommended MCPs

Architecture

~/.forge/                          ← Global Forge installation
├── core/                          ← Upstream (updated via forge upgrade)
│   ├── VERSION
│   ├── phases/                    ← Workflow phase definitions
│   ├── agents/                    ← Audit agent configurations
│   ├── templates/                 ← Project scaffold templates
│   └── standards/                 ← Base standards
├── user/                          ← Your customizations (never touched by upgrade)
│   ├── config.yaml                ← Your defaults (cloud, stack, preferences)
│   ├── standards/                 ← Standards you've added
│   ├── patterns/                  ← Approved patterns with code examples
│   ├── anti-patterns/             ← Things to never do
│   ├── mcps.yaml                  ← Your MCP registry
│   └── history/                   ← Project history and learnings

project/.forge/                    ← Per-project Forge state
├── context.yaml                   ← Stack, infra, decisions
├── brief.md                       ← Normalized requirement
├── plan.yaml                      ← AI-optimized implementation plan
├── journal.md                     ← Project-specific learnings
├── overrides/                     ← Local standard overrides
├── audit/                         ← Audit logs
└── maturity.yaml                  ← Assessment results

MCP Server

Forge also runs as an MCP server, making it accessible from any editor (Cursor, Copilot, Windsurf, etc.):

forge mcp start

License

MIT