Merge origin/main into /spec branch — retag v1.45.0.0 → v1.47.0.0

main moved to v1.46.0.0 (gstack v2 foundation, eval-first floor across
51 skills) while this branch was at v1.45.0.0. v1.46 also reserved
v1.45.0.0 for the design daemon feature. Retag this branch's release
v1.45.0.0 → v1.47.0.0 so it lands cleanly on top of main.

Conflict resolutions:
- VERSION: 1.47.0.0 (MINOR continues on top of main's 1.46.0.0; this
  branch is also a MINOR per scale-aware rules — new skill capability).
- CHANGELOG: rewrite this branch's release header v1.45.0.0 → v1.47.0.0.
  Keep both main entries above main's older history.

Adapts to main's eval-first floor (v1.46.0.0 test/skill-coverage-matrix.ts
+ test/skill-coverage-floor.test.ts):
- Register /spec in SKILL_COVERAGE with 3 gate entries + 2 periodic.
- Skill catalog grows 51 → 52. Floor 6/6 structural checks pass.
- Catalog tokens: 4045 → 4116 (+71 for /spec, within v1.46's ≤7000 budget).
- Trim spec frontmatter description to single-paragraph block form to
  respect v1.46's catalog-trim intent (was 14 lines / ~900 chars,
  now 5 lines / ~350 chars; routing prose stays in body sections).
- 363/363 gate-tier tests pass across skill-coverage-floor (309) +
  skill-coverage-matrix (10) + skill-size-budget (3) + parity-suite (4) +
  spec-template-invariants (35) + spec-template-sync (2).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

spec/SKILL.md

@@ -1,18 +1,7 @@
 ---
 name: spec
 version: 0.1.0
-description: |
-  Turn vague intent into a precise, executable spec in five phases. Pipe the spec
-  into a spawned Claude Code agent with `--execute`, dedupe against existing issues
-  with `--dedupe`, or hand off to GitHub. Every spec passes a codex quality gate
-  before file. Interrogates the user in strict phases — why, scope, technical,
-  draft, final — and refuses to produce an issue until ambiguity is gone. Use
-  after /office-hours has settled the shape of an idea, or any time the user
-  describes work that's not yet backlog-ready.
-  Use when asked to "spec this out", "file an issue", "write up a ticket", "make
-  this a GitHub issue", or "turn this into a backlog item". e.g., type `/spec` on
-  a vague bug → 5-phase interrogation → filed issue → spawned agent in ~4 minutes.
-  (gstack)
+description: Turn vague intent into a precise, executable spec in five phases. (gstack)
 allowed-tools:
   - Bash
   - Read
@@ -30,6 +19,14 @@ triggers:
 <!-- AUTO-GENERATED from SKILL.md.tmpl — do not edit directly -->
 <!-- Regenerate: bun run gen:skill-docs -->
 
