@joshuafolkken/kit 1.1514.0 → 1.1784.0

package/eslint/base.js

@@ -34,7 +34,7 @@ import { unicorn_rules, unicorn_test_rules } from './rules/unicorn.js'
 const FILE_PATTERNS = {
 	d_ts: ['**/*.d.ts'],
 	typescript: ['**/*.ts', '**/*.tsx'],
-	scripts: ['scripts/**/*.ts', 'scripts/**/*.js'],
+	scripts: ['scripts/**/*.ts', 'scripts/**/*.js', 'tools/**/*.ts', 'tools/**/*.js'],
 	// joshuafolkken/kit#1414: `**/*.spec.ts` is deliberately absent. The same config bans that name
 	// outright, so handing it the test relaxation (`max-lines-per-function` 35 and the rest) is the
 	// config contradicting itself, and it is what makes `*.spec.ts` read as supported. A banned file

package/lefthook/base.yml

@@ -118,7 +118,9 @@ pre-push:
     # of every changed file it passed on and the commit that map is a diff against; where that record
     # covers the tree this push carries — and the working tree is clean, so the tree and the commit
     # are the same thing — the suite is not run again. Measured: 15.9s of a 40s `josh git -y`, spent
-    # 40 seconds after the same tree went green. Anything else runs the whole suite exactly as before,
+    # 40 seconds after the same tree went green. Since kit#4065 the gate's unit check runs only the
+    # tests the change can reach, so such a push runs no local whole suite at all; CI's sharded whole
+    # suite is what covers the rest before the merge. Anything else runs the whole suite exactly as before,
     # and `JOSH_PRE_PUSH_FORCE=1 git push` runs it regardless. A push whose last gate ran before
     # `josh bump` rewrote package.json is one of those "anything else" cases, not a regression.
     test-unit:

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1514.0",
+  "version": "1.1784.0",
   "name": "@joshuafolkken/kit",
   "description": "Development toolkit for AI-assisted projects: formatting, AI assistant rules and a Git/GitHub Issue workflow for any repository, plus lint, type check, tests and hooks for Node projects",
   "keywords": [
@@ -57,63 +57,23 @@
     ".coderabbit.yaml",
     ".gitattributes",
     ".mcp.json",
-    ".ncurc.json",
     ".prettierignore",
     "pnpm-workspace.yaml",
     ".pnpmfile.mjs",
     "tsconfig.sonar.json",
     "playwright.config.ts",
     "!**/*.test.ts",
-    "!scripts/gh/gh-subcommand-guard.ts",
     "!**/*.spec.ts",
     "!**/*-fixture*.ts",
     "!**/__snapshots__",
     "!**/*.golden.txt",
-    "!scripts/eval",
-    "!scripts/time",
-    "!scripts/cost",
-    "!scripts/cost-audit",
-    "!scripts/retrospective",
-    "!scripts/dogfood",
-    "!scripts/metrics",
-    "!scripts/test/classify-isolation.ts",
-    "!scripts/test/hanging-execa.ts",
-    "!scripts/test/http-fault-injection.ts",
-    "!scripts/test/josh-harness*.ts",
-    "!scripts/test/pure-files.ts",
-    "!scripts/test/test-machine-guard.ts",
-    "!scripts/test/test-network-guard.ts",
-    "!scripts/test/test-repository-guard.ts",
-    "!scripts/test/test-state-guard.ts",
-    "!scripts/test/test-stdout-guard.ts",
-    "!scripts/test/test-telegram-guard.ts",
-    "!scripts/test/unit-guard-environment.ts",
-    "!scripts/test/unit-projects.ts",
-    "!scripts/test/untested-sources.ts",
-    "!scripts/test/vitest-include-globs.ts",
-    "!scripts/build/shim-shell.ts",
-    "!scripts/claude/skill-meta.ts",
-    "!scripts/exports/member-usage.ts",
-    "!scripts/exports/namespace-escape.ts",
-    "!scripts/exports/namespace-members.ts",
-    "!scripts/exports/unused-members.ts",
-    "!scripts/document/generate-catalog.ts",
-    "!scripts/document/generate-command-usage.ts",
-    "!scripts/document/issue-citation-budget.ts",
-    "!scripts/document/retired-phrases.ts",
-    "!scripts/document/review-agent-type.ts",
-    "!scripts/document/single-source.ts",
-    "!scripts/hooks/hook-bundle-ready.ts",
-    "!scripts/hooks/prompt-hooks.ts",
-    "!scripts/josh/josh-script-reader.ts",
-    "!scripts/package/engine-range.ts",
-    "!scripts/package/production-dependency-graph.ts",
-    "!scripts/rules/delivered-rules-harness.ts",
-    "!scripts/rules/top-level-scripts-guard.ts"
+    "!dist/hooks/.inputs-verified.json*",
+    "!dist/.hooks-staging-*"
   ],
   "imports": {
     "#eslint/*": "./eslint/*",
     "#scripts/*": "./scripts/*.ts",
+    "#tools/*": "./tools/*.ts",
     "#playwright-config": "./playwright.config.ts",
     "#ports": "./ports/index.js",
     "#ports/*": "./ports/*.ts"
@@ -256,7 +216,7 @@
     "@types/semver": "^7.8.0",
     "cspell": "^10.4.0",
     "esbuild": "^0.28.2",
-    "eslint": "^10.12.0",
+    "eslint": "^10.13.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.5",
     "eslint-plugin-import-x": "^4.17.1",
@@ -264,6 +224,7 @@
     "eslint-plugin-sonarjs": "^4.2.2",
     "eslint-plugin-unicorn": "^78.0.0",
     "eslint_d": "^15.0.3",
+    "fast-check": "^4.10.2",
     "globals": "^17.13.0",
     "lefthook": "^2.2.2",
     "prettier": "^3.9.10",
@@ -274,13 +235,14 @@
     "secretlint": "^13.0.7",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.71.2",
-    "vitest": "^5.0.4"
+    "vitest": "^5.0.5"
   },
   "dependencies": {
     "cli-spinners": "^3.4.0",
     "csv-parse": "^7.0.3",
     "execa": "^10.1.1",
-    "js-yaml": "^5.4.3",
+    "flatted": "^3.4.4",
+    "js-yaml": "^5.5.0",
     "jsonc-parser": "^3.3.1",
     "ora": "^9.4.1",
     "semver": "^7.8.5",
@@ -292,7 +254,7 @@
   "devEngines": {
     "packageManager": {
       "name": "pnpm",
-      "version": "12.13.0+sha512.1e55719bf26e809dce5c5084fdebaa64efb3da9038ae5d68a9f8a68311f1a45841c8c3b76a37298c3b66f6bcc80409a9b7f33c78a7168a3e90fb65a5d8235ae4",
+      "version": "12.14.0+sha512.c18ba6d87993d3d164cb5e8948f32b2c06ee854487e06cd8d86781342fb3e5bb4634367034711e86802baa9c37bea906ce1929ad08d70884c97d801df13389a6",
       "onFail": "download"
     }
   },

package/pnpm-workspace.yaml

@@ -8,8 +8,10 @@ allowBuilds:
   '@joshuafolkken/kit': false # project postinstall handles lefthook install
 
 # pnpm 12 reads these settings from this file only; the same lines in .npmrc are ignored (kit #3267).
-# A release must be a day old before pnpm resolves it, and an unsatisfied `engines` fails the install.
-minimumReleaseAge: 1440
+# A release must be three days old before pnpm resolves it, and an unsatisfied `engines` fails the
+# install. `josh init` / `josh sync` mirror the window to `.aikido` and to Dependabot's `cooldown`
+# (kit #4023): an upstream hijack can take days to come to light, so one day is not enough.
+minimumReleaseAge: 4320
 engineStrict: true
 
 # Skip the install-time supply-chain re-verification of the already-committed, reviewed lockfile.

package/prompts/coding-standards.md

@@ -1,6 +1,6 @@
 # コーディング指針 — lint では表せない書き方
 
-関数の構文・品質上限・型安全・早期 return・マジックナンバーは `CLAUDE.md` → "Critical Conventions (non-standard — always apply)"、lint・型検査の実行は `CLAUDE.md` → "Code Change Rules"（`pnpm josh gate`、実装中は `pnpm josh lint:related` / `pnpm josh test:related`）に従う。ここにない命名の細目（クラスのプロパティ・メソッドの `snake_case` など）は `eslint/rules/naming-convention.js` が持つ。**`function` 構文（アロー関数を使わない）と早期 return の 1 行形式は lint が検査しない**ので、書き手とレビューが確かめる。
+関数の構文・品質上限・型安全・早期 return・マジックナンバーは `CLAUDE.md` → "Critical Conventions (non-standard — always apply)"、lint・型検査の実行は `CLAUDE.md` → "Code Change Rules"（`pnpm josh gate`、実装中は `pnpm josh lint:related` / `pnpm josh test:related`）に従う。ここにない命名の細目（クラスのプロパティ・メソッドの `snake_case` など）は `eslint/rules/naming-convention.js` が持つ。`function` 構文と早期 return の 1 行形式は lint が検査する。
 
 ## Conventions
 

package/prompts/collaboration-workflow/file-edits.md

@@ -1,8 +1,6 @@
 ## ファイル編集はコマンド本文に本文を載せない
 
-`CLAUDE.md` からは [`rule-delivery.md`](./rule-delivery.md) →「配送されている規則」を経て届く。
-
-`pnpm josh rule:guard`（file-body の行）が、既存ファイルを書き戻すヒアドキュメント・書き込むインタプリタ heredoc / `node -e`・書き込むスクリプトを作るヒアドキュメント・`perl -0pi -e` を拒否する。ガードに見えない Edit / Write の全文書き直しと `sed -i` は以下に従う。
+`pnpm josh rule:list` の `file-body` 行が、既存ファイルを書き戻すヒアドキュメント・書き込むインタプリタ heredoc / `node -e`・書き込むスクリプトを作るヒアドキュメント・`perl -0pi -e` を拒否する。ガードに見えない Edit / Write の全文書き直しと `sed -i` は以下に従う。
 
 ### 何を禁じているか
 
@@ -52,7 +50,3 @@ PY
 | `cat > new-file <<'EOF'`（新規、長文なら Write） | 可                  |
 | `cat > edit.py <<'EOF'`（書き込むスクリプト）    | 不可                |
 | 読み取り（`cat` / `sed -n` / `grep`）            | 可                  |
-
-### なぜコストが二重になるか
-
-書き戻す形は本文がコマンドとファイルの両方に載り、コマンドは以降の全リクエストで読み直される。

package/prompts/collaboration-workflow/issue-citation.md

@@ -23,4 +23,4 @@
 
 ### 停止時の担保（joshuafolkken/kit#2247）
 
-`Stop` フック `pnpm josh stop:guard` は返信の地の文に裸の `#N` があると、`issue:cite` と同じ処理で引用行を作り `systemMessage` として表示する（モデルの手番は使わない）。引用できない番号があったときだけ停止をブロックし、`pnpm josh issue:cite <N...>` の実行形を差し戻す。差し戻されたらその実行形で引用し直す（検出が外す範囲は [docs/josh-commands.md](https://github.com/joshuafolkken/kit/blob/main/docs/josh-commands.md) の `josh stop:guard`）。
+裸の `#N` は `pnpm josh stop:guard` が引用行にする。差し戻されたら、その実行形で引用し直す（[docs/josh-commands.md](https://github.com/joshuafolkken/kit/blob/main/docs/josh-commands.md) の `josh stop:guard`）。

package/prompts/collaboration-workflow/issue-template.md

@@ -1,12 +1,14 @@
 ## Step 1: Issue 作成テンプレ
 
-タイトルは簡潔で明瞭な英語にする（「出力の言語（`JOSH_SESSION_LANG`）」の例外）。日本語や改善できるタイトルは実装開始前に `gh api -X PATCH repos/{owner}/{repo}/issues/<N> -f title="<title>"` で書き換える。本文は次のテンプレートの節をすべて含める:
+タイトルは簡潔で明瞭な英語にする（「出力の言語（`JOSH_SESSION_LANG`）」の例外）。日本語や改善できるタイトルは実装開始前に `pnpm josh issue:plan <N> --body-file <path> --title "<title>"` で計画と一緒に書き換える。本文は次のテンプレートの節をすべて含める:
 
 ````md
 ## 背景
 
 <不具合なら `- 種別: 不具合`、そうでなければ `- 種別: 非不具合` を宣言する>
+<不具合なら `- 原因: #<PR>`、追えなければ `- 原因: 不明（<理由>）` を宣言する>
 <人の判断が要らなければ `- 人の判断: 不要`、要るなら `- 人の判断: 要（<方針の判断 / 外部アカウント / 目視確認>）` を宣言する>
+<任意。`- 優先度: 緊急（条件 <1-3> / 短縮 <値>）`、`- 優先度: 高（<根拠>）`、`- 優先度: 通常` のどれか。無ければ通常>
 
 <なぜ必要か>
 
@@ -51,6 +53,7 @@
 - 1 回あたりの得: <値>
 - 外れたときの損: <値>
 - 出典: <`pnpm josh lane:stats` → 値>
+- 1 マージあたりの短縮: <分>（レーン中央値 <分> の <%>）
 
 ## Origin
 
@@ -59,17 +62,32 @@
 
 ### `## 背景` 直下の宣言と分類ラベル
 
-起票は `pnpm josh issue:file "<title>" --body-file <本文ファイル> --depth <n>` で行い、本文の検査（`pnpm josh issue:lint <path>` と同じ）と下表のラベル付与はコマンドが行う。**宣言は起票者が選ぶ。** `- 人の判断:` の行は必須で、`issue:file` が検査し `auto-ok` の判定に使う（`scripts/issue/issue-auto-ok.ts`、`docs/how-to/run-backlog.md`）。`不要` を宣言する起票には `--label run:lane`（kit 自身の検証の不具合なら `run:solo`）も付ける — 無ければ `issue:file` が拒否する。
-
-| 宣言                   | 付くラベル                        | 選ぶ基準                                                   |
-| ---------------------- | --------------------------------- | ---------------------------------------------------------- |
-| `- 種別: 不具合`       | `bug`                             | 報告された症状を直す（無ければ `- 種別: 非不具合`）        |
-| `- 目的: 機能追加`     | `enhancement`                     | 新しい機能。修正・文書・依存更新・保守には書かない         |
-| `- 目的: 機能改善`     | `enhancement`                     | 既存機能の改善。目的が曖昧なら受け入れ条件を具体化してから |
-| `- 目的: 時間短縮`     | `enhancement`                     | 所要時間を短くする。`## 期待効果` の 4 行が必須            |
-| `- 互換性: 破壊的変更` | `breaking-change`                 | 契約を変える。移行措置があっても書き、廃止対象と影響を書く |
-| `- 種別: 振る舞い変更` | なし                              | AI の振る舞いを変える。下の 3 見出しが必須                 |
-| `- 人の判断: 不要`     | `auto-ok`（除外ラベルが無ければ） | 方針の判断・外部アカウント・目視確認のどれも要らない       |
+起票は `pnpm josh issue:file "<title>" --body-file <本文ファイル>` で行い、本文の検査（`pnpm josh issue:lint <path>` と同じ）と下表のラベル付与はコマンドが行う。**宣言は起票者が選ぶ。** `- 人の判断:` の行は必須で、`issue:file` が検査し `auto-ok` の判定に使う（`scripts/issue/issue-auto-ok.ts`、`docs/how-to/run-backlog.md`）。`不要` を宣言する起票には `--label run:lane`（kit 自身の検証が `main` で毎回決まって誤った答えを出す不具合なら `run:solo`。時々出る誤判定は `run:lane` と `priority:critical`）も付ける — 無ければ `issue:file` が拒否する。
+
+| 宣言                                          | 付くラベル                        | 選ぶ基準                                                                              |
+| --------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------- |
+| `- 種別: 不具合`                              | `bug`                             | 報告された症状を直す（無ければ `- 種別: 非不具合`）                                   |
+| `- 目的: 機能追加`                            | `enhancement`                     | 新しい機能。修正・文書・依存更新・保守には書かない                                    |
+| `- 目的: 機能改善`                            | `enhancement`                     | 既存機能の改善。目的が曖昧なら受け入れ条件を具体化してから                            |
+| `- 目的: 時間短縮`                            | `enhancement`                     | 所要時間を短くする。`## 期待効果` の 4 行が必須                                       |
+| `- 互換性: 破壊的変更`                        | `breaking-change`                 | 契約を変える。移行措置があっても書き、廃止対象と影響を書く                            |
+| `- 種別: 振る舞い変更`                        | なし                              | AI の振る舞いを変える。下の 3 見出しが必須                                            |
+| `- 人の判断: 不要`                            | `auto-ok`（除外ラベルが無ければ） | 方針の判断・外部アカウント・目視確認のどれも要らない                                  |
+| `- 実施可能条件: #<PR> のマージ後 <K> マージ` | `not-before`（待つ間）            | 追跡計測。元の PR のマージ後に lane ledger が K 件のマージを記録するまで着手しない    |
+| `- 実施可能日: <UTC>`                         | `not-before`（待つ間）            | 外部の期限など暦そのものに意味がある待ち（`YYYY-MM-DDTHH:MMZ`）。追跡計測には使わない |
+| `- 優先度: 緊急（…）`                         | `priority:critical`               | 下の A か B。条件番号か短縮値を括弧に書く                                             |
+| `- 優先度: 高（…）`                           | `priority:high`                   | 下の C・D・E のどれか。根拠を括弧に書く                                               |
+| `- 優先度: 通常`                              | なし                              | どれにも当たらない（宣言が無いときも同じ）                                            |
+
+優先度の基準（`scripts/issue/issue-priority.ts`）。`kickoff new critical` / `high` と打った優先度があれば本文は判定しない:
+
+- A. 割り込み起票の 3 条件のどれか（`wip-cap.md` →「3 条件 — 該当するかは判断ではない」）
+- B. 1 マージあたりの短縮がレーン中央値の 10% 以上
+- C. 同じく 3% 以上 10% 未満
+- D. 人が示した期限や方針がある
+- E. ほかの open Issue 2 件以上の前提（blocked-by）になっている
+- 短縮は `効く率 × 1 回あたりの得 × 1 マージあたりの回数`、中央値は `pnpm josh lane:stats` の `lane median` 列。`- 目的: 時間短縮` の Issue は `- 1 マージあたりの短縮:` 行に % を書く。`issue:file` は行が無いか % が無ければ拒否し、その % から下限（B なら緊急、C なら高）を出して、それより低い宣言も拒否する
+- 根拠の無い `緊急` / `高` も `issue:file` が拒否する
 
 - **持ち主の意図と違う動きは、コード・コメント・テストに書かれた設計どおりでも `- 種別: 不具合` とする。** 例: コメントとテストに固定されたまま意図より広く働く自動付与、文書だけでも意図と違う分類を生む基準
 - `- 種別: 不具合` の回帰テストは、利用者が症状を見たのと同じ粒度で書く。修正前のツリーでも緑になるテストは `pnpm josh git -y` が拒否する（joshuafolkken/kit#2448）
@@ -100,9 +118,8 @@
 
 `josh` が使えない環境での手作業手順:
 
-1. 子 Issue をすべて起票し、番号を控える。
-2. ラベルを用意する: `gh api repos/{owner}/{repo}/labels -f name=epic -f color=5319e7 -f description="Tracks a batch of child issues from one split" --silent 2>/dev/null || true`
-3. epic を作り、`id` ではなく **number** を控える: `gh api repos/{owner}/{repo}/issues -f title="<epic-title>" -f 'labels[]=epic' -F body=@<body-file> --jq .number`。本文は次の形にする（順序がなければ `Dependencies` に `None — the children are independent; any execution order works.` と書く）:
+1. 子 Issue をすべて起票し、番号を控える。`epic` ラベルは `josh sync` が用意する。
+2. epic を作り、`id` ではなく **number** を控える: `gh api repos/{owner}/{repo}/issues -f title="<epic-title>" -f 'labels[]=epic' -F body=@<body-file> --jq .number`。本文は次の形にする（順序がなければ `Dependencies` に `None — the children are independent; any execution order works.` と書く）:
 
    ```md
    ## Split rationale
@@ -123,4 +140,4 @@
    - [ ] #102 <title>
    ```
 
-4. 順序があるときだけ、別ステップで依存を足す（Issue 番号ではなく database id を渡す）: `gh api repos/{owner}/{repo}/issues/<N2>/dependencies/blocked_by -F issue_id="$(gh api repos/{owner}/{repo}/issues/<N1> --jq .id)"`
+3. 順序があるときだけ、別ステップで依存を足す（Issue 番号ではなく database id を渡す。失敗しても止めない）: `gh api repos/{owner}/{repo}/issues/<N2>/dependencies/blocked_by -F issue_id="$(gh api repos/{owner}/{repo}/issues/<N1> --jq .id)"`

package/prompts/collaboration-workflow/lane-instructions.md

@@ -4,8 +4,7 @@ headless のレーン子とレビューセッションは、`CLAUDE.md` を読
 
 - 起動プロンプトがそのまま明示の起動。応答する人はいないので、確認は求めない。
 - `CLAUDE.md` を開き直さない。ここに無い規則は、対話セッションでしか効かない。
-
-<!-- include: CLAUDE.md → "Project" -->
+- 下の `pnpm josh gate` は、レーン子では `josh ship` が回す（`.claude/skills/workflow-commands/chain-rule.md` → "Run the review-to-merge chain" step 0）。
 
 ## Communication
 

package/prompts/collaboration-workflow/measurement.md

@@ -0,0 +1,37 @@
+# 所要時間は記録から測る
+
+**CI と gate の所要時間は記録から読む。計測のために全ツリーのツールを手元で再実行しない。**
+
+再実行はコア予算の外で走り、並走する lane と重なる。`timed-rerun` 行（`rule-delivery.md`）が配送する。
+
+## 記録の読み方
+
+- CI のジョブとステップ: Actions の記録を読む。
+
+  ```bash
+  gh api --method GET "repos/<owner>/<repo>/actions/runs?branch=<branch>&per_page=5" --jq '.workflow_runs[] | [.id, .name, .conclusion, .run_started_at, .updated_at] | @tsv'
+  gh api --method GET "repos/<owner>/<repo>/actions/runs/<run_id>/jobs?per_page=100" --jq '.jobs[] | [.name, .started_at, .completed_at] | @tsv'
+  gh api --method GET "repos/<owner>/<repo>/actions/runs/<run_id>/jobs?per_page=100" --jq '.jobs[] | select(.name == "<job>") | .steps[] | [.name, .started_at, .completed_at] | @tsv'
+  ```
+
+- 手元の gate とチェックごとの所要時間: `pnpm josh lane:stats --period <days>`（gate の記録、`docs/josh-commands-run.md`）。
+
+## 効果を測る後続 Issue
+
+PR の効果を測る後続 Issue を起票するとき:
+
+- 開始条件は日数でなく標本数で書く: `## 背景` に `- 実施可能条件: #<PR> のマージ後 <K> マージ`（`issue-template.md`）。`#<PR>` は元の PR の番号で、Issue の番号は `issue:file` が refuse する。
+- K は測る値の種類で決める:
+  - 事象の回数の率（停止・再利用など）: 変更前の率で 10 件以上見込める最小のマージ数（K ≥ 10 ÷ 変更前の率）。変更前の標本数を上限の目安にする。
+  - 連続値の平均・差（所要時間など）: 5〜10。
+  - 最大値・裾: 変更前の標本数と同程度。
+- 受け入れ条件の集計は固定日数でなく `pnpm josh lane:stats --period <days>` とし、`<days>` は元 PR のマージからの経過日数（小数可）にする。
+
+計測を記録し終えた → `pnpm josh issue:measured <N> --evidence-file <path>`。`.claude/skills/workflow-commands/issue-comments.md` →「A measurement-only Issue」。
+
+## 手元で再実行してよいとき
+
+記録で答えられない問い（記録の無い変更前後の比較など）に限る。
+
+- 1 回だけ実行する。lane 子は `pnpm josh reserved-run <weight> -- <command>` で包み、コア予算に数えさせる。ESLint は `--concurrency off` で走らせ、並列度の計測はレーン外で行う（`lane-direct-tool`）。
+- 結果を Issue のコメントに残し、以後はそれを使い回す。

package/prompts/collaboration-workflow/operating-rules.md

@@ -2,7 +2,6 @@
 
 - 通知は CI チェック成功後に投稿する
 - 通知投稿に失敗しても、実装完了の事実をログで確認できるようにする
-- 自動投稿する Issue コメントは `JOSH_SESSION_LANG` の言語（未設定なら `ja`）で書く。Issue タイトルだけは英語
 
 ### CI チェック失敗時の対応
 
@@ -19,7 +18,7 @@
 - auto-merge の本文は [`followup.md`](../../.claude/skills/workflow-commands/followup.md)、`backlogrun` の子への継承は [`backlogrun-child.md`](../../.claude/skills/workflow-commands/backlogrun-child.md)
 - `kickoff` / `pnpm josh followup` 単独実行は文書化されたスコープで終了する。PR が OPEN のまま完了したら状態を報告して停止する
 - 「チェックが全部 green」は次へ進む承認ではない
-- **deny と配送ガードは実装であって規則ではない。** `gh pr merge`・force push・ブランチ削除は `.claude/settings.json` の `permissions.deny` と `pnpm josh rule:guard` が拒否する（一覧は [`rule-delivery.md`](./rule-delivery.md) →「配送されている規則」）が、規則より狭い。ツールが通したことを許可と読まない。`fullrun` の auto-merge は `pnpm josh followup` の内部から gh を起動するため影響を受けない
+- **deny と配送ガードは実装であって規則ではない。** `gh pr merge`・force push・ブランチ削除は `.claude/settings.json` の `permissions.deny` と `pnpm josh rule:list` の `git-force` 行が拒否する（一覧は [`rule-delivery.md`](./rule-delivery.md) →「配送されている規則」）が、規則より狭い。ツールが通したことを許可と読まない。`fullrun` の auto-merge は `pnpm josh followup` の内部から gh を起動するため影響を受けない
 - 共有状態に影響する操作（Tier C）は、迷ったら確認する。可逆な実装・設計判断（Tier A）は下記 "decision-autonomy" に従う
 
 ### no-self-staging — git index を勝手に変更しない（自律 staging の禁止）
@@ -38,22 +37,21 @@
   3. 「別パッケージ起因の問題は割り込み Issue で対応する」
   4. `backlogrun` が epic の子を始める前の preflight（`pnpm josh run:hold <N>` が `reclaim` と答えたときの回収 — joshuafolkken/kit#926, joshuafolkken/kit#1965）
 
-  1〜3 は直後に `pnpm josh stash:pop "<メッセージ>"` で復元する。stash は全 work tree が共有する 1 本のスタックなので、位置指定や引数なしの `git stash pop` は使わない（joshuafolkken/kit#2050）。4 は復元しない — 代わりに stash を子の Issue にコメントで記録する（`prerequisite.md` の stash と同じく、記録だけが後で pop させる手がかり）
+  1〜3 は直後に `pnpm josh stash:pop "<メッセージ>"` で復元する（位置指定の pop は `worktree-mutation` 行が拒否する）。4 は復元しない — 代わりに stash を子の Issue にコメントで記録する（`prerequisite.md` の stash と同じく、記録だけが後で pop させる手がかり）
 
 - **会話で作った実装をランへ渡す「引き渡し用の stash」も `pnpm josh stash:pop "<メッセージ>"` で復元する。当てたあと stash は消える**
   - 計画には復元手順としてこの 1 行だけを書く。`git stash apply` / `git stash pop` も「drop しない」という条件も書かない
   - 計画がガードの拒否する復元形を指していたら、実行側は `stash:pop` に読み替えて続行し、Issue コメントに残す（Tier A）。`needs-decision` では止まらない
   - stash を残すのは持ち主の判断だけ。持ち主が計画に理由を書き、ランはそこで止まって確認する
 - staging・index の書き換え・`git commit` の直接実行は deny されており、deny には「そのターンでユーザーが明示指示した」という例外がない。ケース 1 はユーザー自身の端末で実行してもらう。コミットを指示されたら `pnpm josh git` を通す
-- index を守る deny と `pnpm josh rule:guard`（`worktree-mutation`・`index-mutation`・`destructive-command`・`protected-file` 行）も実装である（→「deny と配送ガードは実装であって規則ではない」）
 
 ### decision-autonomy — 意思決定の自律ポリシー（確認停止を減らす）
 
 `CLAUDE.md` → "Decision autonomy" の境界の細則。
 
 - **A と B の判定**: 確認するのは「差が僅差 かつ 後戻りしにくい／アーキテクチャに長く影響する」ときだけ。明確に優位な選択肢は自動で選び、僅差でも安価に巻き戻せる選択は決めて記録して進む
-- 起票した Issue の所属先は、候補が複数の epic に散っていても Tier B ではない（joshuafolkken/kit#1339）。1 つを選び、採用・却下・理由・決定日を Issue と epic の両方に記録する。止まるのは 2 つが本当に甲乙つけがたいときだけ
+- 起票した Issue の所属先は、候補が複数の epic に散っていても Tier A（`.claude/skills/epic-commands/epic-bundle.md`）
 - 自己修正（自分が公開した成果物の事実誤りの訂正、同じセッションで自分が特定した自分の作業の抜けの穴埋め）は Tier A。承認済みの作業の完了・修復に限り、目標の表明や問いで動いてよい意味ではない（→ `principles.md` → "consult-vs-execute"）
 - **Tier C との境界**: マージ・ブランチ削除・force push・スコープ外の変更は、自分が招いた問題でも Tier C。確認を外しても監査証跡は外さない
 - **major のバージョン bump は Tier C**: `pnpm josh bump major` は自分の判断で実行も提案もしない。既定は minor / patch で、major はユーザーがそのターンで明示したときだけ（0.x の major は 1.0.0 になり戻せない）。`josh bump` が版を変えたら、変わった挙動の `docs/` をコミット前に更新する
-- 自動判断の記録: Issue 駆動ワークフロー内では `pnpm josh issue:comment <N> --body-file <path>` で、採用案・不採用の代替案・採用案が優位な理由を書く
+- 自動判断を記録する Issue コメントは `pnpm josh issue:comment <N> --body-file <path>` で投稿する

package/prompts/collaboration-workflow/output-bounds.md

@@ -27,14 +27,9 @@
 
 ## 検証コマンドをパイプに繋がない（joshuafolkken/kit#1556）
 
-**パイプラインの終了コードは最後のコマンドのものである。** `pnpm josh gate 2>&1 | tail -40` は赤いゲートを成功として返す。**これは `josh gate` の欠陥ではない。** 直すのは呼び出し方である。
+**パイプラインの終了コードは最後のコマンドのものである。** `pnpm josh gate 2>&1 | tail -40` は赤いゲートを成功として返す。**これは `josh gate` の欠陥ではない。** **既定はパイプなしで実行する。** 避けられないなら `set -o pipefail` を前置する。どの形でも、印字された判定行を読む。`piped-verification` 行（`rule-delivery.md`）が強制する。
 
-- **既定はパイプなしで実行する。** 判定行は末尾に出るので、省略されても残る
-- 絞るなら、ファイルへ落として範囲で読む（`pnpm josh gate > /tmp/gate.log 2>&1; tail -40 /tmp/gate.log`）
-- パイプが避けられないなら `set -o pipefail` を前置する
-- どの形でも、印字された判定行を読む。終了コードだけを答えにしない
-
-対象は結果が合否を意味するコマンドだけ — `gate` ／ `check` ／ `lint*` ／ `cspell*` ／ `test*` ／ `eval`。**`git log | head` や `gh issue list | head` は対象外であり、意図的にそうしている。** `latest:scope` ／ `review:brief` も、判定ではなく答えを印字するので `$(...)` で受けてよい。`pnpm josh pretool:guard` は、後段が `tail` ／全行読みの `grep` だけの検証パイプラインを `(set -o pipefail; …)` で包み、他のパイプは拒否する（`rule-delivery.md`）。
+対象は結果が合否を意味するコマンドだけ — `gate` ／ `check` ／ `lint*` ／ `cspell*` ／ `test*` ／ `eval`。**`git log | head` や `gh issue list | head` は対象外であり、意図的にそうしている。** `latest:scope` ／ `review:brief` も、判定ではなく答えを印字するので `$(...)` で受けてよい。
 
 ## 検査
 

package/prompts/collaboration-workflow/plan-comment.md

@@ -1,8 +1,9 @@
 ## Step 3: 計画コメントを記録して通知する
 
 1. 提案を人間が判断する
-2. 採用した計画を Issue に記録する。body が空なら計画をファイルに書き `gh api -X PATCH repos/{owner}/{repo}/issues/<N> --field body=@<path>` で書き込む（本文はパスで渡す — `shell-body.md`）。body があれば `pnpm josh issue:comment <N> --body-file <path>` でコメントする
+2. 採用した計画をファイルに書き、`pnpm josh issue:plan <N> --body-file <path>` で Issue に記録する。body が空なら本文に、空でなければコメントになる（本文はパスで渡す — `shell-body.md`）
    - 計画が stash の復元を含むときの書き方: `operating-rules.md` → "no-self-staging"
+   - 計画には `### 影響を受ける既存の利用者` が必須（`pnpm josh plan:consumers <識別子...>` が下書きを出す。書き方: `kickoff.md` の手順 4）
 3. Telegram で計画開始を通知する:
 
    ```bash
@@ -15,44 +16,4 @@
    - Issue URL を必ず含め、箇条書きの間に改行を入れる
    - `kickoff` はここで**停止**する（実装に進まない）
 
-4. 作業ツリーに変更（ステージ済みを含む）が既にあれば退避する:
-   ```bash
-   git stash push -u -m "plan: pre-existing changes"
-   ```
-5. メインブランチへ切り替えて最新を取得する:
-   ```bash
-   pnpm josh ms
-   ```
-6. `pnpm josh latest:scope` が `required` と答えたときだけ `pnpm josh latest` を実行し、`dependency-update` スキルに従う（`.claude/skills/workflow-commands/latest-gate.md`）。脆弱性への override は `pnpm-workspace.yaml` の `overrides` に書く（pnpm 11/12 は `package.json` の `pnpm.overrides` を無視する）。
-   ステップ 4 で stash したら、ここでメッセージ指定で復元する（位置指定や引数なしの `git stash pop` は使わない — joshuafolkken/kit#2050）:
-   ```bash
-   pnpm josh stash:pop "plan: pre-existing changes"
-   ```
-7. **作業サマリを提示してから**実装を開始する（`report-format.md` → "作業前サマリはいつ・どう出すか"）。Issue body が埋まっていても提示し、Issue コメントとしては投稿しない。
-8. 実装完了後、lint/test より前に `prompts/refactoring.md` に従い、高・中優先度項目が残らなくなるまでリファクタリングする
-9. 検証ゲート（`CLAUDE.md` の Completion gate）を実行する
-
-`pnpm josh git` を実行する（`-y` で確認プロンプトをスキップ）。**子はバージョンを上げない** — 版を決めるのは `pnpm josh release` だけ（joshuafolkken/kit#1486）。Issue タイトルは実行前に `issue-template.md` の Step 1 冒頭に沿って整える。
-
-```bash
-pnpm josh git -y "<issue-title> #<issue-number>"
-```
-
-### Recovery after failed push (pre-push hook blocked)
-
-If `pnpm josh git -y` fails at the push step, fix the blocking issue and recover with:
-
-```bash
-# 1. Push manually after fixing the issue
-git push --set-upstream origin <branch>
-
-# 2. Create the PR only — closes #N keyword is preserved
-pnpm josh pr
-# equivalent: pnpm josh git -y --skip-commit --skip-push
-```
-
-Do not run `gh pr create` directly — it bypasses `build_body`, which writes `closes #N`.
-
-### レビューからマージまで
-
-レビューは実装したセッションがコミットの前に `pnpm josh review:brief` で始め、`/code-review` は `Agent` ツールのサブエージェントが実行する。周回の上限、残った指摘の振り分けと `pnpm josh epic:bundle`、マージを打つターンは `.claude/skills/workflow-commands/chain-rule.md` → "Run the review-to-merge chain"、"The review runs in a subagent, never a main-line skill load"、方針は `prompts/review.md` → "Review round cap"。**`/code-review` の出力で停止しない。**
+実装からマージまでは [`fullrun-steps.md`](../../.claude/skills/workflow-commands/fullrun-steps.md) の手順に従う。

package/prompts/collaboration-workflow/principles.md

@@ -46,6 +46,11 @@ AI の判断が要らない手順は、AI に読ませて実行させない。
 2. **1 つを悪くするなら、同じ変更の中で別の場所を削って埋め合わせる** — 合計を悪化させない
 3. **それでも両立しないときは、数字を示して利用者に聞く**（Tier B）— 何をどれだけ悪くして、何を得るか
 
+不具合や複雑さへの対策を出すときは、次のようにする。
+
+- 機能や最適化の追加を止める・凍結する・後回しにする案を出さない。順序は優先度ラベルが決める
+- 進化を続けたまま不具合を防ぐ仕組み（単一ソース化、層の統合、不変条件のテスト）を提案する
+
 ## concise-prose — 文章は条件と動作だけを書く
 
 docs・prompts・skills・拒否文・Issue・PR の文章に適用する。