docs: Higgsfield README + CHANGELOG match the npm-only CLI refresh and the two disables — ship-feature higgsfield-pack

This commit is contained in:
bastien
2026-09-30 18:17:16 +02:00
parent 4c7db8893b
commit d9617d8eb8
2 changed files with 7 additions and 6 deletions
+1 -1
View File
@@ -7,7 +7,7 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
## [Unreleased] ## [Unreleased]
### Added ### Added
- **Higgsfield pack, off by default**: `make plugin` installs the `@higgsfield/cli` CLI (Step 8.6) and clones the skills of higgsfield-ai/skills into `skills-external/higgsfield-*` through the new `lib/higgsfield-skills.sh`; `make update` refreshes both; `make doctor` reports the CLI and its session at info level. The pack belongs to no profile: `lib/toggle-external.sh enable higgsfield` links the seven allowlisted media skills, `enable higgsfield-websites` the landing-page aid, and no `profile set` or `make link` re-enables either. `CLAUDE.global.md` routes explicit media-generation asks to it. Hermetic suite `lib/tests/higgsfield.test.sh`. - **Higgsfield pack, off by default**: `make plugin` installs the `@higgsfield/cli` CLI (Step 8.6) and clones the skills of higgsfield-ai/skills into `skills-external/higgsfield-*` through the new `lib/higgsfield-skills.sh`; `make update` refreshes the skills, and the CLI when npm installed it; `make doctor` reports the CLI and its session without ever warning. The pack belongs to no profile: `lib/toggle-external.sh enable higgsfield` links the seven allowlisted media skills, `enable higgsfield-websites` the landing-page aid, and no `profile set` or `make link` re-enables either. `CLAUDE.global.md` routes explicit media-generation asks to it. Hermetic suite `lib/tests/higgsfield.test.sh`.
- **Effort round (BDR-108)**: every skill carries an entry level next to its model pin. `lib/effort-pins.txt` (map) + `lib/effort-pins.sh` (idempotent re-apply after the last vendoring step of `install-plugins.sh` and `update-all.sh`) replace the hardcoded brainstorming/writing-plans loop and extend the pins to the design stack (high, one level per stack since the last loaded wins), superpowers, agent-skills and the 21st pack; `skills-perso` low, `pdf-translate` medium, `site-motion` high; doctrine: the design stack loads paired with the first Read (a lone Skill call applies nothing). Model pins stay tier aliases: the latest version of a tier is also the cheapest or same-priced, so the quality/price trade-off is tier × effort, never version. `lib/effort-audit.py` prints thinking coverage per scope (sub-agent records carry no thinking count on ~90 % of requests: EVAL-037's "executors stay cheap" was a measurement gap, not a finding). - **Effort round (BDR-108)**: every skill carries an entry level next to its model pin. `lib/effort-pins.txt` (map) + `lib/effort-pins.sh` (idempotent re-apply after the last vendoring step of `install-plugins.sh` and `update-all.sh`) replace the hardcoded brainstorming/writing-plans loop and extend the pins to the design stack (high, one level per stack since the last loaded wins), superpowers, agent-skills and the 21st pack; `skills-perso` low, `pdf-translate` medium, `site-motion` high; doctrine: the design stack loads paired with the first Read (a lone Skill call applies nothing). Model pins stay tier aliases: the latest version of a tier is also the cheapest or same-priced, so the quality/price trade-off is tier × effort, never version. `lib/effort-audit.py` prints thinking coverage per scope (sub-agent records carry no thinking count on ~90 % of requests: EVAL-037's "executors stay cheap" was a measurement gap, not a finding).
- **Effort tiering (BDR-107)**: reasoning effort routed per role and per phase. Session default `high`; `effort:` pins on the 20 repo-authored agents; entry level on 28 tracked user-invoked skills plus the two vendored superpowers skills (re-applied by `install-plugins.sh` after resync); five shifter skills `effort-low` … `effort-max` loaded at phase boundaries per `lib/effort-shift.md`, always sent with the step's first tool call (a lone Skill call is a no-op on 2.1.283), with `max` at the verify-secure caps and ship-feature 4b; `/effort-max` as the turn-scoped relaunch lever; statusline shows the live level; session banner warns when `CLAUDE_CODE_EFFORT_LEVEL` silences the pins; census `lib/tests/effort-routing.test.sh`; transcript audit `lib/effort-audit.py`. - **Effort tiering (BDR-107)**: reasoning effort routed per role and per phase. Session default `high`; `effort:` pins on the 20 repo-authored agents; entry level on 28 tracked user-invoked skills plus the two vendored superpowers skills (re-applied by `install-plugins.sh` after resync); five shifter skills `effort-low` … `effort-max` loaded at phase boundaries per `lib/effort-shift.md`, always sent with the step's first tool call (a lone Skill call is a no-op on 2.1.283), with `max` at the verify-secure caps and ship-feature 4b; `/effort-max` as the turn-scoped relaunch lever; statusline shows the live level; session banner warns when `CLAUDE_CODE_EFFORT_LEVEL` silences the pins; census `lib/tests/effort-routing.test.sh`; transcript audit `lib/effort-audit.py`.
- **Design gate asks the user to sign in to 21st instead of skipping it**: - **Design gate asks the user to sign in to 21st instead of skipping it**:
+6 -5
View File
@@ -362,11 +362,11 @@ higgsfield auth login # browser flow
`make plugin` does both (Step 8.6 installs the CLI, then offers the login in `make plugin` does both (Step 8.6 installs the CLI, then offers the login in
an interactive terminal) and clones the skills of an interactive terminal) and clones the skills of
[higgsfield-ai/skills](https://github.com/higgsfield-ai/skills) into [higgsfield-ai/skills](https://github.com/higgsfield-ai/skills) into
`skills-external/higgsfield-*`. `make update` refreshes the CLI and the `skills-external/higgsfield-*`. `make update` refreshes the skills, and the
skills, and `make doctor` reports the CLI and its session. The copies are CLI when npm installed it; `make doctor` reports the CLI and its session.
machine-owned and gitignored. They follow upstream `main`, so a prompt The copies are machine-owned and gitignored. They follow upstream `main`,
change arrives with no diff to review, and a skill that upstream removes so a prompt change arrives with no diff to review, and a skill that
keeps its last local copy. upstream removes keeps its last local copy.
The pack is off by default and belongs to no profile. It costs nothing until The pack is off by default and belongs to no profile. It costs nothing until
you ask for it, and no `profile set` touches it: you ask for it, and no `profile set` touches it:
@@ -375,6 +375,7 @@ you ask for it, and no `profile set` touches it:
bash lib/toggle-external.sh enable higgsfield # media skills bash lib/toggle-external.sh enable higgsfield # media skills
bash lib/toggle-external.sh enable higgsfield-websites # landing-page aid bash lib/toggle-external.sh enable higgsfield-websites # landing-page aid
bash lib/toggle-external.sh disable higgsfield bash lib/toggle-external.sh disable higgsfield
bash lib/toggle-external.sh disable higgsfield-websites
``` ```
`higgsfield` links a fixed list of seven media skills: generate, soul-id, `higgsfield` links a fixed list of seven media skills: generate, soul-id,