master-plan-manager_skill

Overview

This skill provides safe, automated management for MASTER_PLAN.md files with backup, validation, and intelligent updates. It streamlines status changes, adds roadmap or bug entries, and preserves document structure. Designed to avoid duplicates and ensure recoverability before any change.

How this skill works

The skill reads the entire MASTER_PLAN.md, analyzes requested edits, and checks for duplicates or formatting issues before applying changes. It creates a timestamped backup, applies incremental edits (status updates, new tasks/bugs/roadmap items), validates markdown structure, and can prompt for user confirmation on significant updates. After changes it verifies integrity and updates the Dependency Index and Recently Completed sections as needed.

When to use it

• Updating task or bug status (TASK-XXX, BUG-XXX)
• Adding new tasks, bugs, roadmap, or idea entries
• Modifying project tracking or planning documentation
• Moving items to Recently Completed or adjusting dependencies
• Before making any change to critical planning files

Best practices

• Always read the full MASTER_PLAN.md before editing
• Create a timestamped backup before applying changes
• Check for existing IDs and avoid duplicates
• Preserve existing formatting, emojis, and section structure
• Make atomic, single-purpose updates and request user confirmation for large edits

Example use cases

• Mark TASK-033 as done and move it to Recently Completed while updating the Dependency Index
• Add a new BUG-021 with severity, symptoms, and initial root cause notes
• Insert a ROAD-005 roadmap entry with priority and status without breaking table formatting
• Update a task’s checklist progress (tick boxes) and keep progress history intact
• Restore the file from a backup if an automated edit introduced a formatting error