From 8d1db315afcd7cf28ddc90a8719de2ec00a0b6a6 Mon Sep 17 00:00:00 2001 From: garrytan Date: Thu, 8 Oct 2026 14:58:33 +0000 Subject: [PATCH] voice: ban the "load-bearing" stock phrase Models overuse "load-bearing"; it joins the AI-vocabulary ban line in both voice tiers. The tier-2 voice directive is also tightened (the meta "compressed for runtime" tag and the bounded closer's restated exemption clause) so the shared preamble shrinks by 163 bytes per tier-2+ skill, which also pays for the reply-language rule that follows. The ship goldens are refreshed for the new render. Co-authored-by: Nader Helmy Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --- SKILL.md | 2 +- autoplan/SKILL.md | 6 +++--- benchmark-models/SKILL.md | 2 +- benchmark/SKILL.md | 2 +- browse/SKILL.md | 2 +- canary/SKILL.md | 6 +++--- codex/SKILL.md | 6 +++--- context-restore/SKILL.md | 6 +++--- context-save/SKILL.md | 6 +++--- design-consultation/SKILL.md | 6 +++--- design-html/SKILL.md | 6 +++--- design-review/SKILL.md | 6 +++--- design-shotgun/SKILL.md | 6 +++--- devex-review/SKILL.md | 6 +++--- diagram/SKILL.md | 2 +- document-generate/SKILL.md | 6 +++--- document-release/SKILL.md | 6 +++--- health/SKILL.md | 6 +++--- investigate/SKILL.md | 6 +++--- ios-clean/SKILL.md | 6 +++--- ios-design-review/SKILL.md | 6 +++--- ios-fix/SKILL.md | 6 +++--- ios-qa/SKILL.md | 6 +++--- ios-sync/SKILL.md | 6 +++--- land-and-deploy/SKILL.md | 6 +++--- landing-report/SKILL.md | 6 +++--- learn/SKILL.md | 6 +++--- make-pdf/SKILL.md | 2 +- office-hours/SKILL.md | 6 +++--- open-gstack-browser/SKILL.md | 2 +- pair-agent/SKILL.md | 6 +++--- plan-ceo-review/SKILL.md | 6 +++--- plan-design-review/SKILL.md | 6 +++--- plan-devex-review/SKILL.md | 6 +++--- plan-eng-review/SKILL.md | 6 +++--- plan-tune/SKILL.md | 6 +++--- qa-only/SKILL.md | 6 +++--- qa/SKILL.md | 6 +++--- retro/SKILL.md | 6 +++--- review/SKILL.md | 6 +++--- scrape/SKILL.md | 2 +- .../resolvers/preamble/generate-voice-directive.ts | 8 ++++---- setup-browser-cookies/SKILL.md | 2 +- setup-deploy/SKILL.md | 6 +++--- setup-gbrain/SKILL.md | 6 +++--- ship/SKILL.md | 6 +++--- skillify/SKILL.md | 6 +++--- spec/SKILL.md | 6 +++--- sync-gbrain/SKILL.md | 6 +++--- test-audit/SKILL.md | 6 +++--- test/fixtures/golden/claude-ship-SKILL.md | 6 +++--- test/fixtures/golden/codex-ship-SKILL.md | 6 +++--- test/fixtures/golden/factory-ship-SKILL.md | 6 +++--- test/voice-directive.test.ts | 14 ++++++++++++++ 54 files changed, 156 insertions(+), 142 deletions(-) create mode 100644 test/voice-directive.test.ts diff --git a/SKILL.md b/SKILL.md index 9105de88e..0c23dcdbf 100644 --- a/SKILL.md +++ b/SKILL.md @@ -96,7 +96,7 @@ find, grep). The dedicated tools are cheaper and clearer. Direct, concrete, builder-to-builder. Name the file, function, command, and user-visible impact. No filler. -No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted. Never corporate or academic. Short paragraphs. End with what to do. +No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, load-bearing. Never corporate or academic. Short paragraphs. End with what to do. The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. diff --git a/autoplan/SKILL.md b/autoplan/SKILL.md index d3dfbcdca..c94df5a77 100644 --- a/autoplan/SKILL.md +++ b/autoplan/SKILL.md @@ -228,7 +228,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -236,13 +236,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/benchmark-models/SKILL.md b/benchmark-models/SKILL.md index 9dedb187b..b0b56f3a6 100644 --- a/benchmark-models/SKILL.md +++ b/benchmark-models/SKILL.md @@ -100,7 +100,7 @@ find, grep). The dedicated tools are cheaper and clearer. Direct, concrete, builder-to-builder. Name the file, function, command, and user-visible impact. No filler. -No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted. Never corporate or academic. Short paragraphs. End with what to do. +No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, load-bearing. Never corporate or academic. Short paragraphs. End with what to do. The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. diff --git a/benchmark/SKILL.md b/benchmark/SKILL.md index 924ea0269..0b2c0e0d1 100644 --- a/benchmark/SKILL.md +++ b/benchmark/SKILL.md @@ -101,7 +101,7 @@ find, grep). The dedicated tools are cheaper and clearer. Direct, concrete, builder-to-builder. Name the file, function, command, and user-visible impact. No filler. -No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted. Never corporate or academic. Short paragraphs. End with what to do. +No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, load-bearing. Never corporate or academic. Short paragraphs. End with what to do. The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. diff --git a/browse/SKILL.md b/browse/SKILL.md index 94df6eefa..f80939f3a 100644 --- a/browse/SKILL.md +++ b/browse/SKILL.md @@ -96,7 +96,7 @@ find, grep). The dedicated tools are cheaper and clearer. Direct, concrete, builder-to-builder. Name the file, function, command, and user-visible impact. No filler. -No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted. Never corporate or academic. Short paragraphs. End with what to do. +No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, load-bearing. Never corporate or academic. Short paragraphs. End with what to do. The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. diff --git a/canary/SKILL.md b/canary/SKILL.md index 11226e9d4..d4c2b2157 100644 --- a/canary/SKILL.md +++ b/canary/SKILL.md @@ -209,7 +209,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -217,13 +217,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/codex/SKILL.md b/codex/SKILL.md index 7e9f2ecf3..777ce5cb2 100644 --- a/codex/SKILL.md +++ b/codex/SKILL.md @@ -212,7 +212,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -220,13 +220,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/context-restore/SKILL.md b/context-restore/SKILL.md index 29969b1f7..8dfe9b8d4 100644 --- a/context-restore/SKILL.md +++ b/context-restore/SKILL.md @@ -211,7 +211,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -219,13 +219,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/context-save/SKILL.md b/context-save/SKILL.md index 9caf2e13c..f1db7349d 100644 --- a/context-save/SKILL.md +++ b/context-save/SKILL.md @@ -210,7 +210,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -218,13 +218,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/design-consultation/SKILL.md b/design-consultation/SKILL.md index e7a1d2139..688369d6d 100644 --- a/design-consultation/SKILL.md +++ b/design-consultation/SKILL.md @@ -235,7 +235,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -243,13 +243,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/design-html/SKILL.md b/design-html/SKILL.md index ca10c55b6..491e9c957 100644 --- a/design-html/SKILL.md +++ b/design-html/SKILL.md @@ -216,7 +216,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -224,13 +224,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/design-review/SKILL.md b/design-review/SKILL.md index 48dc45843..c9d913831 100644 --- a/design-review/SKILL.md +++ b/design-review/SKILL.md @@ -213,7 +213,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -221,13 +221,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/design-shotgun/SKILL.md b/design-shotgun/SKILL.md index 6ed709651..6d59b14b5 100644 --- a/design-shotgun/SKILL.md +++ b/design-shotgun/SKILL.md @@ -229,7 +229,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -237,13 +237,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/devex-review/SKILL.md b/devex-review/SKILL.md index 35c3f2cd3..b1b9f5617 100644 --- a/devex-review/SKILL.md +++ b/devex-review/SKILL.md @@ -215,7 +215,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -223,13 +223,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/diagram/SKILL.md b/diagram/SKILL.md index 74c64cdd1..1a44c768d 100644 --- a/diagram/SKILL.md +++ b/diagram/SKILL.md @@ -99,7 +99,7 @@ find, grep). The dedicated tools are cheaper and clearer. Direct, concrete, builder-to-builder. Name the file, function, command, and user-visible impact. No filler. -No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted. Never corporate or academic. Short paragraphs. End with what to do. +No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, load-bearing. Never corporate or academic. Short paragraphs. End with what to do. The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. diff --git a/document-generate/SKILL.md b/document-generate/SKILL.md index c417c387c..53b380dab 100644 --- a/document-generate/SKILL.md +++ b/document-generate/SKILL.md @@ -215,7 +215,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -223,13 +223,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/document-release/SKILL.md b/document-release/SKILL.md index e307f55ad..c6cdb946a 100644 --- a/document-release/SKILL.md +++ b/document-release/SKILL.md @@ -213,7 +213,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -221,13 +221,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/health/SKILL.md b/health/SKILL.md index 735cf4826..4acaef9b6 100644 --- a/health/SKILL.md +++ b/health/SKILL.md @@ -211,7 +211,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -219,13 +219,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/investigate/SKILL.md b/investigate/SKILL.md index 7c33545d9..597292536 100644 --- a/investigate/SKILL.md +++ b/investigate/SKILL.md @@ -255,7 +255,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -263,13 +263,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/ios-clean/SKILL.md b/ios-clean/SKILL.md index 392167498..b76c5785a 100644 --- a/ios-clean/SKILL.md +++ b/ios-clean/SKILL.md @@ -213,7 +213,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -221,13 +221,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/ios-design-review/SKILL.md b/ios-design-review/SKILL.md index 7baf2877d..3bd297c4d 100644 --- a/ios-design-review/SKILL.md +++ b/ios-design-review/SKILL.md @@ -215,7 +215,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -223,13 +223,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/ios-fix/SKILL.md b/ios-fix/SKILL.md index 29dc12111..012adc18b 100644 --- a/ios-fix/SKILL.md +++ b/ios-fix/SKILL.md @@ -216,7 +216,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -224,13 +224,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/ios-qa/SKILL.md b/ios-qa/SKILL.md index d9c68e49d..615d47f1c 100644 --- a/ios-qa/SKILL.md +++ b/ios-qa/SKILL.md @@ -220,7 +220,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -228,13 +228,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/ios-sync/SKILL.md b/ios-sync/SKILL.md index abec253c6..274363991 100644 --- a/ios-sync/SKILL.md +++ b/ios-sync/SKILL.md @@ -213,7 +213,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -221,13 +221,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/land-and-deploy/SKILL.md b/land-and-deploy/SKILL.md index 46e0da65f..398107100 100644 --- a/land-and-deploy/SKILL.md +++ b/land-and-deploy/SKILL.md @@ -208,7 +208,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -216,13 +216,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/landing-report/SKILL.md b/landing-report/SKILL.md index a973c4108..de688d27c 100644 --- a/landing-report/SKILL.md +++ b/landing-report/SKILL.md @@ -210,7 +210,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -218,13 +218,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/learn/SKILL.md b/learn/SKILL.md index 2184050cb..b7bdf2ec9 100644 --- a/learn/SKILL.md +++ b/learn/SKILL.md @@ -211,7 +211,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -219,13 +219,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/make-pdf/SKILL.md b/make-pdf/SKILL.md index a7984fea1..fb9a83200 100644 --- a/make-pdf/SKILL.md +++ b/make-pdf/SKILL.md @@ -137,7 +137,7 @@ find, grep). The dedicated tools are cheaper and clearer. Direct, concrete, builder-to-builder. Name the file, function, command, and user-visible impact. No filler. -No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted. Never corporate or academic. Short paragraphs. End with what to do. +No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, load-bearing. Never corporate or academic. Short paragraphs. End with what to do. The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. diff --git a/office-hours/SKILL.md b/office-hours/SKILL.md index bb982c76f..7b7179f7b 100644 --- a/office-hours/SKILL.md +++ b/office-hours/SKILL.md @@ -256,7 +256,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -264,13 +264,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/open-gstack-browser/SKILL.md b/open-gstack-browser/SKILL.md index aa4071bb7..72b5a1916 100644 --- a/open-gstack-browser/SKILL.md +++ b/open-gstack-browser/SKILL.md @@ -98,7 +98,7 @@ find, grep). The dedicated tools are cheaper and clearer. Direct, concrete, builder-to-builder. Name the file, function, command, and user-visible impact. No filler. -No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted. Never corporate or academic. Short paragraphs. End with what to do. +No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, load-bearing. Never corporate or academic. Short paragraphs. End with what to do. The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. diff --git a/pair-agent/SKILL.md b/pair-agent/SKILL.md index 9e64c039a..4acea278a 100644 --- a/pair-agent/SKILL.md +++ b/pair-agent/SKILL.md @@ -212,7 +212,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -220,13 +220,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/plan-ceo-review/SKILL.md b/plan-ceo-review/SKILL.md index 89c40f04c..aa908bf83 100644 --- a/plan-ceo-review/SKILL.md +++ b/plan-ceo-review/SKILL.md @@ -237,7 +237,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -245,13 +245,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/plan-design-review/SKILL.md b/plan-design-review/SKILL.md index 4ece30f26..b1f893e4a 100644 --- a/plan-design-review/SKILL.md +++ b/plan-design-review/SKILL.md @@ -237,7 +237,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -245,13 +245,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/plan-devex-review/SKILL.md b/plan-devex-review/SKILL.md index 3959013ed..087d1e9c5 100644 --- a/plan-devex-review/SKILL.md +++ b/plan-devex-review/SKILL.md @@ -209,7 +209,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -217,13 +217,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/plan-eng-review/SKILL.md b/plan-eng-review/SKILL.md index 4a7a4b981..0aa8cdc2b 100644 --- a/plan-eng-review/SKILL.md +++ b/plan-eng-review/SKILL.md @@ -253,7 +253,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -261,13 +261,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- Do not add em dashes in prose you compose during the review. Existing templates, quoted text, command output, and required copied labels may contain them. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- Do not add em dashes in prose you compose during the review. Existing templates, quoted text, command output, and required copied labels may contain them. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/plan-tune/SKILL.md b/plan-tune/SKILL.md index 12110f1a8..94ff1312a 100644 --- a/plan-tune/SKILL.md +++ b/plan-tune/SKILL.md @@ -221,7 +221,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -229,13 +229,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/qa-only/SKILL.md b/qa-only/SKILL.md index a08d041bf..126bf4a80 100644 --- a/qa-only/SKILL.md +++ b/qa-only/SKILL.md @@ -211,7 +211,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -219,13 +219,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/qa/SKILL.md b/qa/SKILL.md index ecd1a11f4..b9d25474b 100644 --- a/qa/SKILL.md +++ b/qa/SKILL.md @@ -215,7 +215,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -223,13 +223,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/retro/SKILL.md b/retro/SKILL.md index bf2f65e72..7ad8a1cfa 100644 --- a/retro/SKILL.md +++ b/retro/SKILL.md @@ -229,7 +229,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -237,13 +237,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/review/SKILL.md b/review/SKILL.md index 3ccab19c5..2a65e6385 100644 --- a/review/SKILL.md +++ b/review/SKILL.md @@ -213,7 +213,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -221,13 +221,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/scrape/SKILL.md b/scrape/SKILL.md index a054f1698..fda2ef1e0 100644 --- a/scrape/SKILL.md +++ b/scrape/SKILL.md @@ -95,7 +95,7 @@ find, grep). The dedicated tools are cheaper and clearer. Direct, concrete, builder-to-builder. Name the file, function, command, and user-visible impact. No filler. -No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted. Never corporate or academic. Short paragraphs. End with what to do. +No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, load-bearing. Never corporate or academic. Short paragraphs. End with what to do. The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. diff --git a/scripts/resolvers/preamble/generate-voice-directive.ts b/scripts/resolvers/preamble/generate-voice-directive.ts index 80856c8b6..4bf9a0011 100644 --- a/scripts/resolvers/preamble/generate-voice-directive.ts +++ b/scripts/resolvers/preamble/generate-voice-directive.ts @@ -11,14 +11,14 @@ export function generateVoiceDirective(ctx: TemplateContext, tier: number): stri Direct, concrete, builder-to-builder. Name the file, function, command, and user-visible impact. No filler. -${emDashRule} No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted. Never corporate or academic. Short paragraphs. End with what to do. +${emDashRule} No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, load-bearing. Never corporate or academic. Short paragraphs. End with what to do. The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides.`; } return `## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -26,13 +26,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- ${emDashRule} No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- ${emDashRule} No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned.`; diff --git a/setup-browser-cookies/SKILL.md b/setup-browser-cookies/SKILL.md index 1814e7dda..45e56c06b 100644 --- a/setup-browser-cookies/SKILL.md +++ b/setup-browser-cookies/SKILL.md @@ -94,7 +94,7 @@ find, grep). The dedicated tools are cheaper and clearer. Direct, concrete, builder-to-builder. Name the file, function, command, and user-visible impact. No filler. -No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted. Never corporate or academic. Short paragraphs. End with what to do. +No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, load-bearing. Never corporate or academic. Short paragraphs. End with what to do. The user has context you do not. Cross-model agreement is a recommendation, not a decision. The user decides. diff --git a/setup-deploy/SKILL.md b/setup-deploy/SKILL.md index f6b6671e1..6fca5618e 100644 --- a/setup-deploy/SKILL.md +++ b/setup-deploy/SKILL.md @@ -212,7 +212,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -220,13 +220,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/setup-gbrain/SKILL.md b/setup-gbrain/SKILL.md index 66e6942fe..e16b9517b 100644 --- a/setup-gbrain/SKILL.md +++ b/setup-gbrain/SKILL.md @@ -211,7 +211,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -219,13 +219,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/ship/SKILL.md b/ship/SKILL.md index 05022421d..b64ddf867 100644 --- a/ship/SKILL.md +++ b/ship/SKILL.md @@ -213,7 +213,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -221,13 +221,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/skillify/SKILL.md b/skillify/SKILL.md index 4b57e3fb2..ea2107677 100644 --- a/skillify/SKILL.md +++ b/skillify/SKILL.md @@ -210,7 +210,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -218,13 +218,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/spec/SKILL.md b/spec/SKILL.md index 04e1f195f..54ab08e2d 100644 --- a/spec/SKILL.md +++ b/spec/SKILL.md @@ -211,7 +211,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -219,13 +219,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/sync-gbrain/SKILL.md b/sync-gbrain/SKILL.md index cedb2eb6c..d4ed3bd82 100644 --- a/sync-gbrain/SKILL.md +++ b/sync-gbrain/SKILL.md @@ -212,7 +212,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -220,13 +220,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/test-audit/SKILL.md b/test-audit/SKILL.md index 0b6a8d46d..6f3c6c210 100644 --- a/test-audit/SKILL.md +++ b/test-audit/SKILL.md @@ -207,7 +207,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -215,13 +215,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/test/fixtures/golden/claude-ship-SKILL.md b/test/fixtures/golden/claude-ship-SKILL.md index 05022421d..b64ddf867 100644 --- a/test/fixtures/golden/claude-ship-SKILL.md +++ b/test/fixtures/golden/claude-ship-SKILL.md @@ -213,7 +213,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -221,13 +221,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/test/fixtures/golden/codex-ship-SKILL.md b/test/fixtures/golden/codex-ship-SKILL.md index c65a05df7..5873804e7 100644 --- a/test/fixtures/golden/codex-ship-SKILL.md +++ b/test/fixtures/golden/codex-ship-SKILL.md @@ -216,7 +216,7 @@ Completion bias does not override safety gates. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -224,13 +224,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/test/fixtures/golden/factory-ship-SKILL.md b/test/fixtures/golden/factory-ship-SKILL.md index 67e586767..dae060274 100644 --- a/test/fixtures/golden/factory-ship-SKILL.md +++ b/test/fixtures/golden/factory-ship-SKILL.md @@ -197,7 +197,7 @@ find, grep). The dedicated tools are cheaper and clearer. ## Voice -GStack voice: Garry-shaped product and engineering judgment, compressed for runtime. +GStack voice: Garry-shaped product and engineering judgment. - Lead with the point. Say what it does, why it matters, and what changes for the builder. - Be concrete. Name files, functions, line numbers, commands, outputs, evals, and real numbers. @@ -205,13 +205,13 @@ GStack voice: Garry-shaped product and engineering judgment, compressed for runt - Be direct about quality. Bugs matter. Edge cases matter. Fix the whole thing, not the demo path. - Sound like a builder talking to a builder, not a consultant presenting to a client. - Never corporate, academic, PR, or hype. Avoid filler, throat-clearing, generic optimism, and founder cosplay. -- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant. +- No em dashes. No AI vocabulary: delve, crucial, robust, comprehensive, nuanced, multifaceted, furthermore, moreover, additionally, pivotal, landscape, tapestry, underscore, foster, showcase, intricate, vibrant, fundamental, significant, load-bearing. - The user has context you do not: domain knowledge, timing, relationships, taste. Cross-model agreement is a recommendation, not a decision. The user decides. Good: "auth.ts:47 returns undefined when the session cookie expires. Users hit a white screen. Fix: add a null check and redirect to /login. Two lines." Bad: "I've identified a potential issue in the authentication flow that may cause problems under certain conditions." -**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours, no unrequested design notes. If the explanation outgrows the change, cut the explanation. Exempt: AskUserQuestion decision briefs, completion-status blocks, anything the user explicitly asked to be explained, and a skill's mandated report format — the report IS the work in report-shaped skills (/qa-only, /plan-*-review, /retro, /document-generate); this rule governs unrequested prose around the deliverable, never the deliverable. +**Bounded closer.** After completing work, report in at most a few short lines: what changed, what was skipped, what to watch. No feature tours or unrequested design notes. Exempt: AskUserQuestion decision briefs, completion-status blocks, explanations the user asked for, and a skill's mandated report (/qa-only, /plan-*-review, /retro, /document-generate). The rule limits prose around the deliverable, never the deliverable. Good closer: "Renamed the flag in 3 files, regenerated docs, tests green. Skipped the CLI alias (unused since v1.2); watch the Windows job." Bad closer: a tour of every edit, a restatement of the plan, and three paragraphs justifying choices nobody questioned. diff --git a/test/voice-directive.test.ts b/test/voice-directive.test.ts new file mode 100644 index 000000000..14bfae690 --- /dev/null +++ b/test/voice-directive.test.ts @@ -0,0 +1,14 @@ +import { describe, expect, test } from 'bun:test'; +import { generateVoiceDirective } from '../scripts/resolvers/preamble/generate-voice-directive'; +import { HOST_PATHS, type TemplateContext } from '../scripts/resolvers/types'; + +const ctx: TemplateContext = { skillName: 'review', tmplPath: 'review/SKILL.md.tmpl', host: 'claude', paths: HOST_PATHS.claude }; +const tiers: number[] = [1, 3]; + +describe('shared voice directive', () => { + test.each(tiers)('tier %i bans the load-bearing stock phrase on the AI-vocabulary line', tier => { + const banLine = generateVoiceDirective(ctx, tier).split('\n').find(line => line.includes('No AI vocabulary:')); + expect(banLine).toBeDefined(); + expect(banLine!).toContain('load-bearing'); + }); +});