@joshuafolkken/kit 1.1178.0 → 1.1229.0

package/eslint/rules/early-return-one-liner.js

@@ -0,0 +1,98 @@
+// early-return-one-liner: 単一の短い early return を one-liner `if (x) return y` に強制するルール
+// （joshuafolkken/kit#3294）。CLAUDE.md の Quality limits は「single short early return → one-liner」と
+// 書くが、`curly` は `['error', 'multi-line']` で one-liner 形を許すだけで要求はしない。そのため
+// review-rubric の手作業チェックに残っていた。散文の指示はドリフトするので lint で強制する。
+//
+// 対象は else の無い `if` で、ブロックの中身が `return` 1 文だけのもの。ブロック内にコメントがあれば
+// 対象外（one-liner にするとコメントの置き場が無くなる）。「短い」の判定は、one-liner にしたときに
+// 行頭のインデントを含めて Prettier の printWidth（100）に収まるかどうか。収まらないものを
+// one-liner にしても Prettier が折り返すだけなので、要求しない。条件式や戻り値が複数行にわたる
+// ものも同じ理由で対象外。
+//
+// 自動修正はブロックを `return` 文そのものに置き換える。既存コードの移行を `--fix` 一発で済ませる
+// ためで、置き換え後の形は `curly: multi-line` も Prettier もそのまま受け入れる。
+
+const RULE_MESSAGE =
+	'Write a single short early return as a one-liner: `if (x) return y`. See CLAUDE.md → Quality limits.'
+
+// Prettier の printWidth（prettier/basic.js）と max-len の code に揃える。
+const PRINT_WIDTH = 100
+// Prettier の useTabs で 1 タブが占める幅（tabWidth の既定値）。max-len の tabWidth と同じ。
+const TAB_WIDTH = 2
+
+const BLOCK_STATEMENT = 'BlockStatement'
+const RETURN_STATEMENT = 'ReturnStatement'
+
+// ブロックの中身が return 1 文だけなら、その return。それ以外は undefined。
+function sole_return(block) {
+	const statements = block.type === BLOCK_STATEMENT ? block.body : []
+	const [statement] = statements
+
+	return statements.length === 1 && statement.type === RETURN_STATEMENT ? statement : undefined
+}
+
+// 行頭からノードの開始位置までの幅。タブは TAB_WIDTH として数える。`} else if` のように `if` が
+// 行の途中から始まるときは、手前の `} else ` も 1 行に並ぶので幅に含める。
+function leading_width(source_code, node) {
+	const line = source_code.lines[node.loc.start.line - 1] ?? ''
+	const prefix = line.slice(0, node.loc.start.column)
+
+	return [...prefix].reduce((width, char) => width + (char === '\t' ? TAB_WIDTH : 1), 0)
+}
+
+// one-liner にしたときの `if (...) return ...` の文字列。
+function one_liner_text(source_code, node, return_statement) {
+	const test_text = source_code.getText(node.test)
+	const return_text = source_code.getText(return_statement).replace(/;$/u, '')
+
+	return `if (${test_text}) ${return_text}`
+}
+
+function fits_on_one_line(source_code, node, text) {
+	return !text.includes('\n') && leading_width(source_code, node) + text.length <= PRINT_WIDTH
+}
+
+function has_comments(source_code, block) {
+	return source_code.getCommentsInside(block).length > 0
+}
+
+// return 1 文だけの `if` が one-liner に書き直せるか。else もコメントも無く、1 行に収まるもの。
+function is_one_liner_candidate(source_code, node, return_statement) {
+	if (node.alternate || has_comments(source_code, node.consequent)) return false
+
+	return fits_on_one_line(source_code, node, one_liner_text(source_code, node, return_statement))
+}
+
+function check_if_statement(context, node) {
+	const { sourceCode: source_code } = context
+	const return_statement = sole_return(node.consequent)
+
+	if (!return_statement || !is_one_liner_candidate(source_code, node, return_statement)) return
+
+	context.report({
+		node,
+		message: RULE_MESSAGE,
+		fix: (fixer) => fixer.replaceText(node.consequent, source_code.getText(return_statement)),
+	})
+}
+
+function create(context) {
+	return {
+		IfStatement(node) {
+			check_if_statement(context, node)
+		},
+	}
+}
+
+/** @type {import('eslint').Rule.RuleModule} */
+const early_return_one_liner_rule = {
+	meta: {
+		type: 'layout',
+		docs: { description: 'Require a single short early return to be written as a one-liner' },
+		fixable: 'code',
+		schema: [],
+	},
+	create,
+}
+
+export { RULE_MESSAGE, early_return_one_liner_rule }

package/eslint/rules/unicorn.js

@@ -20,6 +20,14 @@ export const NAME_REPLACEMENTS_ALLOW_LIST = {
 	repository: true, // unicorn 68 は repository→repo を勧めるが、明確さを優先し完全名を維持する
 }
 
+// unicorn 77 は逆に repo→repository を要求する（joshuafolkken/kit#3273）。repo は GitHub の
+// owner/repo・gh repo・josh repo:party と同じ定着した語で、展開しても明確さは増えない。
+// allowList は大文字小文字を区別した単語一致なので RepoIdentity の `Repo` を拾えない。
+// 置き換えそのものを外すと repo / Repo のどちらも対象外になる。
+export const NAME_REPLACEMENTS_DISABLED = {
+	repo: false,
+}
+
 // unicorn 68→69 のベースライン方針（Issue #610 / Problem 3）:
 // `unicorn.configs.recommended` で 65→68 にかけて新たに有効化されたルール
 // （prefer-url-href / consistent-class-member-order / prefer-number-coercion /
