v1.33.0.1 feat(build): bump build skill version to 1.22.0 and regenerate docs

.github/workflows/build-skill-gate.yml

@@ -0,0 +1,66 @@
+name: Build Skill TDD Gate
+
+on:
+  pull_request:
+    branches: [main]
+    paths:
+      - "build/**"
+      - "bin/gstack-build"
+      - "scripts/gen-skill-docs.ts"
+      - "scripts/discover-skills.ts"
+      - "scripts/host-config.ts"
+      - "scripts/models.ts"
+      - "scripts/resolvers/**"
+      - "hosts/**"
+      - "test/gen-skill-docs.test.ts"
+      - "package.json"
+      - "bun.lock"
+      - ".github/workflows/build-skill-gate.yml"
+  push:
+    branches: [main]
+    paths:
+      - "build/**"
+      - "bin/gstack-build"
+      - "scripts/gen-skill-docs.ts"
+      - "scripts/discover-skills.ts"
+      - "scripts/host-config.ts"
+      - "scripts/models.ts"
+      - "scripts/resolvers/**"
+      - "hosts/**"
+      - "test/gen-skill-docs.test.ts"
+      - "package.json"
+      - "bun.lock"
+      - ".github/workflows/build-skill-gate.yml"
+  workflow_dispatch:
+
+concurrency:
+  group: build-skill-gate-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-skill-tdd-gate:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Generate all host skill docs
+        run: bun run gen:skill-docs --host all
+
+      - name: Verify generated docs are fresh
+        run: |
+          git diff --exit-code || {
+            echo "Generated skill docs are stale. Run: bun run gen:skill-docs --host all"
+            exit 1
+          }
+
+      - name: Run deterministic build skill gate
+        run: bun run test:build-skill

.github/workflows/version-gate.yml

@@ -34,7 +34,7 @@ jobs:
           set -euo pipefail
           PR_VERSION=$(cat VERSION | tr -d '[:space:]')
           BASE_REF="${{ github.event.pull_request.base.ref }}"
