TL;DR: faf auto now pulls your project name, goal, and version from your manifest files automatically. One command runs the full pipeline — init, detect, extract, sync, score. No questions, no prompts, no manual entry.

The One Command

bunx faf-cli auto

npx faf-cli auto

That's it. No install required. Run it in any project directory and watch:

faf auto
├── 1. Init        → Creates project.faf (or enhances existing)
├── 2. Detect      → TURBO-CAT discovers your stack (199 formats)
├── 3. Extract     → Pulls name, goal, version from manifests
├── 4. Sync        → Generates CLAUDE.md (bi-sync)
└── 5. Score       → Reports AI-readiness with before/after delta

What's New in v5.0.5

Smart Metadata Extraction (v5.0.4)

faf auto now reads your manifest files and fills in the blanks:

package.json → project name, description, version
Cargo.toml → crate name, description, version
pyproject.toml → package name, description, version

Before this, faf auto would leave placeholder values like name: my-project that you had to fill in manually. Now it reads your actual project metadata and fills them in for you.

CLI Detection Fix (v5.0.5)

Restored proper CLI detection in the init command. The FrameworkDetector was incorrectly overriding the project type — fixed with safe fallbacks and no crashes on missing fields.

Why faf auto Matters

Every developer using AI coding assistants has the same problem: the AI doesn't know your project. It guesses. It asks. It assumes. Every session.

faf auto fixes this in one command:

Before: AI working blind — guessing your stack, your goals, your conventions
After: AI has structured context — scored, validated, synced to CLAUDE.md

91% token reclaim out the gate

Relentless pursuit to 100% faf auto

The Full Pipeline

faf auto

For existing projects — already have a project.faf? faf auto enhances it. Detects what's missing, fills it in, re-scores. Idempotent — run it as many times as you want.

faf bi-sync

Keep CLAUDE.md synchronized. 8ms. Deterministic. No string surgery.

Try It

bunx faf-cli auto

No install. No clone. One command. Your project gets a project.faf, a synced CLAUDE.md, and a score. Done.

For daily use:

bun install -g faf-cli

npm install -g faf-cli

The Numbers

v5.0.5 — Released March 12, 2026
1,108/1,108 — Tests passing (49 suites)
100% — Trophy score (Gold Code)
199 — TURBO-CAT format detection
64 — CLI commands
8ms — Bi-sync speed

Your CLAUDE.md Is Not a Foundation — why structured context beats prose, and why faf auto is the answer.

The faf auto Edition