intent-planner 0.13.1

package/templates/ja/intent/README.md

@@ -0,0 +1,118 @@
+# Intent Planning Workflow
+
+このディレクトリは、大規模リファクタやアーキテクチャ変更のための軽量な Intent Planning workflow です。
+
+意図的に CLI ではなく、完全な IDD 状態機械でもありません。実装前に「全体の意図」と「統一した設計方針」を人間と Claude が良いタイミングで擦り合わせ、Claude が局所最適な小手先修正に逃げるのを防ぐためのものです。cc-sdd が個別 feature の spec を作る手前を補完します。
+
+## 目的
+
+実装の前に、以下を明確化します。
+
+1. Intent Tree（`intent-tree.md`）
+2. Intent Compass（`intent-compass.md`。覆された Decision Rules の退避先は `compass-archive.md`）
+3. Packet Plan（`packets/` — `active/` 配下の packet ファイルと `plan.md`・`index.md`。1 packet = 1 ファイルで管理し、完了した packet は `archive/` へ移動）
+4. cc-sdd の requirements / design / tasks 下書き（packet 毎の `cc-sdd/<スラッグ>/` ディレクトリ。README を除き Git 非追跡のローカル下書き）
+
+## ワークフロー
+
+1. `/intent-discover` を実行
+2. `intent-tree.md` をレビュー（モードと設計者役の詰めの問い designer-questions も確定される）
+3. `/intent-compass` を実行
+4. `intent-compass.md` をレビュー
+5. `/intent-packets` を実行
+6. `packets/` をレビュー（`plan.md` と `active/` 配下の packet ファイル）
+7. `/intent-export-cc-sdd` を実行
+8. cc-sdd 成果物をレビューしてから実装に進む
+
+## ライフサイクル（intent を育て続ける）
+
+上のワークフローは「計画」フェーズです。export 後も intent は使い捨てず、次のサイクルで育て続けます。
+
+- 計画: `/intent-discover` → `/intent-compass` → `/intent-packets` → `/intent-export-cc-sdd`
+- 実装: cc-sdd で実装する
+- 維持: `/intent-writeback`（packet 単位の学びの還流）、節目に `/intent-improve`（全体の再整合）
+- 随時: `/intent-status`（現在地と次の一手）、`/intent-validate`（export 前の検証）
+
+`/intent-writeback` の学びは `deltas.md` に delta として記録され（canonical 成果物は直接書き換えない）、`/intent-status` と `/intent-improve` がそれを参照します。
+
+### いつどのスキルを使うか
+
+| スキル | タイミング | 役割 |
+|--------|-----------|------|
+| `/intent-status` | 随時（迷ったとき） | 現在地の要約と「次の一手」をちょうど1つ推奨する（読み取り専用） |
+| `/intent-validate` | export 前（推奨） | 成果物間の矛盾・カバレッジ漏れ・境界不整合を深刻度付きで報告する（読み取り専用） |
+| `/intent-writeback` | packet の実装完了後 | 実装で得た学びを `deltas.md` に記録し、承認された項目だけを canonical 成果物へ昇格する |
+| `/intent-improve` | 節目（複数 packet 実装後など） | `.intent/` と実装の現実を completeness / correctness / coherence の3軸で再整合する |
+
+計画フェーズの4スキル（`/intent-discover`・`/intent-compass`・`/intent-packets`・`/intent-export-cc-sdd`）の使い方は上記「ワークフロー」を参照してください。
+
+## モード（Intent の詰め方アルゴリズム）
+
+Intent の詰め方は「モード」として切り替え可能です。`mode.md` に選択中のモードが記録され、各コマンドがそれを読んで一貫した戦略で動きます。モード定義は `modes/` にあり、新しいモードを追加できます（`modes/README.md` 参照）。
+
+`mode.md` には、モードと直交する軸として設計者役の詰めの問い（designer-questions: on / off）も記録されます。`/intent-discover` が入口でフローが代わりに問うてくれることを説明し、要否を確認します。on のときは共通の追加確認（L1 計測基準、walking skeleton、画面ラフ）と `/intent-validate` の規範検査が有効になり、さらに開発目的（purpose: poc / product）を確認して、poc なら仮説・反証条件・GO/NO-GO の確認が加わります。off のときの増分は要否確認の1問だけです。
+
+## Enforcement（書き戻し漏れの検査・任意）
+
+`/intent-writeback` の実行漏れを機械的に検出する任意のレイヤーです。**既定は off** で、設定しない限り動作は何も変わりません。`mode.md` の「Enforcement（ユーザー管理）」セクションを直接編集して切り替えます（`off`=既定・検査なし / `remind`=警告のみ / `gate`=export・push を停止）。
+
+検査されるのは次の2つです。
+
+- **pending delta の放置（中心）** — `deltas.md` に記録したまま、承認・反映されずに残っている delta
+- **staleness（実験的）** — 最後の書き戻し（または export）以降に `.intent/` 以外を変更したコミット数が閾値（`enforcement-threshold`、既定: 5）を超えた状態。無関係なコミットも数えるため誤検知が残ります。`enforcement-exclude` で計数から除くパスを指定できます。まず `remind` で試すことを推奨します
+
+検査が効くのは、`/intent-export-cc-sdd` の export 前・`/intent-status` の警告・インストーラ `--enforce` で配置した pre-push フックの3箇所です。判定はすべて読み取り専用スクリプト `scripts/intent-check.mjs` が行います（ファイルの作成・変更・削除はしません）。gate で停止しても、明示的な続行指示や `git push --no-verify` という逃げ道があります。enforcement が強制するのは手続きの実行のみで、書き戻し内容の正しさは保証しません。
+
+### Claude Code SessionStart hook（任意）
+
+セッション開始時に書き戻し漏れの警告をエージェントのコンテキストへ入れたい場合は、`.claude/settings.json` に次を手動で追記します（intent-planner が自動で書き込むことはありません）。
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          { "type": "command", "command": "node .intent/scripts/intent-check.mjs" }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### 注意（既知の制約）
+
+- nvm / volta 環境では、GUI の git クライアントの PATH に node が無いことがあり、その場合 pre-push フックの検査はスキップされます（stderr に1行通知が出ます）
+- `core.hooksPath` を使う環境（husky 等）では `.git/hooks` が呼ばれないため、配置した pre-push フックは効きません
+- git worktree や submodule など `.git` がファイルになっている環境では、`--enforce` のフック配置は失敗します
+- 旧 scaffold を導入済みの環境で enforcement を使うには、`mode.md` に Enforcement セクションを手動で追加してください（最新テンプレートの同セクションをコピー）
+
+## Drift-watch（逸脱監視・任意）
+
+enforcement と並ぶ、もう一つの**任意のクロスカット層**です。意図を立てたあと実装が進むほど「意図したソフトウェアでなくなっていく」逸脱（architectural drift）を、外れきる前に名指しで捕まえます。これは**モードではありません**（モードは排他で一度に1つだけ有効。drift-watch は `off` | `on` の独立スイッチです）。
+
+**既定は off** で、設定しない限り動作は何も変わりません。`mode.md` の「Drift-watch（ユーザー管理）」セクションを直接編集して `on` に切り替えます。
+
+`on` のとき、`/intent-discover` が Intent Tree の地形診断を、`/intent-export-cc-sdd` が export 水際で compass 照合の警告を出します。**いずれも警告のみで停止しません**（enforcement の `gate` とは別概念で、誤検知前提のため停止する値を持ちません）。検知は `.intent/drift-log.md` にローカル記録されます（外部への送信は一切なく、`.intent/` 内で完結します）。
+
+根拠となるのは `.intent/drift-patterns.md`（逸脱の型カタログ）で、配布時の seed は網羅ではなく、**利用者が自分の現場で踏んだ逸脱を型として足して育てる**前提です。集計（改善度レポート）は新コマンドを増やさず、`/intent-status` の軽い併記と `/intent-improve` の pattern×outcome クロス集計に相乗りします。
+
+## エージェント向けルール
+
+### 計画フェーズ（intent-* スキル実行時）
+
+- Intent Planning フェーズではアプリケーションコードを変更しない。
+- parent intent を支えない局所リファクタを提案しない。
+- 各 packet は parent intent を必ず参照する。
+- 各タスクは invariant を保持する。
+- 意図が不明なときはコードを編集せず Open Questions に書く。
+- 推測された意図は、人間がレビューするまで暫定として扱う。
+
+### 実装フェーズ（Agent Contract — packet を実装するエージェントへ）
+
+1. Invariants は絶対制約（hard constraint）として扱う。
+2. Decision Rules は superseded と明記されない限り有効として扱う。
+3. Anti-direction に該当する実装を行わない。
+4. packet が Compass と矛盾する場合は実装を停止して人間に確認する。
+5. コード実態が intent と矛盾する場合は delta として記録し（`/intent-writeback`）、intent を黙って書き換えない。

