Part of Forge DevKit ecosystem
◇ forge-core
Architecture-aware guardrails from your codebase
The problem
AI forgets your architecture every session
#1 developer complaint - lack of context is the real problem, not lack of capability.
Generic rules miss your patterns
Cursor Rules generators produce textbook defaults. They don't know your DDD layers or CQRS boundaries.
Context rot compounds across sessions
Each new chat starts from zero. Yesterday's guardrails are gone. AI rewrites what it wrote before.
How it works
Install
One command adds forge-core to your Claude Code environment.
Audit
7-gate wizard scans your repo: stack, layers, patterns, conflict zones, parallel readiness.
Generate
Produces project-specific CLAUDE.md, dev-skills, quality patterns, and pipeline phases.
Develop
AI agents use generated guardrails automatically. Upgrade command syncs when your architecture evolves.
Key capabilities
◇50+ quality patterns
Architecture-specific rules for DDD, CQRS, Clean Architecture, microservices, and more.
◇15 rationalization detectors
Catches when AI tries to skip tests, bypass types, or take shortcuts.
◇4 execution modes
Economy (~60% fewer tokens), balanced, quality (full pipeline), manual. Plus 3 strategies: sequential, parallel, patch. You decide how thorough each task needs to be.
◇7-gate progressive wizard
Each gate saves state. Resume anytime. No information overload.
◇Upgrade command
Architecture changed? One command regenerates all artifacts. Version headers track what's yours vs generated.
◇Cross-repo support
Monorepos, multi-repo setups, shared architectures - all detected and handled.
Sample output
A real-world example of what this module produces.
◆ Gate 1: Architecture Audit - Results
Stack: NestJS 11.0 + TypeScript 5.8 + Prisma 6.4
Build: SWC | Linter: ESLint + Prettier
Arch: DDD (3 bounded contexts)
Layers:
modules: src/modules/ (24 files) - domain logic, CQRS handlers
infra: src/infra/ (12 files) - Prisma repos, external APIs
shared: src/shared/ (8 files) - guards, pipes, decorators
Conflict zones: none (0 files)
Parallel readiness: 9/10 - highly parallelWho is this for
Solo Developer
Stop re-explaining your stack every session - guardrails persist automatically.
Tech Lead
Enforce architecture patterns across the team without manual reviews.
Agency Developer
Spin up guardrails for each client project in minutes, not hours.
forge-core vs Cursor Rules
See the full comparison for details.
| Dimension | Cursor Rules | Forge DevKit |
|---|---|---|
| Rule creation | Manual or template generator | Auto-generated from architecture audit |
| Architecture awareness | None - you specify stack manually | Detects stack, layers, patterns (DDD, CQRS) |
| Scope | Single rules file | Full pipeline: rules + product + tests + tasks |
| Updates | Manual maintenance | Upgrade command regenerates |
| Platform | Cursor only | Claude Code, Cursor, Windsurf, any AI agent |