Memory Manager

Maintain clean and organized project memory.

Activation

Activate when:

• After completing any phase activity (research, design, implementation)

• After task completion

• When project state seems inconsistent

• Periodic maintenance requested

• "Clean up project files" or "Update project state"

Workflow

1. Load Current State

Use Read on {project_path}/project_state.md

Extract:

• Current phase

• Last updated date

• Current focus

• Progress summary

2. Scan Project Files

v3.0.0 Folder Structure Support:

Use Bash with ls -d to inventory task directories:

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

For each task directory found, check for:

• task.md (main tracker) - required

• research.md (Phase 1 content) - optional

• architecture.md (Phase 2 content) - optional

• implementation.md (Phase 3 content) - optional

Also scan architecture folder:

{project_path}/architecture/*.md

Count:

• Component architectures (architecture/*.md)

• In-progress tasks (directories in in_progress/)

• Completed tasks (directories in completed/)

Backward Compatibility:

If *.md files found (not directories), warn:

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

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

3. Detect Inconsistencies

Check for issues:

Issue Detection Fix

Empty files File size = 0 Ask to delete or populate

Orphaned tasks Task in wrong folder Move to correct location

Stale state project_state.md outdated Update current focus

Missing files Referenced but not found Create or update reference

4. Update project_state.md

Use Edit to update:

{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

Next Steps

1. {Immediate next action}

2. {Following action}

3. Organize Files

If files are misplaced, use Bash to move:

v3.0.0 Folder Structure:

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 Single Files (backward compatibility):

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. Clean Up

Ask before deleting anything:

Found {count} empty/orphaned files:

• {file 1}
• {file 2}

Delete these? (yes/no/review each)

7. Update Project Registry

Update the registry at ~/.claude/drupal-dev-framework/active_projects.json :

• Read the registry file

• Find this project by path

• Update:

• lastAccessed : today's date

• status : "active" or "archived" if all tasks complete

• Write the updated registry

If project not in registry, offer to add it:

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

8. Report

Show summary:

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.

Lean Memory Principles

Follow these rules:

• One source of truth - don't duplicate information

• Summarize, don't copy - reference external files

• Archive, don't delete - move to completed/, not trash

• Update in place - no versioned copies (main.md, not main_v2.md)

Stop Points

STOP and wait for user:

• Before deleting any files

• Before major reorganization

• After presenting cleanup summary