forked from bchanot/claude
docs(phase5): higgsfield citers, MIGRATION fenced steps + real-dir impeccable, gate header, /profile allowed-tools, wording
This commit is contained in:
1 parent
9327b4fcd0
commit
94ce345aa2
12 files changed
+93
-55
No files matched your search
+7
-5
@@ -66,11 +66,13 @@ Exit codes: `0` = ready · `11` = ready-but-unverified (proceed, but surface it)
|
||||
|
||||
design toolchain: INCOMPLETE
|
||||
off: pack-design plugin:ui-ux-pro-max@ui-ux-pro-max-skill
|
||||
→ run: bash ~/.claude/lib/profile.sh set web (or: enable design)
|
||||
→ run: bash ~/.claude/lib/profile.sh set web
|
||||
or: bash ~/.claude/lib/profile.sh enable design
|
||||
or: bash ~/.claude/lib/profile.sh enable ui-ux-pro-max@ui-ux-pro-max-skill
|
||||
then /reload-plugins
|
||||
|
||||
- **source=local or default** → `profile.sh set web` (or `enable design`),
|
||||
then `/reload-plugins`.
|
||||
- **source=local or default** → `profile.sh set web`, or one `profile.sh
|
||||
enable <pack | plugin id>` per entry listed as off, then `/reload-plugins`.
|
||||
- **source=flag** (the conversation runs under `claude --settings`, frozen)
|
||||
→ relaunch it with a design profile: `cc <name> web`.
|
||||
- **the `21st` CLI TRIPS the gate** when absent (required for Build), it is
|
||||
@@ -191,9 +193,9 @@ or profile, never a lone tool.
|
||||
|
||||
## IMPORTANT
|
||||
|
||||
- Remedy is ALWAYS the printed line (`profile.sh set web` / `enable design`
|
||||
- Remedy is ALWAYS the printed line (`profile.sh set web` / `enable <pack>`
|
||||
+ `/reload-plugins`, or `cc <name> web` under a flag), never an atomic
|
||||
tool toggle — `current --plain` is the single source of what's active.
|
||||
tool toggle; `current --plain` is the single source of what's active.
|
||||
- the `21st` CLI is REQUIRED (it trips the gate) and no profile can
|
||||
install it — the gate names the two commands; surface them to the user.
|
||||
Signed out → exit 12: ask `! 21st login`, wait, re-run; explicit opt-out
|
||||
|
||||
@@ -13,8 +13,9 @@
|
||||
# 11 ready-but-unverified (21st could not answer) · 12 sign-in
|
||||
# required · 2 error (profile.sh failed or gave no pack lines).
|
||||
# Remedy on 10: source=flag → relaunch `cc <name> web` (a --settings
|
||||
# conversation is frozen); else `profile.sh set web` (or `enable design`)
|
||||
# then /reload-plugins. The CLI is a global npm install either way.
|
||||
# conversation is frozen); else `profile.sh set web`, or `enable <pack>` /
|
||||
# `enable <plugin id>` per missing entry, then /reload-plugins. The CLI is
|
||||
# a global npm install either way.
|
||||
# READY also needs the packs to resolve: every skills/pack-<n>/skills/*
|
||||
# entry of pack-design and pack-gstack-design must have a SKILL.md.
|
||||
# Usage: design-tool-gate.sh (no argument; env DESIGN_GATE_PROFILE_SH,
|
||||
@@ -29,11 +30,8 @@ NEEDED=(pack-design pack-gstack-design
|
||||
"plugin:ui-ux-pro-max@ui-ux-pro-max-skill")
|
||||
|
||||
# ---- 21st CLI on PATH + sign-in state ---------------------------------------
|
||||
# Same sanitized-PATH problem for `21st` (an npm global bin): a PATH repair
|
||||
# for the 21st CLI only (claude is no longer called here). The npm global
|
||||
# bin dir is often missing from a hook's PATH. Probe for the binary directly
|
||||
# and prepend the dir that has it, otherwise a perfectly installed CLI reads
|
||||
# as "missing" and trips the gate.
|
||||
# A hook's PATH often lacks the npm global bin dir: find `21st` there and
|
||||
# prepend its dir, or an installed CLI reads as missing and trips the gate.
|
||||
ensure_21st_on_path() {
|
||||
command -v 21st >/dev/null 2>&1 && return
|
||||
local cand
|
||||
@@ -125,8 +123,10 @@ print_remedy() {
|
||||
echo " → run: bash ~/.claude/lib/profile.sh set web"
|
||||
for k in "${missing[@]}"; do
|
||||
case "$k" in
|
||||
pack-*) echo " or: profile.sh enable ${k#pack-}" ;;
|
||||
*) echo " (enable the plugin in a profile: set web)" ;;
|
||||
pack-*)
|
||||
echo " or: bash ~/.claude/lib/profile.sh enable ${k#pack-}" ;;
|
||||
*)
|
||||
echo " or: bash ~/.claude/lib/profile.sh enable ${k#plugin:}" ;;
|
||||
esac
|
||||
done
|
||||
echo " then /reload-plugins"
|
||||
|
||||
+5
-5
@@ -12,15 +12,15 @@ Agent(subagent_type="plugin-probe", description="plugin gate — probe",
|
||||
prompt="Run your probes from <PROJECT_ROOT>. Emit the PROBE REPORT.")
|
||||
```
|
||||
|
||||
## 2. VALIDATION CHECKPOINT (main loop — between probe and reasoner)
|
||||
## 2. VALIDATION CHECKPOINT (main loop: between probe and reasoner)
|
||||
|
||||
Validate the PROBE REPORT before any reasoning:
|
||||
- `PROFILE` block holds a `profile=` line.
|
||||
- At least one project signal present (MANIFESTS / FRAMEWORK-DEPS /
|
||||
TSX-JSX-COUNT > 0 / DOCKER-COUNT > 0 / EMBEDDED hits). Else print
|
||||
`⚠️ No project signals detected — recommendations will be conservative.`
|
||||
`⚠️ No project signals detected: recommendations will be conservative.`
|
||||
and continue.
|
||||
- `CHECKPOINT profile-sh=UNAVAILABLE` → print `⚠️ profile.sh unavailable —
|
||||
- `CHECKPOINT profile-sh=UNAVAILABLE` → print `⚠️ profile.sh unavailable:
|
||||
recommendations will be advisory only, no auto-activation.` and SKIP
|
||||
step 5 (apply) entirely.
|
||||
- PROBE REPORT missing/unparsable → retry the probe ONCE fresh; a 2nd
|
||||
@@ -44,7 +44,7 @@ Show the returned PLUGIN CHECK block.
|
||||
answered.
|
||||
- OK → print `✅ Plugin check passed — [active plugins] — complexity: <score>%`.
|
||||
|
||||
## 5. APPLY GATE (main loop — only when the flow auto-activates)
|
||||
## 5. APPLY GATE (main loop: only when the flow auto-activates)
|
||||
|
||||
If any plugin has ⚡ ENABLE status:
|
||||
1. List the changes:
|
||||
@@ -60,7 +60,7 @@ If any plugin has ⚡ ENABLE status:
|
||||
refuses (rc 2, nothing written), so there is nothing to roll back: stop at
|
||||
the first non-zero rc, print its stderr, and continue with the current
|
||||
config. "customize" → user picks. "no" → proceed with current config.
|
||||
3. After a successful write print `✅ Applied N change(s) — run
|
||||
3. After a successful write print `✅ Applied N change(s): run
|
||||
/reload-plugins to load the packs in this session (connectors and model:
|
||||
next session).` In a `--settings` conversation (`PROFILE :` block says
|
||||
`source=flag`) the advisor emits no enable for a pack the flag turns off;
|
||||
|
||||
@@ -55,7 +55,7 @@ plain on off off flag dev; out="$(gate_run in "$WORK/bin")"; rc=$?
|
||||
expect T3-remedy-flag 10 "relaunch this conversation with a design profile: cc <name> web"
|
||||
expect T3-names 10 "off: pack-gstack-design plugin:ui-ux-pro-max@ui-ux-pro-max-skill"
|
||||
plain on on off local web; out="$(gate_run in "$WORK/bin")"; rc=$?
|
||||
expect T3a-plugin 10 "enable the plugin in a profile: set web"
|
||||
expect T3a-plugin 10 "profile.sh enable ui-ux-pro-max@ui-ux-pro-max-skill"
|
||||
plain on on on local web
|
||||
mkdir -p "$WORK/repo/skills/pack-design/skills"
|
||||
ln -s /nonexistent "$WORK/repo/skills/pack-design/skills/x"
|
||||
|
||||
Reference in new issue
Block a user