@@ -40,7 +48,10 @@ export const unicorn_rules = {
 	'unicorn/no-array-reduce': 'error',
 	// abbreviation を禁止（明確な命名を強制、idiomatic な短縮名は許可）
 	// unicorn 68 で prevent-abbreviations から name-replacements にリネーム
-	'unicorn/name-replacements': ['error', { allowList: NAME_REPLACEMENTS_ALLOW_LIST }],
+	'unicorn/name-replacements': [
+		'error',
+		{ allowList: NAME_REPLACEMENTS_ALLOW_LIST, replacements: NAME_REPLACEMENTS_DISABLED },
+	],
 	// より良いエラーメッセージ
 	'unicorn/error-message': 'error',
 	// ファイル名のケース統一（unicorn 65 で既定 true になった checkDirectories を無効化し、
@@ -189,4 +200,8 @@ export const unicorn_rules = {
 	// 差分ノイズだけを生む。無効化ではなく 'single-line' 側で一貫性を強制する
 	// （内容が複数行のコメントはこのルールの対象外なので、長い解説コメントは影響を受けない）。
 	'unicorn/single-line-block-comment-style': ['error', 'single-line'],
+	// unicorn 77 で新設。JSDoc の各行から ` * ` を外させるが、行頭の `*` は JSDoc の標準形で、
+	// エディタは `/**` の中で改行するたびに自動で挿入する。有効のままだと新しい doc コメントの
+	// たびにエディタと衝突し、可読性の利得なく差分ノイズだけを生むため無効化する（joshuafolkken/kit#3273）。
+	'unicorn/no-asterisk-prefix-in-documentation-comments': 'off',
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1178.0",
+  "version": "1.1229.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": [
@@ -20,7 +20,7 @@
     "url": "git+https://github.com/joshuafolkken/kit.git"
   },
   "engines": {
-    "node": ">=22.19.0"
+    "node": "^22.19.0 || ^24.0.0 || >=26.0.0"
   },
   "josh": {
     "progress_interval_minutes": 15
@@ -85,10 +85,10 @@
     "!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/document/document-scan.ts",
     "!scripts/exports/member-usage.ts",
     "!scripts/exports/namespace-escape.ts",
     "!scripts/exports/namespace-members.ts",
@@ -101,6 +101,7 @@
     "!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"
@@ -174,7 +175,7 @@
     "eslint-plugin-import-x": "^4.17.1",
     "eslint-plugin-promise": "^7.3.0",
     "eslint-plugin-sonarjs": "^4.2.1",
-    "eslint-plugin-unicorn": "^76.0.0",
+    "eslint-plugin-unicorn": "^77.0.0",
     "globals": "^17.12.0",
     "prettier": "^3.9.9",
     "prettier-plugin-svelte": "^4.1.1",
@@ -256,7 +257,7 @@
     "eslint-plugin-import-x": "^4.17.1",
     "eslint-plugin-promise": "^7.3.0",
     "eslint-plugin-sonarjs": "^4.2.2",
-    "eslint-plugin-unicorn": "^76.0.0",
+    "eslint-plugin-unicorn": "^77.0.0",
     "eslint_d": "^15.0.3",
     "globals": "^17.13.0",
     "lefthook": "^2.1.16",
@@ -287,7 +288,7 @@
     }
   },
   "scripts": {
-    "build": "tsx scripts/build/build-bin.ts && tsx scripts/build/build-hooks.ts && tsx scripts/build/build-version.ts && tsx scripts/build/build-config-merge.ts && tsx scripts/build/build-managed-marker.ts && tsx scripts/build/build-self-sync-guard.ts && tsx scripts/build/build-claude-md.ts && tsx scripts/build/build-codex-hooks.ts",
+    "build": "tsx scripts/build/build.ts",
     "josh": "tsx scripts/josh/josh.ts"
   }
 }

package/pnpm-workspace.yaml

@@ -7,16 +7,21 @@ allowBuilds:
   workerd: true
   '@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
+engineStrict: true
+
 # Skip the install-time supply-chain re-verification of the already-committed, reviewed lockfile.
-# Since pnpm 11.5, `minimum-release-age` can trigger a pre-install metadata re-fetch; on clean CI boxes
+# Since pnpm 11.5, `minimumReleaseAge` can trigger a pre-install metadata re-fetch; on clean CI boxes
 # (e.g. Cloudflare Workers Builds) it can't authenticate private @joshuafolkken/* GitHub Packages,
-# producing a false ERR_PNPM_TARBALL_URL_MISMATCH. minimum-release-age still applies at resolution
+# producing a false ERR_PNPM_TARBALL_URL_MISMATCH. minimumReleaseAge still applies at resolution
 # time, so age protection is preserved — only the per-install re-check of a trusted lockfile is skipped.
 trustLockfile: true
 
-# Security fixes often require same-day vite releases; minimum-release-age in .npmrc would block them.
+# Security fixes often require same-day vite releases; minimumReleaseAge would block them.
 # `@types/node` and `tsx` are also excluded so routine Dependabot-style bumps are not
-# delayed by the minimum-release-age window.
+# delayed by the minimumReleaseAge window.
 #
 # `josh init` / `josh sync` mirror this list to Safe Chain's .aikido project config (kit #2618).
 # Older Safe Chain shims ignore .aikido and can still hide an excluded release. `josh ranges`

package/prettier/basic.d.ts

@@ -1,3 +1,5 @@
 import type { Config } from 'prettier'
 
-export const config: Config
+declare const config: Config
+
+export { config }

package/prettier/index.d.ts

@@ -1,3 +1,5 @@
 import type { Config } from 'prettier'
 
-export declare const config: Config
+declare const config: Config
+
+export { config }

package/prettier/static.d.ts

@@ -1,3 +1,5 @@
 import type { Config } from 'prettier'
 
-export const config: Config
+declare const config: Config
+
+export { config }

package/prompts/coding-standards.md

@@ -26,7 +26,7 @@ lint・型検査の実行手順は `CLAUDE.md` → "Code Change Rules" の検証
 - **過度な抽象化を避ける**: 現在の要件で必要な抽象化のみを行う。将来の拡張性を考慮した抽象化は不要
 - **パターンの強制は避ける**: デザインパターンやアーキテクチャパターンを無理に適用しない
 - **コードの重複は撲滅**: コードクローン（重複）は完全に撲滅する。重複が見つかった場合は関数やモジュールに抽出して共通化する
-- **仕組みを足す前に原因を問う**: これは**書かれたコードの可読性**の規則。仕組み（フック・ガード・ルール）を足すか・どこへ置くかという**設計時の判断**は `prompts/collaboration-workflow/principles.md` → "設計はエレガント" の担当なので、本文を写さずそちらを参照する
+- **仕組みを足す前に原因を問う**: これは**書かれたコードの可読性**の規則。仕組み（フック・ガード・ルール）を足すか・どこへ置くかという**設計時の判断**は `prompts/collaboration-workflow/principles.md` → "elegant-design" の担当なので、本文を写さずそちらを参照する
 
 ### エラーハンドリング
 

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

@@ -42,7 +42,7 @@ PY
 
 **レビュー指摘の修正がこの規則の主戦場である。** 「この行の条件が逆」「この定数を切り出す」といった局所的な指摘ほど、部分編集は小さくなる。一方で全文書き直しのコストはファイルの大きさで決まり、指摘の小ささでは下がらない。**指摘が局所的であるほど、全文書き直しとの差は開く。**
 
-実測では 1 ランで約 2 分 45 秒が、すでに存在する行を打ち直すことに使われていた（joshuafolkken/kit#1260）。内訳は `docs/maintainers/file-edits-rationale.md` → "全文書き直しの実測"。
+実測では 1 ランで約 2 分 45 秒が、すでに存在する行を打ち直すことに使われていた（joshuafolkken/kit#1260）。内訳は `docs/maintainers/file-edits-rationale.md` → "Measured cost of whole-file rewrites"。
 
 ### `sed -i` を使う前に満たす 4 条件
 
@@ -67,12 +67,12 @@ PY
 
 ### なぜコストが二重になるか
 
