Skip to content
Back to the list

abstractdriven.com · MIT

Abstract Driven Development V3

A fractal architecture that keeps AI agents from breaking the codebase

As a codebase grows, AI coding agents start putting code in the wrong place, because they cannot hold the whole set of architectural conventions in context. A.D.D. solves this by making the convention derivable rather than memorised.

§ 01Algorithm

F.A.P — fractal architecture pattern
module ::= {
  Bootstrap          # DI, khởi tạo
  Operators          # điều phối, logic nghiệp vụ
  CoreAbstractions   # entity, state, port — KHÔNG phụ thuộc gì
  Implementations    # adapter công nghệ  ← chỉ tầng này được lồng module con
  Boundary           # hợp đồng ra ngoài — KHÔNG phụ thuộc gì
}

Implementations ::= { module }        # tự tương tự, lồng vô hạn

invariant:
  ¬∃ chu trình phụ thuộc
  ¬ phụ thuộc ngược lên tầng trên
  path = /Implementations/Order/Implementations/PayFast
         → LLM điều hướng bằng đường dẫn, luôn suy ra được luật phụ thuộc

§ 02Highlights

  • Five invariant layers: Bootstrap, Operators, Core Abstractions, Implementations, Boundary
  • Only Implementations may nest sub-modules — the condition that makes the structure self-similar
  • No circular dependencies, no upward dependencies
  • llms.txt: a compressed specification written for language models
  • MIT licensed, and used in production in our own POS, EDU ChatBot and ManaGate

§ 03Screens

Abstract Driven Development V301
Abstract Driven Development V302
Abstract Driven Development V303