docs(profiles): profiles no longer described by connector state
This commit is contained in:
1 parent
b80da299c7
commit
91a32a7a7d
4 files changed
+13
-19
No files matched your search
+2
-2
@@ -59,11 +59,11 @@ 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/<dir>/` 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 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).
|
||||
- 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; 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.
|
||||
- gitflow pre-commit (`lib/gitflow.sh`, generated `githooks/pre-commit` and per-repo `.githooks/pre-commit`) exempts on `main`/`develop` only staged paths under `.claude/memory/`, `.claude/tasks/`, `.claude/audits/`, `.claude/deploy/` and `.githooks/`, was all of `.claude/**`. A commit touching `.claude/rules/`, `.claude/settings.json`, agents or skills on a protected base is now blocked: branch first. Staged paths are listed with `--no-renames`, so a `git mv` from a blocked path into the allowlist is blocked too. Per-repo hooks pick it up at the next session start, the global ones at `make link`. Tests: `lib/gitflow-test.sh` T21d-T21h.
|
||||
- `settings.json` gains `skillOverrides` setting the claude.ai-synced skills to `"off"`, global so a plain `claude` gets it too. Listed by name: a skill synced later stays listed until its name is added, and a same-named skill elsewhere is hidden too. A project re-enables one with `{"skillOverrides": {"<name>": "on"}}` in its `.claude/settings.local.json`. The reason is listing cost: every synced skill is listed in every session's context. Measured headless on the full profile on 2026-11-09, CLI 2.1.319: Skills 16.2k to 12.5k, total 32.2k to 28.5k. The listing budget is unchanged (40000 and 50000 give the same listing once the synced skills are off). `syncClaudeAiSkills: false` is not used: it moves the synced skills to `~/.claude/skills/.trash/`. Check `claude --version` on another machine before pulling.
|
||||
- Profiles deny no claude.ai connector: the two higgsfield connectors were removed from the claude.ai account on 2026-11-09, so `deniedMcpServers` leaves `audit`, `dev`, `minimal`, `qa` and `seo`, and the pack census drops its connector rule. A project that ran `profile.sh set` with one of those five profiles before this change keeps the two entries in its `.claude/settings.local.json`, and no profile verb strips them any more: harmless while the connectors stay removed, delete them by hand before reconnecting either one. Reconnecting them for good: revert the `chore(profiles)` commit of this change, which restores the denies and their census rule.
|
||||
|
||||
### Removed
|
||||
- `rules/default-language.md`: its content is `lib/architecture-defaults.md` § Default language.
|
||||
|
||||
@@ -239,7 +239,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 <nom> 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.
|
||||
**Profils et packs.** Un profil se règle par projet (`/profile set web` puis `/reload-plugins`) ou par conversation (`cc <nom> 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` 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.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -2,23 +2,21 @@
|
||||
|
||||
A profile is a literal Claude Code settings fragment: `enabledPlugins`
|
||||
(every pack `pack-<n>@skills-dir` and managed plugin, explicit), optional
|
||||
`deniedMcpServers` (the two higgsfield claude.ai connectors), optional
|
||||
`deniedMcpServers` (claude.ai connectors to deny), optional
|
||||
`model`. Per project: `bash ~/.claude/lib/profile.sh set <name>` writes it
|
||||
into `.claude/settings.local.json`, then `/reload-plugins`. Per
|
||||
conversation: `cc <session> <name>` (lib/cc.sh) runs
|
||||
`claude --settings lib/profiles/<name>.json`; that conversation is frozen
|
||||
(no reload brings a pack back; relaunch instead). No profile = the manifest
|
||||
defaults = `full` with the connectors present. `deniedMcpServers` is a union
|
||||
across files: a `cc x web` over a project set to `dev` keeps the connectors
|
||||
denied; `set web` in the project brings them back next session.
|
||||
defaults = `full`.
|
||||
|
||||
`profile.sh list` reads these lines (format `- **name**: text`):
|
||||
|
||||
- **full**: every pack except higgsfield and extras; ui-ux-pro-max on; connectors present. The default.
|
||||
- **full**: every pack except higgsfield and extras; ui-ux-pro-max on. The default.
|
||||
- **max**: everything on, pr-review-toolkit included; for a one-off session, not a project.
|
||||
- **minimal**: no pack, no design plugin, connectors denied; the smallest listing.
|
||||
- **minimal**: no pack, no design plugin; the smallest listing.
|
||||
- **dev**: gstack-dev only; backend or tooling work without UI.
|
||||
- **design**: design, scroll3d, gstack-design, gstack-browser, ui-ux-pro-max; connectors present.
|
||||
- **design**: design, scroll3d, gstack-design, gstack-browser, ui-ux-pro-max.
|
||||
- **web**: design + scroll3d + web-validate + the three gstack packs + ui-ux-pro-max; public site work.
|
||||
- **seo**: seo, web-validate, gstack-browser, gstack-dev; audit and fixes on a live site.
|
||||
- **qa**: gstack-browser + web-validate; dogfooding and conformance only.
|
||||
@@ -27,6 +25,6 @@ denied; `set web` in the project brings them back next session.
|
||||
Invariants (checked by `lib/pack-census.sh`): the same key set in every
|
||||
fragment; `model-router@skills-dir` and `security-guidance@claude-code-plugins`
|
||||
true everywhere; `example-skills@anthropic-agent-skills` and
|
||||
`brightdata-plugin@synced` false everywhere; the connectors denied on exactly
|
||||
minimal, dev, seo, qa, audit; `full` equal to the manifest defaults.
|
||||
`brightdata-plugin@synced` false everywhere; `full` equal to the manifest
|
||||
defaults.
|
||||
Add your own profile as another `<name>.json` with the same key set.
|
||||
@@ -23,8 +23,8 @@ output. With no argument, run `current` and then `list`.
|
||||
## What a profile is
|
||||
|
||||
`lib/profiles/<name>.json` holds `enabledPlugins` (every pack and managed
|
||||
plugin, explicit), optional `deniedMcpServers` (the two higgsfield claude.ai
|
||||
connectors) and optional `model`. Descriptions: `lib/profiles/README.md`.
|
||||
plugin, explicit), optional `deniedMcpServers` (claude.ai connectors to
|
||||
deny) and optional `model`. Descriptions: `lib/profiles/README.md`.
|
||||
|
||||
- Per project: `set <name>` merges the fragment into
|
||||
`.claude/settings.local.json` (other keys kept). Then `/reload-plugins`
|
||||
@@ -34,8 +34,7 @@ connectors) and optional `model`. Descriptions: `lib/profiles/README.md`.
|
||||
`claude --settings lib/profiles/<name>.json`. That conversation is frozen:
|
||||
editing the fragment or the local file changes nothing here, and a pack the
|
||||
fragment turns off cannot come back; start another `cc`.
|
||||
- No profile: the manifest defaults, which equal `full` with the connectors
|
||||
present.
|
||||
- No profile: the manifest defaults, which equal `full`.
|
||||
|
||||
## Verbs
|
||||
|
||||
@@ -58,9 +57,6 @@ root (no `CLAUDE.md`, no `.git`), unreadable or invalid local JSON.
|
||||
plugins through the `claude plugin` CLI. A pack need found mid-skill is proposed to
|
||||
the user (`set <n>` or `enable <pack>` + `/reload-plugins`, or a relaunch
|
||||
under `--settings`), written only on consent (lib/plugin-gate.md).
|
||||
- `deniedMcpServers` is a union across settings files: a `cc x web` over a
|
||||
project set to `dev` keeps the connectors denied; `set web` in the
|
||||
project brings them back for the next session.
|
||||
- `max` turns on `pack-extras` (diagram, make-pdf, 21st-ai, 21st-ui-explore,
|
||||
21st-ui-review); `pack-higgsfield` is on in `max` only, else `enable
|
||||
higgsfield` for a named media ask.
|
||||
Reference in new issue
Block a user