memory-manager

メモリマネージャー

プロジェクトのメモリを整理された状態に保ちます。

有効化

次の場合に有効化します：

• いずれかのフェーズの作業（調査、設計、実装）を完了した後
• タスク完了後
• プロジェクトの状態に不整合があるように見える場合
• 定期的なメンテナンスを依頼された場合
• 「プロジェクトファイルを整理して」または「プロジェクトの状態を更新して」と依頼された場合

ワークフロー

1. 現在の状態を読み込む

Read を使用して {project_path}/project_state.md を読み込みます。

以下を抽出します：

• 現在のフェーズ
• 最終更新日
• 現在の重点事項
• 進捗の概要

2. プロジェクトファイルをスキャンする

v3.0.0 フォルダー構造のサポート：

Bash と ls -d を使用してタスクディレクトリを一覧表示します：

# List task directories (not .md files)
ls -d {project_path}/implementation_process/in_progress/*/ 2>/dev/null
ls -d {project_path}/implementation_process/completed/*/ 2>/dev/null

見つかった各タスクディレクトリについて、以下を確認します：

• task.md（メインのトラッカー）— 必須
• research.md（フェーズ 1 の内容）— 任意
• architecture.md（フェーズ 2 の内容）— 任意
• implementation.md（フェーズ 3 の内容）— 任意

アーキテクチャフォルダーもスキャンします：

{project_path}/architecture/*.md

以下を数えます：

• コンポーネントアーキテクチャ（architecture/*.md）
• 進行中のタスク（in_progress/ 内のディレクトリ）
• 完了したタスク（completed/ 内のディレクトリ）

後方互換性：

ディレクトリではなく *.md ファイルが見つかった場合は、警告します：

⚠️  Old v2.x format detected: {count} single-file tasks

Run `/drupal-dev-framework:migrate-tasks` to upgrade to v3.0.0 folder structure.

3. 不整合を検出する

以下の問題を確認します：

問題	検出方法	修正方法
空のファイル	ファイルサイズ = 0	削除するか内容を追加するか確認する
孤立したタスク	タスクが誤ったフォルダーにある	正しい場所に移動する
古い状態	project_state.md が最新でない	現在の重点事項を更新する
ファイルの欠落	参照先が見つからない	ファイルを作成するか参照を更新する

4. project_state.md を更新する

Edit を使用して更新します：

# {Project Name}

**Updated:** {today's date}
**Phase:** {detected phase}
**Status:** {current status}
**Path:** {project_path}

## Overview
{Keep existing or update based on recent work}

## Progress
- Phase 1 (Research): {Complete/In Progress} - {count} research files
- Phase 2 (Architecture): {Complete/In Progress} - {count} component files
- Phase 3 (Implementation): {X}/{Y} tasks complete

## Current Focus
{What's actively being worked on}

## Key Decisions
| Date | Decision | Rationale |
|------|----------|-----------|
{add new decisions, keep old ones}

## Next Steps
1. {Immediate next action}
2. {Following action}

5. ファイルを整理する

ファイルの配置が誤っている場合は、Bash を使用して移動します：

v3.0.0 フォルダー構造：

# Move completed task directory from in_progress
mv "{project_path}/implementation_process/in_progress/{task_name}/" \
   "{project_path}/implementation_process/completed/{task_name}/"

v2.x の単一ファイル（後方互換性）：

# Move completed task file from in_progress
mv "{project_path}/implementation_process/in_progress/{task_name}.md" \
   "{project_path}/implementation_process/completed/{task_name}.md"

6. クリーンアップする

削除する前に必ず確認します：

Found {count} empty/orphaned files:
- {file 1}
- {file 2}

Delete these? (yes/no/review each)

7. プロジェクトレジストリを更新する

~/.claude/drupal-dev-framework/active_projects.json のレジストリを更新します：

1. レジストリファイルを読み込む
2. パスを使ってこのプロジェクトを見つける
3. 以下を更新する：
   • lastAccessed：今日の日付
   • status：active または、すべてのタスクが完了している場合は archived
4. 更新したレジストリを書き込む

プロジェクトがレジストリにない場合は、追加するかどうかを提案します：

This project is not in the registry.
Add it for easier access next time? (yes/no)

8. 報告する

概要を表示します：

Memory cleanup complete:

Files scanned: {count}
Issues found: {count}
Issues fixed: {count}

Current state:
- Phase: {phase}
- Architecture files: {count}
- Tasks in progress: {count}
- Tasks completed: {count}

project_state.md updated.
Registry updated.

メモリを簡潔に保つ原則

以下のルールに従います：

• 信頼できる情報源は1つにする — 情報を重複させない
• コピーせず要約する — 外部ファイルを参照する
• 削除せずアーカイブする — ゴミ箱ではなく completed/ に移動する
• 既存ファイルを更新する — バージョン付きコピーを作成しない（main_v2.md ではなく main.md）

停止ポイント

次の場合は停止して、ユーザーの指示を待ちます：

• ファイルを削除する前
• 大規模な再編成を行う前
• クリーンアップの概要を提示した後