workflow-plan_skill

Overview

This skill implements a unified 4-phase planning workflow with built-in plan verification and interactive replanning. It coordinates session discovery, context gathering, conditional conflict resolution, and task generation, then offers plan verification or execution paths. The orchestrator manages lifecycle artifacts (IMPL_PLAN.md, task JSONs, PLAN_VERIFICATION.md) and maintains session-level planning-notes for cumulative state.

How this skill works

The orchestrator detects mode from triggers (plan / verify / replan) and converts user input into a structured GOAL/SCOPE/CONTEXT before starting Phase 1. Each phase is loaded and executed on demand: session discovery, context gathering, optional conflict resolution, and task generation. Sub-tasks are attached to a TodoWrite, executed sequentially, then collapsed to preserve a clean view; plan verification and interactive replanning run as separate modes with their own outputs.

When to use it

• You need a repeatable plan generation process that produces implementation artifacts and task JSONs.
• You want automated quality checks before starting execution (plan verification).
• You need conditional conflict detection and guided resolution against a codebase or requirements.
• You want interactive replanning when requirements change or a task-id must be updated.
• You need session-based continuity where planning-notes carry context across phases.

Best practices

• Provide a clear, concise user goal so input parsing yields a focused GOAL/SCOPE/CONTEXT.
• Use the recommended Verify Plan Quality gate before execution to catch issues early.
• Enable interactive preferences unless you require fully automated runs (autoYes toggles confirmations).
• Keep sessions small; compact planning-notes when context windows grow large to avoid token bloat.
• Rely on the TodoWrite attachment/collapse pattern to monitor live progress and debug phase failures.

Example use cases

• Generate an implementation plan and task list for adding JWT authentication to a TypeScript service.
• Verify plan quality for a multi-module refactor before handing tasks to CI/CD execution agents.
• Run an interactive replan to adjust task boundaries after new requirements are introduced for an open feature.
• Automate phased planning for onboarding a new project: session creation, context package, conflict checks, and task generation.
• Attach detailed sub-tasks during context analysis and collapse them into a high-level phase summary for sprint planning.