Claude-FAF-MCP

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

---

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)

---

🛠️ 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_sixws	NEW: 6Ws Builder - Interactive web form + CLI integration
faf_human_add	Add human context (Claude Code compatible)

Performance: 19ms average execution. Fastest: 1ms.

✨ New in v4.3.0: 6Ws Builder

Answer 6 questions to create AI-ready context:

1. WHO - Who is this for?
2. WHAT - What does it do?
3. WHERE - Where does it run?
4. WHY - Why does it exist?
5. WHEN - When to use it?
6. HOW - How to get started?

Complete Workflow in Claude Desktop:

User → Claude: "Help me add context to my project"
Claude → User: "Visit faf.one/6ws to fill out the 6 questions"
User → Fills form → Copies human_context YAML
User → Claude: [Pastes YAML]
Claude → Uses faf_human_add tool → Context merged!
Claude → Runs faf_score → Shows new AI-readiness score ✨

Two ways to use:

• Web (Recommended): faf.one/6ws — Fill form, copy YAML, use faf_human_add in Claude
• CLI: faf 6ws — Interactive paste-back workflow (terminal)

Score Boost: Completing all 6 Ws typically adds +25-35% to your AI-readiness score!

Works with Claude, Gemini, Grok, Cursor, Codex, WARP, any AI assistant.

📄 Alternative: Auto-Extract from Existing README

Already have a README.md? Skip the form and extract context automatically:

In Claude Desktop:

User → Claude: "Extract context from my README"
Claude → Uses faf_readme tool → Automatically extracts WHO/WHAT/WHERE/WHY/WHEN/HOW
Claude → Shows extracted context with confidence scores
User → "Merge it!"
Claude → Uses faf_readme { merge: true } → Context added to project.faf
Claude → Runs faf_score → Shows new AI-readiness score ✨

What faf_readme extracts:

• WHAT: Project description, taglines, TL;DR sections
• WHY: Problem statements, benefits, motivation
• WHO: Target audience ("for developers", "built for teams")
• WHERE: Platforms (npm, pip, Docker, cloud, browser)
• WHEN: Status badges, version info, test counts
• HOW: Quick Start commands, installation instructions

Usage:

// Just extract (see what's found)
faf_readme

// Extract and merge into project.faf
faf_readme { merge: true }

// Overwrite existing fields
faf_readme { merge: true, overwrite: true }

Same score boost: +25-35% typical, instant results, zero manual work!

---

🎯 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

• faf-cli — CLI tool v4.3.0 (21k+ downloads, 671/671 tests passing)
• faf.one/6ws — 6Ws Builder (Web + CLI integration)
• MCPaaS — MCP as a Service (The Endpoint for Context)
• faf-wasm — WASM SDK (<5ms scoring)
• Chrome Extension — Browser integration
• faf.one — Official website

---

📚 Documentation

• Full Documentation
• MCP Tools Reference

---

📄 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