+
+## When to invoke this skill
+
+Files the issue,
+optionally spawns a Claude Code agent in a fresh worktree, and lets /ship close
+the source issue on merge. Use when asked to "spec this out", "file an issue",
+"write up a ticket", "make this a GitHub issue", or "turn this into a backlog item".
+
 ## Preamble (run first)
 
 ```bash
@@ -570,84 +567,7 @@ Applies to AskUserQuestion, user replies, and findings. AskUserQuestion Format i
 - User-turn override wins: if the current message asks for terse / no explanations / just the answer, skip this section.
 - Terse mode (EXPLAIN_LEVEL: terse): no glosses, no outcome-framing layer, shorter responses.
 
-Jargon list, gloss on first use if the term appears:
-- idempotent
-- idempotency
-- race condition
-- deadlock
-- cyclomatic complexity
-- N+1
-- N+1 query
-- backpressure
-- memoization
-- eventual consistency
-- CAP theorem
-- CORS
-- CSRF
-- XSS
-- SQL injection
-- prompt injection
-- DDoS
-- rate limit
-- throttle
-- circuit breaker
-- load balancer
-- reverse proxy
-- SSR
-- CSR
-- hydration
-- tree-shaking
-- bundle splitting
-- code splitting
-- hot reload
-- tombstone
-- soft delete
-- cascade delete
-- foreign key
-- composite index
-- covering index
-- OLTP
-- OLAP
-- sharding
-- replication lag
-- quorum
-- two-phase commit
-- saga
-- outbox pattern
-- inbox pattern
-- optimistic locking
-- pessimistic locking
-- thundering herd
-- cache stampede
-- bloom filter
-- consistent hashing
-- virtual DOM
-- reconciliation
-- closure
-- hoisting
-- tail call
-- GIL
-- zero-copy
-- mmap
-- cold start
-- warm start
-- green-blue deploy
-- canary deploy
-- feature flag
-- kill switch
-- dead letter queue
-- fan-out
-- fan-in
-- debounce
-- throttle (UI)
-- hydration mismatch
-- memory leak
-- GC pause
-- heap fragmentation
-- stack overflow
-- null pointer
-- dangling pointer
-- buffer overflow
+Curated jargon list lives at `~/.claude/skills/gstack/scripts/jargon-list.json` (80+ terms). On the first jargon term you encounter this session, Read that file once; treat the `terms` array as the canonical list. The list is repo-owned and may grow between releases.
 
 
 ## Completeness Principle — Boil the Lake
@@ -1554,84 +1474,7 @@ Applies to AskUserQuestion, user replies, and findings. AskUserQuestion Format i
 - User-turn override wins: if the current message asks for terse / no explanations / just the answer, skip this section.
 - Terse mode (EXPLAIN_LEVEL: terse): no glosses, no outcome-framing layer, shorter responses.
 
-Jargon list, gloss on first use if the term appears:
-- idempotent
-- idempotency
-- race condition
-- deadlock
-- cyclomatic complexity
-- N+1
-- N+1 query
-- backpressure
-- memoization
-- eventual consistency
-- CAP theorem
-- CORS
-- CSRF
-- XSS
-- SQL injection
-- prompt injection
-- DDoS
-- rate limit
-- throttle
-- circuit breaker
-- load balancer
-- reverse proxy
-- SSR
-- CSR
-- hydration
-- tree-shaking
-- bundle splitting
-- code splitting
-- hot reload
-- tombstone
-- soft delete
-- cascade delete
-- foreign key
-- composite index
-- covering index
-- OLTP
-- OLAP
-- sharding
-- replication lag
-- quorum
-- two-phase commit
-- saga
-- outbox pattern
-- inbox pattern
-- optimistic locking
-- pessimistic locking
-- thundering herd
-- cache stampede
-- bloom filter
-- consistent hashing
-- virtual DOM
-- reconciliation
-- closure
-- hoisting
-- tail call
-- GIL
-- zero-copy
-- mmap
-- cold start
-- warm start
-- green-blue deploy
-- canary deploy
-- feature flag
-- kill switch
-- dead letter queue
-- fan-out
-- fan-in
-- debounce
-- throttle (UI)
-- hydration mismatch
-- memory leak
-- GC pause
-- heap fragmentation
-- stack overflow
-- null pointer
-- dangling pointer
-- buffer overflow
+Curated jargon list lives at `~/.claude/skills/gstack/scripts/jargon-list.json` (80+ terms). On the first jargon term you encounter this session, Read that file once; treat the `terms` array as the canonical list. The list is repo-owned and may grow between releases.
 
 
 ## Completeness Principle — Boil the Lake

spec/SKILL.md.tmpl

@@ -2,16 +2,10 @@
 name: spec
 version: 0.1.0
 description: |
-  Turn vague intent into a precise, executable spec in five phases. Pipe the spec
-  into a spawned Claude Code agent with `--execute`, dedupe against existing issues
-  with `--dedupe`, or hand off to GitHub. Every spec passes a codex quality gate
-  before file. Interrogates the user in strict phases — why, scope, technical,
-  draft, final — and refuses to produce an issue until ambiguity is gone. Use
-  after /office-hours has settled the shape of an idea, or any time the user
-  describes work that's not yet backlog-ready.
-  Use when asked to "spec this out", "file an issue", "write up a ticket", "make
-  this a GitHub issue", or "turn this into a backlog item". e.g., type `/spec` on
-  a vague bug → 5-phase interrogation → filed issue → spawned agent in ~4 minutes.
+  Turn vague intent into a precise, executable spec in five phases. Files the issue,
+  optionally spawns a Claude Code agent in a fresh worktree, and lets /ship close
+  the source issue on merge. Use when asked to "spec this out", "file an issue",
+  "write up a ticket", "make this a GitHub issue", or "turn this into a backlog item".
   (gstack)
 allowed-tools:
   - Bash