diff --git a/src/fabledassistant/mcp/server.py b/src/fabledassistant/mcp/server.py index f321c78..67c8d33 100644 --- a/src/fabledassistant/mcp/server.py +++ b/src/fabledassistant/mcp/server.py @@ -48,11 +48,15 @@ rules via create_rule when you notice a pattern worth codifying — coordinate with the operator on whether it belongs in an existing rulebook+topic or a new one. -Plans are tasks with kind=plan. Begin a plan with start_planning(project_id, -title) — that seeds a plan template and returns the project's applicable_rules. -Maintain the plan with the normal task tools (update_task for the body, -add_task_log for progress); its work-logs are the build record. Build plans in -Scribe via start_planning, not in local .md files. +Plans are tasks with kind=plan, and Scribe is the canonical home for them. +When you begin non-trivial work, call start_planning(project_id, title) FIRST — +before any brainstorming, design, or plan-writing skill runs. start_planning +seeds the plan body, returns the project's applicable_rules, and gives you the +task id you'll write into. If a skill or habit tells you to save a plan or spec +to `docs/superpowers/plans/*.md` or `docs/superpowers/specs/*.md`, that path is +superseded here: put the spec/plan content in the kind=plan task's body via +update_task, and record progress with add_task_log. Local .md files are not +the record — the task is. Deletes are recoverable: every delete_* tool moves the entity (and its descendants) to the trash and returns a deleted_batch_id. Use list_trash() to