faf

Overview

The Foundational AI-Context Format (FAF) is an IANA-registered open format that transforms project context into structured data that AI systems can instantly understand. It provides a universal, shareable context format for any AI tool, human, or team. The project includes MCP servers that enable Claude and other AI systems to access project context through the FAF format, which exists as a YAML file with detailed information about dependencies, architecture, and project goals. The ecosystem has over 27,000 downloads across multiple implementations.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• faf_init

  Initialize a new FAF project

  Try:Initialize a new FAF project for my appTry:Create a project.faf file
• faf_migrate

  Migrate legacy .faf files to visible project.faf

  Try:Migrate my .faf file to project.fafTry:Convert old FAF format to new format
• faf_git

  Analyze GitHub repository and create project.faf

  Try:Analyze https://github.com/user/repo and create project.fafTry:Generate FAF context from a GitHub repository
• faf_score

  Calculate context completeness score for FAF files

  Try:What's the FAF score for my project?Try:Check my project's context completeness
• faf_bi-sync

  Generate multiple AI instruction formats from FAF

  Try:Generate AGENTS.md, .cursorrules, CLAUDE.md, and GEMINI.md from project.fafTry:Create documentation for different AI platforms
• faf_convert

  Convert any file type to .faf format

  Try:Convert package.json to project.fafTry:Transform my README to FAF format

Note: Tool names inferred from CLI examples and descriptions in the README. The repository contains the format specification but the actual MCP tools are provided by separate packages like claude-faf-mcp.

Comparable tools

Installation

npm install -g faf-cli
cd your-project
faf init

npm install -g claude-faf-mcp

{
  "mcpServers": {
    "faf": {
      "command": "claude-faf-mcp",
      "args": []
    }
  }
}

FAQ

What is FAF?

FAF (Foundational AI-Context Format) is an IANA-registered open format for AI context that transforms project information into structured data that AI systems can instantly understand.

How does FAF compare to other AI context files?

Unlike markdown-based context files (like .cursorrules or CLAUDE.md), FAF uses structured YAML, is IANA-registered as an Internet standard, supports scoring, and can generate all other AI-specific formats from a single source.

What AI platforms support FAF?

FAF has MCP servers for Claude, and implementations for Grok, Gemini, and other platforms. It's designed to be universal and works with any AI coding assistant.

On Hacker News

Recent discussion from the developer community.

• Show HN: FAF – The package.json for AI context (IANA registered)▲ 1
  Story by wolfejam · 2026-01-29

Compare faf with