intent-planner 0.13.1 → 0.14.0

package/templates/ja/codex/skills/intent-writeback/SKILL.md

@@ -25,7 +25,7 @@ description: export 済み packet の実装完了後、実装で得た学びを
 
 ### Step 2: 学びを抽出して提示する
 - 実装の現実（コードベース・テスト・`.kiro/specs/`。すべて読み取りのみ）と、packet 定義（対象 packet ファイル）・cc-sdd 下書き・intent-compass.md を突き合わせる。
-- rules の5観点（[decision] / [invariant-violation] / [implicit-behavior] / [deferred-resolved] / [question]）で学びを抽出し、タグ付きの一覧で提示する。
+- rules の5観点（[decision] / [invariant-violation] / [implicit-behavior] / [deferred-resolved] / [question]）で学びを抽出し、タグ付きの一覧で提示する。各学びは `[tag] <平易な要約一文（必須）>`（承認者がそのまま読んで意味の取れる平易な文）で示し、背景・根拠・含意が要るときだけ任意の `解説:` を添える（解説は必須でなく、要約のみが正規形。rules §2/§9 参照）。
 
 ### Step 3: delta を記録する（canonical 不可侵）
 - 抽出した学びを `.intent/deltas.md` に新規エントリ（Status: pending）として記録する。
@@ -33,7 +33,7 @@ description: export 済み packet の実装完了後、実装で得た学びを
 - この段階では canonical（intent-tree.md / intent-compass.md / `.intent/packets/` 配下）を一切書き換えない。
 
 ### Step 4: 昇格を確認する（承認の粒度を分ける）
-- 承認の粒度は学びの種類で分ける（rules §3 第2段）。全件を一律に一件ずつ問わない。
+- 承認の粒度は学びの種類で分ける（rules §3 第2段）。全件を一律に一件ずつ問わない。承認の一次情報は各学びの平易な要約一文であり、解説は要るときだけ補う二次情報として扱う。
 - **ゲート対象**（`[invariant-violation]` と Decision Rules を変える `[decision]`）は項目ごとに承認を確認する。
 - **それ以外（L3 追記系・`[question]` 転記）**は反映先を一覧で提示し、止めたい項目があれば指定を求めたうえで、無指定なら一括昇格する。
 - 止めた（承認されない）項目には「却下（再提案不要） | 保留（次回 writeback で再提案）」のどちらかを確認する。
@@ -56,7 +56,7 @@ description: export 済み packet の実装完了後、実装で得た学びを
 - **昇格結果（先頭）**: 何が canonical（intent-tree / intent-compass / packets）へ昇格したか、反映先明細つき。止めた項目は「却下（再提案不要） / 保留（次回再提案）」の見送りタグで区別して示す。
 - **完了処理の結果（次）**: 対象 packet の `state: done`・`closed_at`・`spec_refs` 記入、`archive/<年>/` への移動、index.md 再生成。「この packet はこれで締まった」と分かる形。
 - **昇格提案**（承認を求める段で出ていれば）: ゲート対象（invariant 違反・Decision Rules 変更）は項目ごとに確認、L3 追記系は一覧提示 + 止める項目の指定。
-- **詳細**: 抽出した学び一覧（5観点 [decision]/[invariant-violation]/[implicit-behavior]/[deferred-resolved]/[question] のタグ付き）、delta 記録結果（deltas.md のエントリ）。
+- **詳細**: 抽出した学び一覧（5観点 [decision]/[invariant-violation]/[implicit-behavior]/[deferred-resolved]/[question] のタグ付き。各行は平易な要約一文を主情報とし、必要なときだけ任意の解説を添える）、delta 記録結果（deltas.md のエントリ）。
 
 ## Safety & Fallback
 - 対象 packet が特定できなければ、状況を提示して書き戻し対象の指定を求めて停止する。

package/templates/ja/codex/skills/intent-writeback/rules/writeback-protocol.md

