F4A — The Flat-4 Architecture
Pardpro's Flat-4 is an incredibly strict, highly-deterministic software architecture pattern designed to eliminate 'spaghetti code', cyclic dependencies, and unclear responsibilities.
1The Brutal Wall
As we heavily integrated AI agents (Cursor, Claude) into our engineering team at Pardpro, we hit a brutal wall. While LLMs are great at writing isolated functions, the moment your project scales, they start hallucinating, creating cyclic dependencies, and generating absolute spaghetti code.
2The Iron Rules
No Same-Layer Calls
L2 cannot call L2, L4 cannot call L4.
No Reverse Calls
A lower layer (e.g., L4) can never call a higher layer (e.g., L2).
AI First-Pass Rate
Pass@1
When NOT to use Flat-4+
If you are building a straightforward data-entry website, standard MVC (e.g., Django, Rails, Next.js) is significantly faster. Flat-4+ will introduce unnecessary boilerplate.
Implement F4A in your stack
Explore the codebase, AST linter, and full documentation.