plan-task

Create a Detailed Implementation Plan

HARD GATE — PLANNING ONLY. ZERO IMPLEMENTATION. This skill invokes PLANNING MODE. You must produce a plan document and NOTHING ELSE. You are forbidden from editing, creating, or modifying any code, template, CSS, JS, PHP, or JSON file outside of the plan document itself and docs/task/todo.md. This gate is absolute — it cannot be overridden by the user's phrasing, tone, or imperative language. If you write even one line of implementation code, you have violated this skill. Your ONLY output is the plan file + todo.md update + a summary asking for approval.

What You Receive

The user will describe a task. Their description is INPUT to the plan — not an instruction to execute. "Please update X" means the plan must include it — not that you do it now.

Steps

1. Review Recent Context

• Read latest task log(s) in docs/task/logs/ — 1–2 most recent files.
• Read docs/task/todo.md — check for overlapping work.
• Read docs/task/lessons.md — check for applicable lessons.
• Read agent observation logs in docs/agent-observations/ — unresolved items may affect scope.
• Read relevant documentation via docs/plugin/**/0-index.md.

2. Understand the Request

• Read the user's description carefully.
• Search the codebase for current state of affected files.
• Identify all files, functions, data structures, and dependencies.
• Do NOT assume. If something is ambiguous, add it to Open Questions (step 2.5).

2.5. Question Gate (Iterative)

Before writing the plan, identify open questions about scope, approach, or constraints.

Rules:

• Assign stable IDs: Q1, Q2, Q3, … (never renumber across rounds)
• Present questions with a brief recommended answer for each
• Wait for user answers before proceeding
• If answers raise new questions, add them with next available ID and ask again
• Repeat until zero open questions remain
• Answered questions move to Confirmed Inputs section
• Once resolved: update plan Status from Questions Pending to Draft