.FAF optimizes AI for your codebase. At 100% (Gold Code), AI stops guessing and starts knowing. Universal MCP server for Cursor, Windsurf, Cline, VS Code, and all MCP-compatible platforms.
Universal version of claude-faf-mcp — Anthropic-approved MCP server, now compatible with all platforms.
AI assistants forget. They misunderstand. They drift.
Every new session, every new file, every new developer — AI starts guessing again. Your codebase context leaks away. Yesterday's perfect assistant becomes today's confused intern.
.FAF fixes this permanently.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏆 FAF AI-READINESS SCORE: 100/100 — GOLD CODE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
At 100%, AI is optimized. No more guessing.
Peak AI performance activated.
├─ Project DNA locked in ├─ Zero context-drift
├─ Architecture understood ├─ Eternal bi-sync active
├─ Domain model captured ├─ Team alignment permanent
└─ Every session starts smart └─ AI works WITH you, not around you
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Setup savings get you started. Lifecycle optimization keeps you ahead.
| When | Without FAF | With FAF |
|---|---|---|
| Day 1 | 20 min setup per dev | 0 min — instant context |
| Month 1 | AI forgets between sessions | AI remembers everything |
| Year 1 | New devs re-explain everything | New devs inherit full context |
| Year 3+ | Institutional knowledge lost | Project DNA preserved forever |
Setup savings: 20 minutes. Lifecycle savings: Infinite.
1. Install:
npm install -g faf-mcp2. Add to your MCP config:
{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "faf-mcp"]}}}| Platform | Config File |
|---|---|
| Cursor | ~/.cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Cline | Cline MCP settings |
| VS Code | MCP extension config |
| Claude Desktop | Use claude-faf-mcp |
The magic: .faf ↔ CLAUDE.md stay synchronized in milliseconds.
project.faf ←──── 8ms ────→ CLAUDE.md
│ │
└── Single source of truth ──┘
- Update either file → both stay aligned
- Zero manual maintenance
- Works across teams, branches, sessions
- Context never goes stale
| Tier | Score | Status |
|---|---|---|
| 🏆 Trophy | 100% | AI Optimized — Gold Code |
| 🥇 Gold | 99%+ | Near-perfect context |
| 🥈 Silver | 95%+ | Excellent |
| 🥉 Bronze | 85%+ | Production ready |
| 🟢 Green | 70%+ | Solid foundation |
| 🟡 Yellow | 55%+ | AI flipping coins |
| 🔴 Red | <55% | AI working blind |
| 🤍 White | 0% | No context at all |
At 55%, AI is guessing half the time. At 100%, AI is optimized.
Start every prompt with "Use FAF" to invoke MCP tools:
Use FAF to initialize my project
Use FAF to score my AI-readiness
Use FAF to sync my context
Use FAF to enhance my project
Works on all platforms — stops web search, forces tool usage.
| Tool | Purpose |
|---|---|
faf_init |
Initialize project.faf |
faf_score |
Check AI-readiness (0-100%) |
faf_sync |
Sync context across platforms |
faf_bi_sync |
Bi-directional .faf ↔ CLAUDE.md |
faf_enhance |
Intelligent enhancement |
faf_read |
Parse and validate FAF files |
faf_write |
Create/update FAF with validation |
Plus CLI fallback with 40+ commands.
Platform Context Protocol
──────── ─────── ────────
Cursor → .faf → MCP
Windsurf → .faf → MCP
Cline → .faf → MCP
VS Code → .faf → MCP
Claude → .faf → MCP
Any IDE → .faf → MCP
.FAF is the foundational layer. Universal context format. IANA-registered. Works everywhere.
- claude-faf-mcp — Claude Desktop (52 tools)
- faf-cli — Terminal CLI (18k+ downloads)
- faf-wasm — WASM SDK (<5ms scoring)
- faf.one — Official website
MIT License — Free and open source
Zero drift. Eternal sync. AI optimized. 🏆
"It's so logical if it didn't exist, AI would have built it itself" — Claude
