docs(mcp): encode rule-scope model in rulebook tool descriptions #67

2026-06-10T10:18:36-04:00

bvandeusen commented

2026-06-10 10:18:36 -04:00

Makes the always-on / subscribed / project-rule distinction explicit at the authoring surface so it can't silently regress (for this operator or other users).

Problem: the tools said only "cross-project rulebook rule" and a bare "subscribe a project" — nothing steered project-specific detail away from shared rulebooks, which is how a Scribe-pinned rule ends up binding every family project.

Principle encoded in 5 places: a rule's home is chosen by who it should bind; both rulebook tiers are SHARED so their rules stay general — they differ in reach (all projects vs opt-in by theme), not generality. Project-specific detail → create_project_rule.

server.py MCP instructions: 3-tier authoring principle
create_rule / create_rulebook / create_project_rule / subscribe_project_to_rulebook docstrings
using-scribe SKILL.md: a "Where a new rule goes" note for the pull path

CI green on 50b6902 (run 811). Refs #755.

🤖 Generated with Claude Code

Makes the always-on / subscribed / project-rule distinction explicit at the authoring surface so it can't silently regress (for this operator or other users). **Problem:** the tools said only "cross-project rulebook rule" and a bare "subscribe a project" — nothing steered project-specific detail away from shared rulebooks, which is how a Scribe-pinned rule ends up binding every family project. **Principle encoded in 5 places:** a rule's home is chosen by *who it should bind*; both rulebook tiers are SHARED so their rules stay general — they differ in *reach* (all projects vs opt-in by theme), not generality. Project-specific detail → `create_project_rule`. - `server.py` MCP instructions: 3-tier authoring principle - `create_rule` / `create_rulebook` / `create_project_rule` / `subscribe_project_to_rulebook` docstrings - `using-scribe` SKILL.md: a "Where a new rule goes" note for the pull path CI green on 50b6902 (run 811). Refs #755. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

bvandeusen added 1 commit 2026-06-10 10:18:36 -04:00

docs(mcp): encode rule-scope model in rulebook tool descriptions

CI & Build / Python lint (push) Successful in 3s

Details

CI & Build / TypeScript typecheck (push) Successful in 34s

Details

CI & Build / Python tests (push) Successful in 48s

Details

CI & Build / Build & push image (push) Successful in 59s

Details

50b6902fe2

Make the always-on / subscribed / project-rule distinction explicit at the
authoring surface so it can't silently regress (for this operator or other
users). Previously the tools said only 'cross-project rulebook rule' and a
bare 'subscribe a project' — nothing steered project-specific detail away
from shared rulebooks, which is how a Scribe-pinned rule ends up binding
every family project.

Principle encoded in 5 places: a rule's home is chosen by WHO it should bind,
and both rulebook tiers are SHARED so their rules stay general — they differ
in reach (all projects vs opt-in by theme), not generality. Project-specific
detail goes in create_project_rule.

- server.py MCP instructions: add the 3-tier authoring principle
- create_rule / create_rulebook / create_project_rule / subscribe_* docstrings
- using-scribe SKILL.md: a 'Where a new rule goes' note for the pull path

Refs #755

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

bvandeusen merged commit 4c8044826f into main

2026-06-10 10:18:51 -04:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: bvandeusen/FabledScribe#67