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) |
| NEW: 6Ws Builder - Interactive web form + CLI integration |
| 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:
WHO - Who is this for?
WHAT - What does it do?
WHERE - Where does it run?
WHY - Why does it exist?
WHEN - When to use it?
HOW - How to get started?
Complete Workflow in Claude Desktop:
Two ways to use:
Web (Recommended): faf.one/6ws — Fill form, copy YAML, use
faf_human_addin ClaudeCLI:
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:
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:
Same score boost: +25-35% typical, instant results, zero manual work!
🎯 The .FAF Position
.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
📄 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