From caa18d2f4e0ad3237c74ba83af69c535fae8f9cb Mon Sep 17 00:00:00 2001 From: bchanot Date: Wed, 8 Apr 2026 17:57:45 +0200 Subject: [PATCH] corrected built in skills instead of plugin --- CHANGELOG.md | 18 +++++++++ README.md | 34 +++++++++++------ USAGE.md | 80 ++++++++++++++++++---------------------- agents/plugin-advisor.md | 58 +++++++++++++++-------------- hooks/session-start.sh | 7 ++-- install-plugins.sh | 23 +++++------- lib/detect-plugins.sh | 10 +++-- version.txt | 2 +- 8 files changed, 126 insertions(+), 106 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 92f69dc..16012cb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,24 @@ Format follows [Keep a Changelog](https://keepachangelog.com/). ## [Unreleased] +## [3.3.0] โ€” 2026-04-08 + +### Breaking +- `security-guidance` removed โ€” never existed as a marketplace plugin (`anthropic/claude-plugins-official` is a non-existent repo). RTK covers security hooks. +- `pr-review-toolkit` removed โ€” same non-existent marketplace. No replacement available. +- `frontend-design` reclassified from TOGGLE plugin to **built-in Claude Code skill** (`/mnt/skills/public/frontend-design/`). Always available, 0 token cost, not toggleable. +- `skill-creator` reclassified from TOGGLE plugin to **built-in Claude Code skill** (`/mnt/skills/examples/skill-creator/`). Always available, 0 token cost, not toggleable. +- `anthropic/claude-plugins-official` marketplace reference removed from `install-plugins.sh` โ€” this GitHub repo does not exist. + +### Changed +- `install-plugins.sh`: fake marketplace block replaced with built-in skill notes; install summary updated +- `lib/detect-plugins.sh`: `detect_frontend_design()` removed (built-in skill, always available); notes added for all removed plugins +- `hooks/session-start.sh`: `frontend_design` removed from toggle loop; `security-guidance` removed from always-on display; new `๐Ÿ”ต BUILT-IN` line shows `frontend-design skill-creator`; token cost estimate no longer counts frontend-design +- `agents/plugin-advisor.md`: decision table, compatibility matrix, recommended sets, conditional rules all updated โ€” frontend-design and skill-creator marked as built-in (0t, not toggleable); security-guidance and pr-review-toolkit removed; passive cost estimates recalculated +- `README.md`: plugin reference table split into installable plugins + built-in skills; compatibility matrix updated; recommended sets recalculated; removed pr-review-toolkit from slash commands; added "Removed plugins" note explaining what happened +- `USAGE.md`: all references updated โ€” quick reference, case studies, session-start boxes, signalโ†’plugin table +- `version.txt`: 3.2.1 โ†’ 3.3.0 + ## [3.2.1] โ€” 2026-04-07 ### Fixed diff --git a/README.md b/README.md index 527240a..c1018b4 100644 --- a/README.md +++ b/README.md @@ -223,7 +223,6 @@ gsd # then inside the session: | Command | Plugin | Description | |---|---|---| -| `/pr-review-toolkit:review-pr` | pr-review-toolkit | Multi-agent PR review (6 specialized agents) | | `/context7:docs ` | context7 | Manual doc lookup for a specific library | --- @@ -369,7 +368,6 @@ Warns if ruflo is active with no multi-agent signal, or if GSD v2 CLI is not ins | Pair | Relation | Notes | |---|---|---| -| frontend-design โ†” ui-ux-pro-max | โš ๏ธ Overlap | Keep both for design-heavy. Drop ui-ux-pro-max for simple UI. | | gstack โ†” gsd v2 | โœ… Complementary | Different scopes โ€” CC workflow vs CLI orchestration | | gstack โ†” ruflo | โš ๏ธ Overlap | Both orchestrate multi-step work. Use one or the other. ~3250-4250t combined. | | gsd v2 โ†” ruflo | โš ๏ธ Overlap | Sequential (GSD) vs parallel swarm (ruflo). Pick based on need. | @@ -377,21 +375,25 @@ Warns if ruflo is active with no multi-agent signal, or if GSD v2 CLI is not ins | superpowers โ†” gstack | โœ… Complementary | Used together by orchestrators | | context7 โ†” any | โœ… Independent | Doc lookup MCP โ€” always safe to combine | +> **Built-in skills** (always available, 0 tokens, not toggleable): +> `frontend-design` and `skill-creator` are built-in Claude Code skills. They complement all plugins without conflict. + ### Recommended sets by project type | Project type | Plugins ON | OFF | Passive cost | |---|---|---|---| -| Backend API / microservice | superpowers, context7* | frontend-design, ui-ux-pro-max, gstack, ruflo | ~800t | -| Frontend SPA / SSR | superpowers, frontend-design, ui-ux-pro-max, context7 | gstack, ruflo | ~1600t | -| Full-stack SaaS | superpowers, gstack, frontend-design, ui-ux-pro-max, context7 | ruflo | ~4400t | +| Backend API / microservice | superpowers, context7* | ui-ux-pro-max, gstack, ruflo | ~800t | +| Frontend SPA / SSR | superpowers, ui-ux-pro-max, context7 | gstack, ruflo | ~1400t | +| Full-stack SaaS | superpowers, gstack, ui-ux-pro-max, context7 | ruflo | ~4150t | | CLI tool / library | superpowers | all toggles | ~800t | | Multi-session large feature | superpowers + gsd v2 CLI (external) | ruflo | ~800t CC | | Quick fix / hotfix | superpowers | all toggles | ~800t | -| Design system / component lib | superpowers, frontend-design, ui-ux-pro-max | gstack, ruflo, gsd | ~1600t | +| Design system / component lib | superpowers, ui-ux-pro-max | gstack, ruflo, gsd | ~1200t | | Enterprise multi-agent | superpowers, ruflo + gsd v2 CLI (external) | others | ~2300t CC | > *context7 only if using fast-evolving libs (Next.js, React 18+, Prisma, Supabase) -> security-guidance and rtk are ALWAYS ON (0 tokens) โ€” omitted from estimates +> rtk is ALWAYS ON (0 tokens) โ€” omitted from estimates +> frontend-design and skill-creator are built-in Claude Code skills (0 tokens, always available) โ€” omitted from recommendations --- @@ -410,18 +412,28 @@ Run `/plugin-check` anytime to get a recommendation for the current project type | Plugin | Status | Passive cost | When to use | Installed by | |---|---|---|---|---| -| **security-guidance** | โœ… ALWAYS ON | 0 tokens (hook only) | โ€” | marketplace | | **RTK** | โœ… ALWAYS ON | 0 tokens (hook only) | โ€” | cargo (pinned in plugins.lock.json) | | **Superpowers** | โœ… REQUIRED | ~600โ€“1000 tokens | โ€” required by orchestrators | marketplace | | **GStack** | ๐Ÿ”„ TOGGLE | ~2500โ€“3000 tokens | Full-product: UI + design + deploy + browser QA | git submodule | | **GSD v2** | ๐Ÿ–ฅ๏ธ CLI | 0 tokens (external CLI) | Multi-day features, crash recovery, cost tracking, parallel workers | npm (pinned in plugins.lock.json) | | **ruflo** | ๐Ÿ”„ TOGGLE | ~500โ€“1500 tokens | Enterprise multi-agent swarm (5+ concurrent agents) | npm + MCP manual | -| **skill-creator** | ๐Ÿ”„ TOGGLE | ~100 tokens | Creating or editing custom skills | marketplace | -| **pr-review-toolkit** | ๐Ÿ”„ TOGGLE | ~300 tokens | PR review sessions | marketplace | -| **frontend-design** | ๐Ÿ”„ TOGGLE | ~200 tokens | Any project with a UI | marketplace | | **ui-ux-pro-max** | ๐Ÿ”„ TOGGLE | ~400 tokens | Design system, color/typography choices | marketplace | | **Context7 MCP** | ๐Ÿ”„ TOGGLE | ~200 tokens | Fast-evolving libs (Next.js, React, Prismaโ€ฆ) | MCP manual | +**Built-in Claude Code skills (always available, 0 tokens, no install needed):** + +| Skill | Location | Description | +|---|---|---| +| **frontend-design** | `/mnt/skills/public/frontend-design/` | UI design guidance โ€” loaded on demand when relevant | +| **skill-creator** | `/mnt/skills/examples/skill-creator/` | Create custom skills from conversation โ€” loaded on demand | + +These built-in skills are always available and cannot be toggled on/off. They have zero passive token cost +(loaded on demand only). Use them naturally โ€” Claude Code activates them when the context matches. + +> **Removed plugins** (previously listed but never existed as installable plugins): +> - `security-guidance` โ€” was listed as a marketplace plugin but the marketplace `anthropic/claude-plugins-official` does not exist. RTK covers security hooks. +> - `pr-review-toolkit` โ€” same non-existent marketplace. No replacement available. + **Rule:** toggle plugins are OFF by default. `/plugin-check` signals when to enable them. If you use `/init-project` or `/ship-feature`, plugin-check runs automatically as STEP 0 and **blocks if Superpowers is not active**. diff --git a/USAGE.md b/USAGE.md index f8f4232..3dfd61d 100644 --- a/USAGE.md +++ b/USAGE.md @@ -96,9 +96,10 @@ Tu veux... ## Les plugins โ€” dรฉcision rapide ``` -Toujours actifs (0 token) : security-guidance, rtk +Toujours actifs (0 token) : rtk +Built-in (toujours disponible, 0 token) : frontend-design, skill-creator -Projet avec interface โ†’ frontend-design ON +Projet avec interface โ†’ frontend-design dรฉjร  disponible (built-in) Design รฉlaborรฉ/system โ†’ ui-ux-pro-max ON Deploy + QA browser โ†’ gstack ON Next.js/React/Prisma โ†’ context7 ON (WARN si absent, pas BLOCK) @@ -223,7 +224,7 @@ cd mon-projet-existant/ /plugin-check "App mobile React Native Expo liste de courses, offline-first, SQLite, notifications push" โ†’ SIGNALS: frontend (mobile), fast-libs (Expo SDK) -โ†’ ENABLE: frontend-design (composants RN) +โ†’ NOTE: frontend-design available (built-in, 0t) โ†’ WARN: context7 si Expo SDK 51+ utilisรฉ (fast-libs) โ†’ OFF: gstack (mobile, pas de browser QA), ui-ux-pro-max (optionnel) โ†’ BLOCKING: none @@ -301,7 +302,7 @@ gsd /plugin-check "Site vitrine Next.js 14 studio photo, design รฉlaborรฉ, animations Framer Motion, galerie, dark mode, SEO" โ†’ SIGNALS: frontend, design-system, fast-libs(Next.js) -โ†’ ENABLE: frontend-design (~200t) +โ†’ NOTE: frontend-design available (built-in, 0t) โ†’ ENABLE: ui-ux-pro-max (~400t) โ€” "design รฉlaborรฉ" signal fort โ†’ WARN: context7 non configurรฉ โ†’ taper "force" pour continuer (ou configurer avant) โ†’ OFF: gstack (vitrine statique, pas de deploy complexe) @@ -355,7 +356,8 @@ Sans ui-ux-pro-max : "Tailwind avec palette neutre, Inter". La diffรฉrence est v /plugin-check "Jeu de puzzle web React + FastAPI + PostgreSQL. Auth JWT, collection de cartes, boutique in-app, leaderboard. Multi-session, dev sur plusieurs semaines." โ†’ SIGNALS: frontend, fast-libs(React), deploy, multi-session -โ†’ ENABLE: frontend-design, context7 +โ†’ NOTE: frontend-design available (built-in, 0t) +โ†’ ENABLE: context7 โ†’ ENABLE: ui-ux-pro-max (cartes visuelles, cohรฉrence design) โ†’ CLI: gsd v2 RECOMMANDร‰ (multi-session dรฉtectรฉ) โ†’ OPTIONAL: gstack si deploy CI + browser QA prรฉvus @@ -454,7 +456,7 @@ ONBOARD COMPLETE: mycli /plugin-check "Rust CLI, pas de frontend, pas de deploy" โ†’ SIGNALS: none (CLI pur) -โ†’ DISABLE: frontend-design, ui-ux-pro-max, gstack, context7 +โ†’ DISABLE: ui-ux-pro-max, gstack, context7 โ†’ KEEP: superpowers โ†’ COST: ~800t (minimal) โ†’ ACTION REQUIRED? NO @@ -519,7 +521,7 @@ DO NOT TOUCH: โ†’ SIGNALS: none (CLI pur, pas de deploy, pas de frontend) โ†’ KEEP: superpowers -โ†’ DISABLE: frontend-design, ui-ux-pro-max, gstack, context7, ruflo +โ†’ DISABLE: ui-ux-pro-max, gstack, context7, ruflo โ†’ COST: ~800t (base seulement) โ†’ ACTION REQUIRED? NO ``` @@ -801,7 +803,7 @@ OPTIONS: SIGNALS: mobile (React Native + Expo dรฉtectรฉs) RECOMMENDATIONS: - โšก ENABLE : frontend-design โ€” composants React Native (~200t) + โ„น๏ธ NOTE : frontend-design available (built-in, 0t) โš ๏ธ DISABLE : gstack โ€” mobile, pas de browser QA ni deploy web โ„น๏ธ OPTIONAL: ui-ux-pro-max โ€” uniquement si design system complexe โ„น๏ธ NOTE : Docker N/A pour les apps mobiles @@ -845,7 +847,7 @@ COST: ~800t RECOMMENDATIONS: โœ… KEEP : superpowers - โš ๏ธ DISABLE: frontend-design, ui-ux-pro-max, gstack, context7, ruflo + โš ๏ธ DISABLE: ui-ux-pro-max, gstack, context7, ruflo BLOCKING: none โ†’ "proceed" โ†’ Scaffolder: cargo check comme verify (pas cargo build) @@ -935,7 +937,7 @@ SIGNALS: monorepo, frontend(apps/web/), fast-libs(Next.js), deploy(apps/api/) RECOMMENDATIONS: OK KEEP : superpowers - ENABLE : frontend-design โ€” apps/web/ uniquement (~200t) + NOTE : frontend-design available (built-in, 0t) WARN : context7 โ€” Next.js detecte dans apps/web/ DISABLE : gstack โ€” apps/api/ n'a pas de browser-qa (NOTE: gstack aurait ete recommande si browser-qa present) @@ -973,13 +975,13 @@ L'utilisateur voit exactement ce qui manque et la commande pour corriger. ### Cas J โ€” session-start : box ne deborde pas avec 5 plugins actifs -**Avant v2.3.0 :** avec `gstack frontend-design ui-ux-pro-max context7 ruflo` tous actifs, la ligne `ON` depassait la largeur de la box. +**Avant v2.3.0 :** avec `gstack ui-ux-pro-max context7 ruflo` tous actifs, la ligne `ON` depassait la largeur de la box. **Avec v2.3.0 :** ``` โ”Œโ”€ Claude Code config โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” -โ”‚ โœ… ON : security-guidance rtk superpowers โ”‚ -โ”‚ ๐ŸŸข ON : gstack frontend-design ui-ux-pro-ma... โ”‚ <- tronque a 37+... +โ”‚ โœ… ON : rtk superpowers โ”‚ +โ”‚ ๐ŸŸข ON : gstack ui-ux-pro-max context7... โ”‚ <- tronque a 37+... โ”‚ โšซ OFF : none โ”‚ โ”‚ ๐Ÿ’ฐ ~5350t passif (48% budget) โ”‚ โ”‚ ๐Ÿ“ฆ v2.3.0 โ”‚ @@ -1032,7 +1034,7 @@ PROJECT STATUS CONFIG Version : v2.4.0 - Plugins ON: superpowers, frontend-design, context7 (~1200t) + Plugins ON: superpowers, context7 (~1000t) GSD v2 : installed (2.64.0) PROJECT @@ -1078,7 +1080,7 @@ SIGNALS: monorepo (upstream), frontend, fast-libs(Next.js) NOTE: dans apps/web/ d'un monorepo (dรฉtectรฉ via parent dir) RECOMMENDATIONS: - ENABLE: frontend-design โ€” apps/web/ uniquement + NOTE: frontend-design available (built-in, 0t) โ€” apps/web/ uniquement WARN: context7 โ€” Next.js dรฉtectรฉ DISABLE: gstack โ€” pas de browser-qa dans ce package ``` @@ -1112,13 +1114,13 @@ Le compteur `5/6 OK` indique exactement le problรจme sans lire toutes les lignes ### Cas O โ€” session-start avec 5 toggles actifs -**Avant v2.4.0 :** avec gstack + frontend-design + ui-ux-pro-max + context7 + ruflo actifs, la ligne dรฉbordait la box. +**Avant v2.4.0 :** avec gstack + ui-ux-pro-max + context7 + ruflo actifs, la ligne dรฉbordait la box. **Avec v2.4.0 :** ``` โ”Œโ”€ Claude Code config โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” -โ”‚ โœ… ON : security-guidance rtk superpowers โ”‚ -โ”‚ ๐ŸŸข ON : gstack frontend-design +3 more โ”‚ +โ”‚ โœ… ON : rtk superpowers โ”‚ +โ”‚ ๐ŸŸข ON : gstack ui-ux-pro-max +2 more โ”‚ โ”‚ โšซ OFF : none โ”‚ โ”‚ ๐Ÿ’ฐ ~5350t passif (48% budget) โ”‚ โ”‚ ๐Ÿ“ฆ v2.4.0 โ”‚ @@ -1147,7 +1149,7 @@ PROJECT STATUS CONFIG Version : v2.5.0 - Plugins ON: superpowers, frontend-design, context7 (~1200t) + Plugins ON: superpowers, context7 (~1000t) GSD v2 : installed (2.64.0) PROJECT @@ -1328,14 +1330,14 @@ Sans ce check : `/status` chargerait un agent inexistant โ†’ erreur cryptique. ### Cas T โ€” session-start avec 6 plugins actifs (tous affichรฉs) -**Avant v2.5.0 :** `gstack frontend-design +4 more` โ€” 4 plugins masquรฉs. +**Avant v2.5.0 :** `gstack ui-ux-pro-max +3 more` โ€” 4 plugins masquรฉs. **Avec v2.5.0 :** ``` โ”Œโ”€ Claude Code config โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” -โ”‚ โœ… ON : security-guidance rtk superpowers โ”‚ -โ”‚ ๐ŸŸข ON : gstack frontend-design ui-ux-pro-max context7โ”‚ -โ”‚ + ruflo skill-creator โ”‚ +โ”‚ โœ… ON : rtk superpowers โ”‚ +โ”‚ ๐ŸŸข ON : gstack ui-ux-pro-max context7โ”‚ +โ”‚ + ruflo โ”‚ โ”‚ โšซ OFF : none โ”‚ โ”‚ ๐Ÿ’ฐ ~5750t passif (52% budget) โ”‚ โ”‚ ๐Ÿ“ฆ v2.5.0 โ”‚ @@ -1382,7 +1384,7 @@ COST: ~800t (superpowers seul) RECOMMENDATIONS: OK KEEP : superpowers (peut รชtre utile pour brainstorm initial) - DISABLE : frontend-design, ui-ux-pro-max, gstack, context7, ruflo + DISABLE : ui-ux-pro-max, gstack, context7, ruflo NOTE : Pour un firmware vraiment simple (hotfix, modification ciblรฉe), mรชme superpowers peut รชtre dรฉsactivรฉ โ†’ ~0t passif ``` @@ -1502,9 +1504,9 @@ Developer se rรฉoriente instantanรฉment โ€” pas de risque d'implรฉmenter sur la ``` โ”Œโ”€ Claude Code config โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” -โ”‚ โœ… ON : security-guidance rtk superpowers โ”‚ -โ”‚ ๐ŸŸข ON : gstack frontend-design ui-ux-pro-max context7โ”‚ -โ”‚ ruflo skill-creator โ”‚ +โ”‚ โœ… ON : rtk superpowers โ”‚ +โ”‚ ๐ŸŸข ON : gstack ui-ux-pro-max context7โ”‚ +โ”‚ ruflo โ”‚ โ”‚ โšซ OFF : none โ”‚ โ”‚ ๐Ÿ’ฐ ~5750t passif (52% budget) โ”‚ โ”‚ ๐Ÿ“ฆ v2.6.0 โ”‚ @@ -1613,19 +1615,9 @@ Si `lib/` n'est pas un symlink vers le repo, `detect-plugins.sh` sourcรฉ est la --- -### Cas Z5 โ€” plugin-advisor warn sur skill-creator inactif +### Cas Z5 โ€” ~~plugin-advisor warn sur skill-creator inactif~~ (obsolรจte depuis v3.3.0) -**Contexte :** projet React SaaS, `skill-creator` restรฉ actif par oubli. - -``` -/plugin-check "React SaaS avec FastAPI" - -SIGNALS: frontend, deploy, fast-libs(React) - -WARN: skill-creator ON โ€” aucun signal skill-creation dรฉtectรฉ - โ†’ ~100t รฉconomisรฉs si dรฉsactivรฉ - โ†’ Activer uniquement quand vous crรฉez des skills custom -``` +> **Obsolรจte :** `skill-creator` est dรฉsormais un skill built-in de Claude Code (toujours disponible, 0 token). Il n'est plus toggleable et n'apparaรฎt plus dans les recommandations enable/disable du plugin-advisor. --- @@ -1637,7 +1629,7 @@ WARN: skill-creator ON โ€” aucun signal skill-creation dรฉtectรฉ SIGNALS: simple, embedded COST: ~800t (superpowers seul) -DISABLE: frontend-design, ui-ux-pro-max, gstack, context7, ruflo, skill-creator +DISABLE: ui-ux-pro-max, gstack, context7, ruflo NOTE: Pour hotfix ultra-ciblรฉ, superpowers aussi optionnel ``` @@ -1697,7 +1689,7 @@ NOTE: embedded project detected โ€” minimal plugin footprint RECOMMENDATIONS: superpowers OPTIONAL - DISABLE: tout le reste (frontend-design, gstack, context7, ruflo, skill-creator) + DISABLE: tout le reste (gstack, context7, ruflo) gsd v2: NOT recommended Workflow: /analyze src/wifi_driver.c โ†’ /ship-feature si multi-fichiers @@ -1754,7 +1746,7 @@ SIGNALS: embedded (platformio.ini) NOTE: embedded project detected โ€” minimal plugin footprint KEEP : superpowers (optional) -DISABLE: frontend-design, ui-ux-pro-max, gstack, context7, ruflo, skill-creator +DISABLE: ui-ux-pro-max, gstack, context7, ruflo gsd v2 : NOT recommended (sessions courtes, tรขches atomiques) ``` @@ -2008,7 +2000,7 @@ Budget Pro note: ``` Description contient... โ†’ Plugin โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ -React / Vue / Svelte โ†’ frontend-design ON +React / Vue / Svelte โ†’ frontend-design (built-in) Next.js 13+ / App Router โ†’ context7 WARN Prisma / Supabase โ†’ context7 ON "design รฉlaborรฉ" / tokens โ†’ ui-ux-pro-max ON @@ -2016,6 +2008,6 @@ Docker + QA browser โ†’ gstack ON "plusieurs semaines" โ†’ gsd v2 CLI "5+ agents parallรจles" โ†’ ruflo ON Rust / Python / Go / C โ†’ tout OFF sauf superpowers -Mobile / Flutter / RN โ†’ frontend-design ON, gstack OFF +Mobile / Flutter / RN โ†’ frontend-design (built-in), gstack OFF Hotfix / script rapide โ†’ tout OFF sauf superpowers ``` diff --git a/agents/plugin-advisor.md b/agents/plugin-advisor.md index 9353a31..860a50a 100644 --- a/agents/plugin-advisor.md +++ b/agents/plugin-advisor.md @@ -29,6 +29,12 @@ command -v gsd &>/dev/null && gsd --version 2>/dev/null | head -1 || echo "gsd-n command -v rtk &>/dev/null && rtk --version 2>/dev/null | head -1 || echo "rtk-not-installed" command -v ruflo &>/dev/null && ruflo --version 2>/dev/null | head -1 || echo "ruflo-cli-not-in-path" +# Built-in Claude Code skills (always available, 0 tokens, NOT toggleable): +# - frontend-design: /mnt/skills/public/frontend-design/ โ€” UI design guidance +# - skill-creator: /mnt/skills/examples/skill-creator/ โ€” create custom skills +# Do NOT recommend enabling/disabling these โ€” they are always present. +# Do NOT count them in passive token cost. + # Project signals (run from project root) ls package.json pyproject.toml Cargo.toml go.mod 2>/dev/null | head -5 grep -rl "next\|react\|vue\|prisma\|supabase" package.json 2>/dev/null | head -3 || true @@ -98,17 +104,17 @@ ACTION REQUIRED? YES / NO | Signal | Enable / Use | Disable / Skip | Notes | |---|---|---|---| -| `frontend` | frontend-design, ui-ux-pro-max | โ€” | Both complement each other | -| `mobile` (React Native/Expo/Flutter) | frontend-design | gstack (no browser QA), Docker N/A | ui-ux-pro-max optional | +| `frontend` | ui-ux-pro-max | โ€” | frontend-design is built-in (always available) | +| `mobile` (React Native/Expo/Flutter) | โ€” | gstack (no browser QA), Docker N/A | frontend-design built-in; ui-ux-pro-max optional | | `monorepo` | per-package plugin recommendations | avoid recommending gstack for whole repo if only one package has browser QA | Specify which plugin applies to which package | -| `design-system` | frontend-design, ui-ux-pro-max | โ€” | High overlap but both useful | +| `design-system` | ui-ux-pro-max | โ€” | frontend-design built-in; ui-ux-pro-max adds design system depth | | `deploy` + `browser-qa` | gstack | โ€” | Full-product workflow | | `multi-session` | gsd v2 CLI | โ€” | Run `gsd` in terminal, not CC plugin | | `fast-libs` | context7 | โ€” | Doc freshness critical | | `multi-agent` + `complex-arch` | ruflo (MCP) | โ€” | Only if genuine swarm needed | | `simple` / single-session | โ€” | gsd, gstack, ruflo, ui-ux-pro-max | Saves ~3000-5000t | | `embedded` / firmware | โ€” | all toggles; superpowers optional | workflow: /analyze โ†’ edit or /ship-feature | -| backend/lib/CLI only | โ€” | frontend-design, ui-ux-pro-max, gstack | ~3100t saved | +| backend/lib/CLI only | โ€” | ui-ux-pro-max, gstack | frontend-design built-in (0t) | | small project / hotfix | โ€” | gstack, ruflo, gsd | Overhead exceeds value | **GSD v2 note:** `gsd-pi` is a standalone CLI (Pi SDK), not a Claude Code plugin. Zero passive token cost in CC sessions. Recommend when: feature > 1 day, multiple isolated context windows needed, crash recovery, cost tracking, or parallel workers. Usage: `gsd` in terminal โ†’ `/gsd auto`. @@ -123,7 +129,6 @@ ACTION REQUIRED? YES / NO | Pair | Relation | Verdict | |---|---|---| -| frontend-design โ†” ui-ux-pro-max | โš ๏ธ Overlap | Both do UI styling. Keep both for design-heavy projects; drop ui-ux-pro-max for simple UIs. ~600t combined. | | gstack โ†” gsd v2 | โœ… Complementary | GStack = full-product CC workflow. GSD v2 = multi-session CLI. Different scopes, no conflict. | | gstack โ†” ruflo | โš ๏ธ Overlap | Both orchestrate multi-step workflows. GStack is CC-native; ruflo is MCP swarm. High combined overhead (~3250-4250t). Use one or the other. | | gsd v2 โ†” ruflo | โš ๏ธ Overlap | GSD v2 = sequential session pipeline. Ruflo = parallel agent swarm. Pick one per project; ruflo only if genuinely parallel work needed. | @@ -131,33 +136,35 @@ ACTION REQUIRED? YES / NO | superpowers โ†” gstack | โœ… Complementary | Used together in /init-project and /ship-feature. Superpowers = engine, GStack = full-product skills. | | superpowers โ†” ruflo | โš ๏ธ Overlap | Both can orchestrate agent sub-tasks. Together only for advanced hybrid setups. | | context7 โ†” any | โœ… Independent | Doc lookup MCP, no workflow overlap. Always safe to combine. | -| skill-creator โ†” superpowers | โš ๏ธ Minor overlap | Superpowers can create skills too. Keep skill-creator only when actively building new skills. | -| frontend-design โ†” gstack | โœ… Complementary | GStack = deploy/QA layer; frontend-design = UI quality layer. Different concerns. | -| pr-review-toolkit โ†” superpowers | โœ… Complementary | superpowers:requesting-code-review and /pr-review-toolkit:review-pr cover different review styles. | | rtk โ†” any | โœ… Independent | Hook-only token compression. Zero interaction with any plugin. | -| security-guidance โ†” any | โœ… Independent | Hook-only security rules. Zero interaction. | + +> **Built-in skills (always available, 0 tokens, not toggleable):** +> - `frontend-design` โ€” UI design guidance, always loaded on demand +> - `skill-creator` โ€” create custom skills from conversation, always loaded on demand +> These do NOT appear in enable/disable recommendations. They complement all plugins without conflict. ### Recommended sets by project type | Project type | Plugins ON | OFF | Passive cost | |---|---|---|---| -| Backend API / microservice | superpowers, context7 (if fast libs) | frontend-design, ui-ux-pro-max, gstack, ruflo | ~800t | -| Frontend SPA / SSR | superpowers, frontend-design, ui-ux-pro-max, context7 | gstack, ruflo | ~1600t | -| Full-stack SaaS | superpowers, gstack, frontend-design, ui-ux-pro-max, context7 | ruflo | ~4400t | +| Backend API / microservice | superpowers, context7 (if fast libs) | ui-ux-pro-max, gstack, ruflo | ~800t | +| Frontend SPA / SSR | superpowers, ui-ux-pro-max, context7 | gstack, ruflo | ~1400t | +| Full-stack SaaS | superpowers, gstack, ui-ux-pro-max, context7 | ruflo | ~4150t | | CLI tool / library | superpowers | all toggles | ~800t | | Multi-session large feature | superpowers + gsd v2 CLI (external) | ruflo (unless parallel) | ~800t CC | | Quick fix / hotfix | superpowers | all toggles | ~800t | -| Design system / component lib | superpowers, frontend-design, ui-ux-pro-max | gstack, ruflo, gsd | ~1600t | -| Fast-evolving libs (Next.js etc.) | superpowers, context7, frontend-design | ruflo | ~1200t | -| Enterprise multi-agent orchestration | superpowers, ruflo + gsd v2 (external) | skill-creator, pr-review-toolkit | ~2300t CC | +| Design system / component lib | superpowers, ui-ux-pro-max | gstack, ruflo, gsd | ~1200t | +| Fast-evolving libs (Next.js etc.) | superpowers, context7 | ruflo | ~1000t | +| Enterprise multi-agent orchestration | superpowers, ruflo + gsd v2 (external) | โ€” | ~2300t CC | -> security-guidance and rtk are ALWAYS ON (0 tokens) โ€” omitted from cost estimates for clarity. +> rtk is ALWAYS ON (0 tokens) โ€” omitted from cost estimates. +> frontend-design and skill-creator are built-in (0 tokens) โ€” always available, omitted from recommendations. ### Conditional rules ``` RULE: IF "mobile" signal (React Native/Expo/Flutter detected): - โ†’ frontend-design ON (~200t) โ€” mobile UI components + โ†’ frontend-design available (built-in, 0t) โ†’ gstack OFF โ€” no browser QA on mobile โ†’ Docker NOT relevant โ€” no server-side containerization for mobile โ†’ ui-ux-pro-max OPTIONAL (~400t) โ€” only if design system complexity is high @@ -165,13 +172,12 @@ RULE: IF "mobile" signal (React Native/Expo/Flutter detected): RULE: IF "monorepo" signal detected: โ†’ scan each top-level package individually for frontend/deploy/fast-libs signals โ†’ recommend plugins per-package, NOT for the whole repo - โ†’ if only apps/web/ has frontend: enable frontend-design for web package only โ†’ if only apps/api/ has deploy: gstack only if apps/api/ has browser QA too โ†’ NOTE in output: "Plugin X recommended for apps/web/ โ€” disable for apps/api/" โ†’ passive cost estimate = highest-cost package profile (other packages add nothing) RULE: IF "frontend" signal OR .tsx/.jsx count > 0: - โ†’ frontend-design ON (~200t) + โ†’ frontend-design available (built-in, 0t) โ€” no action needed โ†’ ui-ux-pro-max ON if "design-system" signal (~400t additional) RULE: IF "deploy" AND "browser-qa" signals: @@ -192,7 +198,7 @@ RULE: IF "simple" OR "hotfix": โ†’ Disable all toggles. ~800t base only. RULE: IF "embedded" signal (firmware, bare-metal, microcontroller, or Makefile+C without Node/Rust/Go): - โ†’ Disable ALL toggles including gstack, context7, ruflo, skill-creator + โ†’ Disable ALL toggles including gstack, context7, ruflo โ†’ superpowers OPTIONAL: useful for initial design brainstorm on complex drivers, but unnecessary for single-function patches โ€” user decides โ†’ GSD v2 CLI: not recommended (sessions are short, tasks are atomic) @@ -203,12 +209,8 @@ RULE: IF gstack ON AND ruflo ON: โ†’ WARN: functional overlap on multi-step orchestration โ†’ Suggest: gstack for CC-native workflow, ruflo only if parallel swarm needed -RULE: IF skill-creator ON AND no `skill-creation` signal detected: - โ†’ WARN: skill-creator active but no skill-creation signal (~100t saved if disabled) - โ†’ Disable unless you're actively building or editing custom skills - RULE: IF `skill-creation` signal: - โ†’ skill-creator ON (~100t) + โ†’ skill-creator is built-in (always available, 0t) โ€” no action needed โ†’ superpowers ON โ€” required for skill scaffolding RULE: IF `browser-qa` signal (e2e tests, Playwright/Cypress/Puppeteer in deps): @@ -216,9 +218,9 @@ RULE: IF `browser-qa` signal (e2e tests, Playwright/Cypress/Puppeteer in deps): โ†’ context7 OPTIONAL (depends on framework version) RULE: IF `design-system` signal (tokens, theme files, Storybook present): - โ†’ frontend-design ON (~200t) + โ†’ frontend-design available (built-in, 0t) โ†’ ui-ux-pro-max ON (~400t) - โ†’ WARN if both are OFF with this signal: significant design gap + โ†’ WARN if ui-ux-pro-max OFF with this signal: design system depth may suffer RULE: IF `complex-arch` signal (multiple services, event bus, distributed system): โ†’ ruflo MCP ON (~500-1500t) @@ -231,7 +233,7 @@ RULE: IF `complex-arch` signal (multiple services, event bus, distributed system ## BLOCK if - Superpowers not active โ†’ install: `claude plugin marketplace add obra/superpowers-marketplace && claude plugin install --scope user superpowers@superpowers-marketplace` -- Significant frontend signal + frontend-design AND ui-ux-pro-max both off +- Significant frontend signal + ui-ux-pro-max off (for design-heavy projects) - Full-product (UI+deploy+QA) + gstack not installed ## WARN (no block) diff --git a/hooks/session-start.sh b/hooks/session-start.sh index d498ae9..ad228a5 100644 --- a/hooks/session-start.sh +++ b/hooks/session-start.sh @@ -48,11 +48,10 @@ unset _lib TOGGLE_ACTIVE=() TOGGLE_INACTIVE=() -for plugin in gstack uiux_pro_max frontend_design context7 ruflo; do +for plugin in gstack uiux_pro_max context7 ruflo; do # Map function name to display name case "$plugin" in uiux_pro_max) display="ui-ux-pro-max" ;; - frontend_design) display="frontend-design" ;; *) display="$plugin" ;; esac @@ -88,7 +87,6 @@ unset _claude_real _repo_dir _passive_t=0 detect_superpowers 2>/dev/null && _passive_t=$((_passive_t + 800)) detect_gstack 2>/dev/null && _passive_t=$((_passive_t + 2750)) -detect_frontend_design 2>/dev/null && _passive_t=$((_passive_t + 200)) detect_uiux_pro_max 2>/dev/null && _passive_t=$((_passive_t + 400)) detect_context7 2>/dev/null && _passive_t=$((_passive_t + 200)) detect_ruflo 2>/dev/null && _passive_t=$((_passive_t + 1000)) @@ -104,7 +102,8 @@ unset _passive_t _budget_pct echo "" echo "โ”Œโ”€ Claude Code config โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”" -printf "โ”‚ โœ… ON : %-40sโ”‚\n" "security-guidance rtk superpowers" +printf "โ”‚ โœ… ON : %-40sโ”‚\n" "rtk superpowers" +printf "โ”‚ ๐Ÿ”ต BUILT-IN: %-35sโ”‚\n" "frontend-design skill-creator" # Plugin display โ€” all plugins shown, split across 2 lines if >4 _active_count=${#TOGGLE_ACTIVE[@]} _inactive_count=${#TOGGLE_INACTIVE[@]} diff --git a/install-plugins.sh b/install-plugins.sh index d04025a..a8f42f4 100644 --- a/install-plugins.sh +++ b/install-plugins.sh @@ -322,16 +322,11 @@ install_plugin() { fi } -# Official Anthropic (always on)= - -# pr-review-toolkit โ€” installer depuis le vrai repo si nรฉcessaire -if ! claude plugin list 2>/dev/null | grep -qi "pr-review"; then - info "Installing pr-review-toolkit from GitHub..." - claude plugin install --scope user https://github.com/anthropic-community/pr-review-toolkit 2>/dev/null \ - || warn "pr-review-toolkit โ€” not available as plugin, use as slash command or skill instead" -else - ok "pr-review-toolkit (already installed)" -fi +# Built-in Claude Code skills (no install needed) +ok "frontend-design โ€” built-in Claude Code skill (always available)" +ok "skill-creator โ€” built-in Claude Code skill (always available)" +ok "security-guidance โ€” covered by RTK hook (no separate plugin exists)" +warn "pr-review-toolkit โ€” no marketplace plugin exists; removed from install" echo "" @@ -376,16 +371,16 @@ echo "โ•‘ Install Summary โ•‘" echo "โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•" echo "" echo " ALWAYS ON (installed at user scope):" -echo " โœ… security-guidance โ€” PreToolUse security hook (0 tokens)" echo " โœ… rtk โ€” token compression hook (0 tokens)" echo " โœ… superpowers โ€” brainstorm/plan/implement/debug workflow" echo "" +echo " BUILT-IN (Claude Code skills โ€” always available, no install needed):" +echo " ๐Ÿ”ต frontend-design โ€” /mnt/skills/public/frontend-design/" +echo " ๐Ÿ”ต skill-creator โ€” /mnt/skills/examples/skill-creator/" +echo "" echo " TOGGLE (installed but start OFF โ€” /plugin-check recommends when needed):" echo " ๐Ÿ”„ gstack โ€” ~/.claude/skills/gstack/ (โ†’ submodule)" echo " ๐Ÿ”„ gsd v2 โ€” standalone CLI 'gsd' (gsd-pi, not a Claude Code plugin)" -echo " ๐Ÿ”„ skill-creator โ€” create skills from conversation (~100 tokens)" -echo " ๐Ÿ”„ pr-review-toolkit โ€” /pr-review-toolkit:review-pr (~300 tokens)" -echo " ๐Ÿ”„ frontend-design โ€” user scope (~200 tokens)" echo " ๐Ÿ”„ ui-ux-pro-max โ€” user scope (~400 tokens)" echo " ๐Ÿ”„ context7 MCP โ€” see Step 7 above (~200 tokens)" echo " ๐Ÿ”„ ruflo MCP โ€” see Step 5 above (~500-1500 tokens, enterprise only)" diff --git a/lib/detect-plugins.sh b/lib/detect-plugins.sh index 120fbb7..9bab205 100644 --- a/lib/detect-plugins.sh +++ b/lib/detect-plugins.sh @@ -37,10 +37,12 @@ detect_gsd() { command -v gsd &>/dev/null } -detect_frontend_design() { - local cache_dir="$HOME/.claude/plugins/cache" - [ -d "$cache_dir" ] && ls "$cache_dir" 2>/dev/null | grep -qi "frontend-design" -} +# NOTE: frontend-design is a built-in Claude Code skill (/mnt/skills/public/frontend-design/). +# It is always available and does not need detection. No detect_frontend_design() function needed. +# NOTE: skill-creator is a built-in Claude Code skill (/mnt/skills/examples/skill-creator/). +# It is always available and does not need detection. No detect_skill_creator() function needed. +# NOTE: security-guidance does not exist as a plugin. RTK covers security hooks. +# NOTE: pr-review-toolkit does not exist as a marketplace plugin. detect_uiux_pro_max() { local cache_dir="$HOME/.claude/plugins/cache" diff --git a/version.txt b/version.txt index e4604e3..15a2799 100644 --- a/version.txt +++ b/version.txt @@ -1 +1 @@ -3.2.1 +3.3.0