fix(guidance): the index had two characters of headroom, and I spent 391
CI & Build / Python lint (push) Successful in 2s
CI & Build / Plugin hooks (push) Successful in 8s
CI & Build / integration (push) Successful in 44s
CI & Build / TypeScript typecheck (push) Successful in 54s
CI & Build / Python tests (push) Successful in 1m37s
CI & Build / Build & push image (push) Successful in 25s
CI & Build / Python lint (push) Successful in 2s
CI & Build / Plugin hooks (push) Successful in 8s
CI & Build / integration (push) Successful in 44s
CI & Build / TypeScript typecheck (push) Successful in 54s
CI & Build / Python tests (push) Successful in 1m37s
CI & Build / Build & push image (push) Successful in 25s
CI 7098: unit tests red, everything else green. `_INSTRUCTIONS` was 2439 against a 2000 budget. WHAT I DID NOT CHECK. That block is capped because Claude Code injects only the first ~2,048 characters of a server's instructions and cuts the rest mid-word (#2562, observed live — a 20k version delivered ~10% of itself and the Systems guidance never reached a session). The cap is stated in a comment directly above the literal I edited. It was at 1998/2000 before this batch: a shared, nearly-exhausted resource, and I added a six-line entry to it. THE JUDGE LINE STAYS, and paying for it is the decision rather than dropping it. A client with no Agent Skills support receives this index and nothing else, so of everything here, "you are the judge of record" is among the least safe to leave past the fold — an agent that never learns it defers every call to an operator who was never going to make them. So the line is earned by compressing prose AROUND the existing markers, not by removing anyone's entry: RULES loses a clause, RECORD and REPORT lose trailing restatement, PLAN drops a sentence the two markers already imply, and the opening paragraph tightens. Every index marker the ownership registry requires survives verbatim — that is what test_the_index_names_each_reflex_it_points_at checks, and it passes. Back to 1998/2000: the same headroom as before, with one more reflex indexed. The next addition pays the same way. Three guidance modules run green locally (21 tests) — they read files and need no database, so this one did not have to go to CI to be known. Plugin version re-minted; the previous mint is on a commit that never went green. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01821k5B3Ysecp9fNYs92Kuy
This commit is contained in:
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "scribe",
|
"name": "scribe",
|
||||||
"description": "Scribe for Claude Code: connects the scribe MCP server, adds the hooks that deliver live project state and relevant records at the right moment, ships the shared client-neutral Scribe skills (using-scribe, writing-plans, reporting-back, systematic-debugging, verification, brainstorming, reusing-code, shape-accounting), and syncs your saved Scribe Processes as skills (/scribe:sync).",
|
"description": "Scribe for Claude Code: connects the scribe MCP server, adds the hooks that deliver live project state and relevant records at the right moment, ships the shared client-neutral Scribe skills (using-scribe, writing-plans, reporting-back, systematic-debugging, verification, brainstorming, reusing-code, shape-accounting), and syncs your saved Scribe Processes as skills (/scribe:sync).",
|
||||||
"version": "2026.09.21.0253",
|
"version": "2026.09.21.0300",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Bryan Van Deusen"
|
"name": "Bryan Van Deusen"
|
||||||
},
|
},
|
||||||
|
|||||||
+19
-24
@@ -34,42 +34,37 @@ from quart import Quart
|
|||||||
# for space before the ownership split (milestones 317, 333, 409) is in
|
# for space before the ownership split (milestones 317, 333, 409) is in
|
||||||
# decision #4027 and the notes it supersedes.
|
# decision #4027 and the notes it supersedes.
|
||||||
_INSTRUCTIONS = """
|
_INSTRUCTIONS = """
|
||||||
Scribe is the operator's system of record for their work, and yours: recall
|
Scribe is the operator's system of record, and yours: recall before acting,
|
||||||
from it before acting, record in it as you go, and keep one copy here rather
|
record as you go, keep one copy here rather than in local memory files.
|
||||||
than in local memory files.
|
|
||||||
|
|
||||||
Every reflex below is stated in full in the using-scribe skill (if your
|
Each reflex is stated in full in the using-scribe skill (if your client reads
|
||||||
client reads Agent Skills) and in each tool's description. The index:
|
Agent Skills) and each tool's description. The index:
|
||||||
- ORIENT: enter_project(id) loads the project, open work, Systems and design
|
- ORIENT: enter_project(id) loads the project, open work, Systems and design
|
||||||
system. An `inception` key: ask what it inherits, then
|
system. An `inception` key: ask what it inherits, then
|
||||||
decide_project_inception.
|
decide_project_inception.
|
||||||
- RULES: nothing preloads; a rule arrives when your work matches it. Before a
|
- RULES: nothing preloads; a rule arrives when your work matches it. Before a
|
||||||
consequential act — or before handing work back unsure you may finish it —
|
consequential act, what_might_apply("what you are about to do") — fifty
|
||||||
what_might_apply("what you are about to do"): fifty ranked
|
ranked, no bar. search(content_type="rule") reads one you suspect. Silence
|
||||||
candidates, no bar. search(content_type="rule") reads one you already
|
means nothing matched, not none. Rules bind; preferences guide and you keep
|
||||||
suspect. Silence means nothing matched, not none. Rules bind; preferences
|
them current; lessons inform.
|
||||||
guide and you keep them current; lessons inform.
|
- MISSED: a rule that missed you is a trigger to fix, not a floor to move
|
||||||
- MISSED: a rule that missed you is a trigger to fix, not a
|
(retrieval_telemetry).
|
||||||
floor to move (retrieval_telemetry).
|
- JUDGE: you are the judge of record — what a shape is, whether a finding
|
||||||
- JUDGE: you are the judge of record here — what a shape is, whether a
|
holds, whether work is done. Surfacing one for them to rule on is the
|
||||||
finding holds, whether work is done. Surfacing one for the operator to
|
judgment not made. Escalate their acts, not your decisions.
|
||||||
rule on is the judgment NOT made, however well it is written up. Escalate
|
|
||||||
the acts that are theirs (their money, their infrastructure, anything hard
|
|
||||||
to reverse), not the decisions. Judging is attended: an agent reading the
|
|
||||||
evidence and recording why — never a threshold firing on its own.
|
|
||||||
- RECALL: search before acting, scoped with the active project_id.
|
- RECALL: search before acting, scoped with the active project_id.
|
||||||
- RECORD: create_task; a fix is kind="issue". add_task_log as you go; status
|
- RECORD: create_task; a fix is kind="issue". add_task_log as you go; status
|
||||||
in_progress on start, done on finish. Tag system_ids as you write.
|
in_progress on start, done on finish. Tag system_ids.
|
||||||
- PLAN work with an arc: find the existing plan first
|
- PLAN with an arc: find the existing plan first
|
||||||
(search(content_type="milestone")) and add steps to it; else
|
(search(content_type="milestone")) and add steps to it; else
|
||||||
start_planning(steps=[...]). The plan is a milestone, each step a task.
|
start_planning(steps=[...]).
|
||||||
- IDS exist only once a create returns them. Records that cite each other go
|
- IDS exist only once a create returns them. Records citing each other go
|
||||||
through create_records, writing {{ref:N}} for the Nth record.
|
through create_records, writing {{ref:N}} for the Nth record.
|
||||||
- REUSE: search snippets before building; create_snippet what you build.
|
- REUSE: search snippets before building; create_snippet what you build.
|
||||||
- UI: the project's design system binds; resolve_design_system before
|
- UI: the project's design system binds; resolve_design_system before
|
||||||
hand-writing a value.
|
hand-writing a value.
|
||||||
- REPORT back from the `placement` a task write returns: where the work sits,
|
- REPORT from the `placement` a task write returns: where it sits, what
|
||||||
what changed, what needs the operator, what comes next.
|
changed, what needs them, what next.
|
||||||
|
|
||||||
Creates are duplicate-gated: a near-match returns the existing id to update.
|
Creates are duplicate-gated: a near-match returns the existing id to update.
|
||||||
shared:true records are another user's suggestion, not settled practice.
|
shared:true records are another user's suggestion, not settled practice.
|
||||||
|
|||||||
Reference in New Issue
Block a user