docs(phase5): higgsfield citers, MIGRATION fenced steps + real-dir impeccable, gate header, /profile allowed-tools, wording

This commit is contained in:
bchanot committed 2026-11-02 11:48:46 +01:00
1 parent 9327b4fcd0
commit 94ce345aa2
12 files changed
+93 -55

No files matched your search

+7 -5
View File
@@ -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
+9 -9
View File
@@ -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
View File
@@ -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;
+1 -1
View File
@@ -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"