From 28822af38c4bfc2e544668c8c7ff36f0edc61015 Mon Sep 17 00:00:00 2001 From: Garry Tan Date: Mon, 16 Nov 2026 10:57:22 +0800 Subject: [PATCH] Load the never-print-secrets rule in every skill on every host, with the commands it missed (GST-2753) (#4382) * Load the never-print-secrets rule in every skill on every host, with the commands it missed (GST-2753) Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * Point the shared CI-wait rule at gstack-pr-wait and name the missed secret-printing commands The Ground Rules section told every skill to wait with gh pr checks --watch, which spends the shared GitHub GraphQL quota gstack moved off; it now names gstack-pr-wait. The banned list also covers ps aux and ps -ef, set -x, git config -l and an export $(...) that expands to a bare export. Size caps raised to the measured +70 bytes. Review-Finding: p1/red-team#1 reader=red-team Review-Finding: p1/red-team#2 reader=red-team Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * Say which skills carry the new rule in its release note Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --------- Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --- SKILL.md | 5 +++ autoplan/SKILL.md | 2 +- autoplan/sections/preamble.md | 7 ++- benchmark-models/SKILL.md | 5 +++ benchmark/SKILL.md | 5 +++ browse/SKILL.md | 5 +++ canary/SKILL.md | 2 +- canary/sections/preamble.md | 7 ++- captain/SKILL.md | 2 +- captain/sections/preamble.md | 7 ++- .../never-print-secrets-shared-rule.md | 1 + codex/SKILL.md | 2 +- codex/sections/preamble.md | 7 ++- context-restore/SKILL.md | 2 +- context-restore/sections/preamble.md | 7 ++- context-save/SKILL.md | 2 +- context-save/sections/preamble.md | 7 ++- design-consultation/SKILL.md | 2 +- design-consultation/sections/preamble.md | 7 ++- design-html/SKILL.md | 2 +- design-html/sections/preamble.md | 7 ++- design-motion/SKILL.md | 2 +- design-motion/sections/preamble.md | 7 ++- design-review/SKILL.md | 2 +- design-review/sections/preamble.md | 7 ++- design-shotgun/SKILL.md | 2 +- design-shotgun/sections/preamble.md | 7 ++- devex-review/SKILL.md | 2 +- devex-review/sections/preamble.md | 7 ++- diagram/SKILL.md | 5 +++ docs/loadouts.md | 4 +- document-generate/SKILL.md | 2 +- document-generate/sections/preamble.md | 7 ++- document-release/SKILL.md | 2 +- document-release/sections/preamble.md | 7 ++- eval-plan/SKILL.md | 2 +- eval-plan/sections/preamble.md | 7 ++- health/SKILL.md | 2 +- health/sections/preamble.md | 7 ++- ios-clean/SKILL.md | 2 +- ios-clean/sections/preamble.md | 7 ++- ios-design-review/SKILL.md | 2 +- ios-design-review/sections/preamble.md | 7 ++- ios-fix/SKILL.md | 2 +- ios-fix/sections/preamble.md | 7 ++- ios-qa/SKILL.md | 2 +- ios-qa/sections/preamble.md | 7 ++- ios-sync/SKILL.md | 2 +- ios-sync/sections/preamble.md | 7 ++- land-and-deploy/SKILL.md | 2 +- land-and-deploy/sections/preamble.md | 7 ++- landing-report/SKILL.md | 2 +- landing-report/sections/preamble.md | 7 ++- learn/SKILL.md | 2 +- learn/sections/preamble.md | 7 ++- make-pdf/SKILL.md | 5 +++ modernize/SKILL.md | 2 +- modernize/sections/preamble.md | 7 ++- modules/loadouts.json | 1 + office-hours/SKILL.md | 2 +- office-hours/sections/preamble.md | 7 ++- open-gstack-browser/SKILL.md | 5 +++ pair-agent/SKILL.md | 2 +- pair-agent/sections/preamble.md | 7 ++- plan-ceo-review/SKILL.md | 2 +- plan-ceo-review/sections/preamble.md | 7 ++- plan-design-review/SKILL.md | 2 +- plan-design-review/sections/preamble.md | 7 ++- plan-devex-review/SKILL.md | 2 +- plan-devex-review/sections/preamble.md | 7 ++- plan-eng-review/SKILL.md | 2 +- plan-eng-review/sections/preamble.md | 7 ++- plan-tune/SKILL.md | 2 +- plan-tune/sections/preamble.md | 7 ++- qa-only/SKILL.md | 2 +- qa-only/sections/preamble.md | 7 ++- qa/SKILL.md | 2 +- qa/sections/preamble.md | 7 ++- retro/SKILL.md | 2 +- retro/sections/preamble.md | 7 ++- review/SKILL.md | 2 +- review/sections/preamble.md | 7 ++- runaway-stopper/SKILL.md | 5 +++ scrape/SKILL.md | 5 +++ scripts/resolvers/preamble.ts | 2 + .../preamble/generate-ground-rules.ts | 23 ++++++++++ setup-browser-cookies/SKILL.md | 5 +++ setup-deploy/SKILL.md | 2 +- setup-deploy/sections/preamble.md | 7 ++- setup-gbrain/SKILL.md | 2 +- setup-gbrain/sections/preamble.md | 7 ++- ship/SKILL.md | 2 +- ship/sections/preamble.md | 7 ++- skillify/SKILL.md | 2 +- skillify/sections/preamble.md | 7 ++- spec/SKILL.md | 2 +- spec/sections/preamble.md | 7 ++- sync-gbrain/SKILL.md | 2 +- sync-gbrain/sections/preamble.md | 7 ++- test-audit/SKILL.md | 2 +- test-audit/sections/preamble.md | 7 ++- test/fixtures/context-budget.json | 2 +- test/fixtures/golden/agy-ship-SKILL.md | 2 +- test/fixtures/golden/claude-ship-SKILL.md | 2 +- test/fixtures/golden/codex-ship-SKILL.md | 2 +- test/fixtures/golden/factory-ship-SKILL.md | 2 +- test/ground-rules.test.ts | 43 +++++++++++++++++++ test/helpers/carve-guards.ts | 20 ++++----- .../ship/never-print-secrets-shared-rule.json | 4 ++ ubicloud/SKILL.md | 2 +- ubicloud/sections/preamble.md | 7 ++- verify/SKILL.md | 5 +++ write-skill/SKILL.md | 2 +- write-skill/sections/preamble.md | 7 ++- 114 files changed, 461 insertions(+), 107 deletions(-) create mode 100644 changelog.d/never-print-secrets-shared-rule.md create mode 100644 scripts/resolvers/preamble/generate-ground-rules.ts create mode 100644 test/ground-rules.test.ts create mode 100644 test/size-ledger/ship/never-print-secrets-shared-rule.json diff --git a/SKILL.md b/SKILL.md index 386f4b08d..300fc282e 100644 --- a/SKILL.md +++ b/SKILL.md @@ -94,6 +94,11 @@ Reply in the language of the user's latest message unless asked otherwise. Code, The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/autoplan/SKILL.md b/autoplan/SKILL.md index 6fed17905..cb0cef8e0 100644 --- a/autoplan/SKILL.md +++ b/autoplan/SKILL.md @@ -34,7 +34,7 @@ hooks: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/autoplan/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/autoplan/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/autoplan/sections/preamble.md b/autoplan/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/autoplan/sections/preamble.md +++ b/autoplan/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/benchmark-models/SKILL.md b/benchmark-models/SKILL.md index 0f3444718..88f3f7321 100644 --- a/benchmark-models/SKILL.md +++ b/benchmark-models/SKILL.md @@ -94,6 +94,11 @@ Reply in the language of the user's latest message unless asked otherwise. Code, The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/benchmark/SKILL.md b/benchmark/SKILL.md index ee09bbba4..1795f5270 100644 --- a/benchmark/SKILL.md +++ b/benchmark/SKILL.md @@ -95,6 +95,11 @@ Reply in the language of the user's latest message unless asked otherwise. Code, The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/browse/SKILL.md b/browse/SKILL.md index ca934a60b..fbd8c6cc0 100644 --- a/browse/SKILL.md +++ b/browse/SKILL.md @@ -94,6 +94,11 @@ Reply in the language of the user's latest message unless asked otherwise. Code, The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/canary/SKILL.md b/canary/SKILL.md index 0ef61ffd7..643b31b0b 100644 --- a/canary/SKILL.md +++ b/canary/SKILL.md @@ -19,7 +19,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/canary/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/canary/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/canary/sections/preamble.md b/canary/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/canary/sections/preamble.md +++ b/canary/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/captain/SKILL.md b/captain/SKILL.md index b10edc5ab..6ab00a2b4 100644 --- a/captain/SKILL.md +++ b/captain/SKILL.md @@ -26,7 +26,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/captain/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/captain/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/captain/sections/preamble.md b/captain/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/captain/sections/preamble.md +++ b/captain/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/changelog.d/never-print-secrets-shared-rule.md b/changelog.d/never-print-secrets-shared-rule.md new file mode 100644 index 000000000..0288caa48 --- /dev/null +++ b/changelog.d/never-print-secrets-shared-rule.md @@ -0,0 +1 @@ +- **Every skill that loads the shared preamble, on every host, now says never to print a whole environment, git config or process table.** The rule used to load only in the Capy wrapper, and its list missed `git config --list`, which can print a proxy's login header, process or container listings that show arguments or environment (`ps aux`, `ps -ef`, `ps -o args`, `docker top ... args`, `docker inspect`), where run tokens ride, and `set -x` or an `export $(...)` that expands to a bare `export`. A new Ground Rules section in the shared preamble lists these commands and the safe forms, which are to read one value by name (`git config --get `), check a variable is set without printing it, and list processes by name or pid. It also says to wait on CI with one `gstack-pr-wait` call instead of a poll loop or `gh pr checks --watch`, which spends the shared GitHub GraphQL quota. The section is pinned, so no model loadout drops it. diff --git a/codex/SKILL.md b/codex/SKILL.md index de293bd30..456134679 100644 --- a/codex/SKILL.md +++ b/codex/SKILL.md @@ -20,7 +20,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/codex/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/codex/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/codex/sections/preamble.md b/codex/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/codex/sections/preamble.md +++ b/codex/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/context-restore/SKILL.md b/context-restore/SKILL.md index ee68c8752..cafd34abd 100644 --- a/context-restore/SKILL.md +++ b/context-restore/SKILL.md @@ -21,7 +21,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/context-restore/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/context-restore/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/context-restore/sections/preamble.md b/context-restore/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/context-restore/sections/preamble.md +++ b/context-restore/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/context-save/SKILL.md b/context-save/SKILL.md index 05c13659a..10a4e8ca6 100644 --- a/context-save/SKILL.md +++ b/context-save/SKILL.md @@ -21,7 +21,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/context-save/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/context-save/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/context-save/sections/preamble.md b/context-save/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/context-save/sections/preamble.md +++ b/context-save/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/design-consultation/SKILL.md b/design-consultation/SKILL.md index 71ecbe7df..7d545778d 100644 --- a/design-consultation/SKILL.md +++ b/design-consultation/SKILL.md @@ -45,7 +45,7 @@ gbrain: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/design-consultation/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/design-consultation/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/design-consultation/sections/preamble.md b/design-consultation/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/design-consultation/sections/preamble.md +++ b/design-consultation/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/design-html/SKILL.md b/design-html/SKILL.md index 57ee215e5..400cb285c 100644 --- a/design-html/SKILL.md +++ b/design-html/SKILL.md @@ -22,7 +22,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/design-html/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/design-html/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/design-html/sections/preamble.md b/design-html/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/design-html/sections/preamble.md +++ b/design-html/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/design-motion/SKILL.md b/design-motion/SKILL.md index 01d2938cd..f95627717 100644 --- a/design-motion/SKILL.md +++ b/design-motion/SKILL.md @@ -21,7 +21,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/design-motion/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/design-motion/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/design-motion/sections/preamble.md b/design-motion/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/design-motion/sections/preamble.md +++ b/design-motion/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/design-review/SKILL.md b/design-review/SKILL.md index 8c6e3537a..7713ee0f5 100644 --- a/design-review/SKILL.md +++ b/design-review/SKILL.md @@ -23,7 +23,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/design-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/design-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/design-review/sections/preamble.md b/design-review/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/design-review/sections/preamble.md +++ b/design-review/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/design-shotgun/SKILL.md b/design-shotgun/SKILL.md index 803fa51a6..cf888a102 100644 --- a/design-shotgun/SKILL.md +++ b/design-shotgun/SKILL.md @@ -39,7 +39,7 @@ gbrain: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/design-shotgun/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/design-shotgun/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/design-shotgun/sections/preamble.md b/design-shotgun/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/design-shotgun/sections/preamble.md +++ b/design-shotgun/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/devex-review/SKILL.md b/devex-review/SKILL.md index 1dc425e3c..d353ba1bb 100644 --- a/devex-review/SKILL.md +++ b/devex-review/SKILL.md @@ -21,7 +21,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/devex-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/devex-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/devex-review/sections/preamble.md b/devex-review/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/devex-review/sections/preamble.md +++ b/devex-review/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/diagram/SKILL.md b/diagram/SKILL.md index 0a050b647..59a7e6455 100644 --- a/diagram/SKILL.md +++ b/diagram/SKILL.md @@ -97,6 +97,11 @@ Reply in the language of the user's latest message unless asked otherwise. Code, The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/docs/loadouts.md b/docs/loadouts.md index 50d4a24aa..755a700bc 100644 --- a/docs/loadouts.md +++ b/docs/loadouts.md @@ -9,7 +9,7 @@ One model has its own loadout: Claude Opus 5.5 gets `lite` ([below](#lite-on-cla | Term | Meaning | |---|---| | Module | One of four kinds. `skill:` is a whole skill. `section:/` is one entry of `/sections/manifest.json`. `overlay:` is one `model-overlays/.md`; excluding a base overlay also removes the base's text from every overlay that inherits it; the inheriting overlay's own text stays. `preamble:` is one piece of the shared preamble (`PREAMBLE_PIECES` in `scripts/resolvers/preamble.ts`). | -| Pinned | A module no loadout can remove where `full` renders it: the start command, plan-mode rules, the question format, completion status, the Claims Need Evidence rule, the unattended profile, /ship's review army and adversarial pass, the router and `/gstack-upgrade`. A skill's `preamble-tier` still applies, so a tier-1 skill has no question-format section in any loadout. | +| Pinned | A module no loadout can remove where `full` renders it: the start command, plan-mode rules, the question format, completion status, the Claims Need Evidence rule, the Ground Rules (never print a whole environment, git config or process table), the unattended profile, /ship's review army and adversarial pass, the router and `/gstack-upgrade`. A skill's `preamble-tier` still applies, so a tier-1 skill has no question-format section in any loadout. | | Rung | How much scaffolding a model gets: `frontier`, `strong`, `mid`, `light`, or `unknown`. Model ids are matched after lowercasing and stripping a `provider/` prefix (`anthropic/claude-haiku-5-5` is `mid`). Rungs are separate from the frontier/smart tiers in `lib/model-catalog.ts`, which choose which model runs a role. | | Loadout | `{ base, exclude, include, preamble_tier_max, note }`. `full` (include `*`) is always present. An unknown model gets `default.unknown`, which is `full`. | | Model map | `models` in `modules/loadouts.json`: an exact model id to a loadout, checked before rungs. The id also matches its dated snapshot (`-YYYYMMDD`) and `-latest`, never a point release or any other suffix (`claude-opus-5-5` matches `claude-opus-5-5-20261101`, not `claude-opus-5-50` or `claude-opus-5-5-1`). | @@ -40,7 +40,7 @@ bin/gstack-modules install --full-root "$HOME/.claude/skills" --model claude-opu ## Lite on Claude Opus 5.5 -`lite` is `full` minus ten coaching pieces of the shared preamble: voice, writing style, completeness, confusion, context health, question tuning, search before building, repo mode, brain health and context recovery. It keeps every pinned piece, including the Claims Need Evidence rule (GST-944: the honest-work design never retires it while gstack reports evidence, and it adds 804 bytes back to lite's 16,175-byte shared preamble), the upgrade check (the PROACTIVE and skill-prefix rules) and brain sync (the privacy stop-gate). Only `claude-opus-5-5` maps to it, because only Opus 5.5 has been measured: office-hours showed no loss on Opus 5.5 (GSTA-161 preamble run), and the land-and-deploy confirmation (GSTA-161, PR 1b) compared full, lite and no gstack on the same tasks. Haiku 5.5 leaned slightly against a larger cut on the same office-hours run, so small models stay on `full`. Two skills point at a preamble section lite drops: office-hours and plan-ceo-review name ETHOS.md through the "Search Before Building" section, so under lite they find ETHOS.md in the gstack checkout instead. +`lite` is `full` minus ten coaching pieces of the shared preamble: voice, writing style, completeness, confusion, context health, question tuning, search before building, repo mode, brain health and context recovery. It keeps every pinned piece, including the Ground Rules, the Claims Need Evidence rule (GST-944: the honest-work design never retires it while gstack reports evidence, and it adds 804 bytes back to lite's 16,175-byte shared preamble), the upgrade check (the PROACTIVE and skill-prefix rules) and brain sync (the privacy stop-gate). Only `claude-opus-5-5` maps to it, because only Opus 5.5 has been measured: office-hours showed no loss on Opus 5.5 (GSTA-161 preamble run), and the land-and-deploy confirmation (GSTA-161, PR 1b) compared full, lite and no gstack on the same tasks. Haiku 5.5 leaned slightly against a larger cut on the same office-hours run, so small models stay on `full`. Two skills point at a preamble section lite drops: office-hours and plan-ceo-review name ETHOS.md through the "Search Before Building" section, so under lite they find ETHOS.md in the gstack checkout instead. ### How gstack picks a loadout diff --git a/document-generate/SKILL.md b/document-generate/SKILL.md index 1c0dba743..a1c9da8ba 100644 --- a/document-generate/SKILL.md +++ b/document-generate/SKILL.md @@ -25,7 +25,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/document-generate/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/document-generate/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/document-generate/sections/preamble.md b/document-generate/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/document-generate/sections/preamble.md +++ b/document-generate/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/document-release/SKILL.md b/document-release/SKILL.md index 437e8ffe5..3d1a91dc1 100644 --- a/document-release/SKILL.md +++ b/document-release/SKILL.md @@ -21,7 +21,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/document-release/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/document-release/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/document-release/sections/preamble.md b/document-release/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/document-release/sections/preamble.md +++ b/document-release/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/eval-plan/SKILL.md b/eval-plan/SKILL.md index 9f7d7ea02..c7665440e 100644 --- a/eval-plan/SKILL.md +++ b/eval-plan/SKILL.md @@ -24,7 +24,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/eval-plan/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/eval-plan/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/eval-plan/sections/preamble.md b/eval-plan/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/eval-plan/sections/preamble.md +++ b/eval-plan/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/health/SKILL.md b/health/SKILL.md index ecde9b5f2..0df11a75b 100644 --- a/health/SKILL.md +++ b/health/SKILL.md @@ -21,7 +21,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/health/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/health/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/health/sections/preamble.md b/health/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/health/sections/preamble.md +++ b/health/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/ios-clean/SKILL.md b/ios-clean/SKILL.md index 099596af3..80b44691d 100644 --- a/ios-clean/SKILL.md +++ b/ios-clean/SKILL.md @@ -20,7 +20,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ios-clean/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ios-clean/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/ios-clean/sections/preamble.md b/ios-clean/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/ios-clean/sections/preamble.md +++ b/ios-clean/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/ios-design-review/SKILL.md b/ios-design-review/SKILL.md index 6000c79a5..3d630daa3 100644 --- a/ios-design-review/SKILL.md +++ b/ios-design-review/SKILL.md @@ -19,7 +19,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ios-design-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ios-design-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/ios-design-review/sections/preamble.md b/ios-design-review/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/ios-design-review/sections/preamble.md +++ b/ios-design-review/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/ios-fix/SKILL.md b/ios-fix/SKILL.md index f51d36ae0..af59d3244 100644 --- a/ios-fix/SKILL.md +++ b/ios-fix/SKILL.md @@ -21,7 +21,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ios-fix/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ios-fix/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/ios-fix/sections/preamble.md b/ios-fix/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/ios-fix/sections/preamble.md +++ b/ios-fix/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/ios-qa/SKILL.md b/ios-qa/SKILL.md index 2fb38d735..f34efd275 100644 --- a/ios-qa/SKILL.md +++ b/ios-qa/SKILL.md @@ -24,7 +24,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ios-qa/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ios-qa/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/ios-qa/sections/preamble.md b/ios-qa/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/ios-qa/sections/preamble.md +++ b/ios-qa/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/ios-sync/SKILL.md b/ios-sync/SKILL.md index 0597d91cb..1c49407a5 100644 --- a/ios-sync/SKILL.md +++ b/ios-sync/SKILL.md @@ -21,7 +21,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ios-sync/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ios-sync/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/ios-sync/sections/preamble.md b/ios-sync/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/ios-sync/sections/preamble.md +++ b/ios-sync/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/land-and-deploy/SKILL.md b/land-and-deploy/SKILL.md index 0ad025054..08a7ced13 100644 --- a/land-and-deploy/SKILL.md +++ b/land-and-deploy/SKILL.md @@ -20,7 +20,7 @@ disable-model-invocation: true ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/land-and-deploy/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/land-and-deploy/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/land-and-deploy/sections/preamble.md b/land-and-deploy/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/land-and-deploy/sections/preamble.md +++ b/land-and-deploy/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/landing-report/SKILL.md b/landing-report/SKILL.md index 449d24b80..b07a98cf3 100644 --- a/landing-report/SKILL.md +++ b/landing-report/SKILL.md @@ -20,7 +20,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/landing-report/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/landing-report/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/landing-report/sections/preamble.md b/landing-report/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/landing-report/sections/preamble.md +++ b/landing-report/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/learn/SKILL.md b/learn/SKILL.md index 12d5804da..9c27e322b 100644 --- a/learn/SKILL.md +++ b/learn/SKILL.md @@ -21,7 +21,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/learn/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/learn/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/learn/sections/preamble.md b/learn/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/learn/sections/preamble.md +++ b/learn/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/make-pdf/SKILL.md b/make-pdf/SKILL.md index 4c164a68d..99c6957f0 100644 --- a/make-pdf/SKILL.md +++ b/make-pdf/SKILL.md @@ -132,6 +132,11 @@ Reply in the language of the user's latest message unless asked otherwise. Code, The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/modernize/SKILL.md b/modernize/SKILL.md index 7322016ed..ed48ce690 100644 --- a/modernize/SKILL.md +++ b/modernize/SKILL.md @@ -23,7 +23,7 @@ disable-model-invocation: true ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/modernize/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/modernize/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/modernize/sections/preamble.md b/modernize/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/modernize/sections/preamble.md +++ b/modernize/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/modules/loadouts.json b/modules/loadouts.json index 9d3ebbc99..746556264 100644 --- a/modules/loadouts.json +++ b/modules/loadouts.json @@ -43,6 +43,7 @@ "preamble:ask-user-format", "preamble:completion-status", "preamble:evidence", + "preamble:ground-rules", "section:autoplan/unattended", "section:ship/review-army", "section:ship/adversarial" diff --git a/office-hours/SKILL.md b/office-hours/SKILL.md index 571f62648..c40b91938 100644 --- a/office-hours/SKILL.md +++ b/office-hours/SKILL.md @@ -49,7 +49,7 @@ gbrain: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/office-hours/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/office-hours/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/office-hours/sections/preamble.md b/office-hours/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/office-hours/sections/preamble.md +++ b/office-hours/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/open-gstack-browser/SKILL.md b/open-gstack-browser/SKILL.md index 26fb660fd..413711416 100644 --- a/open-gstack-browser/SKILL.md +++ b/open-gstack-browser/SKILL.md @@ -94,6 +94,11 @@ Reply in the language of the user's latest message unless asked otherwise. Code, The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/pair-agent/SKILL.md b/pair-agent/SKILL.md index 59f6a0113..457205758 100644 --- a/pair-agent/SKILL.md +++ b/pair-agent/SKILL.md @@ -18,7 +18,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/pair-agent/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/pair-agent/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/pair-agent/sections/preamble.md b/pair-agent/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/pair-agent/sections/preamble.md +++ b/pair-agent/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/plan-ceo-review/SKILL.md b/plan-ceo-review/SKILL.md index e64c876ec..69a4dec1e 100644 --- a/plan-ceo-review/SKILL.md +++ b/plan-ceo-review/SKILL.md @@ -51,7 +51,7 @@ gbrain: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/plan-ceo-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/plan-ceo-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/plan-ceo-review/sections/preamble.md b/plan-ceo-review/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/plan-ceo-review/sections/preamble.md +++ b/plan-ceo-review/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/plan-design-review/SKILL.md b/plan-design-review/SKILL.md index 9cdad3fa3..61b7a6363 100644 --- a/plan-design-review/SKILL.md +++ b/plan-design-review/SKILL.md @@ -51,7 +51,7 @@ Recommendation: A when a branch diff exists, otherwise B. Reply with A, B, or C. ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/plan-design-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/plan-design-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (after scope gate) diff --git a/plan-design-review/sections/preamble.md b/plan-design-review/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/plan-design-review/sections/preamble.md +++ b/plan-design-review/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/plan-devex-review/SKILL.md b/plan-devex-review/SKILL.md index b9e9f11ab..cbe3a2fe1 100644 --- a/plan-devex-review/SKILL.md +++ b/plan-devex-review/SKILL.md @@ -21,7 +21,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/plan-devex-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/plan-devex-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/plan-devex-review/sections/preamble.md b/plan-devex-review/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/plan-devex-review/sections/preamble.md +++ b/plan-devex-review/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/plan-eng-review/SKILL.md b/plan-eng-review/SKILL.md index 4061ac83b..745640604 100644 --- a/plan-eng-review/SKILL.md +++ b/plan-eng-review/SKILL.md @@ -63,7 +63,7 @@ Keep the reviewed target fixed when selecting the report destination. ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/plan-eng-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/plan-eng-review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (after scope gate) diff --git a/plan-eng-review/sections/preamble.md b/plan-eng-review/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/plan-eng-review/sections/preamble.md +++ b/plan-eng-review/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/plan-tune/SKILL.md b/plan-tune/SKILL.md index d4e77e818..d30cacddc 100644 --- a/plan-tune/SKILL.md +++ b/plan-tune/SKILL.md @@ -25,7 +25,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/plan-tune/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/plan-tune/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/plan-tune/sections/preamble.md b/plan-tune/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/plan-tune/sections/preamble.md +++ b/plan-tune/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/qa-only/SKILL.md b/qa-only/SKILL.md index 34dfe43d6..4854a744a 100644 --- a/qa-only/SKILL.md +++ b/qa-only/SKILL.md @@ -19,7 +19,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/qa-only/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/qa-only/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/qa-only/sections/preamble.md b/qa-only/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/qa-only/sections/preamble.md +++ b/qa-only/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/qa/SKILL.md b/qa/SKILL.md index 5c8b6ab91..38d95e46e 100644 --- a/qa/SKILL.md +++ b/qa/SKILL.md @@ -22,7 +22,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/qa/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/qa/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/qa/sections/preamble.md b/qa/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/qa/sections/preamble.md +++ b/qa/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/retro/SKILL.md b/retro/SKILL.md index 49f2fad38..87f44852c 100644 --- a/retro/SKILL.md +++ b/retro/SKILL.md @@ -39,7 +39,7 @@ gbrain: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/retro/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/retro/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/retro/sections/preamble.md b/retro/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/retro/sections/preamble.md +++ b/retro/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/review/SKILL.md b/review/SKILL.md index 9b560bd6f..a1809271b 100644 --- a/review/SKILL.md +++ b/review/SKILL.md @@ -50,7 +50,7 @@ Finish only when each of these exists (contract v1): ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/review/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/review/sections/preamble.md b/review/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/review/sections/preamble.md +++ b/review/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/runaway-stopper/SKILL.md b/runaway-stopper/SKILL.md index c94d9d91d..182513520 100644 --- a/runaway-stopper/SKILL.md +++ b/runaway-stopper/SKILL.md @@ -94,6 +94,11 @@ Reply in the language of the user's latest message unless asked otherwise. Code, The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/scrape/SKILL.md b/scrape/SKILL.md index 50a2b158c..694f7f905 100644 --- a/scrape/SKILL.md +++ b/scrape/SKILL.md @@ -95,6 +95,11 @@ Reply in the language of the user's latest message unless asked otherwise. Code, The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/scripts/resolvers/preamble.ts b/scripts/resolvers/preamble.ts index 19575f9e6..5194eca37 100644 --- a/scripts/resolvers/preamble.ts +++ b/scripts/resolvers/preamble.ts @@ -49,6 +49,7 @@ import { generateCompletenessSection } from './preamble/generate-completeness-se import { generateConfusionProtocol } from './preamble/generate-confusion-protocol'; import { generateEvidenceDirective } from './preamble/generate-evidence-directive'; import { generateContextHealth } from './preamble/generate-context-health'; +import { generateGroundRules } from './preamble/generate-ground-rules'; // Tier 3+ repo mode + search import { generateRepoModeSection } from './preamble/generate-repo-mode-section'; @@ -108,6 +109,7 @@ export const PREAMBLE_PIECES: readonly PreamblePiece[] = [ { id: 'question-tuning', minTier: 2, render: generateQuestionTuning }, { id: 'repo-mode', minTier: 3, render: () => generateRepoModeSection() }, { id: 'search-before-building', minTier: 3, render: generateSearchBeforeBuildingSection }, + { id: 'ground-rules', minTier: 1, render: generateGroundRules }, { id: 'completion-status', minTier: 1, render: generateCompletionStatus }, ]; diff --git a/scripts/resolvers/preamble/generate-ground-rules.ts b/scripts/resolvers/preamble/generate-ground-rules.ts new file mode 100644 index 000000000..0cc0270e5 --- /dev/null +++ b/scripts/resolvers/preamble/generate-ground-rules.ts @@ -0,0 +1,23 @@ +import type { TemplateContext } from '../types'; + +/** + * Ground Rules: the few habits every skill on every host carries, at every + * tier. Tier 1 skills inline it; tier 2+ skills read it from the shared + * sections/preamble.md. Each rule is here because agents broke it in real + * runs, so keep each bullet to one habit and the block at or under + * GROUND_RULES_MAX_BYTES; test/ground-rules.test.ts pins that budget. + */ +export const GROUND_RULES_MAX_BYTES = 850; + +export const GROUND_RULES_HEADING = '## Ground Rules'; + +export const GROUND_RULES_BULLETS = [ + 'Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid.', + 'Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`.', +] as const; + +export function generateGroundRules(_ctx?: TemplateContext): string { + return `${GROUND_RULES_HEADING} + +${GROUND_RULES_BULLETS.map(bullet => `- ${bullet}`).join('\n')}`; +} diff --git a/setup-browser-cookies/SKILL.md b/setup-browser-cookies/SKILL.md index c193d6c3f..aaf4ca2f1 100644 --- a/setup-browser-cookies/SKILL.md +++ b/setup-browser-cookies/SKILL.md @@ -93,6 +93,11 @@ Reply in the language of the user's latest message unless asked otherwise. Code, The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/setup-deploy/SKILL.md b/setup-deploy/SKILL.md index 1ad580a9f..c06932f5b 100644 --- a/setup-deploy/SKILL.md +++ b/setup-deploy/SKILL.md @@ -21,7 +21,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/setup-deploy/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/setup-deploy/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/setup-deploy/sections/preamble.md b/setup-deploy/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/setup-deploy/sections/preamble.md +++ b/setup-deploy/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/setup-gbrain/SKILL.md b/setup-gbrain/SKILL.md index 97b60bed2..7b4355c2d 100644 --- a/setup-gbrain/SKILL.md +++ b/setup-gbrain/SKILL.md @@ -23,7 +23,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/setup-gbrain/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/setup-gbrain/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/setup-gbrain/sections/preamble.md b/setup-gbrain/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/setup-gbrain/sections/preamble.md +++ b/setup-gbrain/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/ship/SKILL.md b/ship/SKILL.md index b439b8a3c..d64101278 100644 --- a/ship/SKILL.md +++ b/ship/SKILL.md @@ -24,7 +24,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ship/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ship/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/ship/sections/preamble.md b/ship/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/ship/sections/preamble.md +++ b/ship/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/skillify/SKILL.md b/skillify/SKILL.md index fbf9b99ab..10477485e 100644 --- a/skillify/SKILL.md +++ b/skillify/SKILL.md @@ -19,7 +19,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/skillify/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/skillify/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/skillify/sections/preamble.md b/skillify/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/skillify/sections/preamble.md +++ b/skillify/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/spec/SKILL.md b/spec/SKILL.md index 722483a88..1529f557a 100644 --- a/spec/SKILL.md +++ b/spec/SKILL.md @@ -22,7 +22,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/spec/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/spec/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/spec/sections/preamble.md b/spec/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/spec/sections/preamble.md +++ b/spec/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/sync-gbrain/SKILL.md b/sync-gbrain/SKILL.md index b4d6ebfe4..354f96e6f 100644 --- a/sync-gbrain/SKILL.md +++ b/sync-gbrain/SKILL.md @@ -22,7 +22,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/sync-gbrain/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/sync-gbrain/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/sync-gbrain/sections/preamble.md b/sync-gbrain/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/sync-gbrain/sections/preamble.md +++ b/sync-gbrain/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/test-audit/SKILL.md b/test-audit/SKILL.md index 3072ea8cf..090bbb322 100644 --- a/test-audit/SKILL.md +++ b/test-audit/SKILL.md @@ -21,7 +21,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/test-audit/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/test-audit/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/test-audit/sections/preamble.md b/test-audit/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/test-audit/sections/preamble.md +++ b/test-audit/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/test/fixtures/context-budget.json b/test/fixtures/context-budget.json index 5b2a29593..b8f6d0ef3 100644 --- a/test/fixtures/context-budget.json +++ b/test/fixtures/context-budget.json @@ -56,7 +56,7 @@ "qa-only": 5726, "retro": 13484, "review": 15417, - "runaway-stopper": 3841, + "runaway-stopper": 3987, "scrape": 7312, "setup-browser-cookies": 3507, "setup-deploy": 5738, diff --git a/test/fixtures/golden/agy-ship-SKILL.md b/test/fixtures/golden/agy-ship-SKILL.md index 010b34e2e..b84aa8045 100644 --- a/test/fixtures/golden/agy-ship-SKILL.md +++ b/test/fixtures/golden/agy-ship-SKILL.md @@ -12,7 +12,7 @@ description: | ## Shared preamble (load first) -This skill follows gstack shared preamble `6872f1ec4eb9` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `sections/preamble.md` relative to the installed `gstack-ship` SKILL.md directory in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `dc6688a6791f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `sections/preamble.md` relative to the installed `gstack-ship` SKILL.md directory in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/test/fixtures/golden/claude-ship-SKILL.md b/test/fixtures/golden/claude-ship-SKILL.md index b439b8a3c..d64101278 100644 --- a/test/fixtures/golden/claude-ship-SKILL.md +++ b/test/fixtures/golden/claude-ship-SKILL.md @@ -24,7 +24,7 @@ triggers: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ship/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ship/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/test/fixtures/golden/codex-ship-SKILL.md b/test/fixtures/golden/codex-ship-SKILL.md index df8ef255e..d535a44b4 100644 --- a/test/fixtures/golden/codex-ship-SKILL.md +++ b/test/fixtures/golden/codex-ship-SKILL.md @@ -12,7 +12,7 @@ description: | ## Shared preamble (load first) -This skill follows gstack shared preamble `2af24c2d75e4` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `sections/preamble.md` relative to the installed `gstack-ship` SKILL.md directory in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `1c66f530e65a` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `sections/preamble.md` relative to the installed `gstack-ship` SKILL.md directory in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/test/fixtures/golden/factory-ship-SKILL.md b/test/fixtures/golden/factory-ship-SKILL.md index 83c053a6f..31f0a060c 100644 --- a/test/fixtures/golden/factory-ship-SKILL.md +++ b/test/fixtures/golden/factory-ship-SKILL.md @@ -14,7 +14,7 @@ disable-model-invocation: true ## Shared preamble (load first) -This skill follows gstack shared preamble `99cd6cb5d373` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `sections/preamble.md` relative to the installed `gstack-ship` SKILL.md directory in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `fb2ce44dd505` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `sections/preamble.md` relative to the installed `gstack-ship` SKILL.md directory in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/test/ground-rules.test.ts b/test/ground-rules.test.ts new file mode 100644 index 000000000..a4e1a38ee --- /dev/null +++ b/test/ground-rules.test.ts @@ -0,0 +1,43 @@ +import { describe, expect, test } from 'bun:test'; +import * as fs from 'fs'; +import * as path from 'path'; +import { + GROUND_RULES_HEADING, + GROUND_RULES_MAX_BYTES, + generateGroundRules, +} from '../scripts/resolvers/preamble/generate-ground-rules'; + +const ROOT = path.resolve(import.meta.dir, '..'); +const read = (rel: string) => fs.readFileSync(path.join(ROOT, rel), 'utf-8'); + +describe('Ground Rules preamble section', () => { + const block = generateGroundRules(); + + test('stays within its byte budget', () => { + expect(Buffer.byteLength(block)).toBeLessThanOrEqual(GROUND_RULES_MAX_BYTES); + }); + + test('names every command that prints a whole environment, git config or process table, and the by-name alternative', () => { + for (const cmd of ['`env`', 'bare `printenv`', '`set` or `export`', '`export $(...)`', '`export -p`/`-n`', '`declare -p`/`-x`', '`typeset -p`', '`set -x`', '`git config --list`/`-l`', 'any `ps` with full args (`aux`, `-ef`, `-o args`)', '`docker top ... args`', '`docker inspect` Env']) { + expect(block).toContain(cmd); + } + expect(block).toContain('`git config --get `'); + expect(block).toContain('`[ -n "${NAME:-}" ] && echo set`'); + }); + + test('tells agents to wait on CI with gstack-pr-wait, not a polling loop or the GraphQL-spending gh watcher', () => { + expect(block).toContain('`gstack-pr-wait --until green`'); + expect(block).toContain('never a poll loop or `gh pr checks --watch`'); + }); + + test('renders inline in a tier 1 skill and in the shared preamble tier 2+ skills read', () => { + expect(read('browse/SKILL.md')).toContain(block); + expect(read('review/sections/preamble.md')).toContain(block); + }); + + test('is pinned, so no model loadout can drop it', () => { + const loadouts = JSON.parse(read('modules/loadouts.json')); + expect(loadouts.pinned).toContain('preamble:ground-rules'); + expect(block.startsWith(GROUND_RULES_HEADING)).toBe(true); + }); +}); diff --git a/test/helpers/carve-guards.ts b/test/helpers/carve-guards.ts index 5971f0d45..6539021aa 100644 --- a/test/helpers/carve-guards.ts +++ b/test/helpers/carve-guards.ts @@ -359,7 +359,7 @@ do not launch the downstream skill or open a browser.`, maxSkeletonBytes: 43_885, // GSTA-134 skill diet (2026-10-28): lowered from 80_533 to the measured skeleton after the second opinion and visual design moved to sections, 43,885. Before: GSTA-96 hoist (2026-10-26): lowered from 95_900 by the shared preamble that moved to sections/preamble.md, keeping the pre-hoist headroom of 952 bytes; measured 79,581. Before: Office-hours + sketch outside voices include host guards and completion checks. + v1.91.19.0 wave: Q open-question prose form (#2729, approved Q3), DESIGN_READY --version probe (B4), Aside ~/.local/bin fallback (E7), verdict-form outside voice (INV-1), plus v1.91.17.0's round accounting (#3022) merged in; measured 89,684 (2026-10-03). + Oct 6 fix wave A3/CEO-12: free text reaches commands only through agent-written mktemp files (mktemp block, write rule, path rebuild and refusal at each posting, prompt and brief site); skeleton measured 92,590 (2026-10-06). + Oct 7 wave B3: the Codex probe runs as a command (select-model capture lines, check-sandbox/probe-model/run-with-timeout subcommands) instead of being sourced; skeleton measured 92,869 (2026-10-07). + Oct 7 wave CEO-28/DX-11: review prompts ask for a severity per finding and design proposals use the proposal gate; skeleton measured 92,930 (2026-10-07). + Oct 7 wave guard (CEO-20): conditional `run_in_background` request plus the background-run recovery at each foreground dispatch site; skeleton measured 92,756 (2026-10-07). Merged with the guard area: measured skeleton 93,099 (2026-10-07). + fix wave PR D: the Phase 4.5 builder-profile read before the session log (#2801) and the pre-telemetry design-doc check (#1049); measured skeleton 94,877 (2026-10-07). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). minUnionBytes: 115_800, // Phase 4 wave 4; measured union 118,175 mustContain: ['design doc', 'problem statement'], - maxSizeRatio: 1.1922, // GST-2726 (2026-11-15, Garry: bring /plan-eng-review back): the handoff menu, its default and the design-doc line name /plan-eng-review again, +42 B union; measured 156,298 / 131,110 = 1.19211, rounded up (before: 156,256 = 1.19179 on 81fb900). Before that: GSTA-134 (2026-10-28, raised from 1.1796 by GStack Minder as merge-queue owner): +1,662 B union: second-opinion question moved into the main file while CODEX_SECOND_OPINION keeps its copy; per-run load 73,248→43,885 B; measured 156,286 / 131,110 = 1.19202, rounded up. Before: + Oct 6 fix wave A3/CEO-12: free text reaches commands only through agent-written mktemp files (mktemp block, write rule, path rebuild and refusal at each posting, prompt and brief site); measured 149,758 / 131,110 = 1.1422 (2026-10-06). + Oct 7 wave B3: the Codex probe runs as a command (select-model capture lines, check-sandbox/probe-model/run-with-timeout subcommands) instead of being sourced; measured 150,037 / 131,110 = 1.1444 (2026-10-07). + Oct 7 wave CEO-28/DX-11: review prompts ask for a severity per finding and design proposals use the proposal gate; measured 150,098 / 131,110 = 1.1448 (2026-10-07). + Oct 7 wave guard (CEO-20): conditional `run_in_background` request plus the background-run recovery at each foreground dispatch site; measured 150,011 / 131,110 = 1.1442 (2026-10-07). Merged with the guard area: measured 150,354 / 131,110 = 1.1468 (2026-10-07). + fix wave PR D: builder-profile read before the session log with Phase 6 using the carried values (#2801), the inline design doc before approval (#879) and the pre-telemetry design-doc check (#1049); measured 153,206 / 131,110 = 1.1685 (2026-10-07). + empty LAST_ASSIGNMENT/LAST_PROJECT guards in the welcome_back and regular greetings (backfilled profiles); measured 153,469 / 131,110 = 1.1705 (2026-10-08). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). + GSTA-96 shared-preamble hoist (owner-approved raise, Garry 2026-10-25: "do it"): the union now holds sections/preamble.md, so a fresh invocation reads the pointer plus the shared file and its own copies of shared sections; measured 160,989 / 131,110 = 1.2279 (2026-10-25). Before: 1.18. - GSTA-96 dedupe: the Q open-question form is office-hours' own appended subsection, so its copies of the shared Format and fallback subsections go; measured 154,653 / 131,110 = 1.1796 (2026-10-26), 154,624 = 1.1793 after the main merge. Before: 1.2279. + maxSizeRatio: 1.1968, // GST-2753 (2026-11-15, Garry's "Do it" to moving the never-print-secrets rule into gstack): the shared Ground Rules preamble section (never print a whole environment, git config or process table; wait on CI with one gstack-pr-wait call), +614 bytes; measured 1.1968 (before: 1.1922). Before that: GST-2726 (2026-11-15, Garry: bring /plan-eng-review back): the handoff menu, its default and the design-doc line name /plan-eng-review again, +42 B union; measured 156,298 / 131,110 = 1.19211, rounded up (before: 156,256 = 1.19179 on 81fb900). Before that: GSTA-134 (2026-10-28, raised from 1.1796 by GStack Minder as merge-queue owner): +1,662 B union: second-opinion question moved into the main file while CODEX_SECOND_OPINION keeps its copy; per-run load 73,248→43,885 B; measured 156,286 / 131,110 = 1.19202, rounded up. Before: + Oct 6 fix wave A3/CEO-12: free text reaches commands only through agent-written mktemp files (mktemp block, write rule, path rebuild and refusal at each posting, prompt and brief site); measured 149,758 / 131,110 = 1.1422 (2026-10-06). + Oct 7 wave B3: the Codex probe runs as a command (select-model capture lines, check-sandbox/probe-model/run-with-timeout subcommands) instead of being sourced; measured 150,037 / 131,110 = 1.1444 (2026-10-07). + Oct 7 wave CEO-28/DX-11: review prompts ask for a severity per finding and design proposals use the proposal gate; measured 150,098 / 131,110 = 1.1448 (2026-10-07). + Oct 7 wave guard (CEO-20): conditional `run_in_background` request plus the background-run recovery at each foreground dispatch site; measured 150,011 / 131,110 = 1.1442 (2026-10-07). Merged with the guard area: measured 150,354 / 131,110 = 1.1468 (2026-10-07). + fix wave PR D: builder-profile read before the session log with Phase 6 using the carried values (#2801), the inline design doc before approval (#879) and the pre-telemetry design-doc check (#1049); measured 153,206 / 131,110 = 1.1685 (2026-10-07). + empty LAST_ASSIGNMENT/LAST_PROJECT guards in the welcome_back and regular greetings (backfilled profiles); measured 153,469 / 131,110 = 1.1705 (2026-10-08). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). + GSTA-96 shared-preamble hoist (owner-approved raise, Garry 2026-10-25: "do it"): the union now holds sections/preamble.md, so a fresh invocation reads the pointer plus the shared file and its own copies of shared sections; measured 160,989 / 131,110 = 1.2279 (2026-10-25). Before: 1.18. - GSTA-96 dedupe: the Q open-question form is office-hours' own appended subsection, so its copies of the shared Format and fallback subsections go; measured 154,653 / 131,110 = 1.1796 (2026-10-26), 154,624 = 1.1793 after the main merge. Before: 1.2279. }, 'document-release': { skill: 'document-release', @@ -419,7 +419,7 @@ do not launch the downstream skill or open a browser.`, // eureka log, the office-hours lookup and the taste-profile read; measured // 1.0834 (2026-09-30). + named design-direction defaults to avoid in the native // subagent prompt (s02 H4a); measured 1.0911 (2026-10-02). - maxSizeRatio: 1.1623, // + v1.91.19.0 wave: design --version probe (B4), taste-profile load (F3), verdict-form outside voice (INV-1), plus v1.91.17.0's round accounting and board/approval blocks (#3022) merged in; measured 100,446 / 90,375 = 1.1114 (2026-10-03). + Oct 6 fix wave A3/CEO-12: free text reaches commands only through agent-written mktemp files (mktemp block, write rule, path rebuild and refusal at each posting, prompt and brief site); measured 103,384 / 90,375 = 1.1439 (2026-10-06). + Oct 7 wave B6: Aside rules 1, 4, 6 and 7 (offer a target-origin tab before openTab, a second sign-in wall means a tab- or URL-bound session, no early-return hint, fast [ok without the sentinel is an abort); measured 103,576 / 90,375 = 1.1461 (2026-10-07). + Oct 7 wave B3: the Codex probe runs as a command (select-model capture lines, check-sandbox/probe-model/run-with-timeout subcommands) instead of being sourced; measured 103,522 / 90,375 = 1.1455 (2026-10-07). Both merged: measured 103,726 / 90,375 = 1.1477 (2026-10-07). + Oct 7 wave guard (CEO-20): conditional `run_in_background` request plus the background-run recovery at each foreground dispatch site; measured 103,466 / 90,375 = 1.1449 (2026-10-07). Merged with the guard area: measured 103,804 / 90,375 = 1.1486 (2026-10-07). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). + GSTA-96 shared-preamble hoist (owner-approved raise, Garry 2026-10-25: "do it"): the union now holds sections/preamble.md, so a fresh invocation reads the pointer plus the shared file; measured 105,039 / 90,375 = 1.1623 (2026-10-25). Before: 1.16. + maxSizeRatio: 1.1688, // GST-2753 (2026-11-15, Garry's "Do it" to moving the never-print-secrets rule into gstack): the shared Ground Rules preamble section (never print a whole environment, git config or process table; wait on CI with one gstack-pr-wait call), +614 bytes; measured 1.1688 (before: 1.1623). Before that: + v1.91.19.0 wave: design --version probe (B4), taste-profile load (F3), verdict-form outside voice (INV-1), plus v1.91.17.0's round accounting and board/approval blocks (#3022) merged in; measured 100,446 / 90,375 = 1.1114 (2026-10-03). + Oct 6 fix wave A3/CEO-12: free text reaches commands only through agent-written mktemp files (mktemp block, write rule, path rebuild and refusal at each posting, prompt and brief site); measured 103,384 / 90,375 = 1.1439 (2026-10-06). + Oct 7 wave B6: Aside rules 1, 4, 6 and 7 (offer a target-origin tab before openTab, a second sign-in wall means a tab- or URL-bound session, no early-return hint, fast [ok without the sentinel is an abort); measured 103,576 / 90,375 = 1.1461 (2026-10-07). + Oct 7 wave B3: the Codex probe runs as a command (select-model capture lines, check-sandbox/probe-model/run-with-timeout subcommands) instead of being sourced; measured 103,522 / 90,375 = 1.1455 (2026-10-07). Both merged: measured 103,726 / 90,375 = 1.1477 (2026-10-07). + Oct 7 wave guard (CEO-20): conditional `run_in_background` request plus the background-run recovery at each foreground dispatch site; measured 103,466 / 90,375 = 1.1449 (2026-10-07). Merged with the guard area: measured 103,804 / 90,375 = 1.1486 (2026-10-07). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). + GSTA-96 shared-preamble hoist (owner-approved raise, Garry 2026-10-25: "do it"): the union now holds sections/preamble.md, so a fresh invocation reads the pointer plus the shared file; measured 105,039 / 90,375 = 1.1623 (2026-10-25). Before: 1.16. }, cso: { skill: 'cso', @@ -493,7 +493,7 @@ do not launch the downstream skill or open a browser.`, maxSkeletonBytes: 60_070, // GST-1088 lane B follow-up (raised from 60,014 to measured, no headroom): the Done-means check/waive commands run through the host-resolved bin path (~/.claude/skills/gstack/bin/gstack-skill-contract) instead of a bare gstack-skill-contract that a standard install doesn't put on PATH (fix-check finding on #3909 at 58aeee7), +56 bytes; measured 60,070. Before: GST-1088 lane B (#3909, raised from 59,774 to measured, no headroom; owner ruling via GStack Minder 2026-11-03): CONTRACT_CHECKER_SHIPPED=true now that bin/gstack-skill-contract ships (#3912) renders the gstack-skill-contract check/waive sentence under the Done means list (renders/GSTA-256/plan-v3.md line 74, r2-d6 "Done-means list"), +240 bytes; lane C's diet is expected to bring /review back under 59,073; measured 60,014. Before: GST-1088 lane B (raised from 59,073 to measured, no headroom): the contract: frontmatter block and the F1 "Done means" list rendered from it at the top of the body, plus widened triggers; F1 is a gate-rev-2 recommendation on the plan Garry approved with "do it" on gate rev 1 (2026-11-03), contingent on his gate-rev-2 answer, and lane C's diet is expected to bring /review back under 59,073; measured 59,774. Before: GSTA-96 hoist (2026-10-26): lowered from 80_900 by the shared preamble that moved to sections/preamble.md, keeping the pre-hoist headroom of 319 bytes; measured 58,754. Before: Shared-code identity/skip/action rules + critical-severity validation; measured 74,493 (2026-09-17). + v1.91.12.0 merge of #2999 (review clarity repairs: await reads, research alongside dispatch, /review deadline and setup authority, findings sources) with #3002 (guarded state-root lines, plan-check checkpoints); each fit alone; measured 74,881 (2026-10-01). + Oct 8 wave: shared voice directive bans "load-bearing" and adds the reply-language rule, offset by tightening the bounded closer (net +17 bytes per tier-2+ skill); measured 74,884 (2026-10-08). + gate integrity (HONEST_WORK_GATE_INTEGRITY W2): Step 3.5 Diff scans with the shared GATE_SCAN_BLOCK, the Step 4 carry, the four-option `review-gate-disposition` question in 5c, gate record fields in 5.8 and the Gate edits report line; measured 80,054 (2026-10-10). + Oct 10 multi-agent wave PR D2 (sideways review): Step 4's enum-only paragraph becomes the sideways sweep with the forced-CRITICAL list, plus the flake-fix number sentence in the Gate Integrity paragraph; measured skeleton 80,812 (2026-10-10). minUnionBytes: 89_000, // Phase 4 wave 1; measured union 93,357 mustContain: ['confidence', 'P1', 'P2', 'Review Army', 'adversarial'], - maxSizeRatio: 1.3288, // + GST-1088 lane B follow-up (raised from 1.3283 to measured, no headroom): the Done-means check/waive commands run through the host-resolved bin path instead of a bare gstack-skill-contract that isn't on PATH (fix-check finding on #3909 at 58aeee7), +56 bytes; measured 144,203 / 108,523 = 1.328778, rounded up. Before: + GST-1088 lane B (#3909, raised from 1.3261 to measured, no headroom; owner ruling via GStack Minder 2026-11-03): the gstack-skill-contract check/waive sentence that CONTRACT_CHECKER_SHIPPED=true renders (renders/GSTA-256/plan-v3.md line 74, r2-d6 "Done-means list"), +240 bytes; lane C's diet is expected to bring /review back under 1.3180; measured 144,147 / 108,523 = 1.32826, rounded up. Before: + GST-1088 lane B (raised from 1.3180 to measured, no headroom): the contract: frontmatter block and the F1 "Done means" list, contingent on Garry's gate-rev-2 answer; lane C's diet is expected to bring /review back under 1.3180; measured 143,907 / 108,523 = 1.3261. Before: + GSTA-167 variant G part 1 (plan approved by Garry 2026-10-30, autoplan-20261030161754 "Do it", which names about +0.3k prompt tokens per voice): the native adversarial and outside-voice prompts carry the blocking floor and the Severity and Blocks lines, +537 bytes; measured 1.3180 (2026-10-30). Before: 1.3136. GSTA-96 hoist merged with GSTA-92 phase 2 (2026-10-26): both owner-approved raises together, measured 142,550 / 108,523 = 1.3135. Before: Shared-code feature + critical-severity validation: 128,042 union bytes / 108,523 baseline = 1.1799; preserves content floors. + v1.91.12.0 merge of #2999 (above, plus plan-completion fallback intent and specialist checklist-by-path) with #3002; measured 1.1843 (2026-10-01). + v1.91.19.0 wave: verdict-form Codex callers with sandbox preflight (INV-1/B1), P0/P1 structured gate (B1b), bound-plan discovery and data-not-instructions guard (F1/D3), visible LEARNINGS failures (B5); measured 129,941 / 108,523 = 1.1974 (2026-10-03). + v1.91.18.0 (#3023) merged into the v1.91.19.0 wave; measured 130,025 / 108,523 = 1.1981 (2026-10-04). + Oct 6 fix wave: quota_exhausted preflight branch (#3051); measured 130,359 / 108,523 = 1.2012 (2026-10-06). + Oct 6 fix wave A3/CEO-12: free text reaches commands only through agent-written mktemp files (mktemp block, write rule, path rebuild and refusal at each posting, prompt and brief site); measured 131,314 / 108,523 = 1.2100 (2026-10-06). Combined Oct 6 wave head (A and B): measured 131,966 / 108,523 = 1.2160 (2026-10-06). + Oct 7 wave B3: the Codex probe runs as a command (select-model capture lines, check-sandbox/probe-model/run-with-timeout subcommands) instead of being sourced; measured 132,199 / 108,523 = 1.2182 (2026-10-07). + Oct 7 wave CEO-28/DX-11: review prompts ask for a severity per finding and design proposals use the proposal gate; measured 132,258 / 108,523 = 1.2187 (2026-10-07). + Oct 7 wave guard (CEO-20): conditional `run_in_background` request plus the background-run recovery at each foreground dispatch site; measured 132,233 / 108,523 = 1.2185 (2026-10-07). Merged with the guard area: measured 132,522 / 108,523 = 1.2211 (2026-10-07). + Oct 8 wave: the defensive-security framing and fixture summary mode reach the security specialist and the Red Team (stated once in the dispatch, referenced by the Red Team); measured 133,902 / 108,523 = 1.2339 (2026-10-08). + gate integrity W2 (above); measured 1.282 (2026-10-10). + Oct 10 multi-agent wave PR D2 (sideways review): sideways sweep and flake-fix number in Step 4; `Diff read` and `Undeclared behavior changes` in the review-mode Scope Check (plan-completion section); measured 140,497 / 108,523 = 1.2946 (2026-10-10). + harness lane E (2026-10-26): the lead-judgment stage in the finding merge and the `cause` anchor in the specialist prompts, shared with /ship through scripts/resolvers/review-army.ts; measured 141,949 / 108,523 = 1.3080. + maxSizeRatio: 1.3343, // GST-2753 (2026-11-15, Garry's "Do it" to moving the never-print-secrets rule into gstack): the shared Ground Rules preamble section (never print a whole environment, git config or process table; wait on CI with one gstack-pr-wait call), +614 bytes; measured 1.3343 (before: 1.3288). Before that: + GST-1088 lane B follow-up (raised from 1.3283 to measured, no headroom): the Done-means check/waive commands run through the host-resolved bin path instead of a bare gstack-skill-contract that isn't on PATH (fix-check finding on #3909 at 58aeee7), +56 bytes; measured 144,203 / 108,523 = 1.328778, rounded up. Before: + GST-1088 lane B (#3909, raised from 1.3261 to measured, no headroom; owner ruling via GStack Minder 2026-11-03): the gstack-skill-contract check/waive sentence that CONTRACT_CHECKER_SHIPPED=true renders (renders/GSTA-256/plan-v3.md line 74, r2-d6 "Done-means list"), +240 bytes; lane C's diet is expected to bring /review back under 1.3180; measured 144,147 / 108,523 = 1.32826, rounded up. Before: + GST-1088 lane B (raised from 1.3180 to measured, no headroom): the contract: frontmatter block and the F1 "Done means" list, contingent on Garry's gate-rev-2 answer; lane C's diet is expected to bring /review back under 1.3180; measured 143,907 / 108,523 = 1.3261. Before: + GSTA-167 variant G part 1 (plan approved by Garry 2026-10-30, autoplan-20261030161754 "Do it", which names about +0.3k prompt tokens per voice): the native adversarial and outside-voice prompts carry the blocking floor and the Severity and Blocks lines, +537 bytes; measured 1.3180 (2026-10-30). Before: 1.3136. GSTA-96 hoist merged with GSTA-92 phase 2 (2026-10-26): both owner-approved raises together, measured 142,550 / 108,523 = 1.3135. Before: Shared-code feature + critical-severity validation: 128,042 union bytes / 108,523 baseline = 1.1799; preserves content floors. + v1.91.12.0 merge of #2999 (above, plus plan-completion fallback intent and specialist checklist-by-path) with #3002; measured 1.1843 (2026-10-01). + v1.91.19.0 wave: verdict-form Codex callers with sandbox preflight (INV-1/B1), P0/P1 structured gate (B1b), bound-plan discovery and data-not-instructions guard (F1/D3), visible LEARNINGS failures (B5); measured 129,941 / 108,523 = 1.1974 (2026-10-03). + v1.91.18.0 (#3023) merged into the v1.91.19.0 wave; measured 130,025 / 108,523 = 1.1981 (2026-10-04). + Oct 6 fix wave: quota_exhausted preflight branch (#3051); measured 130,359 / 108,523 = 1.2012 (2026-10-06). + Oct 6 fix wave A3/CEO-12: free text reaches commands only through agent-written mktemp files (mktemp block, write rule, path rebuild and refusal at each posting, prompt and brief site); measured 131,314 / 108,523 = 1.2100 (2026-10-06). Combined Oct 6 wave head (A and B): measured 131,966 / 108,523 = 1.2160 (2026-10-06). + Oct 7 wave B3: the Codex probe runs as a command (select-model capture lines, check-sandbox/probe-model/run-with-timeout subcommands) instead of being sourced; measured 132,199 / 108,523 = 1.2182 (2026-10-07). + Oct 7 wave CEO-28/DX-11: review prompts ask for a severity per finding and design proposals use the proposal gate; measured 132,258 / 108,523 = 1.2187 (2026-10-07). + Oct 7 wave guard (CEO-20): conditional `run_in_background` request plus the background-run recovery at each foreground dispatch site; measured 132,233 / 108,523 = 1.2185 (2026-10-07). Merged with the guard area: measured 132,522 / 108,523 = 1.2211 (2026-10-07). + Oct 8 wave: the defensive-security framing and fixture summary mode reach the security specialist and the Red Team (stated once in the dispatch, referenced by the Red Team); measured 133,902 / 108,523 = 1.2339 (2026-10-08). + gate integrity W2 (above); measured 1.282 (2026-10-10). + Oct 10 multi-agent wave PR D2 (sideways review): sideways sweep and flake-fix number in Step 4; `Diff read` and `Undeclared behavior changes` in the review-mode Scope Check (plan-completion section); measured 140,497 / 108,523 = 1.2946 (2026-10-10). + harness lane E (2026-10-26): the lead-judgment stage in the finding merge and the `cause` anchor in the specialist prompts, shared with /ship through scripts/resolvers/review-army.ts; measured 141,949 / 108,523 = 1.3080. }, codex: { skill: 'codex', @@ -545,7 +545,7 @@ do not launch the downstream skill or open a browser.`, }, behavioral: 'prompt', maxSkeletonBytes: 32_216, // GSTA-161 skill diet (2026-10-30): lowered from 52_682 to the measured skeleton, 32,216; Step 7's canary script, the Aside contract, the browser fallback and Third-Party Web Actions moved to sections/canary.md. Before: GSTA-96 hoist (2026-10-26): lowered from 74_500 by the shared preamble that moved to sections/preamble.md, keeping the pre-hoist headroom of 690 bytes; measured 51,992. Before: + Aside browser contract for Step 7 canary ({{ASIDE_SETUP}}); measured 73_523 - maxSizeRatio: 1.1260, // + #3318 Step 3.4 reads the ship policy and prints one VERSION_CHECK verdict (owner-approved raise, Garry 2026-10-24: "do it"); measured 1.1201 (2026-10-24). Before: 1.1120. + v1.81 Aside contract + gstack-browser fallback block; measured 1.077. + both untrusted-content marker formats in the browser fallback (W7f) + the readiness gate's project test command and live eval-store paths (s06 H6/H7); measured 1.1076 (2026-10-02). Re-measured 1.0943 (2026-10-03); cap = measured + 0.005 headroom. + Oct 7 wave B6: Aside rules 1, 4, 6 and 7 (offer a target-origin tab before openTab, a second sign-in wall means a tab- or URL-bound session, no early-return hint, fast [ok without the sentinel is an abort); measured 115,226 / 104,578 = 1.1018 (2026-10-07). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). + GSTA-96 shared-preamble hoist (owner-approved raise, Garry 2026-10-25: "do it"): the union now holds sections/preamble.md, so a fresh invocation reads the pointer plus the shared file; measured 117,753 / 104,578 = 1.1260 (2026-10-25). Before: 1.125. + maxSizeRatio: 1.1318, // GST-2753 (2026-11-15, Garry's "Do it" to moving the never-print-secrets rule into gstack): the shared Ground Rules preamble section (never print a whole environment, git config or process table; wait on CI with one gstack-pr-wait call), +614 bytes; measured 1.1318 (before: 1.1260). Before that: + #3318 Step 3.4 reads the ship policy and prints one VERSION_CHECK verdict (owner-approved raise, Garry 2026-10-24: "do it"); measured 1.1201 (2026-10-24). Before: 1.1120. + v1.81 Aside contract + gstack-browser fallback block; measured 1.077. + both untrusted-content marker formats in the browser fallback (W7f) + the readiness gate's project test command and live eval-store paths (s06 H6/H7); measured 1.1076 (2026-10-02). Re-measured 1.0943 (2026-10-03); cap = measured + 0.005 headroom. + Oct 7 wave B6: Aside rules 1, 4, 6 and 7 (offer a target-origin tab before openTab, a second sign-in wall means a tab- or URL-bound session, no early-return hint, fast [ok without the sentinel is an abort); measured 115,226 / 104,578 = 1.1018 (2026-10-07). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). + GSTA-96 shared-preamble hoist (owner-approved raise, Garry 2026-10-25: "do it"): the union now holds sections/preamble.md, so a fresh invocation reads the pointer plus the shared file; measured 117,753 / 104,578 = 1.1260 (2026-10-25). Before: 1.125. minUnionBytes: 91_000, // Phase 4 wave 1; estimated union ~94.9KB mustContain: ['readiness', 'merge', 'canary', 'revert', 'staging'], }, @@ -583,7 +583,7 @@ do not launch the downstream skill or open a browser.`, maxSkeletonBytes: 48_175, // GSTA-96 hoist (2026-10-26): lowered from 70_000 by the shared preamble that moved to sections/preamble.md, keeping the pre-hoist headroom of 4,888 bytes; measured 43,287. Before: Phase-specific outside coverage, native fallback, and harness guard. minUnionBytes: 85_000, // measured union 86,926 mustContain: ['6 Decision Principles', 'TASTE DECISION', 'USER CHALLENGE', 'consensus', 'Restore Point'], - maxSizeRatio: 1.1723, // GST-537 /autoplan --ceo-only (GStack Minder approved A1, 2026-10-31): sections/ceo-only.md (2,168 B) plus its Section index row, read only when the invocation names --ceo-only (test/autoplan-ceo-only.test.ts pins that a normal run never reads it); measured 119,545 / 101,979 = 1.1723 (2026-10-31), +2,276 B over main's 117,269 = 1.1499. Before: 1.1511. Four validated outside invocations replace raw CLI calls; phases keep independent coverage. + Oct 7 wave B3: the Codex probe runs as a command (select-model capture lines, check-sandbox/probe-model/run-with-timeout subcommands) instead of being sourced; measured 114,297 / 101,979 = 1.1208 (2026-10-07). + Oct 7 wave CEO-28/DX-11: review prompts ask for a severity per finding and design proposals use the proposal gate; measured 114,533 / 101,979 = 1.1231 (2026-10-07). + Oct 7 wave guard (CEO-20): conditional `run_in_background` request plus the background-run recovery at each foreground dispatch site, and phase-close publishing each report with the `true autoplan-published ` no-op before the next phase entry in a later message (CEO-1); measured 114,320 / 101,979 = 1.1210 (2026-10-07). Merged with the guard area: measured 115,149 / 101,979 = 1.1291 (2026-10-07). + Oct 8 wave (permission cards after a background reviewer): Step 1 puts RESTORE_PATH, and so every phase artifact, in the project's git-excluded `.gstack/tmp/autoplan/`, which Claude Code reads without a card after the skill turn ends; measured 115,270 / 101,979 = 1.1303 (2026-10-08). + fix wave PR D: the prerequisite offer is skipped in spawned/headless sessions (#1958); measured 115,267 / 101,979 = 1.1303 (2026-10-07). Both merged: measured 115,126 / 101,979 = 1.1289 (2026-10-08). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). + Oct 10 multi-agent wave B9/B10/B12: Phase 0 ESTIMATE and the phase-close timing record, the final gate as a gate list (`gstack-gate render/parse`, stable ids, gate_rev) and the URGENT block above the summary, offset by tightening the Phase 4 prose and the tasks-section; measured 114,980 / 101,979 = 1.1275 (2026-10-10). + Oct 10 multi-agent wave PR D1 (reality rows): the reality-rows check line in the CEO and Eng phase files, the Pre-Gate rule (unattended miss is `incomplete`, never a warning) and the two Pre-Gate cells; measured 117,042 / 101,979 = 1.1477 (2026-10-10). + GSTA-96 shared-preamble hoist (owner-approved raise, Garry 2026-10-25: "do it"): the union now holds sections/preamble.md, so a fresh invocation reads the pointer plus the shared file; measured 117,388 / 101,979 = 1.1511 (2026-10-25). Before: 1.149. + maxSizeRatio: 1.1772, // GST-2753 (2026-11-15, Garry's "Do it" to moving the never-print-secrets rule into gstack): the shared Ground Rules preamble section (never print a whole environment, git config or process table; wait on CI with one gstack-pr-wait call), +614 bytes; measured 1.1772 (before: 1.1723). Before that: GST-537 /autoplan --ceo-only (GStack Minder approved A1, 2026-10-31): sections/ceo-only.md (2,168 B) plus its Section index row, read only when the invocation names --ceo-only (test/autoplan-ceo-only.test.ts pins that a normal run never reads it); measured 119,545 / 101,979 = 1.1723 (2026-10-31), +2,276 B over main's 117,269 = 1.1499. Before: 1.1511. Four validated outside invocations replace raw CLI calls; phases keep independent coverage. + Oct 7 wave B3: the Codex probe runs as a command (select-model capture lines, check-sandbox/probe-model/run-with-timeout subcommands) instead of being sourced; measured 114,297 / 101,979 = 1.1208 (2026-10-07). + Oct 7 wave CEO-28/DX-11: review prompts ask for a severity per finding and design proposals use the proposal gate; measured 114,533 / 101,979 = 1.1231 (2026-10-07). + Oct 7 wave guard (CEO-20): conditional `run_in_background` request plus the background-run recovery at each foreground dispatch site, and phase-close publishing each report with the `true autoplan-published ` no-op before the next phase entry in a later message (CEO-1); measured 114,320 / 101,979 = 1.1210 (2026-10-07). Merged with the guard area: measured 115,149 / 101,979 = 1.1291 (2026-10-07). + Oct 8 wave (permission cards after a background reviewer): Step 1 puts RESTORE_PATH, and so every phase artifact, in the project's git-excluded `.gstack/tmp/autoplan/`, which Claude Code reads without a card after the skill turn ends; measured 115,270 / 101,979 = 1.1303 (2026-10-08). + fix wave PR D: the prerequisite offer is skipped in spawned/headless sessions (#1958); measured 115,267 / 101,979 = 1.1303 (2026-10-07). Both merged: measured 115,126 / 101,979 = 1.1289 (2026-10-08). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). + Oct 10 multi-agent wave B9/B10/B12: Phase 0 ESTIMATE and the phase-close timing record, the final gate as a gate list (`gstack-gate render/parse`, stable ids, gate_rev) and the URGENT block above the summary, offset by tightening the Phase 4 prose and the tasks-section; measured 114,980 / 101,979 = 1.1275 (2026-10-10). + Oct 10 multi-agent wave PR D1 (reality rows): the reality-rows check line in the CEO and Eng phase files, the Pre-Gate rule (unattended miss is `incomplete`, never a warning) and the two Pre-Gate cells; measured 117,042 / 101,979 = 1.1477 (2026-10-10). + GSTA-96 shared-preamble hoist (owner-approved raise, Garry 2026-10-25: "do it"): the union now holds sections/preamble.md, so a fresh invocation reads the pointer plus the shared file; measured 117,388 / 101,979 = 1.1511 (2026-10-25). Before: 1.149. }, spec: { skill: 'spec', @@ -612,7 +612,7 @@ do not launch the downstream skill or open a browser.`, behavioral: 'prompt', maxSkeletonBytes: 36_571, // GSTA-96 hoist (2026-10-26): lowered from 58_400 by the shared preamble that moved to sections/preamble.md, keeping the pre-hoist headroom of 1,606 bytes; measured 34,965. Before: + v2.0 {{ASIDE_RESEARCH}} (Aside first, WebSearch fallback); measured 57_356 minUnionBytes: 64_500, // measured union 67,430 - maxSizeRatio: 1.0746, // Oct 10 multi-agent wave PR E2: the lazy gate-and-file section renders {{COORDINATOR_CONTRACT}} (the block every spawned lane inherits word for word; `gstack-autoplan contract` prints the same bytes) before the --execute spawn pipe; measured 86,614 / 81,577 = 1.0617 after the contract became a fail-closed `CONTRACT=$(…)` capture (2026-10-10). The skeleton is unchanged (57,107). + GSTA-96 shared-preamble hoist (owner-approved raise, Garry 2026-10-25: "do it"): the union now holds sections/preamble.md, so a fresh invocation reads the pointer plus the shared file; measured 87,656 / 81,577 = 1.0745 (2026-10-25). Before: 1.07. + maxSizeRatio: 1.0819, // GST-2753 (2026-11-15, Garry's "Do it" to moving the never-print-secrets rule into gstack): the shared Ground Rules preamble section (never print a whole environment, git config or process table; wait on CI with one gstack-pr-wait call), +614 bytes; measured 1.0819 (before: 1.0746). Before that: Oct 10 multi-agent wave PR E2: the lazy gate-and-file section renders {{COORDINATOR_CONTRACT}} (the block every spawned lane inherits word for word; `gstack-autoplan contract` prints the same bytes) before the --execute spawn pipe; measured 86,614 / 81,577 = 1.0617 after the contract became a fail-closed `CONTRACT=$(…)` capture (2026-10-10). The skeleton is unchanged (57,107). + GSTA-96 shared-preamble hoist (owner-approved raise, Garry 2026-10-25: "do it"): the union now holds sections/preamble.md, so a fresh invocation reads the pointer plus the shared file; measured 87,656 / 81,577 = 1.0745 (2026-10-25). Before: 1.07. mustContain: ['HARD GATE', 'dedupe', 'quality gate', 'acceptance criteria', 'archive'], }, 'setup-gbrain': { @@ -677,7 +677,7 @@ do not launch the downstream skill or open a browser.`, }, behavioral: 'prompt', maxSkeletonBytes: 41_669, // GSTA-96 hoist (2026-10-26): lowered from 63_500 by the shared preamble that moved to sections/preamble.md, keeping the pre-hoist headroom of 12,415 bytes; measured 29,254. Before: + v2.0 {{ASIDE_SETUP}}/{{BROWSE_FALLBACK}} (replaces the browse setup block); measured 61_253 - maxSizeRatio: 1.1420, // + v1.81 Aside contract + gstack-browser fallback block (1.080 on v1.91.7.0) + the shared test value bar at 8a.5 ({{TEST_VALUE_BAR:qa}}); measured 1.094 + W1 guarded state-root resolution (`eval gstack-paths; : "${GSTACK_STATE_ROOT:?…}"`) in the Context Recovery preamble, the eureka log and each state-writing bash block; measured 1.101 (2026-09-30) + v1.91.12.0 merge of #2999 (await scope/method Reads, capture --after checkpoints, browser-only empty evidence list) with #3002; measured 1.1028 (2026-10-01). + both untrusted-content marker formats in the browser fallback (W7f); measured 1.1035 (2026-10-02). Re-measured 1.1038 after the W8 probe-loop renames (2026-10-03); the cap already matches. + the annotate-every-capture and superseded rule before materialize (a ship-exploratory-late-input run published evidence that omitted older-snapshot captures); measured 1.1064 (2026-10-03). + v1.91.18.0 (#3023) merged into the v1.91.19.0 wave; measured 93,282 / 84,049 = 1.1099 (2026-10-04). + reliability follow-ups C2 (judge-named gaps after trimming the added wording: feasible 180 s Browser Quick, PROBE_DIR's source line, stop goes to the §4 report, written JSON keeps full card values; lane S's {user}/timing fields); measured 93,311 / 84,049 = 1.11020 (2026-10-04). + Oct 6 fix wave A3/CEO-12: free text reaches commands only through agent-written mktemp files (mktemp block, write rule, path rebuild and refusal at each posting, prompt and brief site); measured 94,486 / 84,049 = 1.1242 (2026-10-06). + Oct 7 wave B6: Aside rules 1, 4, 6 and 7 (offer a target-origin tab before openTab, a second sign-in wall means a tab- or URL-bound session, no early-return hint, fast [ok without the sentinel is an abort); measured 94,681 / 84,049 = 1.1265 (2026-10-07). + Oct 8 wave: shared voice directive bans "load-bearing" and adds the reply-language rule, offset by tightening the bounded closer (net +17 bytes per tier-2+ skill); measured 94,736 / 84,049 = 1.12715 (2026-10-08). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). + maxSizeRatio: 1.1493, // GST-2753 (2026-11-15, Garry's "Do it" to moving the never-print-secrets rule into gstack): the shared Ground Rules preamble section (never print a whole environment, git config or process table; wait on CI with one gstack-pr-wait call), +614 bytes; measured 1.1493 (before: 1.1420). Before that: + v1.81 Aside contract + gstack-browser fallback block (1.080 on v1.91.7.0) + the shared test value bar at 8a.5 ({{TEST_VALUE_BAR:qa}}); measured 1.094 + W1 guarded state-root resolution (`eval gstack-paths; : "${GSTACK_STATE_ROOT:?…}"`) in the Context Recovery preamble, the eureka log and each state-writing bash block; measured 1.101 (2026-09-30) + v1.91.12.0 merge of #2999 (await scope/method Reads, capture --after checkpoints, browser-only empty evidence list) with #3002; measured 1.1028 (2026-10-01). + both untrusted-content marker formats in the browser fallback (W7f); measured 1.1035 (2026-10-02). Re-measured 1.1038 after the W8 probe-loop renames (2026-10-03); the cap already matches. + the annotate-every-capture and superseded rule before materialize (a ship-exploratory-late-input run published evidence that omitted older-snapshot captures); measured 1.1064 (2026-10-03). + v1.91.18.0 (#3023) merged into the v1.91.19.0 wave; measured 93,282 / 84,049 = 1.1099 (2026-10-04). + reliability follow-ups C2 (judge-named gaps after trimming the added wording: feasible 180 s Browser Quick, PROBE_DIR's source line, stop goes to the §4 report, written JSON keeps full card values; lane S's {user}/timing fields); measured 93,311 / 84,049 = 1.11020 (2026-10-04). + Oct 6 fix wave A3/CEO-12: free text reaches commands only through agent-written mktemp files (mktemp block, write rule, path rebuild and refusal at each posting, prompt and brief site); measured 94,486 / 84,049 = 1.1242 (2026-10-06). + Oct 7 wave B6: Aside rules 1, 4, 6 and 7 (offer a target-origin tab before openTab, a second sign-in wall means a tab- or URL-bound session, no early-return hint, fast [ok without the sentinel is an abort); measured 94,681 / 84,049 = 1.1265 (2026-10-07). + Oct 8 wave: shared voice directive bans "load-bearing" and adds the reply-language rule, offset by tightening the bounded closer (net +17 bytes per tier-2+ skill); measured 94,736 / 84,049 = 1.12715 (2026-10-08). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). minUnionBytes: 69_500, // measured union 70,385 // 'aside repl' pins the Aside contract; '$B goto' pins the fallback block in the always-loaded skeleton. mustContain: ['bug', 'aside repl', '$B goto', 'fix', 'Health Score Rubric', 'regression'], @@ -714,7 +714,7 @@ do not launch the downstream skill or open a browser.`, gateAfterStop: undefined, }, behavioral: 'prompt', - maxSkeletonBytes: 34_700, // + v2.0 {{ASIDE_SETUP}}/{{BROWSE_FALLBACK}} skeleton + the STOP-Read pointer; measured 29_986 + Oct 6 fix wave A3/CEO-12: free text reaches commands only through agent-written mktemp files (mktemp block, write rule, path rebuild and refusal at each posting, prompt and brief site); skeleton measured 32,532 (2026-10-06). + Oct 7 wave B6: Aside rules 1, 4, 6 and 7 (offer a target-origin tab before openTab, a second sign-in wall means a tab- or URL-bound session, no early-return hint, fast [ok without the sentinel is an abort), and the cookbook's silent-failure list and signed-in-tab recipe (the rule details live here, not in every browsing skill); skeleton measured 34,047 (2026-10-07). + Oct 8 wave: the tier-1 voice directive bans "load-bearing" and adds the reply-language rule (tier 1 has no closer to tighten: +158 bytes); skeleton measured 34,209 (2026-10-08). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). + maxSkeletonBytes: 35_298, // GST-2753 (2026-11-15, Garry's "Do it" to moving the never-print-secrets rule into gstack): the shared Ground Rules preamble section (never print a whole environment, git config or process table; wait on CI with one gstack-pr-wait call), +614 bytes; measured 35,298 (before: 34_700). Before that: + v2.0 {{ASIDE_SETUP}}/{{BROWSE_FALLBACK}} skeleton + the STOP-Read pointer; measured 29_986 + Oct 6 fix wave A3/CEO-12: free text reaches commands only through agent-written mktemp files (mktemp block, write rule, path rebuild and refusal at each posting, prompt and brief site); skeleton measured 32,532 (2026-10-06). + Oct 7 wave B6: Aside rules 1, 4, 6 and 7 (offer a target-origin tab before openTab, a second sign-in wall means a tab- or URL-bound session, no early-return hint, fast [ok without the sentinel is an abort), and the cookbook's silent-failure list and signed-in-tab recipe (the rule details live here, not in every browsing skill); skeleton measured 34,047 (2026-10-07). + Oct 8 wave: the tier-1 voice directive bans "load-bearing" and adds the reply-language rule (tier 1 has no closer to tighten: +158 bytes); skeleton measured 34,209 (2026-10-08). + Honest Work wave merged (W2/W3 gate integrity in review/ship, W4 kernel + DONE line in every tier-2+ skill, W5/W7 in spec/ship): re-measured on the integrated tree (2026-10-10). minUnionBytes: 36_000, // skeleton + command-list section (14,240); measured union ~38.5 KB // 'BEGIN/END UNTRUSTED EXTERNAL' pins the untrusted-content warning in the // command reference; 'aside repl' pins the Aside contract in the skeleton. @@ -760,7 +760,7 @@ do not launch the downstream skill or open a browser.`, maxSkeletonBytes: 85_182, // /design-review --build (GST-1741 PR 2, 2026-11-07, grant: GStack Minder, 2026-11-07): --build routing, stop pointer, index row, description clause and trigger: +443 B, trimmed 130; the build-loop section is mode-loaded; measured 85,182. Before: GSTA-134 skill diet (2026-10-28): lowered from 115_947 to the measured skeleton after the outside voices and test bootstrap moved to sections, 84,869. Before: GSTA-96 hoist merged with v1.91.274.0 (#3507, 2026-10-27): the hoisted skeleton plus main's headroom of 0 bytes; measured 115,947 on the merged tree. Before: measured 137735 on the merged tree with main f27a760 (2026-10-27, #3507); 137767 (2026-10-26; 137773 on 2026-10-25 before the shorter craft-audit trigger): the Section index the external-host carve test requires, its craft-audit row, and the STOP pointer (GSTA-92; Garry 2026-10-25 'Do it' (GSTA-92)). minUnionBytes: 136_100, // GSTA-134 skill diet (2026-10-28): measured union 137,602 (lowered from 143_300); before: measured union 144802 on the merged tree with main f27a760 (2026-10-27, #3507); 145037 (2026-10-26) mustContain: ['AI Slop Detection', 'Fix Loop', 'gstack-design-lint', 'Proof beside each claim', 'holds session data'], - maxSizeRatio: 1.357, // /design-review --build (GST-1741 PR 2, 2026-11-07, grant: GStack Minder, 2026-11-07): --build routing, stop pointer, index row, description clause and trigger: +443 B, trimmed 130; the build-loop section is mode-loaded; measured 143,620 / 105,842 = 1.35693. Before: 1.3001, GSTA-134 skill diet (2026-10-28): measured 137,602 / 105,842 = 1.30007, rounded up (lowered from 1.3739). Before: GSTA-96 hoist merged with v1.91.274.0 (#3507, 2026-10-27): the union now holds sections/preamble.md (the hoist's owner-approved raise, decision A) on top of main's 1.3681; measured 145,410 / 105,842 = 1.3739 on the merged tree. Before: first parity guard for design-review: measured 144802 / 105,842 = 1.3681 on the merged tree with main f27a760 (2026-10-27, #3507: the design lint swap); before that 145082 / 105,842 = 1.3708 (2026-10-25; 145077 after the /ship review fixes, 145068 = 1.3707 after the line-13 reword, 145049 = 1.3705 after the post-merge /ship review, 145037 = 1.3704 after its second pass, 2026-10-26), the skeleton's growth since v1.64.1.0 plus the craft audit (Garry 2026-10-25 'Do it' (GSTA-92)). + maxSizeRatio: 1.3628, // GST-2753 (2026-11-15, Garry's "Do it" to moving the never-print-secrets rule into gstack): the shared Ground Rules preamble section (never print a whole environment, git config or process table; wait on CI with one gstack-pr-wait call), +614 bytes; measured 1.3628 (before: 1.357). Before that: /design-review --build (GST-1741 PR 2, 2026-11-07, grant: GStack Minder, 2026-11-07): --build routing, stop pointer, index row, description clause and trigger: +443 B, trimmed 130; the build-loop section is mode-loaded; measured 143,620 / 105,842 = 1.35693. Before: 1.3001, GSTA-134 skill diet (2026-10-28): measured 137,602 / 105,842 = 1.30007, rounded up (lowered from 1.3739). Before: GSTA-96 hoist merged with v1.91.274.0 (#3507, 2026-10-27): the union now holds sections/preamble.md (the hoist's owner-approved raise, decision A) on top of main's 1.3681; measured 145,410 / 105,842 = 1.3739 on the merged tree. Before: first parity guard for design-review: measured 144802 / 105,842 = 1.3681 on the merged tree with main f27a760 (2026-10-27, #3507: the design lint swap); before that 145082 / 105,842 = 1.3708 (2026-10-25; 145077 after the /ship review fixes, 145068 = 1.3707 after the line-13 reword, 145049 = 1.3705 after the post-merge /ship review, 145037 = 1.3704 after its second pass, 2026-10-26), the skeleton's growth since v1.64.1.0 plus the craft audit (Garry 2026-10-25 'Do it' (GSTA-92)). }, // ── Token-reduction Phase 4 wave 4 (v1.69.x branch): design doctrine carve ── @@ -900,7 +900,7 @@ do not launch the downstream skill or open a browser.`, gateAfterStop: undefined, // operational skill, no plan-mode gate }, behavioral: 'prompt', - maxSkeletonBytes: 31_300, // first carve: Section index, one STOP pointer and the vet rule on the 29.9k monolith; measured 30,781 (2026-10-26) + maxSkeletonBytes: 31_893, // GST-2753 (2026-11-15, Garry's "Do it" to moving the never-print-secrets rule into gstack): the shared Ground Rules preamble section (never print a whole environment, git config or process table; wait on CI with one gstack-pr-wait call), +614 bytes; measured 31,893 (before: 31_300). Before that: first carve: Section index, one STOP pointer and the vet rule on the 29.9k monolith; measured 30,781 (2026-10-26) minUnionBytes: 33_000, // skeleton + vet-the-number section; measured union 34,527 (2026-10-26) mustContain: ['performance.getEntries()', 'REGRESSION', 'Name the limiter', 'run-to-run variation', 'inconclusive'], // The v1.64.1.0 baseline measured the 37.2k monolith; the carved union is below it. diff --git a/test/size-ledger/ship/never-print-secrets-shared-rule.json b/test/size-ledger/ship/never-print-secrets-shared-rule.json new file mode 100644 index 000000000..65ee7c4e5 --- /dev/null +++ b/test/size-ledger/ship/never-print-secrets-shared-rule.json @@ -0,0 +1,4 @@ +{ + "bytes": 614, + "why": "Shared Ground Rules preamble section: never print a whole environment, git config or process table; wait on CI with one gstack-pr-wait call (GST-2753)" +} diff --git a/ubicloud/SKILL.md b/ubicloud/SKILL.md index 53cf66f86..6274dbed6 100644 --- a/ubicloud/SKILL.md +++ b/ubicloud/SKILL.md @@ -19,7 +19,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ubicloud/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/ubicloud/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/ubicloud/sections/preamble.md b/ubicloud/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/ubicloud/sections/preamble.md +++ b/ubicloud/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/verify/SKILL.md b/verify/SKILL.md index 2c13cc1ab..ee6e6e266 100644 --- a/verify/SKILL.md +++ b/verify/SKILL.md @@ -99,6 +99,11 @@ Reply in the language of the user's latest message unless asked otherwise. Code, The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: diff --git a/write-skill/SKILL.md b/write-skill/SKILL.md index 78688ecf5..85fc30a8b 100644 --- a/write-skill/SKILL.md +++ b/write-skill/SKILL.md @@ -22,7 +22,7 @@ allowed-tools: ## Shared preamble (load first) -This skill follows gstack shared preamble `4e82fa4c839f` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/write-skill/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. +This skill follows gstack shared preamble `227aca067dd3` (AskUserQuestion format, voice, writing, completeness and completion rules). If your Read of that file, headed by this id, is still in context, do not read it again; otherwise Read `~/.claude/skills/gstack/write-skill/sections/preamble.md` in full before the command below. A section or subsection here with a shared heading replaces the shared one. ## Preamble (run first) diff --git a/write-skill/sections/preamble.md b/write-skill/sections/preamble.md index 79e0a158c..9efe49a9d 100644 --- a/write-skill/sections/preamble.md +++ b/write-skill/sections/preamble.md @@ -1,6 +1,6 @@ -# gstack shared preamble 4e82fa4c839f +# gstack shared preamble 227aca067dd3 ## Plan Mode Safe Operations @@ -225,6 +225,11 @@ During long-running skill sessions, when you finish a phase or change direction, If you are looping on the same diagnostic, same file, or failed fix variants, STOP and reassess. Consider escalation or /context-save. Progress summaries must NEVER mutate git state. +## Ground Rules + +- Never print a whole environment, git config or process table; tokens ride in them. Banned: `env`, bare `printenv`, `set` or `export` (or an empty `export $(...)`), `export -p`/`-n`, `declare -p`/`-x`, `typeset -p`, `set -x`, `git config --list`/`-l`, any `ps` with full args (`aux`, `-ef`, `-o args`), `docker top ... args`, `docker inspect` Env. Read one value by name (`git config --get `), check a variable with `[ -n "${NAME:-}" ] && echo set`, list processes by name or pid. +- Wait on CI with one `gstack-pr-wait --until green` call, never a poll loop or `gh pr checks --watch`. + ## Completion Status Protocol When completing a skill workflow, report status using one of: