TL;DR: faf compile is now a first-class CLI command — no external toolchain needed. Plus: Mk4 canonical slot names, tri-sync topic files for Claude Code memory, and a README that went from 684 lines to 164. Built for the solo developer shipping at midnight and the enterprise team shipping at scale.

What's New

faf compile — Binary in One Command

Your .faf is YAML. Human-readable. AI-consumable. But YAML has overhead — parsing, whitespace, encoding. faf compile turns it into .fafb: a CRC32-sealed binary with a 32-byte header, section table, and deterministic output.

Previously this required the Rust toolchain installed separately. Now it runs through the WASM scoring kernel — same compiler, zero dependencies.

faf compile

faf decompile project.fafb

Mk4 Slot Renames — Enterprise DNA

Six canonical slot names, aligned with the Mk4 scoring engine that powers every FAF runtime:

frontend → framework
css_framework → css
state_management → state
api_type → api
database → db
package_manager → pkg_manager

Full backward compatibility. Old .faf files score identically. New files use the canonical names. The alias map is the single source of truth.

Tri-sync Topic Files — Claude Code Memory

faf bi-sync keeps .faf and CLAUDE.md in sync. Now tri-sync adds a third leg: Claude Code's native memory format.

Six topic types — project, stack, context, preferences, key_files, state — each written as individual memory files with frontmatter. Your project DNA flows into Claude's persistent memory. Context that survives across conversations.

README — 684 Lines to 164

Enterprise documentation doesn't mean enterprise-length READMEs. We moved deep-dive content into docs/ — Guide, Scoring, Sync, Testing, Skills, Ecosystem — and kept the README focused: install, commands, links. Same pattern as Vite, Astro, Tailwind.

The Enterprise Angle

FAF started as one developer solving their own problem. Now it scales to any team size:

Solo dev: faf auto — zero to 100% in one command
Small team: faf bi-sync — .faf and CLAUDE.md stay in sync, 8ms
Enterprise: Mk4 canonical names, compiled binaries, topic-file memory, structured docs

Same CLI. Same format. Same IANA-registered MIME type. Whether you're shipping a side project or managing 500 repositories.

Try It

npm install -g faf-cli@5.2.0

bunx faf-cli compile

The Numbers

v5.2.0 — Released March 19, 2026
1,184/1,184 — Tests passing (52 suites)
100% — Trophy score
36,000+ — Downloads across 3 registries
169µs — Average scoring engine on a 2019 iMac