# Foundational AI-Context Format

STOP faffing About!

THE context file - more important than package.json to AI. Your project's DNA in a format AI actually understands.

20,000+ npm downloads across the FAF ecosystem

"package.json wasn't built for this, .faf was!"

package.json gives me a static list. .faf shows me what to do!

Install Now View on GitHub

## The Magic Moment

Watch how faf-cli transforms any project into perfect AI context in seconds

Boris-Flow: 12-test integration suite validating the complete Claude Code ecosystem

## F1-Inspired Performance

⚡

### Lightning Fast

Generation in <20ms. Scoring in <100ms. Validation in <50ms. Every millisecond matters.

🎯

### AI/Human YinYang Balance

Revolutionary 50/50 context weighting. Human identity drives the project, technical excellence enables it.

🔍

### Smart Detection

Supports 153+ project patterns. TypeScript, Python, React, Vue, Node.js - all detected automatically.

📊

### Quality Scoring

0-100% completeness score with actionable feedback. Know exactly what's missing for better AI context.

🚫

### .fafignore Support

Exclude what you don't need. Built-in security patterns plus full user customization.

🏁

### RAW Tested

85% score from Claude AI, positive from Gemini. Tested with real AI assistants, not synthetic data.

## Get Started in 30 Seconds

    # Install globally
    npm install -g faf-cli

    # Generate .faf file for your project
    faf init

    # See your score and get AI-ready
    faf score --details

Start Building