@@ -21,6 +21,8 @@
 
 対象 packet の定義（対象 packet ファイル）・cc-sdd 下書き（Intent 由来の制約を含む）・intent-compass.md と、実装の現実（コードベース・テスト・`.kiro/specs/`。すべて読み取りのみ）を突き合わせ、次の5観点で学びを抽出する。タグは観点と1:1。実装の現実を読む際、Decision Rule（intent-compass.md）が名指すコードモジュール（ファイル名・モジュール名）も grep 突合の視野に含め、Rule 主文と実装の乖離を `[invariant-violation]` として抽出してよい。
 
+抽出した各学びは、`[tag] <平易な要約一文（必須）>` の形で書く。要約は専門用語で圧縮した名詞句ではなく、その packet を実装していない承認者がそのまま読んで意味の取れる平易な文にする（伝わりやすさを優先し、多少長くなってよい）。背景・根拠・含意の補足が要るときだけ、その下に字下げした `  - 解説: <…>` を任意で添える（解説は必須ではなく、要約のみの学びが正規形）。これは §9 の deltas.md 正規テンプレートと同じ書式であり、ここで抽出した学びはその書式のまま §9 へ記録される。
+
 | タグ | 観点 |
 |------|------|
 | `[decision]` | 新しい決定（実装中に下した、packet 定義に書かれていない判断） |
@@ -126,11 +128,15 @@ writeback フェーズにおいては、canonical 成果物を直接書き換え
 
 ### 学び
 
-- [decision] <新しい決定>
-- [invariant-violation] <発見された invariant 違反>
-- [implicit-behavior] <意図に書かれていなかった暗黙挙動>
-- [deferred-resolved] <解消された Deferred>
-- [question] <新たな未解決 Question>
+各学びは `[tag] <平易な要約一文（必須）>` で書きます。要約は専門用語で圧縮した名詞句ではなく、その packet を実装していない承認者がそのまま読んで意味の取れる平易な文にします（伝わりやすさを優先し、多少長くなってよい）。背景・根拠・含意の補足が要るときだけ、その下に字下げした `  - 解説: <…>` を**任意で**添えます（解説は必須ではなく、要約のみの学びが正規形です）。
+
+- [decision] <実装中に下した、packet 定義に書かれていない判断を平易な一文で>
+  - 解説: <なぜその判断に至ったか・背景や根拠（任意。不要なら付けない）>
+- [invariant-violation] <既存 Invariant と実装の現実が衝突している箇所を平易な一文で>
+  - 解説: <どの Invariant とどう衝突するか・想定される対応（任意）>
+- [implicit-behavior] <意図に書かれていなかったが実装が既にそうなっている挙動を平易な一文で（多くは要約のみで成立）>
+- [deferred-resolved] <保留にしていた事項がどう解消されたかを平易な一文で>
+- [question] <新たに浮かんだ未解決の問いを平易な一文で>
 
 ### 昇格記録（promoted / closed 時）
 

package/templates/ja/intent/README.md

@@ -94,7 +94,7 @@ enforcement と並ぶ、もう一つの**任意のクロスカット層**です
 
 **既定は off** で、設定しない限り動作は何も変わりません。`mode.md` の「Drift-watch（ユーザー管理）」セクションを直接編集して `on` に切り替えます。
 
