Tools: Define your project once, generate AGENTS.md + .cursorrules + CLAUDE.md + GEMINI.md

Tools: Define your project once, generate AGENTS.md + .cursorrules + CLAUDE.md + GEMINI.md

Source: Dev.to

Every AI coding tool invented its own context file: Four prose files. Four places to keep in sync. Update one, forget another. Context rot starts day one. What if there was one source of truth? project.faf is ~35 lines of structured YAML. IANA-registered as application/vnd.faf+yaml. It defines your project once — stack, goals, conventions, architecture — and generates all four formats: npm i -g faf-cli faf bi-sync --all That's it. CLAUDE.md + AGENTS.md + .cursorrules + GEMINI.md from one file. Three layers, three jobs: What shipped in v4.5.0: MIT licensed. Free forever. 23,000+ npm downloads across the ecosystem. Blog post with diagrams: https://faf.one/blog/agents-md-edition GitHub: https://github.com/Wolfe-Jam/faf-cli Templates let you quickly answer FAQs or store snippets for re-use. Are you sure you want to hide this comment? It will become hidden in your post, but will still be visible via the comment's permalink. Hide child comments as well For further actions, you may consider blocking this person and/or reporting abuse - .faf defines — structured YAML, machine-readable, single source of truth
- .md files instruct — prose for each tool, generated from .faf
- AI interprets — each tool reads its native format, no translation needed - faf agents import/export/sync — full AGENTS.md interop
- faf cursor import/export/sync — full .cursorrules interop
- faf bi-sync --all — every format in one pass
- 87 new tests caught 3 cross-platform bugs (Windows \r\n, UTF-8 BOM, old Mac \r) before any user ever would
- 1,051 tests passing total