Skip to content

architecture.md

Latest commit

 

History

History
50 lines (38 loc) · 1.99 KB

architecture.md

File metadata and controls

50 lines (38 loc) · 1.99 KB
Raw

The loop, in one diagram

The architect has exactly three jobs: audit, plan, review. Judgment at the ends, cheap hands in the middle. There is no fourth Fable job, and in particular there is no "Fable does the work" job.

flowchart TB
  T["a real task"] --> A{"/architect<br/>judgment or typing?"}

  A -->|"TYPING"| EXEC
  A -->|"JUDGMENT / MIXED"| AUD

  subgraph FABLE ["the architect seat: decides, never types"]
    AUD["04 · audit the repo<br/>ranked findings · file:line · owner model"]
    PLAN["05 · write the plan<br/>five fields per step"]
    REV["08 · review the diff<br/>one graded pass"]
  end

  AUD --> PLAN --> HO["06 · handoff contract<br/>context · task · constraints · gate · escalation"]

  subgraph CHEAP ["the executor seat: types, never decides"]
    EXEC["07 · supervised run<br/>serial · effort medium · files-touched boundary"]
  end

  HO --> EXEC
  EXEC -->|"hits a decision the plan didn't make"| PLAN
  EXEC --> REV
  REV -->|"BLOCKER or MAJOR"| EXEC
  REV -->|"clean"| SHIP["ship"]

  FABLE -.->|"did Fable actually serve this?"| DET["09 · fallback detector"]
  SHIP --> LED["11 · ledger: what it actually cost"]
Loading

Read the token shape, because it's why this is cheap. The architect's three jobs are all input-heavy and output-light: it reads a lot of code and writes short reports. That's the cheap direction — you're mostly paying the input rate to let the best brain read. The one output-heavy step, the implementation, runs on the cheap seat. Every place a lot of tokens get written, a cheap seat writes them.

Why every piece is a file

Not one core artifact lives in a chat session, a product feature, or a model's memory. Files survive the model getting pulled and the harness compacting your conversation into a lossy summary. The chat is where work happens; the files are what you keep.

Which is also why every artifact here names a seat, never a model. Fable fills the architect socket today. The chips change; the sockets hold.