-`on` のとき、`/intent-discover` が Intent Tree の地形診断を、`/intent-export-cc-sdd` が export 水際で compass 照合の警告を出します。**いずれも警告のみで停止しません**（enforcement の `gate` とは別概念で、誤検知前提のため停止する値を持ちません）。検知は `.intent/drift-log.md` にローカル記録されます（外部への送信は一切なく、`.intent/` 内で完結します）。
+`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 クロス集計に相乗りします。
 

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

@@ -1,6 +1,6 @@
 # Constraint Starters（制約の叩き台カタログ）
 
-> `/intent-compass`（主接点）・`/intent-discover`（地形診断レーン）が、Anti-direction / Invariants を書くときの**叩き台候補**として読みます。同梱のドメイン定石を文脈と照合して「このケースはこれでしょ」と候補提示するための母集合です。**提示は read-only の叩き台であり、compass への転記は人が採否を選んでから手動で行います**（AI が自動転記しません）。利用者が自分のよく使う制約は別ファイル `constraint-library.md` で育てます。
+> `/intent-compass`（主接点）・`/intent-discover`（逸脱しやすい場面の事前チェックレーン）が、Anti-direction / Invariants を書くときの**叩き台候補**として読みます。同梱のドメイン定石を文脈と照合して「このケースはこれでしょ」と候補提示するための母集合です。**提示は read-only の叩き台であり、compass への転記は人が採否を選んでから手動で行います**（AI が自動転記しません）。利用者が自分のよく使う制約は別ファイル `constraint-library.md` で育てます。
 
 ## このカタログの読み方
 

package/templates/ja/intent/deltas.md

@@ -22,11 +22,15 @@
 
 ### 学び
 
-- [decision] <新しい決定>
-- [invariant-violation] <発見された invariant 違反>
-- [implicit-behavior] <意図に書かれていなかった暗黙挙動>
-- [deferred-resolved] <解消された Deferred>
-- [question] <新たな未解決 Question>
+各学びは `[tag] <平易な要約一文（必須）>` で書きます。要約は専門用語で圧縮した名詞句ではなく、その packet を実装していない承認者がそのまま読んで意味の取れる平易な文にします（伝わりやすさを優先し、多少長くなってよい）。背景・根拠・含意の補足が要るときだけ、その下に字下げした `  - 解説: <…>` を**任意で**添えます（解説は必須ではなく、要約のみの学びが正規形です）。
+
+- [decision] <実装中に下した、packet 定義に書かれていない判断を平易な一文で>
+  - 解説: <なぜその判断に至ったか・背景や根拠（任意。不要なら付けない）>
+- [invariant-violation] <既存 Invariant と実装の現実が衝突している箇所を平易な一文で>
+  - 解説: <どの Invariant とどう衝突するか・想定される対応（任意）>
+- [implicit-behavior] <意図に書かれていなかったが実装が既にそうなっている挙動を平易な一文で（多くは要約のみで成立）>
+- [deferred-resolved] <保留にしていた事項がどう解消されたかを平易な一文で>
+- [question] <新たに浮かんだ未解決の問いを平易な一文で>
 
 ### 昇格記録（promoted / closed 時）
 

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

@@ -36,6 +36,6 @@
 |---|---|
 | `prevented`（discover の予防成功） | `missed`（防げず通った） |
 | `caught`（export の捕捉成功） | `false-positive`（誤検知だった） |
-| | `not-applicable`（地形に無かった・空振り） |
+| | `not-applicable`（場面に無かった・空振り） |
 
 集計は `pattern × outcome` のクロス集計を前提とします。`missed=0` は「効いた」ではなく「記録漏れの疑い」と読みます。

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

@@ -1,13 +1,13 @@
 # Drift Patterns（逸脱の型カタログ）
 
-> `/intent-discover` が地形診断の根拠として読みます（`drift-watch: on` のとき）。利用者が自分の現場で踏んだ逸脱を型として足して育てるファイルです。
+> `/intent-discover` が逸脱しやすい場面の事前チェックの根拠として読みます（`drift-watch: on` のとき）。利用者が自分の現場で踏んだ逸脱を型として足して育てるファイルです。
 
 ## このカタログの読み方
 
 - **これは網羅ではありません。** ここに載っている型は出発点（seed 1件 + 汎用2件）にすぎません。あなたの現場で実際に踏んだ逸脱を型として追記し、育てていく前提のファイルです。
-- 各型は集計キー（`id`）で `drift-log.md` と突き合わせます。型を増やすほど、着手前に「踏みやすい地形」を名指しできる範囲が広がります。
+- 各型は集計キー（`id`）で `drift-log.md` と突き合わせます。型を増やすほど、着手前に「逸脱しやすい場面」を名指しできる範囲が広がります。
 - 同梱の汎用2件（`premature-abstraction` / `layer-leak`）は、症状の異なる**弱い手がかり**として置いています。1個の強い代表例（`microservice-over-split`）に思考が固着（fixation）しないよう、あえて毛色を散らしてあります。
-- 型に「該当した」ことは逸脱の確定ではありません。地形診断は誤検知前提です。該当したら**先に anti-direction / invariant を書いておく**ことで、外れきる前に手を打ちます。
+- 型に「該当した」ことは逸脱の確定ではありません。逸脱しやすい場面の事前チェックは誤検知前提です。該当したら**先に anti-direction / invariant を書いておく**ことで、外れきる前に手を打ちます。
 
 ## 型の書き方
 
@@ -53,7 +53,7 @@
 
 ## id: coinage-proliferation
 
-- name: 造語が増えやすい地形
+- name: 造語が増えやすい場面
 - symptom: AI が正規語彙（ubiquitous language）に既にある語を再利用せず、台帳に無い新造の語を次々と充てていく。同じ概念に複数の言い回しが並び、語彙が分裂して意図の擦り合わせ（製品の核）が崩れていく進み方。
 - 先に書かせるもの:
   - Anti-direction: 正規語が既にある概念へ新しい語を作らない。やむを得ず新語を導入するときは初出に一行の説明を添える。
@@ -61,7 +61,7 @@
 
 ## id: scope-creep
 
-- name: スコープが拡大しやすい地形
+- name: スコープが拡大しやすい場面
 - symptom: export 済みの作業単位（packet）の宣言スコープを超える実装指示が後から来る（例: フロント専用 packet なのにバックエンド・認可・トランザクション境界の実装を足すよう求める）。各追加は局所的に自然でも、新領域でこそ必要になる packet 固有の不変則（認可・データ整合性・トランザクション境界・冪等性）が抜け落ちたまま積み上がる進み方。
 - 先に書かせるもの:
   - Anti-direction: export 済み packet の `## Scope` を超える指示を cc-sdd でそのまま押し切らない。新領域は別 packet として intent に戻す。

