From ab9b5b647c3a4f3b2b5c4ccdb5a4b0931e456ad4 Mon Sep 17 00:00:00 2001 From: Bryan Van Deusen Date: Sun, 19 Jul 2026 16:14:46 -0400 Subject: [PATCH] docs(scribe): true up plugin + MCP docs after calendar/entity removal Milestone #194 plugin/docs slice. - plugin.json: "second brain" framing -> "system-of-record"; bump 0.1.11 -> 0.1.12 (any plugin/ change must bump the manifest, issue #1040) - plugin/README.md + using-scribe SKILL + scribe_static_context: drop events/typed-entities from the surface lists; "second brain" -> "system of record" in the SessionStart context Claude reads each session - docs/api-keys-and-mcp.md: drop the Typed-entities + Events MCP tool rows, add the Systems row - README.md: rewrite the stale front-matter (chat/RAG/calendar/weather/push described a pre-pivot product) to the current Claude-driven work store Deeper pre-pivot doc-rot in docs/features.md + docs/api-reference.md (chat/journal/weather/web-research) is tracked separately as an issue. Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01BPtbSzA4JLMAKgFZ8VTg7Q --- README.md | 4 ++-- docs/api-keys-and-mcp.md | 3 +-- plugin/.claude-plugin/plugin.json | 4 ++-- plugin/README.md | 4 ++-- plugin/hooks/scribe_static_context.md | 6 +++--- plugin/skills/using-scribe/SKILL.md | 4 ++-- 6 files changed, 12 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 7a2b3fb..5b0add7 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ # Fabled Scribe -A self-hosted second brain and project management application with integrated LLM capabilities. Write, organise, and act on your notes and tasks with the help of a local AI assistant — all running on your own hardware. +A self-hosted work system-of-record for software projects, built to be driven by Claude Code. Notes, tasks, issues, projects, milestones, rules, and stored processes — reachable from Claude via a built-in MCP endpoint and a bundled Claude Code plugin, with a clean web UI for humans. No in-app LLM; Claude is the sole assistant. ## Features -Notes and tasks with a Markdown editor, sub-tasks, milestones, and kanban project workspaces. AI chat with streaming responses, RAG over your notes, and tool use (web search, calendar, weather). A daily briefing that digests your tasks, RSS feeds, and weather on a schedule. Knowledge graph, per-user/group sharing, PWA with push notifications, and an MCP server for external AI clients. +Notes and tasks with a Markdown editor, sub-tasks, milestones, issues, and kanban project workspaces. Stored processes, an engineering rulebook system, and semantic search with proactive knowledge-injection into Claude's context. A knowledge graph, per-user/group sharing, and a built-in MCP server (`/mcp`) plus a bundled Claude Code plugin so Claude can record and recall your work directly. ## Quick Start diff --git a/docs/api-keys-and-mcp.md b/docs/api-keys-and-mcp.md index 35b89ea..f6ebe4c 100644 --- a/docs/api-keys-and-mcp.md +++ b/docs/api-keys-and-mcp.md @@ -86,8 +86,7 @@ table here. The tools are grouped by family: | Tasks | `create_task`, `update_task`, `add_task_log`, `start_planning` | Actionable work + plans | | Projects / Milestones | `enter_project`, `get_project`, `create_milestone`, … | Containers and outcomes | | Search / Recall | `search`, `get_recent`, `list_tags` | Semantic + structured recall | -| Typed entities | `create_person`, `create_place`, `create_list`, … | Structured records | -| Events | `create_event`, `list_events`, `update_event`, … | Calendar | +| Systems | `create_system`, `list_systems`, `list_system_records` | Reusable per-project subsystems/areas | | Rulebooks | `list_always_on_rules`, `list_rules`, `create_rule`, `create_project_rule`, `subscribe_project_to_rulebook`, … | Engineering/workflow rules | | Processes | `list_processes`, `get_process`, `create_process` | Saved prompts/workflows | | Trash | `list_trash`, `restore`, `purge_trash` | Recoverable deletes | diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json index f2fbe60..dc90135 100644 --- a/plugin/.claude-plugin/plugin.json +++ b/plugin/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "scribe", - "description": "Scribe second brain for Claude Code: MCP tools over your notes/tasks/projects/rules, a session-start push channel that surfaces your always-on rules + active-project context, process-skills (writing-plans, systematic-debugging, verification, brainstorming), and your saved Scribe Processes auto-surfaced as skills (/scribe:sync). Replaces superpowers + file-memory with one app-backed plugin.", - "version": "0.1.11", + "description": "Scribe system-of-record for Claude Code: MCP tools over your notes/tasks/projects/rules, a session-start push channel that surfaces your always-on rules + active-project context, process-skills (writing-plans, systematic-debugging, verification, brainstorming), and your saved Scribe Processes auto-surfaced as skills (/scribe:sync). Replaces superpowers + file-memory with one app-backed plugin.", + "version": "0.1.12", "author": { "name": "Bryan Van Deusen" }, "mcpServers": { "scribe": { diff --git a/plugin/README.md b/plugin/README.md index 0fea71d..b6ab7ff 100644 --- a/plugin/README.md +++ b/plugin/README.md @@ -3,8 +3,8 @@ Turns a self-hosted [Scribe](https://git.fabledsword.com/bvandeusen/FabledScribe) instance into a first-class Claude Code extension: -- **MCP tools** over your notes, tasks, projects, milestones, events, typed - entities, and rulebook (the `scribe` server). +- **MCP tools** over your notes, tasks, projects, milestones, systems, and + rulebook (the `scribe` server). - **Session-start push channel** — a `SessionStart` hook injects your always-on rules + active-project context so Scribe surfaces *without being asked*. - **Universal process-skills** — brainstorm, systematic-debugging, TDD, diff --git a/plugin/hooks/scribe_static_context.md b/plugin/hooks/scribe_static_context.md index d4f2703..180ecf1 100644 --- a/plugin/hooks/scribe_static_context.md +++ b/plugin/hooks/scribe_static_context.md @@ -1,7 +1,7 @@ -# Scribe — your second brain and system of record +# Scribe — your system of record -This environment has the **Scribe** plugin: the operator's self-hosted second -brain (notes, tasks, projects, milestones, rules) reachable through the +This environment has the **Scribe** plugin: the operator's self-hosted system +of record (notes, tasks, projects, milestones, rules) reachable through the `scribe` MCP tools. Treat Scribe — **not local files** — as the source of truth for the operator's work, and as your own working memory across sessions. diff --git a/plugin/skills/using-scribe/SKILL.md b/plugin/skills/using-scribe/SKILL.md index c098447..fab80e1 100644 --- a/plugin/skills/using-scribe/SKILL.md +++ b/plugin/skills/using-scribe/SKILL.md @@ -5,8 +5,8 @@ description: Use at the START of every session, and before answering anything ab # Using Scribe -Scribe is the operator's self-hosted second brain (notes, tasks, issues, -projects, milestones, systems, events, typed entities) and rulebook, reachable +Scribe is the operator's self-hosted system of record (notes, tasks, issues, +projects, milestones, systems) and rulebook, reachable through the bundled `scribe` MCP server. Its value is mostly in what it **already holds** — so make reading it a reflex, not something you wait to be asked for.