-インタプリタで書き戻す形は、編集後の本文が**コマンド本文とファイルの両方**に載る。さらに悪いのは持続性である。**コマンド本文は、書いた時点以降のすべてのリクエストで読み直される。** ランの序盤に書いた編集スクリプトほど、そのランの残り全リクエストぶん課金され続ける。ファイル側は次に読んだときだけ載るのに対し、コマンド側は消えない。実測の内訳は `docs/maintainers/file-edits-rationale.md` → "コマンド本文の実測内訳"。
+インタプリタで書き戻す形は、編集後の本文が**コマンド本文とファイルの両方**に載る。さらに悪いのは持続性である。**コマンド本文は、書いた時点以降のすべてのリクエストで読み直される。** ランの序盤に書いた編集スクリプトほど、そのランの残り全リクエストぶん課金され続ける。ファイル側は次に読んだときだけ載るのに対し、コマンド側は消えない。実測の内訳は `docs/maintainers/file-edits-rationale.md` → "Measured breakdown of command text"。
 
 ### なぜ resident に置くか
 
-根拠は `docs/maintainers/file-edits-rationale.md` → "なぜ resident に置くか"。
+根拠は `docs/maintainers/file-edits-rationale.md` → "Why it is resident"。
 
 ### マーカーテスト
 
-固定している内容は `docs/maintainers/file-edits-rationale.md` → "マーカーテスト"。
+固定している内容は `docs/maintainers/file-edits-rationale.md` → "Marker tests"。

package/prompts/collaboration-workflow/glossary.md

@@ -12,6 +12,6 @@
 - **entry read** — コマンド起動時に読む文書の集合。`pnpm josh read:set` がその集合と費用を答える。→ `.claude/skills/workflow-commands/SKILL.md` → "Which file to read"
 - **oracle** — 機械的に読める入力だけから規則の答えを計算するコマンド。一覧は `pnpm josh oracle:list`。→ `prompts/collaboration-workflow/residency.md` → "第 0 問"
 - **interrupt** — WIP 上限を超えても起票できる、3 条件で決まる発見。別パッケージ起因の上流起票（割り込み Issue）とは別の区分。→ `prompts/collaboration-workflow/wip-cap.md` → "割り込み起票"、`prompts/collaboration-workflow/upstream-interrupt.md` → "別パッケージ起因の問題は割り込み Issue で対応する"
-- **Tier** — 判断点の 3 区分。A は可逆で自分で決める、B は拮抗していて人に聞く、C は不可逆・共有状態で明示指示が要る。→ `CLAUDE.md` → "Decision autonomy"、`prompts/collaboration-workflow/operating-rules.md` → "意思決定の自律ポリシー"
+- **Tier** — 判断点の 3 区分。A は可逆で自分で決める、B は拮抗していて人に聞く、C は不可逆・共有状態で明示指示が要る。→ `CLAUDE.md` → "Decision autonomy"、`prompts/collaboration-workflow/operating-rules.md` → "decision-autonomy"
 - **carry** — `backlogrun` の 1 回の起動の予算と進捗を、セッション cut をまたいで引き継ぐ記録（`pnpm josh run:carry`）。→ `.claude/skills/workflow-commands/backlogrun-steps.md` → "The session cut is inside the invocation"
 - **wave** — エピックの子をまとめて並行実行する組。仕組みではなく、依存宣言で表す形。→ `.claude/skills/epic-commands/execution-waves.md` → "Execution waves — parallel, then one alone, then the rest"

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

@@ -25,16 +25,16 @@
 
 ### 指示されていない行動は取らない
 
-PR マージ・ブランチ削除・force push・共有ブランチへの push・外部通知の追加送信・リポジトリ設定の変更など、**共有状態に影響する操作はその場でユーザーに明示指示されたものだけ実行する**。
+規則そのもの — 共有状態に影響する操作はその場で明示指示されたものだけ実行し、マージを認可するのはどのコマンドの起動か — は `CLAUDE.md` → "Git Rules" に常駐している。ここに書くのは、その規則を実行するときの細則である。対象には共有ブランチへの push・外部通知の追加送信・リポジトリ設定の変更も含まれる。
 
