claude-faf-mcp IANA-Registered Format for AI Context · application/vnd.faf+yaml 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. Gold Code = AI Optimized. Your project DNA lives in proje
Add this skill
npx mdskills install Wolfe-Jam/claude-faf-mcpComprehensive MCP server for AI context management with extensive tooling and strong performance benchmarks
1<div style="display: flex; align-items: center; gap: 12px;">2 <img src="https://www.faf.one/orange-smiley.svg" alt="FAF" width="40" />3 <div>4 <h1 style="margin: 0; color: #FF8C00;">claude-faf-mcp</h1>5 <p style="margin: 4px 0 0 0;"><strong>IANA-Registered Format for AI Context</strong> · <code>application/vnd.faf+yaml</code></p>6 </div>7</div>89> **.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.1011[](https://github.com/anthropics/claude-code-action)12[](https://github.com/Wolfe-Jam/claude-faf-mcp/actions/workflows/ci.yml)13[](https://www.npmjs.com/package/claude-faf-mcp)14[](https://www.npmjs.com/package/claude-faf-mcp)15[](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)16[](https://faf.one)17[](https://opensource.org/licenses/MIT)1819---2021## The Problem: Context-Drift2223AI assistants forget. They misunderstand. They drift.2425Every 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.2627**.FAF fixes this permanently.**2829---3031## The Solution: Gold Code3233```34━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━35🏆 FAF AI-READINESS SCORE: 100/100 — GOLD CODE36━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━3738At 100%, AI is optimized. No more guessing.39Peak AI performance activated.4041├─ Project DNA locked in ├─ Zero context-drift42├─ Architecture understood ├─ Eternal bi-sync active43├─ Domain model captured ├─ Team alignment permanent44└─ Every session starts smart └─ AI works WITH you, not around you4546━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━47```4849**Gold Code = AI Optimized.** Your project DNA lives in `project.faf`. AI reads it instantly. Context never drifts.5051---5253## 🔄 Eternal Bi-Sync5455The magic: `.faf` ↔ `CLAUDE.md` stay synchronized in milliseconds.5657```58project.faf ←──── 8ms ────→ CLAUDE.md59 │ │60 └── Single source of truth ──┘61```6263- Update either file → both stay aligned64- Zero manual maintenance65- Works across teams, branches, sessions66- **Context never goes stale**6768---6970## Tier System: From Blind to Optimized7172| Tier | Score | Status |73|------|-------|--------|74| 🏆 **Trophy** | 100% | **AI Optimized** — Gold Code |75| 🥇 **Gold** | 99%+ | Near-perfect context |76| 🥈 **Silver** | 95%+ | Excellent |77| 🥉 **Bronze** | 85%+ | Production ready |78| 🟢 **Green** | 70%+ | Solid foundation |79| 🟡 **Yellow** | 55%+ | AI flipping coins |80| 🔴 **Red** | <55% | AI working blind |81| 🤍 **White** | 0% | No context at all |8283**At 55%, AI is guessing half the time.** At 100%, AI is optimized.8485---8687## 💎 Lifecycle Value8889Setup savings get you started. Lifecycle optimization keeps you ahead.9091| When | Without FAF | With FAF |92|------|-------------|----------|93| **Day 1** | 20 min setup per dev | 0 min — instant context |94| **Month 1** | AI forgets between sessions | AI remembers everything |95| **Year 1** | New devs re-explain everything | New devs inherit full context |96| **Year 3+** | Institutional knowledge lost | Project DNA preserved forever |9798**Setup savings: 20 minutes. Lifecycle savings: Infinite.**99100---101102## ⚡ Quick Start103104**Copy and paste this to Claude/your AI:**105106> 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.107108**One-Click Alternative:** [Desktop Extension (.mcpb)](https://github.com/Wolfe-Jam/claude-faf-mcp/releases/latest)109110---111112## 🛠️ 52 MCP Tools113114All tools run standalone — zero CLI dependencies, 16.2x faster than process spawning.115116| Tool | Purpose |117|------|---------|118| `faf_init` | Initialize project DNA |119| `faf_score` | Check AI-readiness (0-100%) |120| `faf_sync` | Bi-sync .faf ↔ CLAUDE.md |121| `faf_auto` | Auto-detect and populate context |122| `faf_enhance` | Intelligent enhancement |123| `faf_quick` | Lightning-fast creation (3ms) |124| `faf_readme` | Extract 6 Ws from README (+25-35% boost) |125| `faf_sixws` | **NEW:** 6Ws Builder - Interactive web form + CLI integration |126| `faf_human_add` | Add human context (Claude Code compatible) |127128**Performance:** 19ms average execution. Fastest: 1ms.129130### ✨ New in v4.3.0: 6Ws Builder131132Answer 6 questions to create AI-ready context:1331341. **WHO** - Who is this for?1352. **WHAT** - What does it do?1363. **WHERE** - Where does it run?1374. **WHY** - Why does it exist?1385. **WHEN** - When to use it?1396. **HOW** - How to get started?140141**Complete Workflow in Claude Desktop:**142143```144User → Claude: "Help me add context to my project"145Claude → User: "Visit faf.one/6ws to fill out the 6 questions"146User → Fills form → Copies human_context YAML147User → Claude: [Pastes YAML]148Claude → Uses faf_human_add tool → Context merged!149Claude → Runs faf_score → Shows new AI-readiness score ✨150```151152**Two ways to use:**153- **Web (Recommended):** [faf.one/6ws](https://faf.one/6ws) — Fill form, copy YAML, use `faf_human_add` in Claude154- **CLI:** `faf 6ws` — Interactive paste-back workflow (terminal)155156**Score Boost:** Completing all 6 Ws typically adds +25-35% to your AI-readiness score!157158Works with Claude, Gemini, Grok, Cursor, Codex, WARP, any AI assistant.159160### 📄 Alternative: Auto-Extract from Existing README161162Already have a README.md? Skip the form and extract context automatically:163164**In Claude Desktop:**165166```167User → Claude: "Extract context from my README"168Claude → Uses faf_readme tool → Automatically extracts WHO/WHAT/WHERE/WHY/WHEN/HOW169Claude → Shows extracted context with confidence scores170User → "Merge it!"171Claude → Uses faf_readme { merge: true } → Context added to project.faf172Claude → Runs faf_score → Shows new AI-readiness score ✨173```174175**What faf_readme extracts:**176- **WHAT**: Project description, taglines, TL;DR sections177- **WHY**: Problem statements, benefits, motivation178- **WHO**: Target audience ("for developers", "built for teams")179- **WHERE**: Platforms (npm, pip, Docker, cloud, browser)180- **WHEN**: Status badges, version info, test counts181- **HOW**: Quick Start commands, installation instructions182183**Usage:**184```javascript185// Just extract (see what's found)186faf_readme187188// Extract and merge into project.faf189faf_readme { merge: true }190191// Overwrite existing fields192faf_readme { merge: true, overwrite: true }193```194195**Same score boost:** +25-35% typical, instant results, zero manual work!196197---198199## 🎯 The .FAF Position200201```202 Model Context Protocol203 ───── ─────── ────────204 Claude → .faf → MCP205 Gemini → .faf → MCP206 Codex → .faf → MCP207 Any LLM → .faf → MCP208```209210**.FAF is the foundational layer.** Universal context format. IANA-registered (`application/vnd.faf+yaml`). Works with any AI.211212---213214## 📦 Ecosystem215216- **[faf-cli](https://www.npmjs.com/package/faf-cli)** — CLI tool v4.3.0 (21k+ downloads, 671/671 tests passing)217- **[faf.one/6ws](https://faf.one/6ws)** — 6Ws Builder (Web + CLI integration)218- **[MCPaaS](https://mcpaas.live)** — MCP as a Service (The Endpoint for Context)219- **[faf-wasm](https://www.npmjs.com/package/faf-wasm)** — WASM SDK (<5ms scoring)220- **[Chrome Extension](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)** — Browser integration221- **[faf.one](https://faf.one)** — Official website222223---224225## 📚 Documentation226227- **[Full Documentation](https://wolfe-jam.github.io/claude-faf-mcp/)**228- **[MCP Tools Reference](https://github.com/Wolfe-Jam/claude-faf-mcp/blob/main/docs/mcp-tools.md)**229230---231232## 📄 License233234MIT License — Free and open source235236---237238**Zero drift. Eternal sync. AI optimized.** 🏆239240*"It's so logical if it didn't exist, AI would have built it itself" — Claude*241
Full transparency — inspect the skill content before installing.