記憶ファイル管理

AI Agent の記憶ファイル（AGENTS.md / CLAUDE.md）を管理し、更新と再構成の操作をサポートします。

核心理念

AGENTS.md を唯一の事実源とする

プロジェクト情報源（コードリポジトリ + ドキュメント）
    │
    │  エッセンスを抽出（distill）
    ▼
AGENTS.md（簡潔、安定、AI ツール間で共通）← 共通情報の唯一の編集点
    │
    ├── CLAUDE.md（@AGENTS.md からのインポート + Claude Code 固有の追加）
    ├── .claude/rules/devdocs-state.md（DevDocs プロジェクトのみ、番号の状態）
    └── 未来：.cursorrules / .windsurfrules（予約済み、未実装）

原則：

• AGENTS.md はツールに依存せず、特定の AI ツール固有の構文を含まないようにします。
• CLAUDE.md は @AGENTS.md を通じて共通情報をインポートし、Claude Code 固有の追加情報を追加できます。
• ツール固有の情報は、それぞれのルールファイル（例：.claude/rules/）を通じて追加します。

ベストプラクティスを参照する

best-practices.md は、すべてのモードで共有される規範です。

• 初回作成時：品質基準として
• --update 更新時：コンテンツのフィルタリング基準として
• --restructure 再構成時：構造検証とアンチパターンの検出基準として

/init との連携

各 AI ツールの /init の動作は異なります（例：Claude Code は CLAUDE.md を作成します）。本 skill は /init がどのようなファイルを生成するかを仮定せず、AGENTS.md のアーキテクチャが正しいことを保証します。

• AGENTS.md が存在しない場合：プロジェクトソースから自動的にスキャンして作成します。
• /init が AGENTS.md を作成済みの場合：後続の --update はこれを基に増分更新します。
• best-practices.md はコンテンツの品質に関する参考資料として使用します。
• memory-template.md は AGENTS.md の出力テンプレートとして使用します。

言語規則

• 日本語と英語での質問をサポートします。
• 回答は日本語で統一します。

実行モード

/agent-memory                    → インテリジェント検出（AGENTS.md は存在するか？更新が必要か？）
/agent-memory --update           → プロジェクトソースから情報を抽出し、AGENTS.md を更新します。
/agent-memory --restructure      → 既存の AGENTS.md をベストプラクティスに従って再構成します。

インテリジェント検出のフロー

AGENTS.md が存在するかどうかを検出
        │
        ├── 存在しない → プロジェクトソースをスキャンし、AGENTS.md + CLAUDE.md を初回作成
        │
        └── 存在する → コンテンツの状態を分析
                    ├── 情報が古い → --update を推奨
                    └── 構造が混乱している → --restructure を推奨

情報抽出の階層化

共通抽出（すべてのプロジェクト）

DevDocs 拡張抽出（docs/devdocs/ が存在する場合）

--update のワークフロー

1. プロジェクト情報源をスキャン
   ├── 共通抽出（パッケージマネージャ、README、git、コード構造）
   └── DevDocs 拡張抽出（docs/devdocs/ が存在する場合）
   │
   ▼
1.5 AGENTS.md が存在するかどうかを確認
   ├── 存在しない → memory-template.md を使用して作成
   └── 存在する → 増分更新
   │
   ▼
2. エッセンスを抽出
   ├── 技術スタック
   ├── ADR の概要（存在する場合。ADR 形式がない場合は、変更履歴から重要な決定を抽出）
   ├── ドメイン用語
   ├── アクティブなタスク + 進捗状況
   ├── 番号の状態（DevDocs プロジェクトのみ）
   └── 実行コマンド
   │
   ▼
2.5 best-practices.md に従ってフィルタリング
   ├── コンテンツのフィルタリング基準：書き込むべきもの vs 書き込むべきでないもの
   └── 品質ルール：6 つのチェック
   │
   ▼
3. AGENTS.md を更新（templates/memory-template.md を使用）
   │
   ▼
4. CLAUDE.md が存在することを確認（存在しない場合は、インポートファイルを作成。すでに存在する場合はスキップし、追加領域は上書きしない）
   │
   ▼
5. .claude/rules/devdocs-state.md を生成/更新（DevDocs プロジェクトのみ）

分流規則

--restructure のワークフロー

1. 既存の AGENTS.md を読み込む
   │
   ▼
2. best-practices.md に従って非標準項目を検出
   ├── 行数制限（≤ 60 行）
   ├── ツールに依存しないこと
   ├── 章の順序（構造仕様との比較）
   ├── アンチパターンの検出
   └── 欠落している章
   │
   ▼
3. templates/memory-template.md に従って再構成
   │
   ▼
4. 再構成案を表示し、確認後に書き込む
   │
   ▼
5. CLAUDE.md が存在することを確認（存在しない場合は、インポートファイルを作成。すでに存在する場合はスキップ）

出力ファイル

AGENTS.md

• 場所：プロジェクトのルートディレクトリ
• テンプレート：templates/memory-template.md
• 制約：60 行を超えないこと、ツールに依存しないこと

CLAUDE.md

• 場所：プロジェクトのルートディレクトリ
• 構造：@AGENTS.md からのインポート + Claude Code 固有の追加領域
• 作成タイミング：AGENTS.md の初回生成時に一緒に作成。すでに存在する場合は上書きしない
• 追加領域はユーザーが手動で管理し、/agent-memory は変更しません。

.claude/rules/devdocs-state.md

• 場所：.claude/rules/devdocs-state.md
• テンプレート：templates/devdocs-state-template.md
• 条件：DevDocs プロジェクトのみ（docs/devdocs/ が存在する場合）

制約

内容の制約

• [ ] AGENTS.md は 60 行を超えないこと
• [ ] AGENTS.md は特定の AI ツール固有の構文を含まないこと
• [ ] CLAUDE.md は @AGENTS.md を通じて共通情報をインポートすること（初回作成後は上書きしない）
• [ ] 番号の状態は .claude/rules/devdocs-state.md にのみ書き込むこと

品質ルール

AGENTS.md に書き込む前に、best-practices.md に従って確認してください。

• 6 つのルール（短く安定している / 広く適用可能 / 実行可能 / 重複を避ける / 詳細は元の場所に残す / ツールに依存しない）
• コンテンツのフィルタリング基準（書き込むべきもの vs 書き込むべきでないもの）
• アンチパターンリスト

操作の制約

• [ ] 00-context.md を生成/変更しない
• [ ] 削除できる場合は削除し、コマンド、制約、チェックポイントを優先する
• [ ] --restructure は再構成前に必ず確認する

Skill 連携

テンプレートの参照

• AGENTS.md テンプレート：templates/memory-template.md
• 番号の状態テンプレート：templates/devdocs-state-template.md
• ベストプラクティス：templates/best-practices.md