forge-dev 0.1.0__tar.gz

forge_dev-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,40 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build tools
+        run: python -m pip install --upgrade build
+      - name: Build package
+        run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/forge-dev
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

forge_dev-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.venv/
+venv/
+.env
+*.log

forge_dev-0.1.0/PKG-INFO

@@ -0,0 +1,134 @@
+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

forge_dev-0.1.0/README.md

@@ -0,0 +1,105 @@
+# 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

forge_dev-0.1.0/claude_skill/SKILL.md

@@ -0,0 +1,171 @@
+---
+name: forge
+description: AI-Native Development Workflow Engine. Use this skill whenever starting a new project, processing requirements, scaffolding code, auditing existing code, or managing development standards. Triggers on phrases like "new project", "initialize", "scaffold", "set up", "forge", "requirement analysis", "implementation plan", "audit code", "assess project", "add standard", "maturity assessment", or any request to create a full project from a requirement. Also triggers when the user mentions PRDs, user stories, epics, or asks about implementation ordering for AI coding agents. Use this skill proactively when the user is about to start coding without a clear plan or project structure.
+---
+
+# Forge — AI-Native Development Workflow Engine
+
+## Overview
+
+Forge transforms requirements into production-ready, audited, observable code. It handles all non-functional requirements (security, observability, auth, API design, compliance) so you focus on business logic.
+
+**Core philosophy**: Requirements in, production code out. Strong defaults, flexible overrides. AI-coding-agent-first task ordering. Continuous auditing.
+
+## When To Use Forge
+
+- Starting any new project or feature
+- Processing a requirement document (PRD, user story, epic, etc.)
+- Setting up project scaffolding with full observability, auth, CI/CD
+- Auditing existing code against standards
+- Assessing project maturity
+- Adding or managing development standards
+- Planning implementation order for AI coding agents
+
+## Quick Start
+
+### 1. Initialize a Project
+
+In the project directory, run:
+
+```bash
+forge init
+```
+
+This detects the directory state:
+- **Empty**: Guided setup — asks about mission, stack, regulatory requirements
+- **Has docs**: Analyzes documents, suggests processing them with `forge intake`
+- **Has code**: Detects stack, offers assessment
+- **Has .forge/**: Already initialized, shows status
+
+### 2. Process a Requirement
+
+```bash
+forge intake requirements.md
+# or
+forge intake --text "Build a multi-tenant SaaS for..."
+```
+
+This classifies the requirement (PRD, user story, epic, etc.) and generates an intake prompt for LLM analysis that produces a Forge Brief with:
+- Normalized features and MVP scope
+- Gap detection with suggestions
+- AI-optimized implementation ordering
+
+### 3. Check Status
+
+```bash
+forge status
+```
+
+### 4. Add Journal Entries
+
+Record project-specific learnings:
+
+```bash
+forge journal "Azure DB requires pg tunnel via temp install"
+```
+
+### 5. Manage Standards
+
+```bash
+forge standards --name "API Versioning" --area "api-design" --description "All APIs must use URL-prefix versioning (e.g., /v1/users)"
+```
+
+Standards are coherence-checked before being added.
+
+## Architecture
+
+### Global Registry (~/.forge/)
+
+```
+~/.forge/
+├── 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
+│   ├── standards/
+│   ├── patterns/
+│   ├── anti-patterns/
+│   ├── mcps.yaml
+│   └── history/
+└── versions/      ← Workflow version snapshots
+```
+
+### Per-Project (.forge/)
+
+```
+.forge/
+├── context.yaml   ← Stack, infra, all decisions
+├── brief.yaml     ← Normalized requirement
+├── plan.yaml      ← AI-optimized implementation plan
+├── journal.md     ← Project-specific learnings
+├── overrides/     ← Local standard overrides
+└── audit/         ← Audit logs
+```
+
+## AI-Optimized Implementation Order
+
+Forge orders implementation to minimize AI coding agent hallucinations:
+
+1. **Types & Contracts** — Pydantic models, TypeScript interfaces, OpenAPI schemas
+2. **Infrastructure** — IaC, environment configs, secrets
+3. **Auth & Security** — Auth flows, RBAC, middleware
+4. **Data Layer** — ORM models, migrations, repositories
+5. **Core Services** — Business logic (no HTTP concerns)
+6. **API Layer** — Endpoints exposing services (OpenAPI-documented, MCP-ready)
+7. **Frontend** — Components, pages, state management
+8. **Observability** — APM, metrics, logs, dashboards, AI tracking
+9. **Testing** — Unit, integration, E2E
+10. **CI/CD & Deploy** — Pipelines, IaC execution, smoke tests
+
+Each phase has complete context from all previous phases, reducing hallucinations.
+
+## Default Stack (User Configurable)
+
+These defaults are stored in `~/.forge/user/config.yaml`:
+
+- **Cloud**: Azure
+- **Backend**: Ask each time (FastAPI, Django, Express, Fastify, NestJS)
+- **Frontend**: React
+- **Database**: PostgreSQL
+- **Auth**: Azure AD B2C
+- **Observability**: App Insights + Prometheus + Loki + Grafana
+- **API**: REST, OpenAPI 3.1, MCP-ready, URL-prefix versioning
+- **CI/CD**: GitHub Actions + Pulumi
+- **Standards**: Strict type checking, enforced linting, 80% coverage minimum
+
+Override any default per-project in `.forge/context.yaml`.
+
+## MCP Server
+
+Forge runs as an MCP server for editor integration:
+
+```bash
+python mcp_server/server.py
+```
+
+Exposes tools: `forge_init`, `forge_intake`, `forge_status`, `forge_journal`, `forge_standards_add`, `forge_coherence_check`, `forge_mcps_list`, etc.
+
+## Key Commands Reference
+
+| Command | What it does |
+|---------|-------------|
+| `forge init` | Initialize project, detect context |
+| `forge intake <file>` | Process requirement → Forge Brief |
+| `forge plan` | Generate AI-optimized task plan |
+| `forge audit` | Run audit agents on current code |
+| `forge assess` | Maturity assessment for existing project |
+| `forge upgrade` | Update Forge core from upstream |
+| `forge journal` | Add project-specific learning |
+| `forge standards` | Add standard (with coherence check) |
+| `forge mcps` | View/manage MCP registry |
+| `forge status` | Show project state |
+
+## References
+
+- See `references/implementation-phases.md` for detailed phase documentation
+- See `references/standards-guide.md` for writing effective standards
+- See `references/audit-agents.md` for agent configuration

forge_dev-0.1.0/forge_core/__init__.py

@@ -0,0 +1,3 @@
+"""Forge — AI-Native Development Workflow Engine."""
+
+__version__ = "0.1.0"

forge_dev-0.1.0/forge_core/agents/__init__.py

@@ -0,0 +1 @@
+"""Forge audit agents."""