Utilizes a specialized IANA-registered YAML format (application/vnd.faf+yaml) to store and manage structured project context, enabling rapid scoring and synchronization of AI-readiness.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@claude-faf-mcpcreate a project.faf for my Express API with JWT auth"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
.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.
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
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.
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 |
| Initialize project DNA |
| Check AI-readiness (0-100%) |
| Bi-sync .faf ↔ CLAUDE.md |
| Auto-detect and populate context |
| Intelligent enhancement |
| Lightning-fast creation (3ms) |
| Extract 6 Ws from README (+25-35% boost) |
| Add human context (Claude Code compatible) |
Performance: 19ms average execution. Fastest: 1ms.
🎯 The .FAF Position
.FAF is the foundational layer. Universal context format. IANA-registered (application/vnd.faf+yaml). Works with any AI.
📦 Ecosystem
MCPaaS — MCP as a Service (The Endpoint for Context)
faf-cli — CLI tool (18k+ downloads)
faf-wasm — WASM SDK (<5ms scoring)
Chrome Extension — Browser integration
faf.one — Official website
📚 Documentation
📄 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