-          git fetch origin "$BASE_REF" --depth=1 --quiet || true
+          git fetch origin "$BASE_REF:refs/remotes/origin/$BASE_REF" --depth=1 --quiet || true
           BASE_VERSION=$(git show "origin/$BASE_REF:VERSION" 2>/dev/null | tr -d '[:space:]' || echo "0.0.0.0")
           {
             echo "pr_version=$PR_VERSION"
@@ -48,6 +48,15 @@ jobs:
           LEVEL=$(bun run scripts/detect-bump.ts "${{ steps.versions.outputs.base_version }}" "${{ steps.versions.outputs.pr_version }}")
           echo "level=$LEVEL" >> "$GITHUB_OUTPUT"
 
+      - name: Detect fork version repair
+        id: fork_repair
+        run: |
+          IS_REPAIR=$(bun run scripts/detect-fork-version-repair.ts \
+            "${{ steps.versions.outputs.base_ref }}" \
+            "${{ steps.versions.outputs.base_version }}" \
+            "${{ steps.versions.outputs.pr_version }}")
+          echo "is_repair=$IS_REPAIR" >> "$GITHUB_OUTPUT"
+
       - name: Query queue (util) — fail-open on error
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -70,5 +79,6 @@ jobs:
       - name: Compare PR VERSION to next free slot
         env:
           PR_VERSION: ${{ steps.versions.outputs.pr_version }}
+          FORK_VERSION_REPAIR: ${{ steps.fork_repair.outputs.is_repair }}
         run: |
           bun run scripts/compare-pr-version.ts next.json "${{ github.event.pull_request.number }}"

.gitignore

@@ -9,6 +9,7 @@ bin/gstack-global-discover
 .claude/skills/
 .claude/scheduled_tasks.lock
 .claude/*.lock
+.claude/settings.local.json
 .agents/
 .factory/
 .kiro/
@@ -26,6 +27,7 @@ extension/lib/xterm.js
 extension/lib/xterm.css
 extension/lib/xterm-addon-fit.js
 .gstack-worktrees/
+.worktrees/
 /tmp/
 *.log
 *.bun-build
@@ -37,3 +39,4 @@ supabase/.temp/
 
 # Throughput analysis — local-only, regenerate via scripts/garry-output-comparison.ts
 docs/throughput-*.json
+build/configure.cm

AGENTS.md

@@ -18,6 +18,10 @@ Invoke them by name (e.g., `/office-hours`).
 | `/plan-eng-review` | Lock architecture, data flow, edge cases, and tests. |
 | `/plan-design-review` | Rate each design dimension 0-10, explain what a 10 looks like. |
 | `/plan-devex-review` | DX-mode review: TTHW, magical moments, friction points, persona traces. |
+| `/plan-domain-review` | Domain-model review for bounded contexts, state, ownership, and events. |
+| `/plan-api-review` | API contract review for REST/gRPC/async interfaces and compatibility. |
+| `/plan-arch-review` | Second-pass software architecture review after eng review. |
+| `/plan-modernization-review` | Modernization review for modularization, migrations, and rollout hazards. |
 | `/plan-tune` | Self-tune AskUserQuestion sensitivity per question. |
 | `/autoplan` | One command runs CEO → design → eng → DX review. |
 | `/design-consultation` | Build a complete design system from scratch. |
@@ -28,6 +32,7 @@ Invoke them by name (e.g., `/office-hours`).
 |-------|-------------|
 | `/review` | Pre-landing PR review. Finds bugs that pass CI but break in prod. |
 | `/codex` | Second opinion via OpenAI Codex. Review, challenge, or consult modes. |
+| `/build` | Autonomous gstack execution loop for living implementation plans. |
 | `/investigate` | Systematic root-cause debugging. No fixes without investigation. |
 | `/design-review` | Live-site visual audit + fix loop with atomic commits. |
 | `/design-shotgun` | Generate multiple AI design variants, comparison board, iterate. |
@@ -89,6 +94,7 @@ Invoke them by name (e.g., `/office-hours`).
 ```bash
 bun install              # install dependencies
 bun test                 # run free tests (no API spend)
+bun run test:build-skill # focused verification for /build skill changes
 bun run test:windows     # curated Windows-safe subset (runs on windows-latest)
 bun run build            # generate docs + compile binaries
 bun run gen:skill-docs   # regenerate SKILL.md files from templates

CLAUDE.md

@@ -119,6 +119,9 @@ gstack/
 ├── codex/           # /codex skill (multi-AI second opinion via OpenAI Codex CLI)
 ├── land-and-deploy/ # /land-and-deploy skill (merge → deploy → canary verify)
 ├── office-hours/    # /office-hours skill (YC Office Hours — startup diagnostic + builder brainstorm)
+├── build/           # /build skill (autonomous plan executor: TDD loop, dual-impl, Codex review)
+│   ├── SKILL.md, SKILL.md.tmpl
+│   └── orchestrator/  # gstack-build CLI: cli.ts, phase-runner.ts, sub-agents.ts, worktree.ts, etc.
 ├── investigate/     # /investigate skill (systematic root-cause debugging)
 ├── retro/           # Retrospective skill (includes /retro global cross-project mode)
 ├── bin/             # CLI utilities (gstack-repo-mode, gstack-slug, gstack-config, etc.)
@@ -638,6 +641,17 @@ above, plus:
   community PR, name the contributor with `Contributed by @username`. Contributors
   did real work. Thank them publicly every time, no exceptions.
 
+## Fork versioning rule
+
+**Never bump the top-level `VERSION` file in this repo when working on fork-specific skills.**
+
+This repo (`anbangr/gstack`) is a personal fork of `garrytan/gstack`. The top-level `VERSION` file tracks the fork's release state relative to upstream. Bumping it creates divergence that makes `gstack-update-check` output confusing (`UPGRADE_AVAILABLE` with the local version higher than upstream).
+
+**The rule:**
+- Editing or building a custom skill (e.g. `build/SKILL.md.tmpl`)? Bump only the `version:` frontmatter field inside that skill file (e.g. `version: 1.19.0`). Do NOT touch `VERSION` or `package.json` version.
+- Merging upstream? Sync `VERSION` and `package.json` to upstream's version after the merge.
+- Only bump `VERSION` when merging or syncing with upstream, never for fork-local skill work.
+
 ## AI effort compression
 
 When estimating or discussing effort, always show both human-team and CC+gstack time: