<div style="display: flex; align-items: center; gap: 12px;">
<img src="https://www.faf.one/orange-smiley.svg" alt="FAF" width="40" />
<div>
<h1 style="margin: 0; color: #FF8C00;">claude-faf-mcp</h1>
<p style="margin: 4px 0 0 0;"><strong>IANA-Registered Format for AI Context</strong> · <code>application/vnd.faf+yaml</code></p>
</div>
</div>
> **.FAF optimizes AI for your codebase.** At 100% (Gold Code), AI stops guessing and starts knowing. Live bi-sync between `.faf` ↔ `CLAUDE.md` means zero context-drift — your project DNA stays aligned with AI, forever.
[](https://github.com/Wolfe-Jam/claude-faf-mcp/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/claude-faf-mcp)
[](https://www.npmjs.com/package/claude-faf-mcp)
[](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)
[](https://faf.one)
[](https://opensource.org/licenses/MIT)
---
## 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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```
**Gold Code = AI Optimized.** Your project DNA lives in `project.faf`. AI reads it instantly. Context never drifts.
---
## 🔄 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.
---
## 💎 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
**Copy and paste this to Claude/your AI:**
> Install the FAF MCP server: `npm install -g claude-faf-mcp`, then add this to my claude_desktop_config.json: `{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "claude-faf-mcp"]}}}` and restart Claude Desktop.
**One-Click Alternative:** [Desktop Extension (.mcpb)](https://github.com/Wolfe-Jam/claude-faf-mcp/releases/latest)
---
## 🛠️ 52 MCP Tools
All tools run standalone — zero CLI dependencies, 16.2x faster than process spawning.
| Tool | Purpose |
|------|---------|
| `faf_init` | Initialize project DNA |
| `faf_score` | Check AI-readiness (0-100%) |
| `faf_sync` | Bi-sync .faf ↔ CLAUDE.md |
| `faf_auto` | Auto-detect and populate context |
| `faf_enhance` | Intelligent enhancement |
| `faf_quick` | Lightning-fast creation (3ms) |
| `faf_readme` | Extract 6 Ws from README (+25-35% boost) |
| `faf_human_add` | Add human context (Claude Code compatible) |
**Performance:** 19ms average execution. Fastest: 1ms.
---
## 🎯 The .FAF Position
```
Model Context Protocol
───── ─────── ────────
Claude → .faf → MCP
Gemini → .faf → MCP
Codex → .faf → MCP
Any LLM → .faf → MCP
```
**.FAF is the foundational layer.** Universal context format. IANA-registered (`application/vnd.faf+yaml`). Works with any AI.
---
## 📦 Ecosystem
- **[MCPaaS](https://mcpaas.live)** — MCP as a Service (The Endpoint for Context)
- **[faf-cli](https://www.npmjs.com/package/faf-cli)** — CLI tool (18k+ downloads)
- **[faf-wasm](https://www.npmjs.com/package/faf-wasm)** — WASM SDK (<5ms scoring)
- **[Chrome Extension](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)** — Browser integration
- **[faf.one](https://faf.one)** — Official website
---
## 📚 Documentation
- **[Full Documentation](https://wolfe-jam.github.io/claude-faf-mcp/)**
- **[MCP Tools Reference](https://github.com/Wolfe-Jam/claude-faf-mcp/blob/main/docs/mcp-tools.md)**
---
## 📄 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*
