Documentation
The same engineering docs the project is built from — architecture decisions, project rules, security model and API conventions — not a separate marketing copy of them.
Architecture
This is THE architecture reference. It is detailed enough that a new engineer can ship a correct, conventional contribution without reading any chat history, ti
Engineering Handbook
This handbook exists so a new senior engineer can become productive without chat history and without reading every file. It is the orientation layer: it tells y
Developer Guide
Welcome. This guide takes you from a clean machine to a running stack, a tour of the codebase, and a worked example of adding a feature end-to-end. Read it alon
Project Rules
These are the non-negotiable engineering rules for Brok's Forge. They exist to keep the platform safe, multi-tenant, and architecturally coherent as it grows fr
Coding Standards
This document is the canonical reference for how we write code in Brok's Forge. It is enforced in code review and, where possible, by the build (compiler args,
API Guidelines
This is the contract every HTTP endpoint in Brok's Forge follows. Consistency here is what lets the Next.js client, the generated OpenAPI SDK, and external inte
Security
- Audience: engineers, reviewers, on-call, and security auditors of the Brok's Forge platform. - Scope: the Java 21 / Spring Boot 3.4.1 modular-monolith backend
Error Handling
Errors in Brok's Forge are typed, mapped, and uniform. Services throw ApiException subclasses carrying a stable ErrorCode; a single @RestControllerAdvice transl
Testing Strategy
- Audience: backend & frontend engineers, reviewers, CI maintainers. - Stack under test: Java 21 / Spring Boot 3.4.1, PostgreSQL + Flyway (ddl-auto=validate), R
Performance
- Audience: backend & frontend engineers, reviewers, on-call. - Stack: Java 21 / Spring Boot 3.4.1, PostgreSQL + Flyway, HikariCP, Redis, Next.js 15. - Status:
Deployment
Primary production target. The Spring Boot API runs on a self-managed AWS EC2 instance (Amazon Linux 2023, Docker Compose) behind Nginx with Let's Encrypt TLS;
Contributing
Thanks for contributing to Brok's Forge — The Engineering Platform for AI Agents. This guide covers how to set up the project, the conventions we hold every cha
Roadmap
This roadmap tracks what is built, what is in flight, and where the platform is headed. Phases are additive: each builds on the last without removing or simplif