-- `fullrun` と `backlogrun` の auto-merge は、それぞれの指示自体に含まれるため許可される（本文は [`followup.md`](../../.claude/skills/workflow-commands/followup.md)、`backlogrun` の子への継承は [`backlogrun-child.md`](../../.claude/skills/workflow-commands/backlogrun-child.md)）。`prrun` はマージを認可しない。それ以外の状況で勝手にマージしてはならない
+- 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:guard` が拒否する（一覧は各ファイルと [`rule-delivery.md`](./rule-delivery.md) →「配送されている規則」）が、それらは規則より狭い — 取りこぼす綴りを禁じ、ツールが通したことを許可と読ませないのは `CLAUDE.md` → "Git Rules" である。`fullrun` の auto-merge は `pnpm josh followup` の内部から gh を起動するため影響を受けない
 - **共有状態に影響する操作（このセクションの対象＝Tier C）は迷ったら確認する。** 確認のコストは低いが、意図しない操作の巻き戻しは高コスト
 - ただしこの「迷ったら確認」は Tier C に限る。**可逆な実装・設計判断（Tier A）は別ルール**（下記「意思決定の自律ポリシー」）に従う
 
-### git index を勝手に変更しない（自律 staging の禁止）
+### no-self-staging — git index を勝手に変更しない（自律 staging の禁止）
 
 規則そのもの — index はユーザーのスナップショットであり、自分の判断でステージ・コミットしない — は `CLAUDE.md` → "Git Rules" に常駐している。ここに書くのは、その規則を実行するときの細則である。index には履歴がなく、上書きされた直前のステージ状態は復元できない（経緯は `docs/maintainers/operating-rules-rationale.md` → "Why the index is the user's"）。
 
@@ -49,17 +49,25 @@ PR マージ・ブランチ削除・force push・共有ブランチへの push
 - 上記以外で staging が必要だと考えたときは、**実行せずに先に確認する**
 - **レーンの中で競合を解決したあとの「解決済み」の記録は、ケース 2 に含まれる（Tier A）。** レーンは run 専用の作業ツリーで、守るべき利用者の staging はない。利用者に `git add` の許可を求めず、`pnpm josh git -y` で記録する。手順は `.claude/skills/workflow-commands/chain-rule.md` →「origin/main is merged in before the gate」の 1 か所にだけ書く（joshuafolkken/kit#2445）
 - 同じ理由で、`git reset` / `git checkout -- <path>` / `git restore <path>` など index や作業ツリーを破壊的に書き換える操作も、自分の判断で実行しない
-- **`git stash` は例外的に、明文化されたフローの中でのみ自動実行してよい**: `fullrun new` / `halfrun new` の手順 5（作業ツリーに変更がある状態で `josh latest` を回す前の退避）、`backlogrun` のラン開始時の `josh latest`、「別パッケージ起因の問題は割り込み Issue で対応する」、および `backlogrun` が epic の子を始める前の preflight（`pnpm josh run:hold <N>` が `reclaim` と答えたときの回収 — joshuafolkken/kit#926, joshuafolkken/kit#1965）。**この 5 番目だけが復元を伴わない。前の 4 つはいずれも直後に `pnpm josh stash:pop "<メッセージ>"` で復元することが手順に含まれている**（stash はリポジトリ単位の 1 本のスタックを全 work tree が共有するため、位置指定や引数なしの `git stash pop` は別のレーンが最後に積んだ stash を取り込む — メッセージで対象を特定する。joshuafolkken/kit#2050）。 回収するのは異常終了したランの置き土産であって、いま実行中のランの作業ではないから、pop して戻す先がない。**代わりに stash を子の Issue にコメントで記録する** — 前提 Issue で中断するときの stash（`prerequisite.md`）と同じく、**その記録だけが後で pop させられる唯一の手がかり**であり、記録し忘れた stash は誰にも拾われない。これら以外の場面で退避したくなったときは、実行せずに先に確認する
+- **`git stash` は例外的に、次の明文化されたフローの中でのみ自動実行してよい**:
+  1. `fullrun new` / `halfrun new` の手順 5（作業ツリーに変更がある状態で `josh latest` を回す前の退避）
+  2. `backlogrun` のラン開始時の `josh latest`
+  3. 「別パッケージ起因の問題は割り込み Issue で対応する」
+  4. `backlogrun` が epic の子を始める前の preflight（`pnpm josh run:hold <N>` が `reclaim` と答えたときの回収 — joshuafolkken/kit#926, joshuafolkken/kit#1965）
+
+  **4 番目だけが復元を伴わない。1〜3 はいずれも直後に `pnpm josh stash:pop "<メッセージ>"` で復元することが手順に含まれている**（stash はリポジトリ単位の 1 本のスタックを全 work tree が共有するため、位置指定や引数なしの `git stash pop` は別のレーンが最後に積んだ stash を取り込む — メッセージで対象を特定する。joshuafolkken/kit#2050）。 回収するのは異常終了したランの置き土産であって、いま実行中のランの作業ではないから、pop して戻す先がない。**代わりに stash を子の Issue にコメントで記録する** — 前提 Issue で中断するときの stash（`prerequisite.md`）と同じく、**その記録だけが後で pop させられる唯一の手がかり**であり、記録し忘れた stash は誰にも拾われない。これら以外の場面で退避したくなったときは、実行せずに先に確認する
+
 - **staging・index の書き換え・`git commit` の直接実行は deny されており、deny には「そのターンでユーザーが明示指示した」という例外がない。** だから上記ケース 1 は AI 側では実行できず、ユーザー自身の端末で実行してもらう。ユーザーが明示的にコミットを指示した場合も、承認済みのコミットは `pnpm josh git` を通す（理由は `docs/maintainers/operating-rules-rationale.md` → "Why the index is the user's"）
-- **ツールが通したことを許可と読み替えてはならない。** deny と `pnpm josh rule:guard`（`worktree-mutation`・`index-mutation`・`destructive-command`・`protected-file` 行）は事故防止の実装で、規則より狭い。何をしてよいかを決めるのはこのルールである
+- index を守る deny と `pnpm josh rule:guard`（`worktree-mutation`・`index-mutation`・`destructive-command`・`protected-file` 行）も事故防止の実装である — 上記「指示されていない行動は取らない」→「deny と配送ガードは実装であって規則ではない」
 
-### 意思決定の自律ポリシー（確認停止を減らす）
+### decision-autonomy — 意思決定の自律ポリシー（確認停止を減らす）
 
-3 層の定義（Tier A / B / C）、起票した Issue の epic 所属と自己修正が Tier A であること、自動判断の記録先は `CLAUDE.md` → "Decision autonomy (minimize confirmation stops)" に常駐している。ここに書くのは、その境界の細則である。
+3 層の定義（Tier A / B / C）、起票した Issue の epic 所属と自己修正が Tier A であること、自動判断の記録先は `CLAUDE.md` → "Decision autonomy" に常駐している。ここに書くのは、その境界の細則である。
 
 - **A と B の判定基準**: 確認するのは「差が僅差 **かつ** 後戻りしにくい／アーキテクチャに長く影響する」ときだけ。「迷っている」だけでは停止理由にならない — 明確に優位な選択肢は多少の不確実性が残っても自動で選び、僅差でも安価に巻き戻せる選択は自動で決めて記録して進む
 - **起票した Issue の所属先は、候補が複数の epic に散っていても Tier B ではない**（joshuafolkken/kit#1339）。`epic --add` 1 回で移せるので推奨する 1 つを選び、採用・却下・理由・決定日を Issue と epic の両方に記録して進む。止まるのは 2 つの epic が本当に甲乙つけがたいときだけである
 - **自己修正**は設計判断ではなく後始末である — 自分が公開した成果物の事実誤り（誤った帰属を含む）の訂正と、同じセッションで自分が特定した自分の作業の抜けの穴埋め（例: 欠けていると自分で指摘した相互リンクの追加）。どちらも可逆で、望ましい結果が 1 つしかなく、問題を迂回せず既に行った作業を修復するだけなので、回避策のリスクはない
-- **「相談と実行を区別する」との境界**: ここでの Tier A は **すでに承認され実行された作業を完了・修復する**ことに限られる。目標の表明（「〜したい」）や進め方への問い（「どうすべき？」）に対して勝手に動いてよい、という意味ではない（→ `principles.md` → "相談と実行を区別する"）
+- **「相談と実行を区別する」との境界**: ここでの Tier A は **すでに承認され実行された作業を完了・修復する**ことに限られる。目標の表明（「〜したい」）や進め方への問い（「どうすべき？」）に対して勝手に動いてよい、という意味ではない（→ `principles.md` → "consult-vs-execute"）
 - **Tier C との境界**: 自分のコメントの訂正は Tier A。マージ・ブランチ削除・force push・スコープ外の変更は、**その問題を招いたのが自分自身であっても** Tier C のまま。確認を外しても監査証跡は外さない
+- **major のバージョン bump は Tier C**: `pnpm josh bump major` は自分の判断で実行せず、提案もしない。破壊的な変更に見えても既定は minor / patch で、major はユーザーがそのターンで明示したときだけ（0.x の major は 1.0.0 になり、戻せない公開を伴う）
 - **自動判断の記録の書き方**: Issue 駆動ワークフロー内では `pnpm josh issue:comment <N> --body-file <path>` で、採用案・不採用の代替案・なぜ採用案が明確に優位かを記載する

package/prompts/collaboration-workflow/overview.md

@@ -26,7 +26,7 @@
   2. **コード内コメント、テストタイトル（`describe` / `it` / `expect`）、コミットメッセージ**。
   3. **スクリプトが出力する固定文字列**: Telegram のヘッダーラベル（`Planning` / `Completion` など）、`Issue:` / `PR:` の URL ラベル、`--notify-message` 省略時の既定メッセージ。
 
-`JOSH_SESSION_LANG` は **開発者個人の設定**であり、`.env`（gitignore 済み・非コミット）に置く。**解決値は毎ターン、`UserPromptSubmit` フック（`pnpm josh session:lang`）がコンテキストへ差し込む。** フック出力を表示しないハーネス（Codex / Gemini / Cursor）は `.env` を読んで解決する。各既定の理由は `docs/maintainers/overview-rationale.md` → "Why the session language defaults the way it does" にある。
+`JOSH_SESSION_LANG` は **開発者個人の設定**であり、`.env`（gitignore 済み・非コミット）に置く。**解決値は毎ターン、`UserPromptSubmit` フック（`scripts/hooks/run-hook.sh session-lang`）がコンテキストへ差し込む。** Codex も `.codex/hooks.json` で同じフックを実行する。フックが走らないハーネス（Gemini / Cursor）は `.env` を読んで解決する。各既定の理由は `docs/maintainers/overview-rationale.md` → "Why the session language defaults the way it does" にある。
 
 ### 配布ドキュメントの層ごとの言語（joshuafolkken/kit#2997）
 
@@ -38,4 +38,4 @@
 | `prompts/` のトピックファイル（次の行の 3 文書を除く）                                  | 日本語 |
 | `prompts/review.md`、`prompts/review-rubric.md`、`prompts/sonar-hotspot-handling.md`    | 英語   |
 
-英語の層から日本語のトピックファイルの節を指すポインターは、その**見出しを原文のまま**引く（例: `principles.md` → 「クローン禁止」）。見出しは `pnpm josh doc:section` が節を引くキーであり、訳すと解決しなくなるため、これは言語の混在ではない。
+英語の層から日本語のトピックファイルの節を指すポインターは、見出しの先頭に置いた**英語 ID** を引く（例: 見出し `## no-clones — クローン禁止・…` を `principles.md` → "no-clones" で指す）。`pnpm josh doc:section` は見出しの前方一致で節を引くので、ID だけで解決し、`JOSH_SESSION_LANG=en` の利用者や日本語を読まないエージェントにも参照先が読める。ID の無い日本語見出しは原文のまま引く。

