session-documenter

セッション記録スキル

作業、決定事項、コンテキストを記録します。

契約

入力：

• 秘密情報に見える値をマスキングした現在のセッションコンテキスト
• 変更したファイル、決定事項、ブロッカー、次のステップ
• 任意のタスクまたは PRD の参照

出力：

• 秘密情報を削除したセッション記録を .agents/sessions/YYYY-MM-DD.md に追記
• 必要に応じて関連するサマリーやタスクを更新

作成・変更するもの：

• .agents/sessions/ の日次セッションファイル
• 決定事項によって永続的なプロジェクトコンテキスト（アーキテクチャ、デプロイ、マイグレーション、注意点）が変わる場合は .agents/memory/*.md

外部への副作用：

• なし

確認が必要な操作：

• 既存のセッション履歴を書き換える前
• セッションのメモを恒久的なルールやスキルに昇格させる前

委任先：

• セッション中に見つかった再利用可能な設定は rules-capture に委任
• セッション中に見つかった再利用可能なワークフローは skill-capture に委任
• 締めくくりの手順は session-end に委任

コマンド

コマンド	アクション
/start	新しいセッションを開始します。今日のファイルを作成または追記し、コンテキストを読み込みます
/end	セッションを終了します。追跡したすべての作業を記録し、関連ファイルを更新します

動作の仕組み

1. /start - .agents/sessions/YYYY-MM-DD.md がなければ作成し、存在する場合は既存のコンテキストを読み込みます
2. セッション中 - 決定事項、変更したファイル、ミスを記録します
3. /end - フローチャート、決定事項、次のステップを含む、マスキング済みのセッション記録を書き込みます

重要なルール

セッションファイルの命名（1 日につき 1 ファイル）

✅ CORRECT: .agents/sessions/2025-11-15.md
❌ WRONG:   .agents/sessions/2025-11-15-feature-name.md

同じ日に複数のセッションがある場合 → 同じファイルにセッション 1、セッション 2 などとして記録します。

フローチャート（機能では必須）

次の場合はフローチャートを含めます。

• 新機能
• 機能の変更
• 複数コンポーネントにまたがるバグ修正

マスキング（必須）

セッションのメモを書き込む前に、次の処理を行います。

• API キー、トークン、パスワード、Cookie、非公開の認証情報、秘密の値を [REDACTED_SECRET] に置き換えます。
• 機密性の高いコマンド出力は、そのままコピーせず要約します。
• 個人データ、非公開 URL、認証情報を含む場合は、リクエスト／レスポンスのペイロード全体を保存せず、決定に関係するフィールドのみを記録します。

セッション記録の構成

1. セッション番号とタイトル
2. システムフロー図（mermaid またはテキスト）
3. 影響を受けるコンポーネント（フロントエンド、バックエンド、データ、外部）
4. 実施内容（タスクのチェックリスト）
5. 主な決定事項（理由を含む）
6. 変更したファイル
7. ミスと修正
8. 次のステップ

更新する関連ファイル

• .agents/memory/*.md — 決定事項によってリポジトリの永続的なコンテキスト（アーキテクチャ、デプロイ、マイグレーション、注意点）が変わる場合に更新します。編集した場合は、ファイルの last_verified の日付を更新します。

参考資料

• 完全ガイド：フェーズ、自動化、検証、例