reflect

振り返り

会話を確認し、学びを永続化します。保存先は brain/、スキルファイル、または構造的な仕組みとします。

プロセス

タスクを使って進捗を管理します（各ステップで TaskCreate を実行し、TaskUpdate で in_progress／completed に更新します）。

1. **brain/index.md を読み、**既存のメモを把握します
2. **会話を確認し、**以下を探します。
   • 発生したミスと受けた修正
   • ユーザーの好みやワークフローのパターン
   • 得られたコードベースの知識（アーキテクチャ、注意点、パターン）
   • 発見したツールやライブラリの癖
   • 決定事項とその理由
   • スキルの実行、オーケストレーション、委任で生じた摩擦
   • 自動化または仕組み化できる、繰り返しの手作業
3. 些細なことや、既存の brain ファイルにすでに記録されていることは除外します
4. 各学びを適切な保存先に振り分けます（下記の振り分けを参照）
5. brain ファイルを追加または削除した場合は、brain/index.md を更新します

振り分け

すべての学びが brain に適しているわけではありません。最も効果的な保存先に振り分けます。

構造的な仕組みでの強制を検討する

学びを brain/ に記録する前に、リンタールール、スクリプト、メタデータフラグ、ランタイムチェックで対応できないか確認します。可能であれば、構造的な仕組みに組み込み、brain のメモは作成しません。brain/principles/encode-lessons-in-structure.md を参照してください。

Brain ファイル（brain/）

コードベースの知識、委任の原則、注意点など、今後のセッションに役立つ情報が対象です。通常はここに保存します。書き方のルールには brain スキルを使います。

• ファイルごとにトピックを1つにします。ファイル名はトピックのスラッグにします。
• インデックスファイルのあるディレクトリに分類し、[[wikilinks]] を使います。
• インデックスファイルに本文を直接書かないでください。

スキルの改善（.agents/skills/<skill>/）

特定のスキルの仕組み（プロセス、プロンプト、エッジケース）に関する学びは、そのスキルを直接更新します。効果的なスキルの内容については、skill-creator スキルのガイドラインを使います。

オーケストレーションワークフローの改善

セッションでシステム全体に関わるオーケストレーション上の問題が明らかになった場合は、次のように振り分けます。

• Brain の原則（新しい委任のヒューリスティック）→ brain/delegation/
• スキルの仕組みの変更（監視ループ、レビュー手順）→ 該当するスキルファイル
• 新しいスキルの機会（仕組み化できる反復ワークフロー）→ ユーザー向けの要約に記載

要約

## Reflect Summary
- Brain: [files created/updated, one-line each]
- Skills: [skill files modified, one-line each]
- Structural: [rules/scripts/checks added]
- Todos: [follow-up items filed]