Skip to content

Commit 0f19fa0

Browse files
Wolfe-Jamclaude
andauthored
docs: FAF authors context — generate→author copy sweep (#76)
FAF authors context (reads repo → discerns → authors from intel); it never "generates" it. Swept user-facing prose only. - README: "faf-cli generates the files this server syncs" → "authors" - README: faf_git action "Generate .faf" → "Author .faf" (x2 tables) - CHANGELOG: "faf-generated files" → "faf-authored files" Left untouched: fenced code-block comments, share-link generation, the generateProjectHtml identifier, and the faf-git-generator module name. Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent c71512d commit 0f19fa0

2 files changed

Lines changed: 4 additions & 4 deletions

File tree

CHANGELOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ faf-mcp now **enhances** your context files instead of replacing them — a stru
5858

5959
### Changed
6060

61-
- **Non-destructive interop.** `faf_cursor`, `faf_agents`, `faf_gemini`, and `faf_sync` now inject a structured `.faf` block at the top of .cursorrules, AGENTS.md, GEMINI.md, and CLAUDE.md and preserve everything you've written below. Re-runs update the block in place (idempotent); existing faf-generated files upgrade cleanly in one pass.
61+
- **Non-destructive interop.** `faf_cursor`, `faf_agents`, `faf_gemini`, and `faf_sync` now inject a structured `.faf` block at the top of .cursorrules, AGENTS.md, GEMINI.md, and CLAUDE.md and preserve everything you've written below. Re-runs update the block in place (idempotent); existing faf-authored files upgrade cleanly in one pass.
6262
- **Composes faf-cli's single-source engines.** Turbo-Cat (~200-format detection) and the 6Ws interview now come from faf-cli — faf-mcp's own forks are deleted. One source of truth, no drift between the CLI and the server.
6363
- **Migrated to the `one.faf` namespace.** MCP Registry identity `io.github.Wolfe-Jam/faf-mcp``one.faf/faf-mcp` (DNS-verified), carrying the single-source `one.faf/context` `_meta` block emitted by faf-cli. The npm package `faf-mcp`, its tools, and its downloads are **unchanged** — only the registry identity moves.
6464

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ You maintain `.cursorrules`. Your teammate uses `AGENTS.md`. Someone on the team
3636

3737
**faf-mcp is the dedicated MCP server for Cursor, Windsurf, Cline, VS Code, and every non-Claude platform.** One `.faf` file in your repo, synced to every format your team needs.
3838

39-
**Context for Cursor & IDE agents:** faf-cli (v7.1) generates the files this server syncs — `bunx faf export --agents`, zero-install and git-native. See [FAF-CLI for Cursor & IDE agents 👀](https://github.com/Wolfe-Jam/faf-cli/blob/main/docs/faf-cli-for-agents.md).
39+
**Context for Cursor & IDE agents:** faf-cli (v7.1) authors the files this server syncs — `bunx faf export --agents`, zero-install and git-native. See [FAF-CLI for Cursor & IDE agents 👀](https://github.com/Wolfe-Jam/faf-cli/blob/main/docs/faf-cli-for-agents.md).
4040

4141
```
4242
project.faf
@@ -108,7 +108,7 @@ npx faf-mcp
108108
| `faf_cursor` | Cursor IDE | Import/export/sync .cursorrules |
109109
| `faf_gemini` | Google Gemini | Import/export/sync GEMINI.md |
110110
| `faf_conductor` | Conductor | Import/export directory structure |
111-
| `faf_git` | GitHub | Generate .faf from any repo URL |
111+
| `faf_git` | GitHub | Author .faf from any repo URL |
112112

113113
```bash
114114
# Sync to all formats at once
@@ -214,7 +214,7 @@ Works on all platforms — stops web search, forces tool usage.
214214
| `faf_cursor` | Import/export/sync .cursorrules |
215215
| `faf_gemini` | Import/export/sync GEMINI.md |
216216
| `faf_conductor` | Import/export directory structure |
217-
| `faf_git` | Generate .faf from GitHub repo URL |
217+
| `faf_git` | Author .faf from GitHub repo URL |
218218
| **Cloud Tools** | |
219219
| `faf_cloud_publish` | Upload to mcpaas.live |
220220
| `faf_cloud_fetch` | Pull from cloud |

0 commit comments

Comments
 (0)