From 3b3015329c73e3f4648ba421ab287e25e820a68a Mon Sep 17 00:00:00 2001 From: bchanot Date: Fri, 13 Nov 2026 11:38:23 +0100 Subject: [PATCH] feat(doctrine): Skill routing lines move into skill descriptions CLAUDE.global.md keeps only the gstack/pack cases (investigate, ship retired, SEO/GEO/W3C pack-off, cso, media, OFF paragraph). bugfix gains the triggers error / 500 / stack trace + fix; ship-feature gains "ship this feature". BDR-125 phase 3 deferred item. --- CLAUDE.global.md | 25 ++++++++++--------------- skills/bugfix/SKILL.md | 3 ++- skills/ship-feature/SKILL.md | 2 +- 3 files changed, 13 insertions(+), 17 deletions(-) diff --git a/CLAUDE.global.md b/CLAUDE.global.md index f4eadeb..89baf98 100644 --- a/CLAUDE.global.md +++ b/CLAUDE.global.md @@ -268,28 +268,23 @@ Skills route by name: match the request to the skill whose description fits. Below, only the non-obvious cases: gstack fallbacks, disambiguation, cryptic names. - Product idea, "worth building?" → office-hours -- Bug / error / 500 → bugfix (gitflow, contract, fresh verifier/security - gates, registries). investigate only on explicit ask for the gstack - ecosystem (cross-project learnings, /freeze, long open-ended investigation) -- feat / hotfix / bugfix distinguished by file count → see descriptions -- Ship / PR → ship-feature (never gstack ship: it takes `origin/HEAD` = - main as base and skips develop); deploy → deploy (runbook, the user - runs it) +- gstack investigate only on explicit ask: bug, error, 500 → bugfix (contract, + verifier and security gates, registries). gstack ship is retired (BDR-105): + ship / PR → ship-feature; deploy → deploy (runbook, the user runs it) - Docs post-ship → document-release (doc if gstack off); stale-doc audit → doc -- Grouped all-axes sweep ("tir groupé", fix + loop until clean) → tour -- Open-work inventory / "queue empty?" / stale TODO vs git → reconcile - Design / UI (build, system, audit, polish) → Read `~/.claude/rules/web-building.md` § "Design work" first - Architecture review → plan-eng-review -- Before /clear or /compact → capitalize; end-of-session ritual → close - superpowers skills are vendored, called by bare name; an upstream `superpowers` prefix names the same skill. Not vendored here: executing-plans → subagent-driven-development finishing-a-development-branch → `gitflow finish` (human signal) systematic-debugging → bugfix verification-before-completion → the verifier gates -- SEO+GEO → seo (GEO only → geo); W3C + WCAG conformance → web-validate; - security audit (secrets, CVE, OWASP) → cso +- SEO+GEO → seo (GEO only → geo); W3C + WCAG → web-validate. Pack off → + propose `profile.sh enable seo` (seo, geo) or `enable web-validate`, the + user runs `/reload-plugins`; else say so. Security audit (secrets, CVE, + OWASP) → cso - Media generation (image, video, audio, brand kit), explicit ask → pack-higgsfield, off by default: `bash ~/.claude/lib/profile.sh enable higgsfield` then `/reload-plugins`, then Read the skill under @@ -297,9 +292,9 @@ cryptic names. before a paid run. Landing page "with Higgsfield", named ask → the same pack's `higgsfield-websites`: an aid inside the Design work rules (`rules/web-building.md`), never `website create|deploy|publish`. -gstack packs OFF (`profile.sh current`) → their skills (investigate, qa, -review, health, retro, office-hours…) are gone: use the fallback above, -else say so. +gstack or other packs OFF (`profile.sh current`) → their skills (investigate, +qa, review, health, retro, office-hours, seo, web-validate…) are gone: use the +fallback our skills' descriptions or the lines above name, else say so. ## graphify diff --git a/skills/bugfix/SKILL.md b/skills/bugfix/SKILL.md index 9606fcf..1208f8b 100644 --- a/skills/bugfix/SKILL.md +++ b/skills/bugfix/SKILL.md @@ -7,7 +7,8 @@ description: | requires careful analysis before fixing. Includes hypothesis-driven investigation and a fix plan. Trigger: "bugfix", "debug this", "fix this bug", "pourquoi ca marche pas", - "investigate and fix", "find and fix", "root cause + fix". + "investigate and fix", "find and fix", "root cause + fix", "error", "500", + "stack trace + fix". For obvious 1-2 file fixes → use /hotfix instead. For bugs that need investigation only (no fix) → use /analyze. argument-hint: diff --git a/skills/ship-feature/SKILL.md b/skills/ship-feature/SKILL.md index c0e4dd0..d9802b3 100644 --- a/skills/ship-feature/SKILL.md +++ b/skills/ship-feature/SKILL.md @@ -1,7 +1,7 @@ --- name: ship-feature effort: xhigh -description: 'Use when shipping a new feature end-to-end — needs design brainstorm, planning, TDD implementation with subagents, error recovery, code review, and finish. Multi-agent orchestrator (9-step pipeline). Triggers: "ship feature", "ship-feature", "build and merge", "feature end-to-end", "implement and ship".' +description: 'Use when shipping a new feature end-to-end — needs design brainstorm, planning, TDD implementation with subagents, error recovery, code review, and finish. Multi-agent orchestrator (9-step pipeline). Triggers: "ship feature", "ship-feature", "build and merge", "feature end-to-end", "implement and ship", "ship this feature".' argument-hint: allowed-tools: Read, Write, Edit, Bash, Grep, Glob ---