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
claude-faf-mcp
**IANA-Registered Format for AI Context** · application/vnd.faf+yaml
.FAF optimizes AI for your codebase. At 100% (Gold Code), AI stops guessing and starts knowing. Live bi-sync between
.faf↔CLAUDE.mdmeans zero context-drift — your project DNA stays aligned with AI, forever.
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.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏆 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.
The magic: .faf ↔ CLAUDE.md stay synchronized in milliseconds.
project.faf ←──── 8ms ────→ CLAUDE.md
│ │
└── Single source of truth ──┘
| 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 | 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)
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.
Answer 6 questions to create AI-ready context:
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:
faf_human_add in Claudefaf 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.
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:
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!
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.
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
Install via CLI
npx mdskills install Wolfe-Jam/claude-faf-mcpClaude Faf MCP is a free, open-source AI agent skill. 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
Install Claude Faf MCP with a single command:
npx mdskills install Wolfe-Jam/claude-faf-mcpThis downloads the skill files into your project and your AI agent picks them up automatically.
Claude Faf MCP works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.