package/templates/ja/intent/cc-sdd/README.md

@@ -0,0 +1,28 @@
+# cc-sdd Export 下書き置き場
+
+> `/intent-export-cc-sdd` が packet ごとの下書きをこの配下に書きます。この README 以外は Git 非追跡（ローカル専用）です。読み手は cc-sdd へ受け渡す利用者と、`/intent-writeback`・`/intent-status`・`/intent-validate` です。下書きの書式の正は export skill の rules（map-cc-sdd）にあり、ここに雛形は置きません。
+
+## 構造
+
+```
+.intent/cc-sdd/
+├── README.md          # この説明（Git 追跡対象）
+└── <packetスラッグ>/   # /intent-export-cc-sdd が packet ごとに生成（非追跡）
+    ├── requirements.md
+    ├── design.md
+    └── tasks.md
+```
+
+ディレクトリ名（スラッグ）は packet 名から決定的に導出されます（規則・衝突時の扱いは map-cc-sdd 参照）。
+
+## 3下書きの役割
+
+- **requirements.md** — cc-sdd の `/kiro-spec-init` に渡す凝縮 Project Description。`## Source Packet`（packet 名の正確な転記）・`## Parent Intent`・`## Invariants` の見出しを必ず含みます。
+- **design.md** — cc-sdd が design を生成する際の見落とし防止ヒント（箇条書き）。本体ではありません。
+- **tasks.md** — 先頭に Intent 由来の制約（parent intent / invariant / Anti-direction）、続いて cc-sdd の tasks 生成チェック項目。
+
+## Git 非追跡の方針
+
+- packet ディレクトリ配下の下書きはローカル専用で Git に追跡されません（追跡対象はこの README のみ）。これにより、チームでのマージ衝突や上書きによる下書き喪失は設計上起きません。
+- export の履歴は Git 共有される `.intent/export-log.md` に1 export = 1行で残ります。「現行 packet」の判定もこのログが正典です。
+- 下書きは writeback 完了後も削除されず、過去 packet の書き戻し漏れの突合（export-log × 残存下書き × deltas.md）に使えます。

