feat(mcp): S5 — issue-kind guidance across all instruction surfaces #73

2026-06-14T23:31:59-04:00

bvandeusen commented

2026-06-14 23:31:59 -04:00

Ships the never-landed S5 of plan #825 (T2 — Issues task_kind): the kind=issue feature existed in schema/tools/REST/UI, but every behavioral surface the plugin pushes to the agent still described the pre-kind convention ("tag issue" on a create_note). Result: agents fixed bugs without reaching for kind=issue and dumped the work as logs on unrelated open tasks.

Product surfaces updated (instance-agnostic, prose-only — no schema/tool-behavior change):

_INSTRUCTIONS: rewrite the "record a problem" bullet → create_task(kind="issue") with symptom→cause→fix + arose_from_id/system_ids, and an explicit "not a work-log on an unrelated task"; add Issue + System to the hierarchy section.
skills/systematic-debugging, verification: drop "tag issue" / create_note-issue → create_task(kind="issue").
skills/using-scribe: add issues/systems to the entity list + reflex #6.
hooks/scribe_static_context: fix → its own issue on the keyless floor.

Tracking: issue #855. Meta-principle captured as project rule #119 (product behavior belongs in the app, not in Scribe rules).

🤖 Generated with Claude Code

Ships the never-landed S5 of plan #825 (T2 — Issues task_kind): the `kind=issue` feature existed in schema/tools/REST/UI, but every behavioral surface the plugin pushes to the agent still described the pre-kind convention ("tag `issue`" on a `create_note`). Result: agents fixed bugs without reaching for `kind=issue` and dumped the work as logs on unrelated open tasks. Product surfaces updated (instance-agnostic, prose-only — no schema/tool-behavior change): - `_INSTRUCTIONS`: rewrite the "record a problem" bullet → `create_task(kind="issue")` with symptom→cause→fix + `arose_from_id`/`system_ids`, and an explicit "not a work-log on an unrelated task"; add Issue + System to the hierarchy section. - skills/systematic-debugging, verification: drop "tag `issue`" / create_note-issue → `create_task(kind="issue")`. - skills/using-scribe: add issues/systems to the entity list + reflex #6. - hooks/scribe_static_context: fix → its own issue on the keyless floor. Tracking: issue #855. Meta-principle captured as project rule #119 (product behavior belongs in the app, not in Scribe rules). 🤖 Generated with [Claude Code](https://claude.com/claude-code)

bvandeusen added 1 commit 2026-06-14 23:31:59 -04:00

feat(mcp): S5 — issue-kind guidance across all instruction surfaces

CI & Build / integration (push) Successful in 15s

Details

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 46s

Details

CI & Build / Build & push image (push) Successful in 1m3s

Details

5fbee18a94

Plan #825 (T2 — Issues task_kind) shipped S1–S4 but its S5 docs slice
never landed, so every behavioral surface the plugin pushes to the agent
still described the pre-kind convention ("tag `issue`" on a create_note).
Result: agents fixed bugs without reaching for kind=issue and dumped the
work as logs on unrelated open tasks.

- _INSTRUCTIONS: rewrite the "record a problem" bullet to
  create_task(kind="issue") with symptom→cause→fix + arose_from_id /
  system_ids, and an explicit "not a work-log on an unrelated task"; add
  Issue + System to the hierarchy section.
- skills/systematic-debugging, verification: drop "tag `issue`" /
  create_note-issue, point at create_task(kind="issue").
- skills/using-scribe: add issues/systems to the entity list + reflex #6.
- hooks/scribe_static_context: fix → its own issue on the keyless floor.

Instance-agnostic, prose-only; no schema or tool-behavior change.
Pairs with always-on rule #118. Issue: #855.

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

bvandeusen merged commit f8c58a7f0f into main

2026-06-14 23:32:04 -04:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: bvandeusen/FabledScribe#73