faf-mcp 1.0.5 → 1.1.0

package/.faf

@@ -0,0 +1,10 @@
+project:
+  name: faf-mcp
+  goal: Universal MCP server for all platforms
+instant_context:
+  tech_stack: Node.js/TypeScript
+  main_language: TypeScript
+  what_building: Universal FAF MCP Server - AI Context Intelligence for All Platforms
+metadata:
+  last_claude_sync: 2025-11-13T20:02:49.198Z
+  bi_sync: active

package/CLAUDE.md

@@ -13,6 +13,20 @@
 - **Stack:** Node.js/TypeScript
 - **Quality:** F1-INSPIRED (Championship Performance)
 
+## 💡 Quick Start for AI
+
+**Q: How do I get started?**
+
+**A: Just USE FAF**
+
+```
+Use FAF to initialize your project
+Use FAF to sync my project.faf to all platforms
+Use FAF to score my AI-readiness
+```
+
+That's it! Start every prompt with "**Use FAF**" and the MCP tools will handle the rest.
+
 ### Our Mission - Universal MCP Integration
 
 **v1.0.0 Launch: PLATFORM-AGNOSTIC**

package/README.md

@@ -1,21 +1,12 @@
 <div style="display: flex; align-items: center; gap: 12px;">
   <img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/logos/orange-smiley.svg" alt="FAF" width="40" />
   <div>
-    <h1 style="margin: 0; color: #FF8C00;">USE>FAF™</h1>
+    <h1 style="margin: 0; color: #FF8C00;">faf-mcp | use>faf</h1>
     <p style="margin: 4px 0 0 0;"><strong>IANA-Registered Format for AI Context</strong> · <code>application/vnd.faf+yaml</code></p>
   </div>
 </div>
 