package/templates/ja/intent/compass-archive/README.md

@@ -0,0 +1,9 @@
+# compass-archive/（分割形）
+
+compass-archive は superseded になった Decision Rule を退避する記録なので、**退避された Decision Rule の rule 単位ファイル** `compass-archive/<rule-slug>.md` に分割して書く。同一 rule の再 supersede は同じファイルに集まる（rule が自然キー）。
+
+- ファイル名の `<rule-slug>` は退避された Decision Rule の識別子を既存のスラッグ規則（`intent-packets/rules/packet-format.md`）で導出する。連番（`0001` 等の中央カウンタ）は使わない。
+- 退避は writeback / improve が Decision Rules を supersede したときに行う。**6欄（Context / Decision / Why / Alternatives considered / Consequences / Revisit when）+ 後継参照はそのまま（byte 不変）で move する**（要約・改変しない＝記録の中身不可侵）。
+- このファイル群自体が archive 役なので、`archive/` サブディレクトリは年単位の更なる退避先（必要時）。
+
+> この README は規約の**言い換え**であり、規約の単一正本は CONTRACT.md「append-only 記録の分割・archive 規約」。置き方の判断は CONTRACT を参照すること。

package/templates/ja/intent/compass-archive.md

@@ -0,0 +1,7 @@
+# Compass Archive
+
+> `/intent-writeback`・`/intent-improve` が、superseded になった Decision Rules エントリを6欄のまま末尾追記で退避します。読み手は人間で、必要なときにだけ参照します。既存行は変更しません。
+
+記入例（この6欄形式のまま末尾に追記する。superseded 注記 + 後継参照付き）:
+
+- **Context**: (問いと状況) / **Decision**: (採った選択肢) / **Why**: (基準) / **Alternatives considered**: (検討した代替案とその理由) / **Consequences**: (Invariants・Anti-direction への接続) / **Revisit when**: (見直し条件) — superseded: (後継エントリへの参照)

package/templates/ja/intent/constraint-library.md

@@ -0,0 +1,32 @@
+# Constraint Library（あなたが育てる制約の台帳）
+
+> あなたが繰り返し使う制約（Anti-direction / Invariant）を、このプロジェクトの `.intent/` 内に貯めて再利用するための台帳です。`/intent-compass` が叩き台を提示するとき、同梱の `constraint-starters.md` と並べてここに貯めた制約も候補に出します。**編集は人が行い、skill は read のみで自動改変しません。** 採用した制約をここへ書き加えるのも人の手（または人の明示承認）で行います。
+
+## この台帳の使い方
+
+- **これはあなたが育てるファイルです。** 同じドメインの開発を繰り返すうちに「自分はいつもこれを Anti-direction / Invariant にしている」という制約が溜まります。それをここへ追記して再利用します。
+- **このプロジェクト内に閉じます。** この台帳は当該 repo の `.intent/` 配下にのみ置かれ、プロジェクトをまたいで共有されることはありません（他に資産を持ち出せない案件でも、制約がプロジェクトの外へ漏れない設計です）。再インストールやバージョンアップでも、ここに書いた内容は上書きされず保持されます。
+- **canonical（人が編集）です。** 提示 skill はこの台帳を read のみで参照し、自動では書き換えません。
+- **これは静的な文書です。** 利用のたびに外部サービス・データベースへ問い合わせることはありません。
+
+## 記入スキーマ
+
+繰り返し使う制約を次のスキーマで追記してください。`id` は kebab-case として一意にします。
+
+```markdown
+## id: <kebab-case 識別キー>
+- name: <短い名前>
+- 領域: <code | non-code>
+- 適合する状況: <どんな案件・題材のときこの制約を効かせたいか>
+- 制約:
+  - Anti-direction: <避けたい方向>
+  - Invariant: <守りたい不変条件>
+- 由来: <この制約をどこで学んだか・なぜ自分の定番にしているか（任意）>
+```
+
+- ここに貯めた制約は、`/intent-compass` が叩き台を提示するときに同梱カタログと並んで候補に出ます（提示は候補まで・採否は人が判断します）。
+- 同梱の `constraint-starters.md`（開発者がメンテして配る定石）と、この `constraint-library.md`（あなたが育てる制約）は別ファイルです。
+
+---
+
+<!-- ここから下に、あなたの繰り返し使う制約を追記してください（上の記入スキーマに従って）。 -->

package/templates/ja/intent/constraint-starters.md