package/prompts/collaboration-workflow/principles.md

@@ -2,7 +2,7 @@
 
 **このファイルは、`CLAUDE.md` の Communication 節が指す 7 つの原則の単一ソースである。** 各節は `CLAUDE.md` から `prompts/collaboration-workflow/principles.md` → "見出し" の形で引かれ、`pnpm josh doc:section` で解決する。経緯と適用例は各節が指す [`docs/maintainers/principles-rationale.md`](../../docs/maintainers/principles-rationale.md) の節にあり、実行中には読まない。
 
-## クローン禁止・単一ソース化（パッケージ境界を越えても）
+## no-clones — クローン禁止・単一ソース化
 
 既存の非自明なロジックを「ソースを変えずに済ませる」ために**コピー・移植・再実装することは既定で禁止**する。すでにどこか（別ファイル・別モジュール・別**パッケージ＝上流依存を含む**）に存在するロジックを複製しようとした瞬間が、**単一ソース化**（全消費者が import する共有モジュール／export／パッケージ）のシグナルである。コピーではなく単一ソース化する。
 
@@ -13,7 +13,7 @@
 
 **計測は `pnpm josh clone:scan`。** 同一リポジトリ内および `JOSH_REPO_PATHS` の他リポジトリを跨いだ複製を検出し、**件数**と各複製の `file:line`（`[same-file|cross-file|cross-repo]` 分類つき、複製なしは `clean`）を印字する。`pnpm josh oracle:list` に載る決定オラクルでもある（導入の経緯は `docs/maintainers/principles-rationale.md` → "Why clone:scan exists"）。
 
-## 設計はエレガント・シンプルを第一目標にする
+## elegant-design — 設計はエレガント・シンプルを第一目標にする
 
 新しい仕組み（フック・ガード・ルール・抽象化）を足す前に、**原因側を直せばその仕組みが要らなくならないか**を先に問う。要らなくなるなら、足さない。症状を叱る仕組みを重ねるのではなく、症状を生んでいる材料を断つ。
 
@@ -22,18 +22,20 @@
 
 **書かれたコードの可読性**（意図が伝わる命名、過度な抽象化を避ける、など）は `prompts/coding-standards.md` の担当で、こちらは**設計時にどの仕組みを足すか・どこへ置くかを決める**規則。両者は別レイヤーなので、片方の本文をもう片方へ写さず、互いを指すだけにする。
 
-## 相談と実行を区別する（議論中にファイルを編集しない）
+## consult-vs-execute — 相談と実行を区別する
 
 ユーザーが「どう進めるべきか」「何をすべきか」「なぜそうなったか」を尋ねたり、目標・願望を述べたりした（「どうすべき？」「how should we…」「なぜ」「理由を知りたい」「〜したい」「〜の方が良い？」）ときは、**分析と推奨のみ**で応答する。ファイル編集・Issue 作成・その他の具体的アクションは取らない。
 
-- 具体的アクションを取ってよいのは、明示的な命令（「do it」「書き換えて」「作成して」「implement」）またはワークフローキーワード（`kickoff` / `halfrun` / `fullrun` / `backlogrun`）があるときだけ
-- 曖昧なときは propose-and-wait を既定とする（「これを実行してよいか？」と尋ねる）
+- 具体的アクションを取ってよいのは、明示的な命令（「do it」「書き換えて」「作成して」「implement」）またはワークフローキーワード（`kickoff` / `halfrun` / `prrun` / `fullrun` / `backlogrun`）があるときだけ
+- 発言が相談か実行の指示か判別できないときは、相談として扱う — 分析と推奨を返し、実行の指示を待つ。実行が指示されたあとの判断点で確認するかどうかは、この規則ではなく `CLAUDE.md` → "Decision autonomy" の Tier で決まる
 - **目標の表明は「計画の依頼」であって「実行の承認」ではない**
 
-## 最新優先・fix-forward（pin-back は最終手段）
+## latest-first — 最新優先・fix-forward（pin-back は最終手段）
 
 依存パッケージ・ツールチェーンは**既定で最新版を採用する**。バンプが lint クラッシュ・新規有効化ルール・型エラーなどの破壊を引き起こしても、古いバージョンへ留まる／戻すことを既定の「安全策」にしてはならない。破壊は**前向きに（fix-forward）速やかに**解消する。
 
+この節が単一ソースで、`dependency-update` skill → "4. When the bump breaks something — fix forward" はここを指す。
+
 1. **最新優先（latest-first）**: 依存・ツールチェーンは新しいバージョンを既定で採用する。適応の手間を避けるためだけに古いバージョンに留まったり戻したりしない
 2. **破壊は fix-forward**: バンプで lint クラッシュ・新規ルール・型エラー等が出たら、前向きに解消する:
    - 新ルール／エラーが正当なら **消費者コードを直す**
@@ -43,7 +45,7 @@
 4. **既存の保護を尊重する**: fix-forward は保護された pin を黙って書き換える許可ではない。overrides と `devEngines` の承認ゲートの単一ソースは `CLAUDE.md` → "Dependency overrides" と `dependency-update` skill である
 5. **タイムリーに**: バンプ起因の破壊は、可能な限り同じ作業セッション内で速やかに対処し、pin の裏に先送りしない
 
-## 恒久ルールは MEMORY ではなくプロンプト／ドキュメントに書く
+## durable-rules — 恒久ルールは MEMORY ではなくプロンプト／ドキュメントに書く
 
 今後のセッションでも守るべき恒久的な振る舞いのルールに気付いたときは、**kit が配布するプロンプト／ドキュメント**（`CLAUDE.md` / `prompts/*`）への変更として記述する。プロジェクト単位の自動 MEMORY（例: `~/.claude/projects/<repo-slug>/memory/`）への保存で済ませてはならない。
 