-> **Universal MCP server** for .FAF (Foundational AI-context Format) with 50 tools
-> Works with Claude Desktop, Cursor, Windsurf, and all MCP-compatible platforms
-
-## 💡 Quick Start
-
-```
-Use FAF to initialize your project
-```
-
-That's it! Start every prompt with "**Use FAF**" and the MCP tools will handle the rest.
+> Universal MCP server for .FAF (Foundational AI-context Format) with 50 tools - Persistent project context for Cursor, Windsurf, Cline, VS Code, and all MCP-compatible platforms (including [Claude Desktop](https://github.com/Wolfe-Jam/claude-faf-mcp))
 
 [![NPM Downloads](https://img.shields.io/npm/dt/faf-mcp?label=total%20downloads&color=00CCFF)](https://www.npmjs.com/package/faf-mcp)
 [![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?logo=discord&logoColor=white)](https://discord.com/invite/3pjzpKsP)
@@ -25,17 +16,48 @@ That's it! Start every prompt with "**Use FAF**" and the MCP tools will handle t
 
 ---
 
-## 🏁 AI-Readiness Scorecard
+## ⚡ Quick Start
 
-**The closer you get to 100% the better AI can assist you.**
+**1. Install:**
 
-At 55% you are building your project with half a blueprint and basically flipping a coin with AI. .FAF defines, and AI becomes optimized for Context with the project.faf file.
+```bash
+npm install -g faf-mcp
+```
+
+**2. Copy and paste this to your AI:**
+
+```
+Install the FAF MCP server: npm install -g faf-mcp, then add this to my MCP config: {"mcpServers": {"faf": {"command": "npx", "args": ["-y", "faf-mcp"]}}} and restart.
+```
+
+### Platform-Specific Setup
+
+**Cursor IDE:** Add to `~/.cursor/mcp.json` ([setup guide](https://docs.cursor.com/context/model-context-protocol))
+
+**Windsurf Editor:** Add to `~/.codeium/windsurf/mcp_config.json` ([Cascade docs](https://docs.windsurf.com/windsurf/cascade/mcp))
+
+**Cline:** Add to Cline's MCP settings
+
+**VS Code:** Install MCP extension, then add server config
+
+**Claude Desktop:** Use the [dedicated claude-faf-mcp package](https://github.com/Wolfe-Jam/claude-faf-mcp) for optimized Claude integration
+
+---
+
+## 🏁 AI-Readiness Scorecard
+
+> **"README for the AI era"** — Google Gemini
 
 <div align="center">
-  <img src="./assets/Project-faf-pckg-json-README.png" alt="project.faf file positioning" width="600" />
-  <p><em>project.faf lives at the project root, between package.json and README.md</em></p>
+  <img src="https://raw.githubusercontent.com/Wolfe-Jam/faf-mcp/main/packages/faf-mcp/assets/Project-faf-pckg-json-README.png" alt="project.faf file positioning" width="600" />
+  <p><em><strong>project.faf is to AI context what package.json is to dependencies</strong></em></p>
+  <p><em>Lives at the project root, between package.json and README.md</em></p>
 </div>
 
+**The closer you get to 100% the better AI can assist you.**
+
+At 55% you are building your project with half a blueprint and basically flipping a coin with AI. .FAF defines, and AI becomes optimized for Context with the project.faf file.
+
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 🏎️  FAF AI-READINESS SCORE: 100/100 — PODIUM EDITION
@@ -59,24 +81,6 @@ At 55% you are building your project with half a blueprint and basically flippin
 
 ---
 
-## ⚡ Quick Start
-
-**Copy and paste this to Claude/your AI:**
-
-> Install the FAF MCP server: `npm install -g faf-mcp`, then add this to my MCP config: `{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "faf-mcp"]}}}` and restart.
-
-### Platform-Specific Setup
-
-**Claude Desktop:** Add to `claude_desktop_config.json` ([location guide](https://wolfe-jam.github.io/claude-faf-mcp/))
-
-**Cursor IDE:** Add to `~/.cursor/mcp.json` ([setup guide](https://docs.cursor.com/context/model-context-protocol))
-
-**Windsurf Editor:** Add to `~/.codeium/windsurf/mcp_config.json` ([Cascade docs](https://docs.windsurf.com/windsurf/cascade/mcp))
-
-**VS Code:** Install MCP extension, then add server config
-
----
-
 ## 🎯 Want a Platform-Specific Package?
 
 We're launching `faf-mcp` as the universal package. If you'd prefer a dedicated package for your platform (like `cursor-faf-mcp` or `windsurf-faf-mcp` with tailored setup instructions), **[request it here](https://github.com/Wolfe-Jam/faf-mcp/issues)**.
@@ -85,33 +89,48 @@ We'll publish platform-specific packages based on demand.
 
 ---
 
-## 💬 How to Use FAF (MCP Standard)
+## 💬 use>faf | Prompt Pattern
 
-Start every prompt with **"Use FAF"** to invoke the MCP tools:
+**Start every prompt with "Use FAF"** to invoke MCP tools directly:
 
-### Claude Desktop
+### All Platforms
 ```
 Use FAF to initialize my project
 Use FAF to sync my project.faf to all platforms
 Use FAF to score my AI-readiness
-```
-
-### Cursor IDE
-```
-Use FAF to create 4 context files from my project.faf
 Use FAF to enhance my project context
-Use FAF to migrate .faf to project.faf
+Use FAF to create platform sync files
 ```
 
-### Why "Use FAF"?
+### Why "Use FAF" Works Everywhere
+
+**Claude Desktop:**
+- ✅ Calls MCP tool instead of searching web
+- ✅ No void container issues
+- ✅ Direct tool invocation
 
-This is the **MCP standard** for explicit tool invocation. It tells the AI:
-- ✅ Use the installed MCP tool (not web search)
-- ✅ Don't create files manually
-- ✅ Invoke the proper FAF commands
+**Claude.ai (Web):**
+- ✅ Stops web search addiction immediately
+- ✅ Forces MCP tool usage
+- ✅ No more guessing
 
-**Without "Use FAF"**: AI might search the web or create files manually
-**With "Use FAF"**: AI calls the correct MCP tool every time
+**Cursor / Windsurf / Cline:**
+- ✅ MCP standard compliance
+- ✅ Tool invocation (not manual file creation)
+- ✅ Consistent behavior
+
+### The Pattern
+
+**Without "Use FAF":**
+- ❌ AI searches the web
+- ❌ AI creates files manually
+- ❌ Void containers
+- ❌ Inconsistent results
+
+**With "Use FAF":**
+- ✅ MCP tool called correctly
+- ✅ Championship output
+- ✅ Every time
 
 ---
 
@@ -122,11 +141,13 @@ This is the **MCP standard** for explicit tool invocation. It tells the AI:
 ```
   Platform      Context          Protocol
   ────────      ───────          ────────
-  Claude    →   .faf        →    MCP
+  Any IDE   →   IANA Format →    Open Protocol
   Cursor    →   .faf        →    MCP
   Windsurf  →   .faf        →    MCP
+  Cline     →   .faf        →    MCP
   VS Code   →   .faf        →    MCP
-  Any IDE   →   IANA Format →    Open Protocol
+  Claude    →   .faf        →    MCP
+  Gemini    →   .faf        →    MCP
 ```
 
 **.FAF is the foundational, universal base layer** for any platform using the Model Context Protocol. It provides the standardized Context that makes MCP work for everyone.
@@ -170,7 +191,17 @@ This is the **MCP standard** for explicit tool invocation. It tells the AI:
 
 ## 🏆 Why FAF?
 
-> "README for the AI era" — Gemini CLI
+### Championship Credentials
+
+**🏅 Creators of the Format** - We designed .FAF (IANA-registered `application/vnd.faf+yaml`)
+**🏅 First & Only** - Persistent Project Context MCP Server approved by Anthropic
+**🏅 Creators of Context-Mirroring** - faf_bi_sync creates native files for all platforms
+**🏅 Google Chrome-Approved** - Published Chrome Extension
+**🏅 12K+ npm Downloads** - Proven adoption across the ecosystem
+
+> "README for the AI era" — Google Gemini
+
+### The FAF Advantage
 
 **Persistent Context** - Your project's DNA lives in `project.faf`, readable by any AI or human
 
@@ -178,6 +209,10 @@ This is the **MCP standard** for explicit tool invocation. It tells the AI:
 
 **Zero Setup Tax** - One file (`project.faf`) eliminates AI context setup across your entire team
 
+**FREE FOREVER** - MIT License, open source, no subscription
+
+**All Boats Rise Together** - Improving projects, AI performance, code quality, speed to market for everyone
+
 **Championship Engineering** - F1-inspired performance with strict TypeScript, zero runtime errors
 
 ---

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "faf-mcp",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "mcpName": "io.github.Wolfe-Jam/faf-mcp",
-  "description": "USE>FAF™ - IANA-registered format (application/vnd.faf+yaml) • Universal AI context • MCP server for all platforms • Start with 'Use FAF'",
+  "description": "faf-mcp | use>faf • IANA-registered format (application/vnd.faf+yaml) • Universal MCP server for Cursor, Windsurf, Cline, VS Code, and all platforms",
   "icon": "./assets/icons/faf-icon-256.png",
   "logo": "./assets/icons/faf-icon-256.png",
   "displayName": ".faf 🧡⚡️",
@@ -85,6 +85,7 @@
     "README.md",
     "CLAUDE.md",
     ".faf",
+    "project.faf",
     "LICENSE",
     "CHANGELOG.md"
   ],

package/project.faf

@@ -0,0 +1,125 @@
+faf_version: 2.5.0
+ai_scoring_system: 2025-09-20
+ai_score: 85%
+ai_confidence: HIGH
+ai_value: 30_seconds_replaces_20_minutes_of_questions
+ai_tldr:
+  project: Faf Mcp - "USE>FAF™ - IANA-registered format (application/vnd.faf+yaml)
+    • Universal AI context • MCP server for all platforms • Start with 'Use
+    FAF'"
+  stack: CLI/TypeScript/TypeScript (tsc)/npm registry/Node.js
+  quality_bar: ZERO_ERRORS_F1_STANDARDS
+  current_focus: Production deployment preparation
+  your_role: Build features with perfect context
+instant_context:
+  what_building: USE>FAF™ - IANA-registered format (application/vnd.faf+yaml) •
+    Universal AI context • MCP server for all platforms • Start with 'Use FAF'
+  tech_stack: CLI/TypeScript/TypeScript (tsc)/npm registry/Node.js
+  main_language: TypeScript
+  deployment: npm registry
+  key_files:
+    - package.json
+    - tsconfig.json
+context_quality:
+  slots_filled: 16/21 (76%)
+  ai_confidence: GOOD
+  handoff_ready: true
+  missing_context:
+    - CI/CD pipeline
+    - Database
+project:
+  name: Faf Mcp
+  goal: USE>FAF™ - IANA-registered format (application/vnd.faf+yaml) • Universal
+    AI context • MCP server for all platforms • Start with 'Use FAF'
+  main_language: TypeScript
+  type: cli-ts
+  generated: 2025-11-13T20:02:03.291Z
+  mission: 🚀 Make Your AI Happy! 🧡 Trust-Driven 🤖
+  revolution: 30 seconds replaces 20 minutes of questions
+  brand: F1-Inspired Software Engineering - Championship AI Context
+ai_instructions:
+  how_to_start: "Just USE FAF - Start every prompt with 'Use FAF to...' and MCP tools handle the rest"
+  priority_order:
+    - 1. Read THIS .faf file first
+    - 2. Check CLAUDE.md for session context
+    - 3. Review package.json for dependencies
+  quick_commands:
+    - "Use FAF to initialize your project"
+    - "Use FAF to sync my project.faf to all platforms"
+    - "Use FAF to score my AI-readiness"
+  working_style:
+    code_first: true
+    explanations: minimal
+    quality_bar: zero_errors
+    testing: required
+  warnings:
+    - Never modify dial components without approval
+    - All TypeScript must pass strict mode
+    - Test coverage required for new features
+stack:
+  frontend: CLI
+  css_framework: None
+  ui_library: None
+  state_management: None
+  backend: Node.js
+  runtime: Node.js >=18.0.0
+  database: None
+  build: TypeScript (tsc)
+  package_manager: npm
+  api_type: CLI
+  hosting: npm registry
+  cicd: None
+preferences:
+  quality_bar: zero_errors
+  commit_style: conventional_emoji
+  response_style: concise_code_first
+  explanation_level: minimal
+  communication: direct
+  testing: required
+  documentation: as_needed
+state:
+  phase: development
+  version: 1.0.0
+  focus: production_deployment
+  status: green_flag
+  next_milestone: npm_publication
+  blockers: null
+tags:
+  auto_generated:
+    - faf-mcp
+    - cli
+    - typescript
+    - typescript-(tsc)
+    - npm-registry
+    - node.js
+  smart_defaults:
+    - .faf
+    - ai-ready
+    - "2025"
+    - software
+    - open-source
+  user_defined: null
+human_context:
+  who: Development teams
+  what: "everything:"
+  why: To MCP work for everyone
+  where: Web platform
+  when: Production/Stable
+  how: Use FAF to initialize your project
+  additional_context: null
+  context_score: 0
+  total_prd_score: 85
+  success_rate: 50%
+ai_scoring_details:
+  system_date: 2025-09-20
+  slot_based_percentage: 76
+  ai_score: 85
+  total_slots: 21
+  filled_slots: 16
+  scoring_method: Honest percentage - no fake minimums
+  trust_embedded: COUNT ONCE architecture - trust MY embedded scores
+faf_dna:
+  birth_dna: 22
+  birth_certificate: FAF-2025-FAFMCP-NR94
+  birth_date: 2025-11-13T20:02:03.306Z
+  current_score: 83