@@ -0,0 +1,58 @@
+# Constraint Starters（制約の叩き台カタログ）
+
+> `/intent-compass`（主接点）・`/intent-discover`（地形診断レーン）が、Anti-direction / Invariants を書くときの**叩き台候補**として読みます。同梱のドメイン定石を文脈と照合して「このケースはこれでしょ」と候補提示するための母集合です。**提示は read-only の叩き台であり、compass への転記は人が採否を選んでから手動で行います**（AI が自動転記しません）。利用者が自分のよく使う制約は別ファイル `constraint-library.md` で育てます。
+
+## このカタログの読み方
+
+- **これは網羅ではありません。** ここに載っている定石は出発点（seed 2件・コード/非コード各1件）にすぎません。後続の提示は文脈に合う定石を**候補**として並べるだけで、採否は利用者が判断します。
+- 各定石は `id`（kebab-case）で識別します。`領域` でコード／非コードを区別し、`適合する状況` で「どんな案件のとき効くか」を、`叩き台` で Anti-direction 候補・Invariant 候補を持ちます。
+- **これは補助であって置き換えではありません。** compass の Anti-direction/Invariant 導出（影響リスト→Invariant 化・プレモータム→Anti-direction）はそのままで、その前段に叩き台候補を差し込むだけです。
+- **これは静的な文書です。** 利用のたびに外部サービス・オンライン照会・データベースへ問い合わせることはありません。「最新の定石を取得する」目的の外部呼び出しもしません。同梱の静的内容と、後続スライスでの文脈補完に留めます。
+- **これは既存の逸脱カタログ（drift-patterns）・気づきカタログ（context-cost-cues）とは別カタログです。** 溜める対象が違う（再利用したい制約定石）ため別ファイルにしており、逸脱ログ（drift-log）の記録・集計には一切触れません。
+
+## 出自・正確性の検証規律（同梱定石の品質）
+
+- **各定石は出典（`出典` フィールド）を必ず持ちます。** 根拠（一次情報の URL 等）と取得日を記し、出自不明の定石を同梱しません。誤った・陳腐化した定石を「このケースはこれでしょ」と押し付けないための歯止めです。
+- **正確性レビュー**: 定石を追加・更新するときは、出典が実在し、現在も妥当であることを確認します（推測や捏造の出典を付けません）。
+- **更新方針**: 出典が陳腐化した（推奨が変わった・撤回された等）定石は、出典を更新するか、定石自体を見直します。
+- **ライセンス**: 出典から引用する場合は、引用元のライセンス・利用条件を尊重します。
+
+## 定石の書き方
+
+新しい定石は次のスキーマで追記してください。`id` は kebab-case として一意にします。`出典` は必須です（出典なしの定石を加えないでください）。
+
+```markdown
+## id: <kebab-case 識別キー>
+- name: <短い名前>
+- 領域: <code | non-code>
+- 適合する状況: <どんな案件・題材のときこの定石が効くか。compass/discover が文脈と照合する手がかり>
+- 叩き台:
+  - Anti-direction: <その状況で書かせたい anti-direction 候補>
+  - Invariant: <同 invariant 候補。題材依存なら compass が文脈から具体化する>
+- 出典: <根拠（一次情報の URL 等）・取得日。必須>
+```
+
+- `適合する状況` は「これに当てはまったら必ずこの定石」という強い判定条件ではなく、照合の手がかりとして書きます（誤検知前提・候補を絞り押し付けません）。
+- `叩き台` は compass の Anti-direction/Invariants へ**そのまま入れる確定値ではなく**、人が採否を選ぶ候補です。
+
+---
+
+## id: sql-injection-placeholder
+
+- name: SQL インジェクション対策（プレースホルダ徹底）
+- 領域: code
+- 適合する状況: Web アプリ等で、ユーザー入力を含む値を使って SQL を組み立てる・データベースへ問い合わせる案件。文字列連結でクエリを作る進み方が見えるとき。
+- 叩き台:
+  - Anti-direction: ユーザー入力を文字列連結で SQL に埋め込まない。動的に組み立てたクエリ文字列をそのまま実行しない。
+  - Invariant: ユーザー由来の値は必ずプレースホルダ（パラメータ化クエリ）経由で渡す。値を SQL 構文の一部として連結しない。
+- 出典: OWASP SQL Injection Prevention Cheat Sheet（https://cheatsheetseries.owasp.org/cheatsheets/SQL_Injection_Prevention_Cheat_Sheet.html・取得 2026-06-21）
+
+## id: slide-deck-structure
+
+- name: 発表資料の構成セオリー（主張先行・1スライド1メッセージ）
+- 領域: non-code
+- 適合する状況: 発表資料・プレゼンテーション・提案スライドを作る案件。情報を詰め込みがち・結論が後ろに回りがちな進み方が見えるとき。
+- 叩き台:
+  - Anti-direction: 1枚のスライドに複数の主張を詰め込まない。結論を末尾まで伏せて事実の羅列から始めない。
+  - Invariant: 1スライド＝1メッセージを保つ。各スライドは主張（結論）を先に置き、根拠で支える構成にする。
+- 出典: Barbara Minto "The Pyramid Principle"（結論先行・MECE の構成原則）／Garr Reynolds "Presentation Zen"（1スライド1メッセージ）・取得 2026-06-21

package/templates/ja/intent/context-cost-cues.md

