Implementation Plan Generator

DEPRECATED: This skill has been replaced by /plan, which adds audit-aware mode, T-shirt sizing, and the Golden Rule. Use /plan instead.

Migration: /implementation-plan → /plan (standalone mode is identical). /implementation-plan with audit findings → /plan --audit.

This file is kept so existing muscle memory gets a clear redirect rather than a broken command. Do not use this skill for new work.

Quick Ref: Interactive planning: gather requirements → analyze codebase → phased task list with risk/ROI ratings → test plan → rollback strategy.

YOU MUST EXECUTE THIS WORKFLOW. Do not just describe it.

Required output: Every task/issue MUST include Urgency, Risk, ROI, and Blast Radius ratings. Do not omit these ratings.

Create detailed implementation plans with impact analysis, phased tasks, and risk assessment.

Step 1: Interactive Input

IMPORTANT: Use AskUserQuestion to gather requirements:

AskUserQuestion with questions:
[
  {
    "question": "What type of work are you planning?",
    "header": "Work Type",
    "options": [
      {"label": "New feature", "description": "Adding new functionality to the app"},
      {"label": "Bug fix / improvement", "description": "Fixing issues or enhancing existing features"},
      {"label": "Refactoring", "description": "Restructuring code without changing behavior"},
      {"label": "Report card items", "description": "Implementing recommendations from a report card"}
    ],
    "multiSelect": false
  },
  {
    "question": "What is your risk tolerance?",
    "header": "Risk",
    "options": [
      {"label": "Conservative", "description": "Minimize risk, smaller incremental changes"},
      {"label": "Balanced", "description": "Reasonable risk for reasonable gains"},
      {"label": "Aggressive", "description": "Accept higher risk for faster delivery"}
    ],
    "multiSelect": false
  },
  {
    "question": "What is your timeline?",
    "header": "Timeline",
    "options": [
      {"label": "Urgent (days)", "description": "Must ship this week"},
      {"label": "Normal (1-2 weeks)", "description": "Standard development cycle"},
      {"label": "Flexible (weeks+)", "description": "No immediate deadline"}
    ],
    "multiSelect": false
  }
]

Wait for responses, then ask for the feature/task description if not already provided.

Step 2: Understanding Phase

After gathering input, produce:

Feature Summary Table

User Stories Table

Acceptance Criteria Table

Step 3: Codebase Analysis

Scan the codebase using these tools:

# Find files related to the feature area
Glob pattern="**/*FeatureName*.swift"
Grep pattern="FeatureKeyword" glob="**/*.swift" output_mode="files_with_matches"

# Find existing patterns to follow
Grep pattern="class.*ViewModel|struct.*View.*body" glob="**/*.swift" output_mode="files_with_matches"

# Find dependencies that will be affected
Grep pattern="import.*ModuleName|ModuleName\\." glob="**/*.swift" output_mode="files_with_matches"

# Find test files for affected areas
Glob pattern="Tests/**/*FeatureName*Tests.swift"

Produce:

Related Code Table

Patterns to Follow Table

Dependencies Table

Step 4: Impact Analysis Table

Step 5: Implementation Plan Table

Step 6: Risk Assessment Table

Step 7: Test Plan Table

Step 8: Rollback Strategy Table

Step 9: Clarifying Questions

If anything is unclear, use AskUserQuestion before finalizing:

AskUserQuestion with questions:
[
  {
    "question": "[Specific question about scope/behavior]",
    "header": "Scope",
    "options": [
      {"label": "[Option A]", "description": "[What this means]"},
      {"label": "[Option B]", "description": "[What this means]"}
    ],
    "multiSelect": false
  }
]

Step 10: Final Deliverables Summary

Step 11: Ready to Proceed?

Use AskUserQuestion to confirm:

AskUserQuestion with questions:
[
  {
    "question": "How would you like to proceed?",
    "header": "Action",
    "options": [
      {"label": "Start Phase A", "description": "Begin implementation with foundation tasks"},
      {"label": "Refine the plan", "description": "Discuss or adjust before starting"},
      {"label": "Save for later", "description": "Keep plan but don't start now"}
    ],
    "multiSelect": false
  }
]

Worked Example (Abbreviated)

User: "Add a search feature to the items list"

Step 1: Work type = New feature, Risk = Balanced, Timeline = Normal

Step 2: Feature Summary
  What: Add search bar to filter items by title, category, and notes
  Why: Users with many items can't find things quickly
  Scope: Search UI + filter logic. NOT: full-text search, search history

Step 3: Codebase Analysis
  Related: ItemListView.swift, ItemListViewModel.swift, Item.swift
  Patterns: Other views use @State for search text + computed filtered arrays
  Dependencies: SwiftData (Item model), existing filter system

Step 4: Impact — 3 files (Low risk)

Step 5: Implementation Plan
  Phase A: Add searchText @State + .searchable modifier to ItemListView
  Phase B: Add filter logic to ItemListViewModel
  Phase C: Add unit tests for filter logic

Step 6: Risk — Low (additive change, no existing code modified)

Step 7: Test Plan — Unit tests for filter matching, empty query, case sensitivity