FAF Agent

📖 Public About Repo — this is the public face of Wolfe-Jam/faf-agent (source private). Spec, README, format docs, skill manifest, project.faf — no source code. Same shape as Anthropic's claude-code repo: public face, private engine.

The Voice of FAF.

A sensible, reliable agent that knows the most about the FAF format. It validates, scores, and answers questions about .faf, .fafm, and .fafa documents — always citing the spec or clearly refusing when a question is outside scope.

Exactly the size of FAF. No more, no less.

.faf 🐘🎙️

---

What it does

• Validates and scores .faf documents (faf-cli kernel; native in v0.2.0)
• Answers specification questions with citations
• Refuses out-of-scope questions cleanly
• Maintains voice-native memory on a namepoint

What it does not do

• General-purpose reasoning or coding
• Answer questions unrelated to the FAF format

Install

uvx faf-agent-mcp

Usage

# Via Claude Code, Cursor, or any MCP host

Home: faf.one/agent · Passport: faf.one/.well-known/fafa · Spec: AGENT-FORMAT.md

Citation

If you use faf-agent, faf-agent-mcp, or the .fafa format in research or production, please cite the format paper:

Wolfe, J. (2026). Why Agents Need a Passport: .fafa — Portable Identity for the Agentic Era. Zenodo. https://doi.org/10.5281/zenodo.21951641

Companion papers: Context (.faf) · Memory (.fafm).

BibTeX

@article{wolfe2026fafa,
  title     = {Why Agents Need a Passport: .fafa — Portable Identity for the Agentic Era},
  author    = {Wolfe, James},
  year      = {2026},
  month     = {aug},
  publisher = {Zenodo},
  doi       = {10.5281/zenodo.21951641},
  url       = {https://doi.org/10.5281/zenodo.21951641}
}

License MIT

If faf-agent has been useful, consider starring the repo — it helps others find it.