forked from bchanot/claude
docs(plugin-gate): probe reads current --plain, advisor emits profile.sh set/enable, /profile rewritten for packs
This commit is contained in:
1 parent
350e658b60
commit
58958229d9
7 files changed
+105
-254
No files matched your search
+23
-51
@@ -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
@@ -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
|
||||
|
||||
Reference in new issue
Block a user