package/templates/ja/intent/glossary.md

@@ -17,7 +17,7 @@
 | 正規語彙 | canonical vocabulary, ubiquitous language | 台帳に登録された正しい用語そのもの。造語の疑いはこの集合に無い語として判定する。 |
 | coinage-suspect | 造語の疑い | 正規語彙のどこにも無い語を造語の疑いとして read-only で名指しする検出 check の ID。 |
 | glossary | 語彙台帳, 用語集 | 正規語＋表記ゆれ/同義語を集約する軽量 canonical 台帳（このファイル）。母集合の置き場。 |
-| drift | 逸脱 | 当初の意図から少しずつ離れていく進み方。drift-patterns が地形として型カタログ化する。 |
+| drift | 逸脱 | 当初の意図から少しずつ離れていく進み方。drift-patterns が場面の型カタログにするする。 |
 | packet | パケット | intent から spec/実装へ渡す意図の最小単位。出自を frontmatter に刻む。 |
 | compass | intent-compass | 意図を決定規律（Decision Rules）・不変条件（Invariants）へ畳んだ羅針盤。 |
 | intent tree | intent-tree, 意図ツリー | 目的・課題・方向を階層で持つ canonical な意図の本体。 |

package/templates/ja/intent/mode.md

@@ -28,5 +28,5 @@
 
 - **drift-watch** — 逸脱（drift）監視の強度。値は `off` | `on` の2つです:
   - `off`（既定）: 何もしません。従来どおりの動作です。
-  - `on`: discover で地形診断、export 水際で compass 照合の警告を出し、検知を drift-log.md に記録します。**いずれも警告のみで、停止はしません**（enforcement の gate とは別概念。誤検知前提のため停止しません）。
+  - `on`: discover で逸脱しやすい場面の事前チェック、export 水際で compass 照合の警告を出し、検知を drift-log.md に記録します。**いずれも警告のみで、停止はしません**（enforcement の gate とは別概念。誤検知前提のため停止しません）。
 - 切り替えはこのファイルを直接編集して行います。off|on の2値のみで、停止（gate 相当）の値は持ちません。未記載・不正値のときは off として扱われ、停止しません。