From 10c63f49d82a2218b9221a4d49eb75ce7de3c90d Mon Sep 17 00:00:00 2001 From: Bryan Van Deusen Date: Fri, 21 Aug 2026 22:10:28 -0400 Subject: [PATCH] =?UTF-8?q?fix(mcp):=20=5FINSTRUCTIONS=20back=20under=20th?= =?UTF-8?q?e=202k=20fold=20=E2=80=94=20the=20inception=20line=20is=20one?= =?UTF-8?q?=20clause,=20detail=20lives=20in=20the=20tool=20docstrings=20(#?= =?UTF-8?q?2882)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- src/scribe/mcp/server.py | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/src/scribe/mcp/server.py b/src/scribe/mcp/server.py index fee91c4..4ccc7a0 100644 --- a/src/scribe/mcp/server.py +++ b/src/scribe/mcp/server.py @@ -37,29 +37,23 @@ in local files (CLAUDE.md, auto-memory); Scribe holds the single copy. Hierarchy: Project -> Milestone -> Task/Note. The map, by purpose: - ORIENT: enter_project(id) at session start — rules, open tasks, recent - notes, Systems and design system in one call. If it returns `inception`, - the project's inheritance was never decided: raise that ask once, then - decide_project_inception. -- START a project: create_project takes what it inherits — always-on - rulebooks to exclude, rulebooks to subscribe, design system, seed - Systems. Ask the operator first; never create a project bare by default. + notes, Systems, design system. `inception` key: ask what the project + inherits, decide_project_inception (create_project takes the same). - DO: create_task. Fixed a problem? kind="issue" (symptom -> root cause -> fix), never a work-log line on an unrelated task. Log with add_task_log; keep status honest — in_progress on start, done on finish. - PLAN work with an arc: start_planning. The plan IS a milestone; each step is a child task, not a checkbox. No local plan .md files. -- CAPTURE: create_note. RECALL: search first, before answering about the - operator's work or opening a task — assume prior art exists, and pass the +- CAPTURE: create_note. RECALL: search first — prior art exists; pass the active project_id to stay in scope. - WHERE work happens: Systems. Tag records with system_ids as you write; create_system when the area is unmodelled. -- HOW to work: rules are pull-only and binding — call list_always_on_rules() - yourself at session start. +- HOW: rules are binding — list_always_on_rules() at session start. - UI: the project's design system is binding — resolve_design_system / get_design_system_stylesheet before hand-writing a value. - REUSE: search snippets before writing a helper; record what you build with create_snippet; classify shapes against canon (classify_shapes) — a - consumer map is rows, never prose. Saved procedures are Processes (follow + consumer map is rows, never prose. Processes are saved procedures (follow verbatim). Deletes are trash-recoverable. A task is a note with status (*_note vs *_task tools).