win20/deep-plan

Deep Plan

Overview

Produce a detailed, actionable implementation plan, then save it into the project at .agent.local/plans/ using a date-prefixed filename or a phased folder structure.

Workflow

1. Gather context

   • Read relevant files to understand existing structure, conventions, and dependencies.
   • Note any constraints (tech stack, lint rules, coding conventions).

2. Clarify missing requirements

   • If anything is ambiguous or risky, ask concise clarifying questions before planning.

3. Generate the plan

   • If subagent support is available: Spawn a subagent with instructions from ./references/guidelines.md
   • Otherwise: Apply the guidelines from ./references/guidelines.md directly to create the plan yourself
   • The guidelines specify the required format, process, and best practices

4. Save the plan

   • Write to .agent.local/plans/<DD-MM-YYYY>-<feature-slug>.md
   • If the plan contains multiple big phases, create .agent.local/plans/<DD-MM-YYYY>-<feature-slug>/phase-1.md, phase-2.md, etc.

Naming Rules

• Use date prefix in DD-MM-YYYY format
• Use a short, lowercase, hyphenated feature slug (e.g., 03-02-2026-profile-onboarding.md)
• Keep file names ASCII