@@ -0,0 +1,55 @@
+# Context Cost Cues（コンテキストを食う場面の気づきカタログ）
+
+> `/intent-discover`・`/intent-improve` が読みます（`drift-watch: on` のとき）。**コンテキストを食う場面に気づかせるための手がかりであり、否定・矯正はしません。** 大量スキル導入や全文投入は精度を上げる正当な選択でありえます。**どのログにも記録しません**（消費量は計測不能で、設定やスキル構成といったプライバシーにも踏み込みません）。利用者が自分の現場で踏んだ型を追記して育てるファイルです。
+
+## このカタログの読み方
+
+- **これは網羅ではありません。** ここに載っている型は出発点（seed 4件）にすぎません。あなたの現場で実際にコンテキストを食った場面を型として追記し、育てていく前提のファイルです。
+- 各型は集計キー（`id`）で識別します。型を増やすほど、「コンテキストを食っているかもしれない」と気づける範囲が広がります。
+- **これは規範ではなく気づきです。** 型に「当てはまった」ことは無駄の確定ではありません。大量スキルの導入・全文ロードは意図的で正当な選択でありえます。当てはまったら「これがコンテキストを食っているかもしれない」と**気づかせるだけ**で、無駄か否かの判断は利用者に委ねます。「直せ」とは言いません。
+- **どのログにも記録しません。** 消費量は計測できず、何が文脈を食うかは人により正当に異なるため、記録すればプライバシーに踏み込みます。気づきは read-only の助言に留めます。
+
+## 型の書き方
+
+新しい型は次のスキーマで追記してください。`id` は kebab-case の集計キーとして一意にします。
+
+```markdown
+## id: <kebab-case 集計キー>
+- name: <短い名前>
+- symptom: <題材・進み方の手がかり。discover/improve が題材と照合する弱い手がかり>
+- もし意図せず効いていれば:
+  - 代わりに: <意図せず効いていた場合に思い出せる軽い代替（薄い入口 / JIT pull / 入力限定）。命令ではなく任意の選択肢>
+```
+
+- `symptom` は「これに当てはまったら必ず無駄」という強い判定条件ではなく、照合の手がかりとして書きます（弱い手がかりにすることで fixation を避けます）。
+- 「もし意図せず効いていれば」は、その型が疑われたときに思い出せる**任意の軽い代替**です。命令形（「直せ」「やめろ」）は使わず、意図的な高コスト選択を否定しません。
+
+---
+
+## id: full-compass-load
+
+- name: 判断基準の全文ロード
+- symptom: 判断基準を1点だけ要するのに、intent-compass.md（判断基準の文書）を全文読んでいるかもしれない。1つの Invariant / Decision Rule を確かめたいだけの場面で、文書全体を文脈に載せている進み方。
+- もし意図せず効いていれば:
+  - 代わりに: 必要な Decision Rule / Invariant を見出し単位で JIT に pull する（薄い入口から該当節だけ読む）軽い代替もあります。全文が要る場面ならそのままで構いません。
+
+## id: whole-tree-read
+
+- name: 意図ツリーの全文読み
+- symptom: L0〜L3 のうち1階層だけ要するのに、intent-tree.md を毎回全部読んでいるかもしれない。特定の成果や能力だけ参照したい場面で、ツリー全体を文脈に載せている進み方。
+- もし意図せず効いていれば:
+  - 代わりに: 必要な層だけを名指しで読む軽い代替もあります。固定ロード文脈へ全文を貼らない選び方です。全体俯瞰が要る場面ならそのままで構いません。
+
+## id: steering-bloat
+
+- name: 固定ロード文脈の肥大
+- symptom: 生成した steering や参照ドキュメントが毎回ロードされる固定文脈を肥大させているかもしれない。責務を足すたびに常時ロード対象が増え、コンテキストが線形に膨らんでいく進み方。
+- もし意図せず効いていれば:
+  - 代わりに: 固定ロードは薄く保ち、詳細は参照先へ逃がして必要時だけ pull する軽い代替もあります。常時その文脈が要る確信があるならそのままで構いません。
+
+## id: redundant-reread
+
+- name: 不要な再読み込み
+- symptom: 直前に読んだ、または編集したばかりのファイルを、内容が変わっていないのに再度読み込んでいるかもしれない。同じ内容を短い間隔で複数回コンテキストに載せている進み方。
+- もし意図せず効いていれば:
+  - 代わりに: 直前に読んだ/編集した内容はそのまま使い、再読み込みを省く軽い代替もあります。並行編集などで変わった可能性を確かめたい場面ならそのままで構いません。

package/templates/ja/intent/deltas/README.md

@@ -0,0 +1,11 @@
+# deltas/（分割形の active 面）
+
+deltas は **packet 由来**の記録なので、**packet 単位ファイル** `deltas/<packet-slug>.md` に分割して書く。別 packet が別ファイルを触るため末尾衝突が原理的に消える。
+
+- ここ（active 面）には現在参照する delta だけを薄く置く。
+- 終端した（もう更新されない）エントリは `deltas/archive/<年>/` へ退避する。
+- ファイル名の `<packet-slug>` は既存の packet スラッグ規則（`intent-packets/rules/packet-format.md`）を参照する。連番（`0001` 等の中央カウンタ）は使わない。
+
+> この README は規約の**言い換え**であり、規約の単一正本は CONTRACT.md「append-only 記録の分割・archive 規約」。置き方の判断は CONTRACT を参照すること。
+
+既存の単一ファイル `../deltas.md` は残してよい（新分割形と共存）。active には実エントリを置かず、エントリは writeback/discover が分割形で生成する。

package/templates/ja/intent/deltas.md

