From faf
Manages .faf files for persistent AI project context: creates/updates YAML files, scores AI-readiness (0-100%), runs faf-cli commands (init/auto/score/bi-sync), syncs CLAUDE.md, configures MCP servers with tool visibility.
npx claudepluginhub wolfe-jam/faf-cliThis skill uses the workspace's default tool permissions.
`.faf` is the universal format for persistent AI project context - "Project DNA ✨ for ANY AI".
Configures IANA-registered .faf files for AI project context, MCP servers, championship scoring, and bi-directional sync across Claude, Cursor, Gemini, Windsurf.
Generates or updates CLAUDE.md/AGENTS.md files for AI coding agents via project scanning and interactive Q&A. Supports multiple tech stacks, preserves customizations.
Provides research notes on Claude Code's agent architecture including prompt assembly, orchestration, skills, plugins, hooks, MCP, and tool pipelines. Useful for developers building coding agents.
Share bugs, ideas, or general feedback.
.faf is the universal format for persistent AI project context - "Project DNA ✨ for ANY AI".
Core Concepts:
Activate this skill when:
.faf filesCLAUDE.md filesfaf CLI commands (init, auto, score, formats, bi-sync).faf - YAML format, machine-readable project contextCLAUDE.md - Markdown format, human-readable project guide.faf ↔ CLAUDE.md kept in sync automaticallyproject.faf - v1.2.0 standard namingfaf init # Create .faf from project
faf auto # Auto-detect stack and create .faf
faf score # Rate AI-readiness (0-100%)
faf formats # List 153+ supported formats
faf bi-sync # Sync .faf ↔ CLAUDE.md
faf status # Check project AI-readiness
faf validate # Validate .faf structure
faf doctor # Diagnose and fix issues
faf migrate # Migrate to latest format
v2.8.0 introduces Tool Visibility System:
Configuration:
{
"mcpServers": {
"faf": {
"command": "npx",
"args": ["-y", "claude-faf-mcp@2.8.0"],
"env": {
"FAF_MCP_SHOW_ADVANCED": "false"
}
}
}
}
Core Tools (21):
faf, faf_auto, faf_init, faf_innit, faf_statusfaf_score, faf_validate, faf_doctor, faf_auditfaf_formats, faf_stacks, faf_skills, faf_install_skillfaf_sync, faf_bi_sync, faf_update, faf_migratefaf_chat, faf_enhancefaf_index, faf_faq, faf_aboutAdvanced Tools (30+):
Set FAF_MCP_SHOW_ADVANCED: "true" to enable:
faf_display, faf_show, faf_checkfaf_trust, faf_trust_confidence, faf_trust_garagefaf_read, faf_write, faf_list, faf_exists, etc.faf_dna, faf_log, faf_auth, faf_recoverfaf_choose, faf_clear, faf_share, faf_creditChampionship Tiers:
Target: 85%+ for production projects
# Basic .faf structure
format: typescript-nextjs
language: typescript
framework: nextjs
version: "14.0.0"
structure:
- src/
- components/
- pages/
dependencies:
react: "^18.0.0"
next: "^14.0.0"
testing: jest
deployment: vercel
# v1.2.0+ additions
project_name: "My Project"
ai_readiness_score: 87
faf auto - Let it detect your stackfaf score - Target 85%+ for championship contextfaf bi-sync - Keep .faf and CLAUDE.md in sync6 Championship Integrations:
npm install -g faf-cli
brew install faf-cli
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"faf": {
"command": "npx",
"args": ["-y", "claude-faf-mcp@latest"]
}
}
}
For advanced tools:
{
"mcpServers": {
"faf": {
"command": "npx",
"args": ["-y", "claude-faf-mcp@latest"],
"env": {
"FAF_MCP_SHOW_ADVANCED": "true"
}
}
}
}
Problem Solved: Reduced cognitive load from 51 tools to 21 core tools.
How It Works:
Categories:
workflow - Essential commandsquality - Scoring and validationintelligence - Format/stack detectionsync - Context synchronizationai - AI enhancement featureshelp - Documentationtrust - Trust validationfile - File operationsutility - Misc toolsConfiguration Priority:
FAF_MCP_SHOW_ADVANCED)~/.fafrc)The Noodle Philosophy 🍜
Format-First
Official Stewardship
brew install faf-cliWJTTC (WolfeJam Technical & Testing Center)
# Check logs
tail -f ~/Library/Logs/Claude/mcp-server-claude-faf-mcp.log
# Verify config
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Test locally
node /path/to/claude-faf-mcp/dist/src/index.js
# Should show 21 core tools (default)
# Or 51 tools (advanced mode)
# Check console output when MCP loads
# Install globally
npm install -g faf-cli
# Or via Homebrew
brew install faf-cli
# Verify installation
faf --version
Create ~/.fafrc:
{
"showAdvanced": true
}
Or key=value format:
FAF_SHOW_ADVANCED=true
# Use local build
{
"mcpServers": {
"faf": {
"command": "node",
"args": ["/path/to/claude-faf-mcp/dist/src/index.js"],
"env": {
"FAF_MCP_SHOW_ADVANCED": "false"
}
}
}
}
To disable this skill temporarily:
# Rename directory to disable
mv ~/.claude/skills/faf-expert ~/.claude/skills/faf-expert.disabled
To re-enable:
# Rename back to enable
mv ~/.claude/skills/faf-expert.disabled ~/.claude/skills/faf-expert
Or just delete the directory to remove completely.
Option 1: Manual Installation
~/.claude/skills/faf-expert/~/.claude/skills/faf-expert/SKILL.mdOption 2: Git Clone (if published)
# Coming soon - published skills repository
git clone [skills-repo] ~/.claude/skills/faf-expert
Option 3: From FAF CLI (future)
# Planned feature
faf skill install faf-expert
Made with 🧡 by wolfejam.dev Official Anthropic MCP Steward Championship Edition v2.8.0 🏎️✨ IANA-Registered Format: application/vnd.faf+yaml (Oct 31, 2025)