claude-faf-mcp

Tell AI what you're building, who it's for, and why it matters. 30 seconds. 🐘 It never forgets.

33 MCP tools. IANA-registered format (application/vnd.faf+yaml). 2,346 test executions per push.

The 3Ws — 3 Answers. That's It.

Every great product started with 3 answers to the 3Ws — Who, What, Why:

Same pattern. Every product that works starts here. .faf captures it:

human_context:
  who: "people who need a ride across town"
  what: "tap a button, car arrives in minutes"
  why: "taxis are slow, expensive, and hard to find"

30 seconds. Claude builds your project.faf from this. Every session after, AI starts smart.

The 6Ws — For Optimized AI

3Ws gets you started. For fully optimized AI, complete the set — Where, When, How:

  where: "mobile app, iOS and Android"    # where does it live?
  when: "launch in 3 months"              # when is it shipping?
  how: "GPS matching, real-time pricing"  # how does it work?

3Ws initiates the project with AI. 6Ws optimizes AI to 100%. Same YAML, same file. More examples → faf.one/ideas

Quick Start

Copy and paste this to Claude:

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.

Then tell Claude your 3Ws: "I'm building [what] for [who] because [why]"

How It Works

You → 3 answers → project.faf → AI reads it → every session → forever

project.faf  ←── 8ms ──→  CLAUDE.md     (bi-sync, free)
project.faf  ←── 8ms ──→  MEMORY.md     (tri-sync, Pro 🐘)

Claude does the rest. Zero-effort, right first time, fast, accurate, done. Language, framework, package manager, build tools — all auto-detected from your existing files. The human context is the part only you can give.

Scoring: From Blind to Optimized

At 55%, AI guesses half the time. At 100%, AI knows your project. Same compiler as faf-cli — same score everywhere.

33 MCP Tools

All tools run standalone — zero CLI dependencies, 19ms average execution.

Create & Detect

Validate & Score

Sync & Persist

Export & Interop

Read & Write

Full tool reference →

🐘 Nelly Never Forgets (Pro)

bi-sync keeps .faf ↔ CLAUDE.md aligned. Free forever.

tri-sync adds MEMORY.md — your AI remembers across sessions. Feed Nelly, she never forgets.

bi-sync  = .faf ↔ CLAUDE.md              ← free forever
tri-sync = .faf ↔ CLAUDE.md ↔ MEMORY.md  ← Pro 🐘

$3/mo · $19/yr · $29/yr Global. 14-day free trial, no signup. Friends of FAF → faf.one/pro

The .FAF Position

Model        Context          Protocol
─────        ───────          ────────
Claude    →   .faf        →    MCP
Gemini    →   .faf        →    MCP
Codex     →   .faf        →    MCP
Any LLM   →   .faf        →    MCP

IANA-registered (application/vnd.faf+yaml). Works with any AI. Define once, use everywhere.

Ecosystem

Same project.faf. Same scoring. Same result. Different execution layer.

Quality

391 tests · 12 suites · 6 platforms (ubuntu/macos/windows × Node 18/20)

CI Dashboard →

Privacy

Everything runs locally. No data leaves your machine. No analytics, no telemetry, no tracking, no accounts. Privacy policy →

License

MIT — Free and open source

FAF Family

format | driven 🏎️⚡️ wolfejam.dev