From 5c37e4a933dc33ccad96e92c9792a455dd3222ce Mon Sep 17 00:00:00 2001 From: "Benjamin D. Smith" Date: Sat, 18 Jul 2026 14:06:50 +0000 Subject: [PATCH] chore(build): regenerate skill docs to current generator output MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 📝 Summary: • re-run `bun run gen:skill-docs` on unmodified templates and commit the drift — the working tree had stale generated output (blank-line churn) left uncommitted by an earlier regen • 326 deletions across 10 SKILL.md + 6 sections files, whitespace and section-render drift only; no template changed in this commit 📊 Code Changes: 0 insertions, 326 deletions (net -326) --- cso/SKILL.md | 31 ----------------- design-consultation/SKILL.md | 31 ----------------- design-review/SKILL.md | 17 ---------- investigate/SKILL.md | 33 ------------------- office-hours/SKILL.md | 10 ------ office-hours/sections/design-and-handoff.md | 21 ------------ plan-ceo-review/SKILL.md | 10 ------ plan-ceo-review/sections/review-sections.md | 21 ------------ .../sections/review-sections.md | 21 ------------ plan-devex-review/sections/review-sections.md | 21 ------------ plan-eng-review/SKILL.md | 10 ------ plan-eng-review/sections/review-sections.md | 21 ------------ qa/SKILL.md | 17 ---------- retro/SKILL.md | 31 ----------------- ship/SKILL.md | 10 ------ ship/sections/adversarial.md | 21 ------------ 16 files changed, 326 deletions(-) diff --git a/cso/SKILL.md b/cso/SKILL.md index ad045defa..4b6049111 100644 --- a/cso/SKILL.md +++ b/cso/SKILL.md @@ -787,17 +787,7 @@ Replace `SKILL_NAME`, `OUTCOME`, and `USED_BROWSE` before running. Skills that run plan reviews (`/plan-*-review`, `/codex review`) include the EXIT PLAN MODE GATE blocking checklist at the end of the skill, which verifies the plan file ends with `## GSTACK REVIEW REPORT` before ExitPlanMode is called. Skills that don't run plan reviews (operational skills like `/ship`, `/qa`, `/review`) typically don't operate in plan mode and have no review report to verify; this footer is a no-op for them. Writing the plan file is the one edit allowed in plan mode. -## Brain Context Load -**Skip this entire section if `gbrain` is not on PATH.** - -Extract 2-4 keywords from the user's request. Search the brain: -`gbrain search ""`. Read the top 3 results with -`gbrain get_page ""`. Use that context to inform your analysis. - -If `gbrain search` returns no results or any non-zero exit, proceed -without brain context. Full search/read protocol + examples: -see `docs/gbrain-write-surfaces.md` §Context Load. # /cso — Chief Security Officer Audit (v2) @@ -1270,28 +1260,7 @@ staleness detection: if those files are later deleted, the learning can be flagg **Only log genuine discoveries.** Don't log obvious things. Don't log things the user already knows. A good test: would this insight save time in a future session? If yes, log it. -## Save Results to Brain -**Skip this entire section if `gbrain` is not on PATH.** - -After completing this skill, save the output: - -```bash -gbrain put "security-audits/" --content "$(cat <<'EOF' ---- -title: "Security Audit: " -tags: [security-audit, ] ---- - -EOF -)" -``` - -Then extract person/org entities and create stub pages for each one. -Throttle errors (exit 1 with "throttle"/"rate limit"/"busy") and any -other non-zero exit are transient — don't retry inline. Full entity-stub -template, throttle handling, and backlink protocol: -see `docs/gbrain-write-surfaces.md` §Save Template. ## Important Rules diff --git a/design-consultation/SKILL.md b/design-consultation/SKILL.md index dffab6c8b..bf4fbf168 100644 --- a/design-consultation/SKILL.md +++ b/design-consultation/SKILL.md @@ -956,17 +956,7 @@ If `DESIGN_NOT_AVAILABLE`: Phase 5 falls back to the HTML preview page (still go --- -## Brain Context Load -**Skip this entire section if `gbrain` is not on PATH.** - -Extract 2-4 keywords from the user's request. Search the brain: -`gbrain search ""`. Read the top 3 results with -`gbrain get_page ""`. Use that context to inform your analysis. - -If `gbrain search` returns no results or any non-zero exit, proceed -without brain context. Full search/read protocol + examples: -see `docs/gbrain-write-surfaces.md` §Context Load. ## Prior Learnings @@ -1229,28 +1219,7 @@ staleness detection: if those files are later deleted, the learning can be flagg **Only log genuine discoveries.** Don't log obvious things. Don't log things the user already knows. A good test: would this insight save time in a future session? If yes, log it. -## Save Results to Brain -**Skip this entire section if `gbrain` is not on PATH.** - -After completing this skill, save the output: - -```bash -gbrain put "design-systems/" --content "$(cat <<'EOF' ---- -title: "Design System: " -tags: [design-system, ] ---- - -EOF -)" -``` - -Then extract person/org entities and create stub pages for each one. -Throttle errors (exit 1 with "throttle"/"rate limit"/"busy") and any -other non-zero exit are transient — don't retry inline. Full entity-stub -template, throttle handling, and backlink protocol: -see `docs/gbrain-write-surfaces.md` §Save Template. ## Important Rules diff --git a/design-review/SKILL.md b/design-review/SKILL.md index 285f32f2b..93d425389 100644 --- a/design-review/SKILL.md +++ b/design-review/SKILL.md @@ -803,17 +803,7 @@ Replace `SKILL_NAME`, `OUTCOME`, and `USED_BROWSE` before running. Skills that run plan reviews (`/plan-*-review`, `/codex review`) include the EXIT PLAN MODE GATE blocking checklist at the end of the skill, which verifies the plan file ends with `## GSTACK REVIEW REPORT` before ExitPlanMode is called. Skills that don't run plan reviews (operational skills like `/ship`, `/qa`, `/review`) typically don't operate in plan mode and have no review report to verify; this footer is a no-op for them. Writing the plan file is the one edit allowed in plan mode. -## Brain Context Load -**Skip this entire section if `gbrain` is not on PATH.** - -Extract 2-4 keywords from the user's request. Search the brain: -`gbrain search ""`. Read the top 3 results with -`gbrain get_page ""`. Use that context to inform your analysis. - -If `gbrain search` returns no results or any non-zero exit, proceed -without brain context. Full search/read protocol + examples: -see `docs/gbrain-write-surfaces.md` §Context Load. # /design-review: Design Audit → Fix → Verify @@ -1994,14 +1984,7 @@ staleness detection: if those files are later deleted, the learning can be flagg **Only log genuine discoveries.** Don't log obvious things. Don't log things the user already knows. A good test: would this insight save time in a future session? If yes, log it. -## Save Results to Brain -**Skip this entire section if `gbrain` is not on PATH.** - -If the skill output is worth preserving, save it via -`gbrain put "" --content ""`. Full template -(heredoc body, frontmatter shape, entity-stub instructions, throttle -handling): see `docs/gbrain-write-surfaces.md` §Save Template. ## Additional Rules (design-review specific) diff --git a/investigate/SKILL.md b/investigate/SKILL.md index ecad1582d..6b53b6a93 100644 --- a/investigate/SKILL.md +++ b/investigate/SKILL.md @@ -832,19 +832,7 @@ Fixing symptoms creates whack-a-mole debugging. Every fix that doesn't address r --- -## Brain Context Load -**Skip this entire section if `gbrain` is not on PATH.** - -Extract 2-4 keywords from the user's request. Search the brain: -`gbrain search ""`. Read the top 3 results with -`gbrain get_page ""`. Use that context to inform your analysis. - -If `gbrain search` returns no results or any non-zero exit, proceed -without brain context. Full search/read protocol + examples: -see `docs/gbrain-write-surfaces.md` §Context Load. - -For structured-data extraction requests ("track this", "extract from emails", "build a tracker"), route to GBrain's data-research skill instead: `gbrain call data-research`. ## Phase 1: Root Cause Investigation @@ -1073,28 +1061,7 @@ staleness detection: if those files are later deleted, the learning can be flagg **Only log genuine discoveries.** Don't log obvious things. Don't log things the user already knows. A good test: would this insight save time in a future session? If yes, log it. -## Save Results to Brain -**Skip this entire section if `gbrain` is not on PATH.** - -After completing this skill, save the output: - -```bash -gbrain put "investigations/" --content "$(cat <<'EOF' ---- -title: "Investigation: " -tags: [investigation, ] ---- - -EOF -)" -``` - -Then extract person/org entities and create stub pages for each one. -Throttle errors (exit 1 with "throttle"/"rate limit"/"busy") and any -other non-zero exit are transient — don't retry inline. Full entity-stub -template, throttle handling, and backlink protocol: -see `docs/gbrain-write-surfaces.md` §Save Template. --- diff --git a/office-hours/SKILL.md b/office-hours/SKILL.md index 3d3c7281d..5b23b1d8a 100644 --- a/office-hours/SKILL.md +++ b/office-hours/SKILL.md @@ -880,17 +880,7 @@ You are a **YC office hours partner**. Your job is to ensure the problem is unde --- -## Brain Context Load -**Skip this entire section if `gbrain` is not on PATH.** - -Extract 2-4 keywords from the user's request. Search the brain: -`gbrain search ""`. Read the top 3 results with -`gbrain get_page ""`. Use that context to inform your analysis. - -If `gbrain search` returns no results or any non-zero exit, proceed -without brain context. Full search/read protocol + examples: -see `docs/gbrain-write-surfaces.md` §Context Load. ## Brain Context (preflight) diff --git a/office-hours/sections/design-and-handoff.md b/office-hours/sections/design-and-handoff.md index 30fcc9a6b..4c253e96a 100644 --- a/office-hours/sections/design-and-handoff.md +++ b/office-hours/sections/design-and-handoff.md @@ -209,28 +209,7 @@ Present the reviewed design doc to the user via AskUserQuestion: - B) Revise — specify which sections need changes (loop back to revise those sections) - C) Start over — return to Phase 2 -## Save Results to Brain -**Skip this entire section if `gbrain` is not on PATH.** - -After completing this skill, save the output: - -```bash -gbrain put "office-hours/" --content "$(cat <<'EOF' ---- -title: "Office Hours: " -tags: [design-doc, ] ---- - -EOF -)" -``` - -Then extract person/org entities and create stub pages for each one. -Throttle errors (exit 1 with "throttle"/"rate limit"/"busy") and any -other non-zero exit are transient — don't retry inline. Full entity-stub -template, throttle handling, and backlink protocol: -see `docs/gbrain-write-surfaces.md` §Save Template. ## Brain Calibration Write-Back (Phase 2 / gated) diff --git a/plan-ceo-review/SKILL.md b/plan-ceo-review/SKILL.md index 241a9de06..939b3734f 100644 --- a/plan-ceo-review/SKILL.md +++ b/plan-ceo-review/SKILL.md @@ -1143,17 +1143,7 @@ matches a past learning, display: This makes the compounding visible. The user should see that gstack is getting smarter on their codebase over time. -## Brain Context Load -**Skip this entire section if `gbrain` is not on PATH.** - -Extract 2-4 keywords from the user's request. Search the brain: -`gbrain search ""`. Read the top 3 results with -`gbrain get_page ""`. Use that context to inform your analysis. - -If `gbrain search` returns no results or any non-zero exit, proceed -without brain context. Full search/read protocol + examples: -see `docs/gbrain-write-surfaces.md` §Context Load. ## Brain Context (preflight) diff --git a/plan-ceo-review/sections/review-sections.md b/plan-ceo-review/sections/review-sections.md index f467198fd..71bae4d93 100644 --- a/plan-ceo-review/sections/review-sections.md +++ b/plan-ceo-review/sections/review-sections.md @@ -828,28 +828,7 @@ staleness detection: if those files are later deleted, the learning can be flagg **Only log genuine discoveries.** Don't log obvious things. Don't log things the user already knows. A good test: would this insight save time in a future session? If yes, log it. -## Save Results to Brain -**Skip this entire section if `gbrain` is not on PATH.** - -After completing this skill, save the output: - -```bash -gbrain put "ceo-plans/" --content "$(cat <<'EOF' ---- -title: "CEO Plan: " -tags: [ceo-plan, ] ---- - -EOF -)" -``` - -Then extract person/org entities and create stub pages for each one. -Throttle errors (exit 1 with "throttle"/"rate limit"/"busy") and any -other non-zero exit are transient — don't retry inline. Full entity-stub -template, throttle handling, and backlink protocol: -see `docs/gbrain-write-surfaces.md` §Save Template. ## Brain Calibration Write-Back (Phase 2 / gated) diff --git a/plan-design-review/sections/review-sections.md b/plan-design-review/sections/review-sections.md index a3859eba9..fde4b79f9 100644 --- a/plan-design-review/sections/review-sections.md +++ b/plan-design-review/sections/review-sections.md @@ -531,28 +531,7 @@ staleness detection: if those files are later deleted, the learning can be flagg **Only log genuine discoveries.** Don't log obvious things. Don't log things the user already knows. A good test: would this insight save time in a future session? If yes, log it. -## Save Results to Brain -**Skip this entire section if `gbrain` is not on PATH.** - -After completing this skill, save the output: - -```bash -gbrain put "design-reviews/" --content "$(cat <<'EOF' ---- -title: "Design Review: " -tags: [design-review, ] ---- - -EOF -)" -``` - -Then extract person/org entities and create stub pages for each one. -Throttle errors (exit 1 with "throttle"/"rate limit"/"busy") and any -other non-zero exit are transient — don't retry inline. Full entity-stub -template, throttle handling, and backlink protocol: -see `docs/gbrain-write-surfaces.md` §Save Template. ## Brain Calibration Write-Back (Phase 2 / gated) diff --git a/plan-devex-review/sections/review-sections.md b/plan-devex-review/sections/review-sections.md index 5c5ee0bcd..e4ce30a95 100644 --- a/plan-devex-review/sections/review-sections.md +++ b/plan-devex-review/sections/review-sections.md @@ -769,28 +769,7 @@ staleness detection: if those files are later deleted, the learning can be flagg **Only log genuine discoveries.** Don't log obvious things. Don't log things the user already knows. A good test: would this insight save time in a future session? If yes, log it. -## Save Results to Brain -**Skip this entire section if `gbrain` is not on PATH.** - -After completing this skill, save the output: - -```bash -gbrain put "devex-reviews/" --content "$(cat <<'EOF' ---- -title: "Devex Review: " -tags: [devex-review, ] ---- - -EOF -)" -``` - -Then extract person/org entities and create stub pages for each one. -Throttle errors (exit 1 with "throttle"/"rate limit"/"busy") and any -other non-zero exit are transient — don't retry inline. Full entity-stub -template, throttle handling, and backlink protocol: -see `docs/gbrain-write-surfaces.md` §Save Template. ## Brain Calibration Write-Back (Phase 2 / gated) diff --git a/plan-eng-review/SKILL.md b/plan-eng-review/SKILL.md index 4754ee908..d0de97b77 100644 --- a/plan-eng-review/SKILL.md +++ b/plan-eng-review/SKILL.md @@ -806,17 +806,7 @@ Replace `SKILL_NAME`, `OUTCOME`, and `USED_BROWSE` before running. Skills that run plan reviews (`/plan-*-review`, `/codex review`) include the EXIT PLAN MODE GATE blocking checklist at the end of the skill, which verifies the plan file ends with `## GSTACK REVIEW REPORT` before ExitPlanMode is called. Skills that don't run plan reviews (operational skills like `/ship`, `/qa`, `/review`) typically don't operate in plan mode and have no review report to verify; this footer is a no-op for them. Writing the plan file is the one edit allowed in plan mode. -## Brain Context Load -**Skip this entire section if `gbrain` is not on PATH.** - -Extract 2-4 keywords from the user's request. Search the brain: -`gbrain search ""`. Read the top 3 results with -`gbrain get_page ""`. Use that context to inform your analysis. - -If `gbrain search` returns no results or any non-zero exit, proceed -without brain context. Full search/read protocol + examples: -see `docs/gbrain-write-surfaces.md` §Context Load. # Plan Review Mode diff --git a/plan-eng-review/sections/review-sections.md b/plan-eng-review/sections/review-sections.md index dc6329fab..7592f0a70 100644 --- a/plan-eng-review/sections/review-sections.md +++ b/plan-eng-review/sections/review-sections.md @@ -849,28 +849,7 @@ staleness detection: if those files are later deleted, the learning can be flagg **Only log genuine discoveries.** Don't log obvious things. Don't log things the user already knows. A good test: would this insight save time in a future session? If yes, log it. -## Save Results to Brain -**Skip this entire section if `gbrain` is not on PATH.** - -After completing this skill, save the output: - -```bash -gbrain put "eng-reviews/" --content "$(cat <<'EOF' ---- -title: "Eng Review: " -tags: [eng-review, ] ---- - -EOF -)" -``` - -Then extract person/org entities and create stub pages for each one. -Throttle errors (exit 1 with "throttle"/"rate limit"/"busy") and any -other non-zero exit are transient — don't retry inline. Full entity-stub -template, throttle handling, and backlink protocol: -see `docs/gbrain-write-surfaces.md` §Save Template. ## Brain Calibration Write-Back (Phase 2 / gated) diff --git a/qa/SKILL.md b/qa/SKILL.md index 21a50f9f3..449ceaf98 100644 --- a/qa/SKILL.md +++ b/qa/SKILL.md @@ -846,17 +846,7 @@ branch name wherever the instructions say "the base branch" or ``. --- -## Brain Context Load -**Skip this entire section if `gbrain` is not on PATH.** - -Extract 2-4 keywords from the user's request. Search the brain: -`gbrain search ""`. Read the top 3 results with -`gbrain get_page ""`. Use that context to inform your analysis. - -If `gbrain search` returns no results or any non-zero exit, proceed -without brain context. Full search/read protocol + examples: -see `docs/gbrain-write-surfaces.md` §Context Load. # /qa: Test → Fix → Verify @@ -1686,14 +1676,7 @@ staleness detection: if those files are later deleted, the learning can be flagg **Only log genuine discoveries.** Don't log obvious things. Don't log things the user already knows. A good test: would this insight save time in a future session? If yes, log it. -## Save Results to Brain -**Skip this entire section if `gbrain` is not on PATH.** - -If the skill output is worth preserving, save it via -`gbrain put "" --content ""`. Full template -(heredoc body, frontmatter shape, entity-stub instructions, throttle -handling): see `docs/gbrain-write-surfaces.md` §Save Template. ## Additional Rules (qa-specific) diff --git a/retro/SKILL.md b/retro/SKILL.md index ae5096b11..b02228f3b 100644 --- a/retro/SKILL.md +++ b/retro/SKILL.md @@ -856,17 +856,7 @@ When the user types `/retro`, run this skill. - `/retro global` — cross-project retro across all AI coding tools (7d default) - `/retro global 14d` — cross-project retro with explicit window -## Brain Context Load -**Skip this entire section if `gbrain` is not on PATH.** - -Extract 2-4 keywords from the user's request. Search the brain: -`gbrain search ""`. Read the top 3 results with -`gbrain get_page ""`. Use that context to inform your analysis. - -If `gbrain search` returns no results or any non-zero exit, proceed -without brain context. Full search/read protocol + examples: -see `docs/gbrain-write-surfaces.md` §Context Load. ## Instructions @@ -1247,28 +1237,7 @@ staleness detection: if those files are later deleted, the learning can be flagg **Only log genuine discoveries.** Don't log obvious things. Don't log things the user already knows. A good test: would this insight save time in a future session? If yes, log it. -## Save Results to Brain -**Skip this entire section if `gbrain` is not on PATH.** - -After completing this skill, save the output: - -```bash -gbrain put "retros/" --content "$(cat <<'EOF' ---- -title: "Retro: " -tags: [retro, ] ---- - -EOF -)" -``` - -Then extract person/org entities and create stub pages for each one. -Throttle errors (exit 1 with "throttle"/"rate limit"/"busy") and any -other non-zero exit are transient — don't retry inline. Full entity-stub -template, throttle handling, and backlink protocol: -see `docs/gbrain-write-surfaces.md` §Save Template. ### Step 10: Week-over-Week Trends (if window >= 14d) diff --git a/ship/SKILL.md b/ship/SKILL.md index bdaf55383..3ce9196d6 100644 --- a/ship/SKILL.md +++ b/ship/SKILL.md @@ -842,17 +842,7 @@ branch name wherever the instructions say "the base branch" or ``. --- -## Brain Context Load -**Skip this entire section if `gbrain` is not on PATH.** - -Extract 2-4 keywords from the user's request. Search the brain: -`gbrain search ""`. Read the top 3 results with -`gbrain get_page ""`. Use that context to inform your analysis. - -If `gbrain search` returns no results or any non-zero exit, proceed -without brain context. Full search/read protocol + examples: -see `docs/gbrain-write-surfaces.md` §Context Load. # Ship: Fully Automated Ship Workflow diff --git a/ship/sections/adversarial.md b/ship/sections/adversarial.md index 6099970f9..c7b2321d1 100644 --- a/ship/sections/adversarial.md +++ b/ship/sections/adversarial.md @@ -179,28 +179,7 @@ staleness detection: if those files are later deleted, the learning can be flagg **Only log genuine discoveries.** Don't log obvious things. Don't log things the user already knows. A good test: would this insight save time in a future session? If yes, log it. -## Save Results to Brain -**Skip this entire section if `gbrain` is not on PATH.** - -After completing this skill, save the output: - -```bash -gbrain put "releases/" --content "$(cat <<'EOF' ---- -title: "Release: " -tags: [release, ] ---- - -EOF -)" -``` - -Then extract person/org entities and create stub pages for each one. -Throttle errors (exit 1 with "throttle"/"rate limit"/"busy") and any -other non-zero exit are transient — don't retry inline. Full entity-stub -template, throttle handling, and backlink protocol: -see `docs/gbrain-write-surfaces.md` §Save Template. ### Refresh learnings for the headline feature on this branch