@@ -57,18 +59,18 @@
 3. 消費者リポジトリで気付いた場合は、ローカル編集ではなく kit 側へ Issue／PR として上流化する
 4. 既に MEMORY にあるルールが実は共有すべきものだと分かったときは、プロンプト／ドキュメントへ移し、MEMORY 側の重複エントリは削除する
 
-## 配布ドキュメント・設定の変更は kit に上流化する
+## upstream-to-kit — 配布ドキュメント・設定の変更は kit に上流化する
 
 `CLAUDE.md` および kit が配布する他のドキュメント／設定は、kit から単一ソースで配布される。
 
 - **消費者リポジトリ（app-kit / game-kit）ではこれらをローカル編集しない**: `josh sync` が編集を上書きするうえ、変更は本来上流（kit）に属する。ドキュメント／設定を編集する前に、それが配布物かどうかを確認し、配布物なら kit 側に変更を提案（Issue／PR）する
 - **kit リポジトリ自身ではあなたが配布元**なので、ここでは編集してよい。編集先は `CLAUDE.md` 1 本である（次節）
 
-## エージェント規則の単一ソースは `CLAUDE.md`（`AGENTS.md` / `GEMINI.md` は導線）
+## エージェント規則の単一ソースは `CLAUDE.md`（`AGENTS.md` / `GEMINI.md` / `.cursorrules` は導線）
 
-**規則の本体は `CLAUDE.md` にしか無い。** `AGENTS.md` と `GEMINI.md` は「規則は `CLAUDE.md` にある。作業前に全文を読むこと」と「規則を書き戻さない」だけを書いた短い導線文書であり、規則を 1 行も持たない。
+**規則の本体は `CLAUDE.md` にしか無い。** `AGENTS.md`・`GEMINI.md`・`.cursorrules` は「規則は `CLAUDE.md` にある。作業前に全文を読むこと」と「規則を書き戻さない」だけを書いた短い導線文書であり、規則を 1 行も持たない（`.cursorrules` は Svelte MCP の使い方の案内だけを足す）。
 
-- **規則の追加・仕様変更・文言修正・節の追加は `CLAUDE.md` に 1 回だけ書く。** 他の 2 本には触れない
+- **規則の追加・仕様変更・文言修正・節の追加は `CLAUDE.md` に 1 回だけ書く。** 導線文書には触れない
 - **導線文書に規則を書き戻さない。** そこに書かれた規則は、次の改訂で更新し忘れる 4 つ目の置き場になる
 - 経緯と機械的な検査は `docs/maintainers/principles-rationale.md` → "Why AGENTS and GEMINI are pointers"、`@CLAUDE.md` 行と他ツールでの未検証は `docs/maintainers/principles-rationale.md` → "The include line, and what has not been verified"
 
@@ -78,5 +80,5 @@
 
 - **フック**: フックが走らない、または出力が見えないツールでは、フックが届ける規則を自分で適用する。その一覧は手書きせず、[`rule-delivery.md`](./rule-delivery.md) →「配送されている規則」の一覧を正とする — 一覧の各項目が、そのツールでは自分で守る規則である。一覧の外でフックが担う 3 つも同じく自分で行う — 最初の実行時コード編集の前に Step 0 の作業サマリを提示する、編集ごとの整形フックに頼らず編集後に `pnpm josh lint:related` と `pnpm josh cspell:dot` を走らせる、`JOSH_SESSION_LANG` は注入を待たずに `.env` から解決する。フックの全体は `.claude/settings.json` の `hooks` が正である
 - **Skill・`/verify-ui`・`/code-review`**: `CLAUDE.md` が skill のロードやサブエージェントでの実行を指示する箇所では、その skill の `SKILL.md` を読み、自分のセッションで従う
-- **`.claude/settings.json` の deny list** は効かない。それが裏付ける規則 — 指示なしのコミット・マージ・ステージングその他の共有状態変更をしない — はそのまま拘束する
+- **`.claude/settings.json` の deny list** は効かない。それが裏付ける `CLAUDE.md` → "Git Rules" はそのまま拘束する
 - **`AskUserQuestion`** は、ユーザーに平文で尋ねることを指す

package/prompts/collaboration-workflow/report-format.md

@@ -68,7 +68,7 @@
 
 ### 変更対象はまとめて読んでから編集する（joshuafolkken/kit#2202）
 
-**「変更とテスト」が変更対象ファイルを列挙した直後、それらを 1 回の `pnpm josh read:files <path> [<path> ...]` で読み、続く独立した編集は 1 回の `pnpm josh edit:files -` で送る**（形式は `docs/josh-commands-automation.md` →「`josh edit:files`」）。**個別の `Edit` に戻すのは**、前の編集結果に依存する編集（`dependent` で拒否される）、編集が 1 件だけのとき、ファイル全体を書くとき（`Write`）の 3 つ。根拠は [`turn-batching.md`](turn-batching.md) →「実装中の独立編集に効く合成コマンド」。
+**「変更とテスト」が変更対象ファイルを列挙した直後、それらを 1 回の `pnpm josh read:files <path> [<path> ...]` で読み、続く独立した編集は 1 回の `pnpm josh edit:files -` で送る**（形式は `docs/josh-commands-run.md` →「`josh edit:files`」）。**個別の `Edit` に戻すのは**、前の編集結果に依存する編集（`dependent` で拒否される）、編集が 1 件だけのとき、ファイル全体を書くとき（`Write`）の 3 つ。根拠は [`turn-batching.md`](turn-batching.md) →「実装中の独立編集に効く合成コマンド」。
 
 ### 完了報告（セッション向け）
 

package/prompts/collaboration-workflow/residency.md

@@ -1,6 +1,6 @@
 ## 常駐ドキュメントと skill の分担（何を常駐に残すか）
 
-**規則をどこに書くか、常駐にどこまで残すかの判定は、このファイルが単一ソースである**（joshuafolkken/kit#2891）。**読むのは規則を置く・移す・引退させるターンだけ**である。`CLAUDE.md` は毎ターン全文が読み込まれ、上限は `scripts/document/resident-budget.ts` の `RESIDENT_CEILING_BYTES`（残りは `pnpm josh bytes CLAUDE.md`）。**置き場所は書き手の重要度判断ではなく、下の 4 つの問いを順に当てて決める。** 経緯・一覧・作例は `docs/maintainers/residency-rationale.md` にある。
+**規則をどこに書くか、常駐にどこまで残すかの判定は、このファイルが単一ソースである**（joshuafolkken/kit#2891）。`CLAUDE.md` はすべてのエージェント規則の入口で、`AGENTS.md` / `GEMINI.md` / `.cursorrules` はそこへの導線である。規則のトリガは `CLAUDE.md` に **1 度だけ**、手順と数値は導線の先に **1 度だけ**書く。`CLAUDE.md` の経緯は `docs/maintainers/claude-md-history.md` にある。**規則を散文で書く前に**、下の問いで置き場所を決める — 計算できる答えは `pnpm josh oracle:list` のコマンドへ、順序は `pnpm josh run:step` へ。**読むのは規則を置く・移す・引退させるターンだけ**である。`CLAUDE.md` は毎ターン全文が読み込まれ、上限は `scripts/document/resident-budget.ts` の `RESIDENT_CEILING_BYTES`（残りは `pnpm josh bytes CLAUDE.md`）。**置き場所は書き手の重要度判断ではなく、下の 4 つの問いを順に当てて決める。** 経緯・一覧・作例は `docs/maintainers/residency-rationale.md` にある。
 
 ### 第 0 問（先に問う）
 

