docs(plugin-gate): probe reads current --plain, advisor emits profile.sh set/enable, /profile rewritten for packs

This commit is contained in:
bchanot committed 2026-11-02 01:31:35 +01:00
1 parent 350e658b60
commit 58958229d9
7 files changed
+105 -254

No files matched your search

+23 -51
View File
@@ -19,7 +19,7 @@ Detection is NOT your job (plugin-probe did it); applying is NOT your job
## INPUT — PROBE REPORT (ground truth, from plugin-probe)
The dispatcher passes `REQUEST` (the project description, verbatim) and the
full `PROBE REPORT` (fields: PLUGINS, EXTERNAL, PROFILE, CLIS, MANIFESTS,
full `PROBE REPORT` (fields: PROFILE, PLUGINS, CLIS, MANIFESTS,
FRAMEWORK-DEPS, TSX-JSX-COUNT, DOCKER-COUNT, ANIM, MONOREPO, EMBEDDED,
CHECKPOINT). Treat it as ground truth — never re-detect, never invent a
field. PROBE REPORT missing or a field absent → emit
@@ -271,60 +271,32 @@ RULE: IF `complex-arch` signal (multiple services, event bus, distributed system
---
## TOGGLING EXTERNAL TOOLS
## WRITING A PROFILE OR A PACK
Marketplace plugins toggle via `claude plugin enable|disable <name>@<marketplace>`.
Non-marketplace tools (gstack per-skill symlinks, emil-design-eng, darwin-skill)
toggle via `bash $HOME/.claude/lib/toggle-external.sh enable|disable <tool>`.
Everything switches through `lib/profile.sh`, per project, never the user
scope. Emit the exact command; never write files directly.
When a recommendation flips the state of one of those tools, emit the exact
command — never write files directly.
```
# Enable gstack for a browser-QA signal:
bash $HOME/.claude/lib/toggle-external.sh enable gstack
# Disable darwin-skill when passive cost is too high for a hotfix:
bash $HOME/.claude/lib/toggle-external.sh disable darwin-skill
```
`higgsfield` / `higgsfield-websites`: never recommended from project signals.
They drive a paid generation service; explicit user ask only (CLAUDE.md
"Skill routing").
### Skill profiles (fine-grained partitioning, with plugin + MCP toggle)
For task-shaped activation (web only, seo only, backend only, design only,
etc.) prefer `lib/profile.sh` over toggling all of gstack at once. Profiles
activate a curated subset of skills + plugins + MCPs and disable the rest of
gstack + managed plugins — sessions stay focused and passive token cost drops.
`profile set <name>` actually toggles plugins (`claude plugin enable|disable`)
and external skill packs (delegates to `lib/toggle-external.sh`) — not just
advisory. No MCP server is auto-toggled today. Always-on plugins (`security-guidance`)
and the vendored superpowers skills are never toggled by a profile. Managed
plugins that `set` may toggle:
`ui-ux-pro-max@ui-ux-pro-max-skill`, `plugin-dev@claude-code-plugins`,
`pr-review-toolkit@claude-code-plugins`. Other plugins are never auto-toggled.
When the project signal matches one of the canonical profiles, recommend the
matching `profile set` command:
| Signal | Recommended profile | Command |
| Signal | Profile | Command |
|---|---|---|
| `frontend` public website (no backend, no SEO focus) | `web` | `bash $HOME/.claude/lib/profile.sh set web` |
| audit-only: SEO + GEO + W3C + WCAG | `seo` | `bash $HOME/.claude/lib/profile.sh set seo` |
| public website end-to-end (build + audit) | `web-full` | `bash $HOME/.claude/lib/profile.sh set web-full` |
| backend / API / system / library (no UI, no SEO) | `backend` | `bash $HOME/.claude/lib/profile.sh set backend` |
| `design-system` (heavy UI work, no dev) | `design` | `bash $HOME/.claude/lib/profile.sh set design` |
| `simple` / hotfix / typical dev session | `dev` | `bash $HOME/.claude/lib/profile.sh set dev` |
| `browser-qa` (e2e tests, no design work) | `qa` | `bash $HOME/.claude/lib/profile.sh set qa` |
| comprehensive audit (security + SEO + perf) | `audit` | `bash $HOME/.claude/lib/profile.sh set audit` |
| narrow session, minimal noise | `minimal` | `bash $HOME/.claude/lib/profile.sh set minimal` |
| public website, no SEO focus | `web` | `bash $HOME/.claude/lib/profile.sh set web` |
| audit-only: SEO + GEO + W3C + WCAG | `seo` | `… set seo` |
| public website end-to-end | `web-full` | `… set web-full` |
| backend / API / library | `backend` | `… set backend` |
| heavy UI, no dev | `design` | `… set design` |
| typical dev session | `dev` | `… set dev` |
| browser QA only | `qa` | `… set qa` |
| comprehensive audit | `audit` | `… set audit` |
| narrow session | `minimal` | `… set minimal` |
| one pack on top | — | `bash $HOME/.claude/lib/profile.sh enable <design|scroll3d|seo|web-validate|gstack-dev|gstack-browser|gstack-design|higgsfield|extras>` |
To go back to the default profile: `bash $HOME/.claude/lib/profile.sh reset`
(= `set full`: enables full's list, parks non-listed gstack/managed items,
toggles the managed plugins like any `set`).
Read `PROFILE :` first: when it says `source=flag`, a pack it turns off
cannot be enabled in this conversation; recommend `relaunch: cc <name>
<profile>` instead of an `enable`. No profile = `full` (manifest defaults);
`unset` returns to it. Every write needs `/reload-plugins` to load the
packs; connectors and model apply to the next session.
`higgsfield`: never recommended from project signals. It drives a paid
generation service; explicit user ask only (CLAUDE.md "Skill routing").
## BLOCK if
+9 -14
View File
@@ -15,17 +15,13 @@ Facts only — no signals, no recommendations, no complexity scoring.
## PROBES (run all; a failing probe reports its fallback string, never aborts)
```bash
# Claude Code plugins
# Packs, managed plugins, connectors, model: the effective state of THIS
# project and conversation (lib/profile.sh, no claude call)
bash "$HOME/.claude/lib/profile.sh" -C "$PWD" current --plain 2>/dev/null || echo "profile-unavailable"
# Marketplace plugins actually installed (ids, enabled state)
claude plugin list 2>/dev/null || echo "plugin-list-unavailable"
# External (non-marketplace) tools status — gstack, emil-design-eng,
# darwin-skill. Managed by lib/toggle-external.sh since
# `claude plugin enable|disable` does not apply to them.
bash "$HOME/.claude/lib/toggle-external.sh" list 2>/dev/null || echo "toggle-external-unavailable"
# Active skill profile — design / dev / qa / audit / minimal / custom.
bash "$HOME/.claude/lib/profile.sh" current 2>/dev/null || echo "profile-unavailable"
# Context7 CLI
command -v ctx7 &>/dev/null && ctx7 --version 2>/dev/null | head -1 || echo "ctx7-not-installed"
@@ -60,7 +56,7 @@ ls src/*.c 2>/dev/null | head -3
ls package.json Cargo.toml go.mod pubspec.yaml setup.py pyproject.toml 2>/dev/null | head -1 # counterindicators (ecosystem present = not bare embedded)
# Checkpoint inputs (consumed by lib/plugin-gate.md's validation checkpoint)
[ -x "$HOME/.claude/lib/toggle-external.sh" ] && echo "toggle-script: executable" || echo "toggle-script: UNAVAILABLE"
[ -f "$HOME/.claude/lib/profile.sh" ] && echo "profile-sh: available" || echo "profile-sh: UNAVAILABLE"
ls "$HOME/.claude/plugins/cache" 2>/dev/null | head -10
ls "$HOME/.agents/skills" 2>/dev/null | head -10
```
@@ -69,9 +65,8 @@ ls "$HOME/.agents/skills" 2>/dev/null | head -10
```
PROBE REPORT
PLUGINS : <claude plugin list output, one per line>
EXTERNAL : <toggle-external list output>
PROFILE : <profile current output>
PROFILE : <current --plain block, verbatim>
PLUGINS : <claude plugin list output>
CLIS : ctx7=<v|absent> gsd=<v|absent> rtk=<v|absent>
MANIFESTS : <files found>
FRAMEWORK-DEPS: <exact "dep": "version" pairs, or framework-deps-none>
@@ -80,7 +75,7 @@ DOCKER-COUNT : <n>
ANIM : eligibility=<status|package|reason> installed=<lib|no>
MONOREPO : dirs=<hits> configs=<hits> parent=<hits>
EMBEDDED : cmake-pio=<hits> linker=<hits> makefile=<y/n> src-c=<hits> ecosystem=<first manifest|none>
CHECKPOINT : toggle-script=<executable|UNAVAILABLE> plugin-dirs=<cache+skills listing>
CHECKPOINT : profile-sh=<available|UNAVAILABLE> plugin-dirs=<cache+skills listing>
```
## RULES