@@ -0,0 +1,34 @@
+# Intent Deltas
+
+> `/intent-writeback` が記録し、`/intent-status` と `/intent-improve` が参照します。canonical 成果物（intent-tree.md / intent-compass.md / `.intent/packets/` 配下の packet ファイル・plan.md）は、この delta 経由でのみ事後更新されます。
+
+## 運用説明
+
+- 書き戻しは二段階です: `/intent-writeback` はまず学びをここに delta として記録し（canonical は直接書き換えない）、ユーザーが承認した項目だけを canonical 成果物へ昇格させます。
+- 1 packet の1回の書き戻し = 1 エントリ。同一 packet の再書き戻し（再 export・再実装後）は新エントリとして追記します（履歴保持）。「対応 delta の有無」の機械判定は初回サイクルのみ有効で、2巡目以降の書き戻し要否は過去エントリ一覧を見てユーザーが判断します。
+- 下書きの保持（packet 毎ディレクトリ）: `.intent/cc-sdd/<packetスラッグ>/` の下書きは packet ごとに永続保持されます（Git 非追跡・ローカル専用）。書き戻しが完了しても下書きは削除されません。export 履歴は `.intent/export-log.md` に記録されており（export ごとに packet 名・日時・コミットを1行追記）、過去に export した packet の書き戻し漏れは export-log.md の全行 × 残存する `.intent/cc-sdd/<packetスラッグ>/` 下書き × このファイルの突合で列挙します。
+
+## 状態の意味論
+
+- `pending`: 記録済みで未昇格。
+- `promoted` / `closed` は終端状態です。1件以上を承認して canonical へ反映 → `promoted`、全項目を「却下」で見送り → `closed`。
+- 見送り項目には「却下（再提案不要） | 保留（次回 writeback で再提案）」の2値タグが必須です。保留の項目だけが次回 `/intent-writeback` での再提案対象（および `/intent-improve` の確認対象）になり、タグの確定更新（昇格 / 却下確定 / 継続保留）は `/intent-writeback` が行います。
+- `[question]` タグの学びは intent-tree.md の Open Questions へ転記した時点で消化済みです（転記先を昇格記録の反映先に記録します）。
+
+## Delta: <packet-name> — <ISO 8601 日付>
+
+- Status: pending | promoted (<昇格日>) | closed (<クローズ日>)
+- Source: export-log.md 最新行 | .intent/cc-sdd/<packetスラッグ>/ の Source Packet | ユーザー指定
+
+### 学び
+
+- [decision] <新しい決定>
+- [invariant-violation] <発見された invariant 違反>
+- [implicit-behavior] <意図に書かれていなかった暗黙挙動>
+- [deferred-resolved] <解消された Deferred>
+- [question] <新たな未解決 Question>
+
+### 昇格記録（promoted / closed 時）
+
+- 反映先: intent-compass.md Decision Rules 新エントリ（旧エントリに superseded 注記）/ intent-tree.md L3 / 対象 packet ファイル（active/ 配下）/ plan.md の Deferred（解消の注記）
+- 見送り: <昇格しなかった学び> — 却下（再提案不要） | 保留（次回 writeback で再提案）

package/templates/ja/intent/drift-log/README.md

@@ -0,0 +1,11 @@
+# drift-log/（分割形の active 面）
+
+drift-log は **事象由来**の記録なので、**日付+slug 単位ファイル** `drift-log/<date>-<slug>.md` に分割して書く。別事象が別ファイルを触るため末尾衝突が原理的に消える。
+
+- ここ（active 面）には現在参照する事象だけを薄く置く。
+- 終端した（もう更新されない）エントリは `drift-log/archive/<年>/` へ退避する。
+- ファイル名の `<slug>` は既存のスラッグ規則（`intent-packets/rules/packet-format.md`）を参照する。連番（`0001` 等の中央カウンタ）は使わない。
+
+> この README は規約の**言い換え**であり、規約の単一正本は CONTRACT.md「append-only 記録の分割・archive 規約」。置き方の判断は CONTRACT を参照すること。
+
+既存の単一ファイル `../drift-log.md` は残してよい（新分割形と共存）。9キースキーマ（記録の中身）は変えない。active には実エントリを置かず、エントリは drift 記録の書き手が分割形で生成する。

package/templates/ja/intent/drift-log.md

@@ -0,0 +1,41 @@
+# Drift Log
+
+> `/intent-discover`・`/intent-export-cc-sdd`・`/intent-improve` のフックが逸脱（drift）の検知を1エントリずつ追記します。書き手はこの3つのフックのみで、読み手は `/intent-status`（軽い併記）と `/intent-improve`（pattern × outcome のクロス集計）です。`drift-watch: off`（既定）のときは誰も書きません。
+>
+> **読むときの注意**: `missed=0` は「効いた証拠」ではなく「記録漏れの疑い」と読んでください。効いた瞬間（prevented / caught）だけが集計に残るのは確証バイアスです。効かなかった瞬間（missed / false-positive / not-applicable）も均等に記録される前提でこのファイルは設計されています。
+
+## 運用説明
+
+- **append-only**: エントリは追記のみです。過去のエントリを書き換えたり削除したりしません（世界線アンカーの非対称を生まないため）。
+- **outcome は下書き / user-verdict は確定**: `outcome` は drift-watch が推定して下書きします。`user-verdict` は利用者が確定します（Intent Tree の canonical / inferred と同じ分離）。利用者が未判定でも `unjudged` のまま記録・集計対象になります。
+- **世界線アンカー（Layer 1）**: 各エントリは `recorded_at`（記録した時刻）と `commit`（記録した世界線）を最初から持ちます。後付けで過去エントリに足すと非対称が生まれるため、最初から記録します。immutability は git に委ね、このファイルは「現在の射影」のまま保ちます。
+- **有効期間を持たない**: drift は事象であって状態ではないため、`valid_until` 等の valid-time 欄は持ちません。
+
+## エントリ書式
+
+各エントリは次の9キーを固定順の Markdown リストで持ちます。`<!-- -->`（HTML コメント）で囲まれた下記は記入見本で、実エントリには含めません。
+
+<!--
+### drift-log entry
+- pattern: <drift-patterns の id | uncatalogued:<短い名>>
+- stage: <discover | export | improve>
+- packet: <packet 名 | ->
+- mechanism: <compass-anti-direction | compass-invariant | pattern-catalog | packet-scope-overflow | none>
+- outcome: <prevented | caught | missed | false-positive | not-applicable>
+- user-verdict: <valid | false-alarm | unjudged>
+- recorded_at: <ISO 8601>          # transaction time（記録した時刻）
+- commit: <短縮ハッシュ | ->        # 世界線アンカー（Layer 1）。取得不可時は -
+- note: <1〜2行>
+-->
+
+## outcome の5値（確証バイアスの構造的回避）
+
+効いた系と効かなかった系を対称に列挙します。「effective だけ書く欄」を物理的に作りません。
+
+| 効いた系 | 効かなかった系 |
+|---|---|
+| `prevented`（discover の予防成功） | `missed`（防げず通った） |
+| `caught`（export の捕捉成功） | `false-positive`（誤検知だった） |
+| | `not-applicable`（地形に無かった・空振り） |
+
+集計は `pattern × outcome` のクロス集計を前提とします。`missed=0` は「効いた」ではなく「記録漏れの疑い」と読みます。

