.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.

---

The Problem: Context-Drift

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.

---

The Solution: Gold Code

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏆  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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

---

💎 Lifecycle Value

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.

---

⚡ Quick Start

1. Install:

npm install -g faf-mcp

2. Add to your MCP config:

{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "faf-mcp"]}}}

Platform-Specific Setup

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

---

🔄 Eternal Bi-Sync

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 System: From Blind to Optimized

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.

---

💬 use>faf | Prompt Pattern

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.

---

🛠️ 17 Native MCP Tools

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.

---

🎯 The .FAF Position

  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.

---

📦 Ecosystem

• claude-faf-mcp — Claude Desktop (52 tools)
• faf-cli — Terminal CLI (18k+ downloads)
• faf-wasm — WASM SDK (<5ms scoring)
• faf.one — Official website

---

📄 License

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