← All Diagrams

AI Context: Before & After

What your AI actually knows about your project

CLAUDE.md Only ~25%
MD
CLAUDE.md 70 lines
Stack info + conventions + structure + rules + state — all prose, all mixed together
AI has to figure out the rest
Parse package.json for actual deps
Scan directory tree for structure
Guess architecture from file names
Re-discover everything next session
Claude only
What does ~25% mean?
AI makes up the other 75%
Without full context, AI hallucinates, makes assumptions, and introduces errors you won't find until production.
.faf + CLAUDE.md 100%
.faf
project.faf 27 lines
Structure — stack, architecture, project type. YAML. Machine-readable. Scorable.
MD
CLAUDE.md 23 lines
Instructions only — conventions, rules, current focus. Pure prose. No data.
AI knows instantly
Full stack context in <1ms
Architecture understood, no scanning
Human rules separate from data
Zero drift — faf sync keeps aligned
Claude Cursor Gemini Windsurf Any AI
What does 100% mean?
AI is optimised for your project
Full context, every session, any tool. No guessing. No drift.
FAF defines. CLAUDE.md instructs. AI consumes.
application/vnd.faf+yaml — IANA registered