package/templates/ja/intent/drift-patterns.md

@@ -0,0 +1,68 @@
+# Drift Patterns（逸脱の型カタログ）
+
+> `/intent-discover` が地形診断の根拠として読みます（`drift-watch: on` のとき）。利用者が自分の現場で踏んだ逸脱を型として足して育てるファイルです。
+
+## このカタログの読み方
+
+- **これは網羅ではありません。** ここに載っている型は出発点（seed 1件 + 汎用2件）にすぎません。あなたの現場で実際に踏んだ逸脱を型として追記し、育てていく前提のファイルです。
+- 各型は集計キー（`id`）で `drift-log.md` と突き合わせます。型を増やすほど、着手前に「踏みやすい地形」を名指しできる範囲が広がります。
+- 同梱の汎用2件（`premature-abstraction` / `layer-leak`）は、症状の異なる**弱い手がかり**として置いています。1個の強い代表例（`microservice-over-split`）に思考が固着（fixation）しないよう、あえて毛色を散らしてあります。
+- 型に「該当した」ことは逸脱の確定ではありません。地形診断は誤検知前提です。該当したら**先に anti-direction / invariant を書いておく**ことで、外れきる前に手を打ちます。
+
+## 型の書き方
+
+新しい型は次のスキーマで追記してください。`id` は kebab-case の集計キーとして一意にします（`drift-log.md` の `pattern` がこの `id` を参照します）。
+
+```markdown
+## id: <kebab-case 集計キー>
+- name: <短い名前>
+- symptom: <題材・進み方の手がかり。discover が題材と照合する弱い手がかり>
+- 先に書かせるもの:
+  - Anti-direction: <該当型が疑われたとき compass 化前に書かせる anti-direction 候補>
+  - Invariant: <同 invariant 候補。題材依存なら discover が文脈から具体化する>
+```
+
+- `symptom` は「これに当てはまったら必ず逸脱」という強い判定条件ではなく、照合の手がかりとして書きます（弱い手がかりにすることで fixation を避けます）。
+- 「先に書かせるもの」は、その型が疑われたときに compass 化より前に Intent Tree の Open Questions / anti-direction 候補へ書かせる文面です。題材に依存する部分は discover が文脈から具体化します。
+
+---
+
+## id: microservice-over-split
+
+- name: マイクロサービス過剰分割
+- symptom: 単一の意図に対し「分割して疎結合に」という美徳へ過剰適応し、サービス・モジュール・パッケージを必要以上に切り出していく。境界をまたぐ呼び出しや調整コストが増え、当初の意図より複雑・疎結合過剰になっていく進み方。
+- 先に書かせるもの:
+  - Anti-direction: 「疎結合・分割」を目的化しない。サービス／モジュールを増やす変更は、その分割が解く具体的な問題を1つ名指しできるときだけ行う。
+  - Invariant: 当初の意図が要求しない境界（サービス・プロセス・パッケージの分割）を増やさない。分割は意図の境界（L3）に一致するときのみ許す。
+
+## id: premature-abstraction
+
+- name: 早すぎる抽象化
+- symptom: まだ用例が1〜2件しかない段階で共通化・汎用基底・設定駆動の枠組みを先に作り始める。「将来こう使うかも」を根拠に、現に存在しない要求のためのレイヤーや拡張点を導入していく進み方。
+- 先に書かせるもの:
+  - Anti-direction: 現に存在しない将来要求のための抽象化・汎用化を先回りで作らない（rule of three を待つ）。
+  - Invariant: 抽象（共通基底・汎用枠組み・設定駆動）の導入は、実在する用例が3件以上あるか、意図が明示的に汎用性を要求するときに限る。
+
+## id: layer-leak
+
+- name: レイヤー越境
+- symptom: 本来下層に閉じるべき関心事（ドメインロジック・永続化・外部 I/O）が上層（UI・ハンドラ・表示層）へ滲み出す、あるいはその逆向きに依存が逆流する。各変更は局所的に楽でも、層の責務境界が少しずつ崩れていく進み方。
+- 先に書かせるもの:
+  - Anti-direction: 目先の都合でドメインロジックや I/O を表示層・ハンドラへ寄せない。層をまたぐ近道をしない。
+  - Invariant: 各層の責務境界（依存の向き）を保つ。上層は下層に依存してよいが、下層は上層に依存しない。
+
+## id: coinage-proliferation
+
+- name: 造語が増えやすい地形
+- symptom: AI が正規語彙（ubiquitous language）に既にある語を再利用せず、台帳に無い新造の語を次々と充てていく。同じ概念に複数の言い回しが並び、語彙が分裂して意図の擦り合わせ（製品の核）が崩れていく進み方。
+- 先に書かせるもの:
+  - Anti-direction: 正規語が既にある概念へ新しい語を作らない。やむを得ず新語を導入するときは初出に一行の説明を添える。
+  - Invariant: 用いる語は glossary の正規語彙へ辿れるか、初出で一行説明されている。台帳に無い語を説明なしで増やさない。
+
+## id: scope-creep
+
+- name: スコープが拡大しやすい地形
+- symptom: export 済みの作業単位（packet）の宣言スコープを超える実装指示が後から来る（例: フロント専用 packet なのにバックエンド・認可・トランザクション境界の実装を足すよう求める）。各追加は局所的に自然でも、新領域でこそ必要になる packet 固有の不変則（認可・データ整合性・トランザクション境界・冪等性）が抜け落ちたまま積み上がる進み方。
+- 先に書かせるもの:
+  - Anti-direction: export 済み packet の `## Scope` を超える指示を cc-sdd でそのまま押し切らない。新領域は別 packet として intent に戻す。
+  - Invariant: 実装は対象 packet の宣言スコープ（`## Scope` / `## Non-scope`）内に留まる。新領域に及ぶなら、その領域の packet 固有不変則（認可・整合性・トランザクション境界・冪等性）を先に立てる。

