Forge is an architecture operating system for backend systems. It models, builds, audits, protects, and evolves your codebase across four architectural domains — Platform, Features, Shared, and Infrastructure — enforcing 13 dependency rules with CRITICAL/ERROR/WARNING severity, and integrating as a live skill into your AI coding agent.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ronaldjdev/forge/llms.txt
Use this file to discover all available pages before exploring further.
Installation
Install Forge via npx and wire it into your AI agent in under two minutes.
Quickstart
Initialize your first project, run a full audit, and scaffold a feature slice.
Architecture Model
Understand the four-layer model, dependency rules, and the architecture graph.
Command Reference
Every Forge command with flags, examples, and expected output.
What Forge Does
Backend projects degrade into coupled code because infrastructure and business rules mix without clear ownership. Forge imposes an auditable, automated, and evolutionary architectural discipline:Scaffold features
cast generates a complete hexagonal feature slice — domain, use cases, adapters, and DI wiring.Audit architecture
inspect scores your project across 10 categories (180 pts → 0–100, grade A–F).Validate rules
quench enforces 13 architectural rules (R1–R13) and can auto-fix WARNING-level violations.Govern AI agents
Deploy as a skill in Claude Code, Cursor, Codex CLI, OpenCode, and Gemini simultaneously.
Get Started in 3 Steps
Initialize your project
Ask your agent to run
forge in your backend project directory. Forge detects your stack, bootstraps the four layers, and generates ARCHITECTURE.md.Supported AI Agents
Forge deploys as a skill into five AI coding agents simultaneously, with hooks tailored to each platform:| Agent | Hook | Effect |
|---|---|---|
| OpenCode | SKILL.md | Architectural instructions loaded at agent startup |
| Claude Code | forgeSentinel (PostToolUse) | Reports violations after every file write |
| Cursor | forgeSmith (preToolUse) | Blocks writes that introduce CRITICAL/ERROR violations |
| Codex CLI | forgeSentinel (PostToolUse) | Reports violations after every file write |
| Gemini | SKILL.md | Architectural instructions loaded at agent startup |
Forge requires Node.js ≥ 18. No runtime dependencies beyond
@clack/prompts and picocolors — all analysis scripts are pure ESM modules.