Metadata-Version: 2.4
Name: forge-dev
Version: 0.1.0
Summary: AI-Native Development Workflow Engine
Author: NaiaTech
License-Expression: MIT
Keywords: ai,development,mcp,scaffold,workflow
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.11
Requires-Dist: click>=8.1.0
Requires-Dist: gitpython>=3.1.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: jinja2>=3.1
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# 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

```bash
pip install forge-dev
```

Or install from source:

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

## Quick Start

```bash
# 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.):

```bash
forge mcp start
```

## License

MIT