package/templates/ja/intent/export-log/README.md

@@ -0,0 +1,12 @@
+# export-log/（分割形の active 面）
+
+export-log は **packet 由来**の記録なので、**packet 単位ファイル** `export-log/<packet-slug>.md` に分割して書く。別 packet が別ファイルを触るため末尾衝突が原理的に消える（cc-sdd / openspec の export が同一単一ファイルへ追記する共有衝突も解消する）。
+
+- ここ（active 面）には現在参照する export 記録だけを薄く置く。
+- 終端した（もう参照しない）エントリは `export-log/archive/<年>/` へ退避する。
+- ファイル名の `<packet-slug>` は既存の packet スラッグ規則（`intent-packets/rules/packet-format.md`）を参照する。連番（`0001` 等の中央カウンタ）は使わない。
+- **旧 `../export-log.md` は生成 active ミラーとして残す**: 読み手横断追随が完結するまで、書き手は毎 export で分割ファイルを `exported_at` 昇順に連結して `../export-log.md` を再生成する（派生・手編集しない）。これにより単一ファイルを読む既存経路が壊れない。
+
+> この README は規約の**言い換え**であり、規約の単一正本は CONTRACT.md「append-only 記録の分割・archive 規約」。置き方の判断は CONTRACT を参照すること。
+
+active には実エントリを置かず、エントリは export の書き手（intent-export-cc-sdd / intent-export-openspec）が分割形で生成する。

package/templates/ja/intent/export-log.md

@@ -0,0 +1,6 @@
+# Export Log
+
+> `/intent-export-cc-sdd` が export ごとに1行追記します（1 export = 1行）。書き手は `/intent-export-cc-sdd` のみで、読み手は intent-check スクリプト・`/intent-status`・`/intent-writeback` です。書き戻し漏れの照合に使われるため、手動編集は不要です。
+
+| packet | exported_at | commit |
+|---|---|---|

package/templates/ja/intent/glossary.md

@@ -0,0 +1,23 @@
+# Glossary（正規語彙の軽量台帳・β）
+
+> このプロジェクトで合意された正規語彙（ubiquitous language）の母集合を1か所にまとめる軽量な canonical 台帳です。`/intent-validate` が「台帳に無い語＝造語の疑い」を read-only で名指しする際の母集合として読みます。**編集は人が行い、skill は read のみで自動改変しません。**
+
+## この台帳の使い方
+
+- **用途は「正規語＋表記ゆれ/同義語の集約」に限定します。** 用語を訳語へ一括置換するための辞書ではありません（読みやすさ・discoverability を損なう訳語置換はしません）。
+- **これは網羅ではありません。** 正規語が増えたら行を追記して育てる前提のファイルです。新しい語を正式採用したら、その正規語と表記ゆれ・一行説明をここに登録してください。
+- **canonical（人が編集）です。** 造語管理 skill はこの台帳を read のみで参照し、自動では書き換えません。言い換え案の反映は人が承認してからの別アクションです。
+- 「正規語」列に無い語が intent 成果物に現れたとき、検出はそれを「造語の疑い」として候補提示します。固有名詞・既存の英語用語・初出一行説明済みの正当な新語は除外されます。
+
+## 記入スキーマ（最小3項目）
+
+| 正規語 | 別表記・同義語 | 一行説明 |
+|---|---|---|
+| ubiquitous language | 正規語彙, ユビキタス言語 | そのプロジェクトで合意された正しい用語の母集合。語彙が分裂すると意図の擦り合わせが崩れる。 |
+| 正規語彙 | canonical vocabulary, ubiquitous language | 台帳に登録された正しい用語そのもの。造語の疑いはこの集合に無い語として判定する。 |
+| coinage-suspect | 造語の疑い | 正規語彙のどこにも無い語を造語の疑いとして read-only で名指しする検出 check の ID。 |
+| glossary | 語彙台帳, 用語集 | 正規語＋表記ゆれ/同義語を集約する軽量 canonical 台帳（このファイル）。母集合の置き場。 |
+| drift | 逸脱 | 当初の意図から少しずつ離れていく進み方。drift-patterns が地形として型カタログ化する。 |
+| packet | パケット | intent から spec/実装へ渡す意図の最小単位。出自を frontmatter に刻む。 |
+| compass | intent-compass | 意図を決定規律（Decision Rules）・不変条件（Invariants）へ畳んだ羅針盤。 |
+| intent tree | intent-tree, 意図ツリー | 目的・課題・方向を階層で持つ canonical な意図の本体。 |