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

☁️ Cloud Sync (NEW in v1.3.0)

Share your FAF context globally via mcpaas.live:

| Tool | Purpose | |------|---------| | faf_cloud_publish | Upload to cloud, get shareable URL | | faf_cloud_fetch | Pull context from cloud | | faf_cloud_list | List available souls | | faf_cloud_search | Search across souls | | faf_cloud_share | Generate share links |

Example Workflow:

# Upload your project.faf
faf_cloud_publish { soul_name: "my-project" }
→ https://mcpaas.live/souls/my-project

# Anyone can fetch it
faf_cloud_fetch { soul_name: "my-project" }
→ Context merged into local project.faf

Zero-install sharing - Recipients need no MCP setup. Served from 300+ Cloudflare edges with <1ms cold starts via 2.7KB Zig-WASM engine.

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

🛠️ 22 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 | | ☁️ Cloud Tools | (NEW in v1.3.0) | | faf_cloud_publish | Upload to mcpaas.live | | faf_cloud_fetch | Pull from cloud | | faf_cloud_list | List souls | | faf_cloud_search | Search souls | | faf_cloud_share | Generate share links |

Plus CLI fallback with 40+ commands (via faf-cli v4.3.0):

• faf readme - Extract 6 Ws from README (+25-35% boost)
• faf human-add - Non-interactive YAML merge (6Ws Builder)
• faf git - GitHub repo analysis without cloning
• And 40+ more 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