diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index dfc4260..469a315 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -27,7 +27,7 @@ claude-config/ ├── rules/ # Rule files deployed to ~/.claude/rules (path-scoped or always-on) ├── agents/ # Execution units called by skills (never invoked directly) ├── skills/ # Entry points invoked via /skill-name -│ └── pack-/ # Skills-dir packs: manifest + tracked symlinks into skills-external/ +│ └── pack-/ # Skills-dir packs: manifest + tracked symlinks into skills-external/ (seo, geo, web-validate, site-motion: real dirs) ├── mods/ # Claude Code mods (function-hooks plugins), loaded through the skills/ symlink ├── skills-external/ # Vendored skill packs: gstack submodule, design skills, superpowers, agent-skills, MengTo scroll skills, 21st and Higgsfield packs (machine-owned copies gitignored) ├── templates/ # Per-project templates (CLAUDE.md, settings, memory registries, path-rule skeletons, deploy runbook, gitignore) diff --git a/CHANGELOG.md b/CHANGELOG.md index b682c9d..58a6ca5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,7 +8,7 @@ Format follows [Keep a Changelog](https://keepachangelog.com/) and this project ### Added - **Secure-by-default guardrails**: `rules/secure-by-default.md` (always on) makes six domains baseline on every project (the Supabase and cloud-function detail lives in the path rules `rules/supabase.md` and `rules/cloud-functions.md`), plus systematic API and access hygiene (auth on every route, CORS, secrets, passwords hashed with argon2id or bcrypt, never compared in clear, logged or hardcoded): hosting (rate limit, CDN and firewall, hard spend cap), Supabase (RLS on every table, owner-scoped policies, no service role key client-side), SMS and email (recorded consent, unsubscribe, STOP), cloud functions (no self-trigger, instance cap, budget stop), injection (bound values in raw escapes, `format()` for dynamic SQL, allowlisted filters, no shell into a DB tool), exposure (no data in the console, no production source map, no debug flag, no secret in hydrated state, data attributes, hidden fields or shipped comments). `/guardrails` audits them: a stdlib Python scanner (`skills/guardrails/scripts/scan.py`, FAIL / WARN / MANUAL, exit 1 on FAIL) then judgment, report in `.claude/audits/GUARDRAILS.md`. The security-auditor gate runs the scanner's `api` and `supabase` domains and blocks on FAIL. Items only a provider dashboard can set stay MANUAL, never claimed done. An optional read-only live probe (`skills/guardrails/scripts/probe.py`, `--live`) confirms a finding from outside on a target the user owns and names: anon-read, cross-user, no-auth route, CORS reflection and a capped rate-limit burst, verdicts OPEN / CLOSED / SKIPPED / ERROR. An `exposure` block in the plan adds three read-only probes, meant for a production build or a staging URL: a served or inline source map for the page's scripts, a stack trace in a 404 or a user-named error route, sensitive keys in a JSON response (identifier-shaped names printed, never values); a target the probe could not observe is SKIPPED or ERROR, never CLOSED, and every plan path must start with `/`. It sends GET, HEAD and OPTIONS only (one opt-in POST burst, capped at 25), requires `--authorized`, takes secrets from the environment never the command line, never follows a redirect to another host, and stops at a request budget. After the report, `/guardrails` proposes fixes (plan phase, so Fable when the router can switch), applies only the ones the user accepts through the `bugfixer` executor and the `lib/verify-secure-loop.md` gates, then re-scans: each accepted fix is a contract criterion whose oracle is the scanner (`--assert-absent RULE:path`, marker `GUARDRAILS-CLEAR`), and a full pass against the pre-fix baseline (`--baseline`, marker `GUARDRAILS-NO-NEW`) catches regressions; a live probe replays on the user's go; two rounds at most, residuals reported open; `--report-only` keeps the audit alone. Suites: `lib/tests/guardrails-scan.test.sh` (clean fixture plus one mutant per rule, check modes, `gates.sh` integration) and `lib/tests/guardrails-probe.test.sh` (probe logic against a localhost fixture server). -- **/a11y skill**: accessibility leaves `/guardrails` and becomes its own skill. Same A11Y-* rules (img alt, field label, click without keyboard, focus outline removed, positive tabindex) on the shared scan engine (`skills/guardrails/scripts/scanner.py`, a `Catalogue` per CLI; `skills/a11y/scripts/scan.py`, markers `A11Y-CLEAR` / `A11Y-NO-NEW`), a Tab-only walk of the main flow on `--live` through `/browse` (marked not done otherwise), report `.claude/audits/A11Y.md`, fixes proposed with the alt and label wording as the user's choice, applied through the bugfix circuit (`bugfixer`, verify-secure gates, `bugfix/a11y-`), re-pass against a baseline. The keyboard, alt and label doctrine moves from `rules/secure-by-default.md` to the lazy `rules/a11y.md` (loads on UI files only; `rules/web-building.md` points at it). `/guardrails` scans `injection` (INJ-*) and `exposure` (EXP-*) instead, with per-language SQL patterns, shared `code_files` / `hits` / `dedupe_lines` / `client_reachable` helpers and a walker that lists files over 1 MB by path; `--domain a11y` is a usage error there. `/web-validate` keeps full WCAG conformance. Suite `lib/tests/a11y-scan.test.sh`; routing row `reflect`; profiles audit, dev, web, full, max. +- **/a11y skill**: accessibility leaves `/guardrails` and becomes its own skill. Same A11Y-* rules (img alt, field label, click without keyboard, focus outline removed, positive tabindex) on the shared scan engine (`skills/guardrails/scripts/scanner.py`, a `Catalogue` per CLI; `skills/a11y/scripts/scan.py`, markers `A11Y-CLEAR` / `A11Y-NO-NEW`), a Tab-only walk of the main flow on `--live` through `/browse` (marked not done otherwise), report `.claude/audits/A11Y.md`, fixes proposed with the alt and label wording as the user's choice, applied through the bugfix circuit (`bugfixer`, verify-secure gates, `bugfix/a11y-`), re-pass against a baseline. The keyboard, alt and label doctrine moves from `rules/secure-by-default.md` to the lazy `rules/a11y.md` (loads on UI files only; `rules/web-building.md` points at it). `/guardrails` scans `injection` (INJ-*) and `exposure` (EXP-*) instead, with per-language SQL patterns, shared `code_files` / `hits` / `dedupe_lines` / `client_reachable` helpers and a walker that lists files over 1 MB by path; `--domain a11y` is a usage error there. `/web-validate` keeps full WCAG conformance. Suite `lib/tests/a11y-scan.test.sh`; routing row `reflect`; a top-level skill in no pack, so on under every profile. - **model-router mod**: `mods/model-router/`, a Claude Code mod (function-hooks plugin), routes every repo skill and agent from phase rows (`plan`, `reflect`, `orchestrate`, `escalate`, `judge`, `audit`, `implement`, `write`, `verify`, `explore`, `apply`, `mechanical`; built-ins Explore on sonnet/medium, Plan on opus/xhigh). A typed skill routes the main loop to its row, and a best-tier row holds across turns in a run slot until `/route clear`, `/route off`, a user `/model` or a typed skill on a non-best row. Agents get their row's model at spawn (within the tier, upward only) and its effort on every step; explicit Agent params win. Orchestrators declare their phases through the `mcp__model-router__route` tool. `ultrathink` in a prompt sets the turn's minimum effort and `/route effort=max` holds until `/route clear`; the built-in `/effort` is not a lever inside a run. `/route show` names the run slot (`main: run `), and a `null` row in the override drops a default row. The model gets a `route` tool and the user a `/route` command (`show|clear|off|on|reload|pending|ask on|off|forget ||model= effort=|switch on|off|verbose on|off`). Optional per-machine config `~/.claude/model-router.json`, where `"enabled": false` turns it off on that machine. The spinner suffix and the status line show the route in force. It loads in every session through the tracked symlink `skills/model-router` (`model-router@skills-dir`). `make doctor` gains a Mods section; suite `make test suite=lib/tests/mods.test.sh`. Known limits: a main-loop switch (a `/model` hand pick excepted) runs only while the cold read it costs (the context minus what the target model's prompt cache holds) fits `upgradeMaxTokens` (200000) or `downgradeMaxTokens` (120000), and a downgrade also needs `mainModelSwitch` (on by default, off on any non-boolean value); the hooks send full model ids, so the `models` table has to follow new versions. - **model-router first-use confirmation**: `mods/model-router/routing.json` (tracked) is the single source of the phase table and of every skill and agent row, and keeps the decisions: `confirmed`, `changed` (`from`/`to`), `projects` exceptions keyed by the origin remote reduced to `host/path` (credentials and local paths never stored), and `ask`. The first use of a rowed typed skill, a rowed agent spawn or a main-loop phase declared through the `route` tool opens a dialog with context: the skill's description (first sentence of its `SKILL.md` frontmatter) or the agent's, the phase with its `about` line (a new field on each of the 12 phases) and the model id and effort the next step really runs on. A row offers Later, Keep or Change; a main-loop phase Later or Keep. Change asks the model (fable, opus, sonnet, haiku with their tier), then the effort among those the phases of that model use (skipped when there is only one), then Everywhere or This project only; the pair maps to an existing phase (rows stay phase names, the same phase counts as Keep, a pair no phase offers is added by hand as a new phase). A skill-row change toasts the model and effort it now runs on, with the `/route switch on` hint when the main loop holds back a downgrade; a free-text answer counts as Later. One dialog at a time, never in headless (`-p`) runs or inside a sub-agent. Only a dialog answer, `/route ask on|off` or `/route forget` (which takes decisions back; a changed row returns to its shipped phase, the frontmatter floors stay yours to realign) writes the file (serialized, 64 KiB cap, never created when absent); each write asks you to commit it from the config repo. `/route pending` lists unconfirmed rows and phases. Layers: routing.json < `~/.claude/model-router.json` (its `ask` wins); a project's `.claude/model-router.json` is never read. Tests: `mods/model-router/hooks/register.test.ts`. - **model-router `/model` scope**: a `/model ` typed in the composer, or a pick in the `/model` picker, with a model the table knows asks where it applies. The picker's switch is held first (PreModelSwitch deny; the engine prints that a hook blocked it); a pick while another dialog is open is refused with `answer the open dialog first`. This project writes the full id as `model` into the project's `.claude/settings.local.json` (created if absent, refused through a link) and sets a sticky model route. This conversation sets the sticky route only. Everywhere runs the native `/model` (user `settings.json`). Both non-native answers drop the run slot and keep a sticky effort. With the picker's Default, an unknown name, a headless run or another origin, the native command runs with no question. A model chosen in that dialog always switches: it bypasses the cold-read caps and the `mainUpgrade` / `mainModelSwitch` flags, and while it is marked down or outside a known window it waits and the automatic chain decides. A native switch or `/clear` drops it; `/route model=` keeps the caps. Known limits: the `/config` Model row still writes user `settings.json`; a dialog never answered has no timeout. Tests: `mods/model-router/hooks/register.test.ts`. @@ -21,8 +21,8 @@ Format follows [Keep a Changelog](https://keepachangelog.com/) and this project - **InstructionsLoaded logger**: `hooks/instructions-loaded.sh`, wired in `settings.json`, appends one JSON line per instruction file loaded to `~/.claude/logs/instructions-loaded.jsonl` (rotated above 5 MB), the proof that a path rule loaded. - **Memory registries v2, single writer**: `lib/memory.sh` is the one writer and reader of the `.claude/memory/` registries (every verb takes an optional leading `-C `): `add --title … --body-file … [--status …] [--supersedes ]` appends an entry with the next ID from the headings and prints only the new ID (a body line starting `## ` outside a code fence would split the entry and is refused, rc 2); `status ` appends a dated `**Status ()**:` line; `journal ` appends under today's `## YYYY-MM-DD`; `index []` prints ID, date, title and status from headings and bodies; `check [--staged]` verifies heading shape, unique IDs, no Index and no open fence (a v1 file is named, never failed); `upgrade` migrates v1 to v2 (Index-only dates and statuses become body lines, `format: 2` added, `## Index` removed, every v1 heading dialect becomes `## ID — title (date)`), after an oracle on IDs, check and blocker verdicts, else rc 2 with the file untouched (a duplicate ID, a non-table Index, or a blocker the v1 reader closed only through prose, a mixed or a negated Status line is refused and named with the `memory.sh status` remedy; a v1 closure is carried over only from a `Status`/`Statut` label holding one closed, non-negated word, at most one upgrade status line per entry). Writes run under a lock in the git common dir (a stale lock is stolen by one waiter at a time; a steal marker left empty over 60 s counts as a dead stealer and is cleared), on a verified backup restored on failure or signal. `templates/memory/` ships v2 templates; the session banner adds `registry v1: N file(s) (memory.sh check)` while a project registry is v1. Suite `lib/tests/memory.test.sh`. - **Architecture defaults carrier**: `lib/architecture-defaults.md`, read before proposing a stack (new project, scaffolding, stack brainstorm, whole-project rewrite): public sites never SPA, Rust by default, web APIs versioned. Path rules `rules/supabase.md` and `rules/cloud-functions.md` hold the full Supabase and cloud-function domains. Suites `lib/tests/user-rules.test.sh` and `lib/tests/doctor-automem.test.sh`. -- **Packs**: nine skills-dir packs under `skills/pack-/` (design, scroll3d, seo, web-validate, gstack-dev, gstack-browser, gstack-design, higgsfield, extras), each a manifest plus tracked symlinks into `skills-external/`. The installers only fill `skills-external/`; a pack is on or off as a unit. `lib/pack-census.sh` checks the packs (every skill linked once, targets resolve, doc citers) and runs in `make test`. -- **Profiles as settings fragments**: `lib/profiles/.json` replaces the flat-link profiles. `lib/profile.sh` verbs: `set`, `enable`, `disable`, `current` (`--plain` for hooks), `list`; `-C ` targets a project, `make profile cmd="set X" dir=/path` and `make profile-current dir=/path`. A project with no local profile runs the manifest defaults (= `full`). +- **Packs**: nine skills-dir packs under `skills/pack-/` (design, scroll3d, seo, web-validate, gstack-dev, gstack-browser, gstack-design, higgsfield, extras), each a manifest plus tracked symlinks into `skills-external/` (seo, geo, web-validate and site-motion are real directories inside their pack). The installers only fill `skills-external/`; a pack is on or off as a unit. `lib/pack-census.sh` checks the packs (every skill linked once, targets resolve, doc citers) and runs in `make test`. +- **Profiles as settings fragments**: `lib/profiles/.json` replaces the flat-link profiles. `lib/profile.sh` verbs: `list`, `show`, `current` (`--plain` for hooks), `set`, `unset`, `enable`, `disable`, `diff`; `-C ` targets a project, `make profile cmd="set X" dir=/path` and `make profile-current dir=/path`. A project with no local profile runs the manifest defaults (= `full`). - Nine profiles: `full`, `max`, `minimal`, `dev`, `design`, `web`, `seo`, `qa`, `audit`. `backend` (= `dev`) and `web-full` (= `full`) were identical fragments and are gone; the census refuses two equal fragments. - **`cc [profile]`**: `lib/cc.sh`, sourced from `~/.bashrc`, starts a conversation under a profile fragment through `--settings`. - The design gate, the plugin gate and advisor, the statusline, the session banner and `doctor.sh` read `profile.sh current --plain`. `doctor.sh` gains Packs and Profiles sections and checks that `cc.sh` is sourced. @@ -52,7 +52,7 @@ Format follows [Keep a Changelog](https://keepachangelog.com/) and this project - `settings.json` sets `"autoMemoryEnabled": false`. `make doctor` gains an Auto memory section (the setting, plus leftover files under `~/.claude/projects/*/memory/`) and checks the `~/.claude/rules` symlink (8 links). The session-start health check includes `rules`. - `lib/tests/doctrine-citers.test.sh`: the file-citation census also reads nested `lib//` paths, `~/.claude/` and `$HOME/.claude/` prefixes (mapped to this repo) and `templates/project-rules/`; a bare `.claude/rules/` citation resolves by citer (this repo's own rules from `.claude/rules/` or `rules/`, else `templates/project-rules/`); T6 also scans `templates/` and `.claude/rules/`, T3 keeps its roots. - `link.sh` no longer links the design and scroll skills flat; impeccable moves to `skills-external/impeccable`. Docs and routing (`CLAUDE.global.md`, `/profile`, README, USAGE, ARCHITECTURE) speak packs. -- Known limit: `cc x web` on a project in `dev` keeps them denied (`deniedMcpServers` is a union); `profile.sh set web` in the project lifts them. +- Known limit: `cc x web` on a project in `dev` keeps the higgsfield connectors denied (`deniedMcpServers` is a union); `profile.sh set web` in the project lifts them from the next session. - Measured headless on 2026-11-02: dev = `pack-gstack-dev`, 41 tools, 0 higgsfield; web = the six web packs, 199 tools, both connectors `connected` and 158 higgsfield tools listed in init (the stderr line "blocked by enterprise policy: claude.ai higgsfield, claude.ai Higgsfield AI" appeared on the deny profiles dev, qa, seo and minimal: that is `deniedMcpServers` working); qa = `pack-gstack-browser pack-web-validate`; seo = qa + `pack-gstack-dev pack-seo`; qa and seo 41 tools, 0 higgsfield; reload canary in one flagless session (id `ee65507c-a958-411b-9580-8aca8105e326`): `/seo` unavailable on minimal, `profile.sh enable seo`, `/reload-plugins` -> "Reloaded: 3 plugins · 2 skills · 32 agents · 7 hooks", then `/seo` and `/pack-seo:seo` both load the SEO skill. `profile.sh current --plain` median 30 ms (target 50). - Listing budget with the packs: measured headless on 2026-11-02 with `--model haiku` (name-only skills, entries 124 on full, 90 on dev): full default 58, 40000 11, 50000 0, 60000 0; dev default 9, 40000 and above 0. Set `SLASH_COMMAND_TOOL_CHAR_BUDGET=50000` in `settings.json` `env`, the smallest tested value with 0 name-only on full. Cost, estimated: full (48.5k - 30.3k bytes) / 4, about 4.5k tokens; dev 30.0k to 36.8k bytes, about 1.7k tokens. `env` is global, so every profile pays. Descriptions are no longer truncated at 50000 (natural size 48.5k). The default budget's absolute value was not read; it may depend on the model's context window. diff --git a/MIGRATION.md b/MIGRATION.md index 4c4f3e2..003e5cc 100644 --- a/MIGRATION.md +++ b/MIGRATION.md @@ -195,7 +195,7 @@ make doctor - **Superpowers**: the plugin is gone. Its 7 wired skills are vendored at v6.4.1 and always on. The 8 other skills and the session-start injection are not replaced. - **Magic MCP**: replaced by the `21st` CLI (`21st login`, no API key). If 1.x registered the `magic` server, remove it from `~/.claude.json` and drop `MAGIC_API_KEY` from `~/.claude/.env`. Nothing reads them any more. - **Git hooks in every repo**: `link.sh` sets git's global `core.hooksPath` to `~/.claude/githooks`. Every repo on the machine now gets the gitflow pre-commit guard and pushes each commit as it lands. For a foreign clone: `git config gitflow.protect false` and `git config gitflow.autopush false`. -- **Default profile**: a project with no local profile runs the manifest defaults (= `full`). Check with `bash lib/profile.sh current`. Nine gstack skills (`ship`, `land-and-deploy`, `setup-deploy`, `autoplan`, `context-save`, `learn`, `careful`, `guard`, `design-shotgun`) left every profile and are denylisted. +- **Default profile**: a project with no local profile runs the manifest defaults (= `full`). Check with `bash ~/.claude/lib/profile.sh current` from the project. Nine gstack skills (`ship`, `land-and-deploy`, `setup-deploy`, `autoplan`, `context-save`, `learn`, `careful`, `guard`, `design-shotgun`) left every profile and are denylisted. - **Higgsfield**: installed, off by default. Nothing to do until you enable it. ### Profiles and packs (2026-11) @@ -216,9 +216,11 @@ is the only one that removes a real directory (`make plugin` replaces writes. ```bash - root="$(dirname "$(readlink -f ~/.claude/settings.json)")" \ - && cd "$root" || exit 1 - git pull --autostash \ + ep= next= + root="$(dirname "$(readlink -f ~/.claude/settings.json)")" + [ -n "$root" ] && [ -f "$root/lib/profile.sh" ] && cd "$root" \ + || { echo "no clone root"; false; } \ + && git pull --autostash \ && ep="$(mktemp)" \ && git show HEAD:settings.json | jq -e '.enabledPlugins | objects' \ > "$ep" \ @@ -232,39 +234,50 @@ is the only one that removes a real directory (`make plugin` replaces Every command is chained with `&&` so that a failed step never reaches `cp`, which writes through the symlink into the live tracked - `settings.json`. `jq -e '.enabledPlugins | objects'` fails when HEAD - holds no object (a null would wipe every plugin). `jq -e .` and `[ -s ]` - refuse an invalid or empty result (an empty file would drop the plugins, - the deny rules and the hooks). + `settings.json`; a failure prints `no clone root` or stops the chain + without closing your shell. `ep= next=` comes first so the final `rm -f` + never removes a file an earlier run named. `jq -e '.enabledPlugins | + objects'` fails when HEAD holds no object (a null would wipe every + plugin). `jq -e .` and `[ -s ]` refuse an invalid or empty result (an + empty file would drop the plugins, the deny rules and the hooks). + + If the autostash pop conflicts, `settings.json` holds conflict markers: + the second `jq` then fails closed and nothing is copied. Resolve the + markers (`git stash list` shows the kept stash) before re-running step 1. 2. Old layout. List the flat links first, then remove the links of `skills-disabled/` and the links of `skills/` that are not kept (model-router, darwin-skill, the seven superpowers, the agent-skills trio). If `skills/impeccable` or `skills-disabled/impeccable` is a real - directory, `mv` it to `skills-external/impeccable` (never `rm`). Run it - from `$root` (step 1). The trailing slash and `-mindepth 1` keep `find` - from matching the start point, which is itself a symlink in `~/.claude`. + directory, `mv` it to `skills-external/impeccable` (never `rm`). It + re-derives `$root`, so it also runs in a new shell; `mkdir -p + skills-disabled` lets a machine that never had that dir pass the same + chain, and `rmdir` removes it at the end. The trailing slash and + `-mindepth 1` keep `find` from matching the start point, which is itself + a symlink in `~/.claude`. ```bash - cd "$root" || exit 1 - find skills/ skills-disabled/ -mindepth 1 -maxdepth 1 -type l - mkdir -p skills-external - for d in skills skills-disabled; do - if [ -d "$d/impeccable" ] && [ ! -L "$d/impeccable" ] \ - && [ ! -e skills-external/impeccable ]; then - mv "$d/impeccable" skills-external/impeccable - fi - done - find skills-disabled/ -mindepth 1 -maxdepth 1 -type l -delete - find skills/ -mindepth 1 -maxdepth 1 -type l \ - ! -name model-router ! -name darwin-skill \ - ! -name observability-and-instrumentation \ - ! -name deprecation-and-migration ! -name ci-cd-and-automation \ - ! -name brainstorming ! -name writing-plans \ - ! -name subagent-driven-development ! -name test-driven-development \ - ! -name requesting-code-review ! -name using-git-worktrees \ - ! -name writing-skills -delete - rmdir skills-disabled; rm -f .active-profile + root="$(dirname "$(readlink -f ~/.claude/settings.json)")" + [ -f "$root/lib/profile.sh" ] && cd "$root" \ + || { echo "no clone root"; false; } \ + && mkdir -p skills-disabled skills-external \ + && find skills/ skills-disabled/ -mindepth 1 -maxdepth 1 -type l \ + && for d in skills skills-disabled; do + if [ -d "$d/impeccable" ] && [ ! -L "$d/impeccable" ] \ + && [ ! -e skills-external/impeccable ]; then + mv "$d/impeccable" skills-external/impeccable + fi + done \ + && find skills-disabled/ -mindepth 1 -maxdepth 1 -type l -delete \ + && find skills/ -mindepth 1 -maxdepth 1 -type l \ + ! -name model-router ! -name darwin-skill \ + ! -name observability-and-instrumentation \ + ! -name deprecation-and-migration ! -name ci-cd-and-automation \ + ! -name brainstorming ! -name writing-plans \ + ! -name subagent-driven-development ! -name test-driven-development \ + ! -name requesting-code-review ! -name using-git-worktrees \ + ! -name writing-skills -delete \ + && rmdir skills-disabled && rm -f .active-profile ``` 3. From `$root`: `make link` (link.sh no longer links the design and scroll skills flat), diff --git a/README.md b/README.md index bb0f9c1..713c42b 100644 --- a/README.md +++ b/README.md @@ -156,7 +156,7 @@ Limits: a main-loop switch re-reads cold the part of the context the target mode All scripts use their own location to find the repo — run them from anywhere. The plugins step logs to `install-YYYYMMDD-HHMMSS.log`. -The installers fill `skills-external/`; the packs under `skills/pack-*/` link it, on or off per project (`bash lib/profile.sh set `) or per conversation (`cc `). +The installers fill `skills-external/`; the packs under `skills/pack-*/` link it, on or off per project (`bash ~/.claude/lib/profile.sh set ` from the project, then `/reload-plugins`) or per conversation (`cc `). `cc` is a shell function from `lib/cc.sh`: add `[ -f "$HOME/.claude/lib/cc.sh" ] && . "$HOME/.claude/lib/cc.sh"` to `~/.bashrc` (`make doctor` warns until it is there). **Optional — Context7** (fast doc lookup for React / Next.js / Prisma…): the plugins step installs the `ctx7` CLI and wires it into Claude Code. The doc-fetch surface is @@ -245,9 +245,12 @@ a different package, ships its own conflicting `graphify` bin) — see | `/site-motion` | Site-level motion: scroll engine choice, page transitions, pin/scrub sequencing across a page or Astro route (design stack) | | `/route` | model-router mod: show or set the main-loop route (show, clear, off, on, reload, pending, ask on\|off, , model=… effort=…, switch on\|off, classify on\|off, verbose on\|off: transitions only) | -> This table lists personal skills. Gstack skills (investigate, review, retro, -> office-hours, cso…) and marketplace plugins add many more — run -> `/skills-perso` to list your hand-written skills, or browse `skills/`. +> This table lists personal skills. `/seo` and `/geo` (pack-seo), `/web-validate` +> (pack-web-validate) and `/site-motion` (pack-design) live in packs: a profile that +> leaves the pack off hides them (`/profile current`). Gstack skills (investigate, +> review, retro, office-hours, cso…) and marketplace plugins add many more; run +> `/skills-perso` to list your hand-written skills, or browse `skills/` and +> `skills/pack-*/skills/`. --- @@ -384,7 +387,7 @@ an interactive terminal) and installs the skill pack that drives it: publishing skills `-registry`, `-design-sync` and `-video`. `21st-ui-build` and `21st-cli-use` sit in pack-design (on under `full`, `design` and `web`). `-ui-explore`, `-ui-review` and `-ai` sit in pack-extras (on -under `max`, or after `bash lib/profile.sh enable extras`). `-registry`, +under `max`, or after `bash ~/.claude/lib/profile.sh enable extras` in the project). `-registry`, `-design-sync` and `-video` stay unlinked in `skills-external/`. The pack is machine-owned and gitignored. It cannot be installed the way @@ -427,8 +430,8 @@ The pack is off by default and on in `max` only. It costs nothing until you ask for it: ```bash -bash lib/profile.sh enable higgsfield # then /reload-plugins -bash lib/profile.sh disable higgsfield +bash ~/.claude/lib/profile.sh enable higgsfield # from the project, then /reload-plugins +bash ~/.claude/lib/profile.sh disable higgsfield ``` The pack (`skills/pack-higgsfield/skills/`) holds the 8 `higgsfield-*` @@ -436,7 +439,7 @@ skills. `higgsfield-websites` is one of them. It helps with landing pages inside the design stack (assets, references), and `higgsfield website -create|deploy|publish` stays unused. Claude runs `bash lib/profile.sh enable higgsfield` on +create|deploy|publish` stays unused. Claude runs `bash ~/.claude/lib/profile.sh enable higgsfield` on a named media ask, then `/reload-plugins` (Skill routing in `CLAUDE.global.md`) and checks the price with `higgsfield generate cost` before a paid run. diff --git a/USAGE.md b/USAGE.md index 87faef3..97f6a9c 100644 --- a/USAGE.md +++ b/USAGE.md @@ -173,8 +173,10 @@ Tu veux... | `/route` | Voir ou fixer la route du mod model-router | show / clear / off / on / reload / pending / ask on\|off / / model=… effort=… / switch on\|off / classify on\|off (classifieur de prompt) / verbose on\|off (transitions seules) | | `/profile` | Changer le profil de packs du projet (`set`), ou l'état effectif (`current`) | Profils dans `lib/profiles/*.json`, packs dans `skills/pack-*/` | -> Cette table couvre les skills personnels principaux. Les plugins (gstack, -> pr-review-toolkit…) et marketplaces externes en ajoutent beaucoup d'autres — +> Cette table couvre les skills personnels principaux. `/seo` et `/geo` (pack-seo) +> et `/web-validate` (pack-web-validate) vivent dans des packs : un profil qui laisse +> le pack éteint les masque (`/profile current`). Les plugins (gstack, +> pr-review-toolkit…) et marketplaces externes en ajoutent beaucoup d'autres ; > `/skills-perso` liste tes skills personnels. --- @@ -214,7 +216,7 @@ Hotfix/quick fix → tout OFF (skills superpowers vendorisés, toujours **GSD v2** n'est pas un plugin Claude Code — c'est un CLI externe. Il ne consomme pas de tokens passifs. Tu le lances dans un terminal séparé avec `gsd`, puis `/gsd auto` pour le mode autonome. -**Profils et packs.** Un profil se règle par projet (`/profile set web` puis `/reload-plugins`) ou par conversation (`cc web`, la conversation est figée: relance-la pour changer). Neuf profils: `full`, `max`, `minimal`, `dev`, `design`, `web`, `seo`, `qa`, `audit`. Sans profil, c'est `full`. Un `--settings` édité en cours de session reste sans effet. `cc x web` sur un projet en `dev` garde les connecteurs higgsfield refusés (union); `set web` dans le projet les rend. +**Profils et packs.** Un profil se règle par projet (`/profile set web` puis `/reload-plugins`) ou par conversation (`cc web`, la conversation est figée: relance-la pour changer). Neuf profils: `full`, `max`, `minimal`, `dev`, `design`, `web`, `seo`, `qa`, `audit`. Sans profil, c'est `full`. Un `--settings` édité en cours de session reste sans effet. `cc x web` sur un projet en `dev` garde les connecteurs higgsfield refusés (union); `set web` dans le projet les rend. `cc` est une fonction de `lib/cc.sh`, à sourcer depuis `~/.bashrc` (`[ -f "$HOME/.claude/lib/cc.sh" ] && . "$HOME/.claude/lib/cc.sh"`) ; `make doctor` le signale tant qu'elle manque. ---