Skip to main content
Glama

.FAF optimizes AI for your codebase. At 100% (Gold Code), AI stops guessing and starts knowing. Live bi-sync between .fafCLAUDE.md means zero context-drift — your project DNA stays aligned with AI, forever.

Claude Code CI NPM Downloads npm version Chrome Web Store Website License: MIT


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


📄 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

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Wolfe-Jam/claude-faf-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server