checkpoint

checkpoint

lets-work の書き込み側の対となるスキルです。このセッションでユーザーが学んだことを記録し、各項目をできる限り上位の場所へ反映します。まずコード、次にリポジトリアーティファクト、最後に個人用ストアです。

個人用の状態（痕跡ゼロの契約）

lets-work と同じ契約です。両者の内容を一致させてください。

• ルート：${XDG_DATA_HOME:-$HOME/.local/share}/identity16-skills/projects/<repo-id>/
• repo-id：正規化した origin URL のスラッグ（プロトコル、認証情報、.git を削除し、/ と : を __ に置き換えます）。リモートがない場合は、絶対パスを同様にスラッグ化します。
• ファイル：state.json（最終訪問マーカー）、dossier.md（メンタルモデル。フォールバックであり、ミラーではありません）、journal.md（追記専用のセッションログ）。

これらを、あるいはこのスキルパックへの言及を、対象プロジェクトのファイル、コミット、PR、issue に書き込んではいけません。

儀式にかける労力は、セッションで得られた学びに比例させてください。 残す価値のある成果がなかった通常のセッションでは、インタビューは不要です。state.json を更新し、一行で確認して完了です。以下の完全な振り分け手順は、ユーザーの理解が実際に進んだセッションに適用します。

手順

1. 候補を集めます。セッションを振り返り、学んだことを列挙します。決定事項、遭遇した落とし穴、発見した不変条件、覆された前提、未解決の疑問、WIP の状態などが対象です。
2. 各項目を上位の場所へ振り分け、黙って適用するのではなく、反映を提案します。
   • コード：コードだけでは表現できない、直感的でない制約や「理由」があれば、対象プロジェクトのコメント規約に従い、重要な箇所に簡潔なコメントを追加することを提案します。
   • リポジトリアーティファクト：採用したアプローチの根拠や却下した代替案があれば、PR の説明、または提出するコミットメッセージに追加することを提案します。
   • 個人用ジャーナル：プロジェクトの進め方に関する事実（議論の場所、ローカルでの実行方法など）、ユーザーの未解決の疑問、WIP メモなど、リポジトリに記録する場所がないものは、今日の日付の見出しの下に journal.md へ追記します。
3. メンタルモデルの差分を dossier.md に反映します。新たに判明した不変条件や、修正された認識などです。コードベースから明らかになった項目は削除します。dossier が短くなるのは、コードベースが改善している証拠です。
4. 現在のコミット、日付、ブランチを state.json に書き込みます。
5. どの項目をどこに記録したか、ユーザーに確認します。

ガードレール

• リポジトリへの反映は通常の成果物（コメント、PR の文章、コミットメッセージ）です。ただし、このスキルパック、個人用ストア、またはそのパスに言及してはいけません。
• リポジトリにすでに記録されている内容（コードの構造、Git の履歴、既存のドキュメント）は、ジャーナルに記録しないでください。