Skip to content
Back to the list

abstractdriven.com · MIT

Abstract Driven Development V3

A fractal architecture so AI agents stop putting code in the wrong place

The larger a codebase gets, the more often an AI coding agent puts code in the wrong place, because it cannot hold every architectural convention in context. A.D.D makes the conventions derivable from the folder structure instead of asking the agent to remember them.

§ 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 fixed layers: Bootstrap, Operators, Core Abstractions, Implementations, Boundary
  • Only Implementations may nest sub-modules, which is what makes the structure self-similar
  • No dependency cycles, no dependencies pointing back up a layer
  • llms.txt: a compressed spec written for language models
  • MIT licensed, and in real use inside our POS, EDU ChatBot and ManaGate

§ 03Screens

Abstract Driven Development V3 — 01