package/prompts/collaboration-workflow/rule-delivery.md

@@ -4,7 +4,7 @@
 
 ## なぜ配送が要るのか
 
-常駐の経路は実効上限で詰まっており、配送は該当する瞬間だけのコストで届き、拒否は読み飛ばせず、発火を単体テストで固定できる。経緯: `docs/maintainers/rule-delivery-rationale.md` →「なぜ配送が要るのか」。
+常駐の経路は実効上限で詰まっており、配送は該当する瞬間だけのコストで届き、拒否は読み飛ばせず、発火を単体テストで固定できる。経緯: `docs/maintainers/rule-delivery-rationale.md` → "Why delivery is needed"。
 
 ## 判定基準 — 引き金を特定できるか
 
@@ -12,7 +12,7 @@
 
 ## 機構 — 1 本だけ、新規に作らない
 
-配送はすべて 1 つの土台に載り、入口はイベントごとに 2 つある。`PreToolUse` の入口が `pnpm josh pretool:guard`（バッチング ／ 調査 ／ 規則の 3 ガードを 1 プロセスで合成）、Stop フックの入口が `pnpm josh stop:guard` である。**2 本目の配送経路を作るのは `CLAUDE.md` →「No clones」が禁じるクローン**である。配線・停止スイッチ・拒否の優先順位: `docs/maintainers/rule-delivery-rationale.md` →「機構」。
+配送はすべて 1 つの土台に載り、入口はイベントごとに 2 つある。`PreToolUse` の入口が `pnpm josh pretool:guard`（バッチング ／ 調査 ／ 規則の 3 ガードを 1 プロセスで合成）、Stop フックの入口が `pnpm josh stop:guard` である。**2 本目の配送経路を作るのは `CLAUDE.md` →「No clones」が禁じるクローン**である。配線・停止スイッチ・拒否の優先順位: `docs/maintainers/rule-delivery-rationale.md` → "The mechanism"。
 
 ## 配送されている規則
 
@@ -27,7 +27,7 @@
 - **バックログ WIP 上限**（`wip-cap.md`）
   - 発火点: `pnpm josh rule:guard` — Issue を起票する `Bash`（`pnpm josh issue:file`）
   - 発火しないとき: Issue が起票されていない ＝ 上限に触れる行為が無い
-- **直接起票の禁止**（`docs/josh-commands-automation.md` → `josh issue:file`、joshuafolkken/kit#2808）
+- **直接起票の禁止**（`docs/josh-commands-backlog.md` → `josh issue:file`、joshuafolkken/kit#2808）
   - 発火点: `pnpm josh rule:guard` — `josh issue:file` を通さずに Issue を作成する `Bash`（`gh issue create`、または `…/issues` への `title` 付き POST）。拒否文は `pnpm josh issue:file` の書式を渡す。**毎回発火する**
   - 発火しないとき: `pnpm josh issue:file` で起票している ＝ 重複探し・本文の検査・`epic:bundle` までの全段がそろっている
 - **1 ラン 10 件の起票上限**（`.claude/skills/workflow-commands/prerequisite.md`、`observation-filing.md`）
@@ -38,7 +38,7 @@
   - 発火しないとき: Issue を読んでいない、または最初から `--comments` ／ `--json comments` ／ `…/comments` で読んでいる
 - **本文をシェルに載せない**（`shell-body.md`）
   - 発火点: `pnpm josh rule:guard` — 二重引用符の本文値（`-f body="…"` ／ `-f "body=…"` ／ `--body "…"` ／ `--notify-message "…"`）にバッククォートか `$` を含む `Bash`
-  - 発火しないとき: 本文がシェルに評価されない ＝ 規則は既に守られている（経緯: `docs/maintainers/rule-delivery-rationale.md` →「本文のシェル評価を同じ機構の 1 行で覆った経緯」）
+  - 発火しないとき: 本文がシェルに評価されない ＝ 規則は既に守られている（経緯: `docs/maintainers/rule-delivery-rationale.md` → "Shell evaluation of a body is one more row of the same mechanism"）
 - **@path をリテラル投稿する誤射**（`shell-body.md`、joshuafolkken/kit#2304）
   - 発火点: `pnpm josh rule:guard` — 生フィールド（`-f` ／ `--raw-field`）で `body=@<path>` を渡した `Bash`。**毎回発火する**
   - 発火しないとき: `-F` ／ `--field body=@`・`@` を含まない本文・`pnpm josh issue:comment` ＝ リテラルの `@path` が送出されない
@@ -112,8 +112,8 @@
 
 ## 配送は 1 ラン 1 回
 
-配送文は**ラン 1 回につき 1 度**しか出ない — 2 度目も拒否すれば、規則に従った直後の呼び出しを止めてしまう。だから**配送文には「同じ呼び出しをもう一度出せ」と明記する**。例外は 2 つで、繰り返す行為を止める項目は毎回発火し（joshuafolkken/kit#1570）、前提の行為を求める項目は前提が末尾に現れるまで毎回拒否する（joshuafolkken/kit#2807）。これとは別に、バッチングと調査の 2 ガードは同じ呼び出しを二度拒否しないまま、違反が間隔分続けば再び発火する（joshuafolkken/kit#2164）— 1 回きりの注意ではない。先の 2 つの例外の配送文には「同じ呼び出しをもう一度出せ」ではなく、それぞれ「これは毎回発火する」「前提が末尾に現れるまで拒否する」と明記する — 1 回きりと読まれると、再発行すれば通ると誤解される。前提の証拠を読めないときは拒否を基本とする。経緯と意図した通過例外: `docs/maintainers/rule-delivery-rationale.md` →「配送は 1 ラン 1 回」。
+配送文は**ラン 1 回につき 1 度**しか出ない — 2 度目も拒否すれば、規則に従った直後の呼び出しを止めてしまう。だから**配送文には「同じ呼び出しをもう一度出せ」と明記する**。例外は 2 つで、繰り返す行為を止める項目は毎回発火し（joshuafolkken/kit#1570）、前提の行為を求める項目は前提が末尾に現れるまで毎回拒否する（joshuafolkken/kit#2807）。これとは別に、バッチングと調査の 2 ガードは同じ呼び出しを二度拒否しないまま、違反が間隔分続けば再び発火する（joshuafolkken/kit#2164）— 1 回きりの注意ではない。先の 2 つの例外の配送文には「同じ呼び出しをもう一度出せ」ではなく、それぞれ「これは毎回発火する」「前提が末尾に現れるまで拒否する」と明記する — 1 回きりと読まれると、再発行すれば通ると誤解される。前提の証拠を読めないときは拒否を基本とする。経緯と意図した通過例外: `docs/maintainers/rule-delivery-rationale.md` → "One delivery per run"。
 
 ## マーカーテスト
 
