Skip to content

feat(ragkit) 0.1.5: session-start bootstrap hook (command-less skills active on CodeBuddy)#88

Merged
qxbyte merged 1 commit into
mainfrom
feat/ragkit-bootstrap-hook
Jul 8, 2026
Merged

feat(ragkit) 0.1.5: session-start bootstrap hook (command-less skills active on CodeBuddy)#88
qxbyte merged 1 commit into
mainfrom
feat/ragkit-bootstrap-hook

Conversation

@qxbyte

@qxbyte qxbyte commented Jul 8, 2026

Copy link
Copy Markdown
Owner

The missing piece. 0.1.4 dropped commands + made skills user-invocable. On Claude Code that's enough — it natively discovers plugin skills, so /ragkit:* shows. On CodeBuddy, a plugin's skills stay inert without a session-start bootstrap (no command surfaces, the model won't auto-invoke) — superpowers' porting guide: "the bootstrap is the entire integration; without it the skill files are inert." superpowers works command-less because it has this hook; ragkit lacked it — that's the whole difference (verified: identical skill frontmatter + plugin.json; superpowers has hooks/, ragkit didn't).

Adds:

  • hooks/hooks.json — SessionStart
  • hooks/run-hook.sh — specode's proven python-probe launcher (no uv)
  • scripts/ragkit_hooks.py — injects the bootstrap (mirrors spec_hooks.py emit shape)

The bootstrap announces the 4 skills and carries the hard anti-improvisation guardrail (invoke by name; never search the filesystem for skill/script files; never read .ragkit vectors / install numpy / hand-roll retrieval; fail loud) — closing the Record-2 hole.

Validated; hook emits valid JSON locally.

🤖 Generated with Claude Code

…ithout commands on CodeBuddy)

0.1.4 dropped commands + made skills user-invocable. On Claude Code that's
enough (it natively discovers plugin skills → /ragkit:* shows). But on CodeBuddy
a plugin's skills stay INERT without a session-start bootstrap — no command
surfaces and the model won't reach for them (superpowers' porting guide: "the
bootstrap is the entire integration; without it the skill files are inert").
superpowers works command-less precisely because it HAS this hook; ragkit lacked it.

Adds: hooks/hooks.json (SessionStart), hooks/run-hook.sh (specode's proven
python-probe launcher, no uv), scripts/ragkit_hooks.py (injects the bootstrap,
mirrors spec_hooks.py). The bootstrap announces the 4 skills AND carries the
hard anti-improvisation guardrail (invoke by name; never search the filesystem
for skill/script files; never read .ragkit vectors / install numpy / hand-roll
retrieval; fail loud on script errors) — directly closing the Record-2 hole.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: qxbyte <126648675+qxbyte@users.noreply.github.com>
@qxbyte qxbyte merged commit 1a80b0a into main Jul 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant