master-plan-manager

Master Plan Manager

Intelligent management of MASTER_PLAN.md files with comprehensive safety measures.

When to Use

Use this skill when:

• Updating task status (TASK-XXX, BUG-XXX)
• Adding items to roadmap or ideas sections
• Modifying project tracking documentation
• Ensuring safe updates to critical planning files

Safety Protocol

MANDATORY before any MASTER_PLAN.md modification:

1. Read First - Always read the entire file before editing
2. Backup - Create timestamped backup before changes
3. Validate - Check if update is actually needed (avoid duplicates)
4. Preserve - Maintain existing structure and formatting
5. Verify - Confirm integrity after changes

Core Operations

1. Status Updates

Update task/bug status in the Dependency Index table:

| ID | Status | Primary Files | Depends | Blocks |
|----|--------|---------------|---------|--------|
| TASK-XXX | 🔄 **IN PROGRESS** | `file.ts` | - | - |

Status transitions:

• 📋 TODO → 🔄 IN PROGRESS → 👀 REVIEW → ✅ DONE

2. Adding New Items

New Task:

### TASK-XXX: Task Title (📋 TODO)

**Priority**: P2-MEDIUM

**Files to Modify:**
- `src/file.ts`

**Steps:**
- [ ] Step 1
- [ ] Step 2

New Bug:

### BUG-XXX: Bug Description (🔄 IN PROGRESS)

**Severity**: HIGH

**Symptoms**: What's wrong

**Root Cause**: (To be determined)

Roadmap Item:

| ROAD-XXX | Feature description | P2 | TODO | Notes |

3. Completing Items

When marking complete:

1. Add strikethrough to ID: ~~TASK-XXX~~
2. Update status: (✅ DONE)
3. Move to "Recently Completed" section
4. Update Dependency Index table

4. ID Format

Prefix	Usage
TASK-XXX	Features and tasks
BUG-XXX	Bug fixes
ROAD-XXX	Roadmap items
IDEA-XXX	Ideas to consider
ISSUE-XXX	Known issues

Safe Update Workflow

1. READ current MASTER_PLAN.md
   ↓
2. ANALYZE what needs to change
   ↓
3. CHECK if content already exists (avoid duplicates)
   ↓
4. BACKUP before modifications
   ↓
5. APPLY changes incrementally
   ↓
6. VALIDATE markdown structure
   ↓
7. CONFIRM with user if significant changes

Examples

Example 1: Mark Task Complete

Before:

### TASK-033: Create Plugin (🔄 IN PROGRESS)

After:

### ~~TASK-033~~: Create Plugin (✅ DONE)

Also update Dependency Index:

| ~~TASK-033~~ | ✅ **DONE** | `plugin/*` | - | - |

Example 2: Add New Bug

### BUG-XXX: Button not responding (🔄 IN PROGRESS)

**Severity**: MEDIUM

**Symptoms**: Click handler not firing on mobile

**Root Cause**: Touch event not handled

**Fix**: Add touchstart listener

Example 3: Update Progress

**Steps:**
- [x] Research ✅
- [x] Implementation ✅
- [ ] Testing
- [ ] Documentation

Integration Commands

When chief-architect or other skills delegate:

master-plan-manager: update-status TASK-033 done
master-plan-manager: add-task "New feature" P2
master-plan-manager: add-bug "Issue description" HIGH
master-plan-manager: move-to-completed TASK-033

Validation Checklist

Before completing any update:

• Read entire file first
• Backup created
• No duplicate IDs
• Proper markdown formatting
• Strikethrough on completed IDs
• Status emoji matches state
• Dependency Index updated

Error Recovery

If something goes wrong:

# Restore from backup
cp docs/MASTER_PLAN.md.backup docs/MASTER_PLAN.md

# Or use git
git checkout HEAD -- docs/MASTER_PLAN.md

Best Practices

1. Never blindly append - Always check if section exists
2. Preserve formatting - Match existing style (emojis, spacing)
3. Atomic updates - One logical change at a time
4. User verification - Ask user to confirm significant changes
5. Keep history - Document why changes were made