-各項目を固定するスイートの一覧: `docs/maintainers/rule-delivery-rationale.md` →「マーカーテスト」。
+各項目を固定するスイートの一覧: `docs/maintainers/rule-delivery-rationale.md` → "Marker tests"。

package/prompts/collaboration-workflow/shell-body.md

@@ -10,7 +10,7 @@
 gh api repos/{owner}/{repo}/issues/1535/comments -f body="… `pnpm josh ms` は …"
 ```
 
-zsh は `pnpm josh ms` を実行し、その標準出力を本文に埋め込む。`pnpm josh followup --notify-message "…"` の本文も同じ根で壊れる。事故の経緯は `docs/maintainers/shell-body-rationale.md` →「事故の経緯 — 二つの被害、一つの原因」。
+zsh は `pnpm josh ms` を実行し、その標準出力を本文に埋め込む。`pnpm josh followup --notify-message "…"` の本文も同じ根で壊れる。事故の経緯は `docs/maintainers/shell-body-rationale.md` → "The incidents — two kinds of damage, one cause"。
 
 - **通知経路**: 置換結果が本文に混ざる。壊れ方が静かで、`followup` は正常終了する
 - **`gh` 経路**: 置換された結果が捨てられるのではなく、**コマンドとして実行される**
@@ -26,7 +26,7 @@ zsh は `pnpm josh ms` を実行し、その標準出力を本文に埋め込む
 | `!`             | 発火しない（履歴展開は非対話では無効）               |
 | `\$` / `` \` `` | 発火しない（直前のバックスラッシュがリテラル化する） |
 
-`!` は引き金に入れていない。理由は `docs/maintainers/shell-body-rationale.md` →「`!` を引き金に入れない理由」。
+`!` は引き金に入れていない。理由は `docs/maintainers/shell-body-rationale.md` → "Why `!` is not a trigger"。
 
 ### 安全な書き方
 
@@ -39,7 +39,7 @@ pnpm josh followup "<title> #<N>" --notify-message-file <path>
 pnpm josh notify --task-type confirmation --issue-url "<url>" --body-file <path>
 ```
 
-**PR コメントも同じ経路である** — REST では pull request のコメントは issue のコメントであり、`pnpm josh issue:comment <N> --body-file <path>` がそのまま使える。`gh issue comment` / `gh pr comment` は使わない（GraphQL 経由。理由は `docs/maintainers/shell-body-rationale.md` →「`gh` サブコマンドを実行可能ブロックに書かない理由」）。
+**PR コメントも同じ経路である** — REST では pull request のコメントは issue のコメントであり、`pnpm josh issue:comment <N> --body-file <path>` がそのまま使える。`gh issue comment` / `gh pr comment` は使わない（GraphQL 経由。理由は `docs/maintainers/shell-body-rationale.md` → "Why no `gh` subcommand is written in an executable block"）。
 
 ### コメント投稿は `pnpm josh issue:comment` の 1 綴りだけ（joshuafolkken/kit#2304）
 
@@ -48,17 +48,17 @@ pnpm josh notify --task-type confirmation --issue-url "<url>" --body-file <path>
 - `gh api ... -F body=@<path>` ／ `--field body=@<path>` — `@` で始まる値を**ファイルとして読む**。正しい
 - `gh api ... -f body=@<path>` ／ `--raw-field body=@<path>` — 値を**そのまま送る**。`@<path>` というリテラル文字列がコメントとして投稿される
 
-`-f` と `-F` は 1 文字違いで、どちらでも `gh` は終了コード 0 でコメント URL を返す。**壊れたことが分かるのは後で人が Issue を見たときだけ**である（`docs/maintainers/shell-body-rationale.md` →「`-f body=@` で失われたコメント」）。
+`-f` と `-F` は 1 文字違いで、どちらでも `gh` は終了コード 0 でコメント URL を返す。**壊れたことが分かるのは後で人が Issue を見たときだけ**である（`docs/maintainers/shell-body-rationale.md` → "The comments lost to `-f body=@`"）。
 
 だから **Issue／PR コメントの投稿は `pnpm josh issue:comment <N> --body-file <path>` ただ 1 綴りに寄せる** — 間違ったフラグを選ぶ余地が無く、本文は `cli-body.ts` を通ってパスで渡るためシェルも評価しない。`-f body=@…` の綴りは実行前に `pnpm josh rule:guard` が拒否する（列挙表の `raw-field-body` 行、`scripts/rules/raw-field-body.ts`）。上の Issue body 書き換え（`-X PATCH ... --field body=@<path>`）は `-F` 側で安全なので綴りを変えない。
 
-`--body-file` / `--notify-message-file` はいずれも `-` で標準入力を読む（`gh issue create --body-file -` と同じ約束）。読み取りは `scripts/josh/cli-body.ts` の 1 本だけで、`josh notify` / `josh followup` / `epic --rationale-file` / `epic --decision-file` の 4 つがそれを共有する。**`--body` と `--body-file` の同時指定は拒否する**（`docs/maintainers/shell-body-rationale.md` →「`--body` と `--body-file` の同時指定を拒否する理由」）。
+`--body-file` / `--notify-message-file` はいずれも `-` で標準入力を読む（`gh issue create --body-file -` と同じ約束）。読み取りは `scripts/josh/cli-body.ts` の 1 本だけで、`josh notify` / `josh followup` / `epic --rationale-file` / `epic --decision-file` の 4 つがそれを共有する。**`--body` と `--body-file` の同時指定は拒否する**（`docs/maintainers/shell-body-rationale.md` → "Why `--body` and `--body-file` together are refused"）。
 
 **`$'…'` も安全である。** ANSI-C クォートの中ではコマンド置換も変数展開も起きない。`CLAUDE.md` が Telegram の本文に `--body=$'…'` を指定しているのはそのためであり、この規則はそれを置き換えるものではない。ただし本文が長くなるほどファイルの方が扱いやすい。
 
 ### 引き金つき配送
 
-`pnpm josh rule:guard` が、二重引用符の本文値にバッククォートか `$` が実際に含まれる `Bash` 呼び出しを拒否して本文を突きつける。拒否されたら本文をファイルに移して出し直す。配線は `docs/maintainers/shell-body-rationale.md` →「引き金つき配送にした理由」、引き金の設計は `docs/maintainers/shell-body-rationale.md` →「引き金をフラグでなく本文で引く理由」、固定しているテストは `docs/maintainers/shell-body-rationale.md` →「マーカーテスト」にある。
+`pnpm josh rule:guard` が、二重引用符の本文値にバッククォートか `$` が実際に含まれる `Bash` 呼び出しを拒否して本文を突きつける。拒否されたら本文をファイルに移して出し直す。配線は `docs/maintainers/shell-body-rationale.md` → "Why it is a triggered delivery"、引き金の設計は `docs/maintainers/shell-body-rationale.md` → "Why the trigger reads the body, not the flag"、固定しているテストは `docs/maintainers/shell-body-rationale.md` → "Marker tests"にある。
 
 ### 引き金が見えないもの