diff --git a/.pi/prompts/shape-draft.md b/.pi/prompts/shape-draft.md new file mode 100644 index 00000000..2aca5e06 --- /dev/null +++ b/.pi/prompts/shape-draft.md @@ -0,0 +1,42 @@ +--- +description: Promote a draft backlog task to a fully-planned task with a complete implementation plan +argument-hint: "" +--- + +We're going to take a draft backlog task — $1 — and shape it into a fully-planned task with a complete implementation plan. + +For the plan to be valid, it must cover these requirements: + +1. **Objective alignment** — The plan clearly states how it achieves the stated objective of the issue, with a direct mapping between the problem and the proposed solution. + +2. **Simplicity and alternatives considered** — The plan identifies the simplest viable approach. It documents alternatives that were evaluated, explains why they were rejected or deferred, and + justifies why the chosen approach is the right trade-off for the objective. + +3. **Completeness and sequencing** — The plan covers every implementation step in a logical order. No gaps exist between "current state" and "done state." Dependencies between steps are + explicit so the plan can be executed sequentially without backtracking. + +4. **Verifiability** — Each implementation step includes concrete verification instructions (tests to run, manual checks to perform, queries to validate) that prove the step was completed + correctly before moving on. + +5. **Architecture impact analysis** — The plan identifies all architectural touchpoints affected by the change (schemas, contexts, PubSub topics, supervision tree, routes, external APIs, UI + components) and describes how each is impacted, including any migration or deprecation path. + +6. **Performance profile** — The plan explains the performance characteristics of the chosen approach: expected runtime complexity, database query patterns (including N+1 risks), memory + footprint, and any latency or throughput implications under realistic load. + +7. **Benchmarking requirements** — The plan identifies whether one-off or ongoing benchmarks are needed to validate or monitor the performance profile, and if so, specifies what to measure, how + to measure it, and what thresholds define acceptable performance. + +8. **Cost profile** — If the implementation consumes paid resources (API calls, compute, storage, third-party services), the plan includes a cost estimate or model so the financial impact is + understood before implementation begins. + +9. **Production infrastructure steps** — Any manual changes required in production (environment variables, service provisioning, database migrations with special handling, DNS changes, firewall + rules) are documented in a dedicated "Production Changes" section, separate from the implementation steps, with rollout and rollback instructions. + +10. **Documentation updates** — The plan enumerates which project documentation files must be created or updated as part of the implementation (e.g., `docs/architecture.md`, + `docs/project-conventions.md`, README, API docs), with a summary of what changes each file needs. + +Once the plan is written, update the task with it — set the plan via `backlog_task_edit` using `planSet`, and if the draft contained useful notes, preserve them or summarize them in `notesSet`. +Then promote the task status from "Draft" to "To Do". + +At the end, do not offer to start implementation. Instead, offer to start a new session so I can review the plan via `/review-task-plan`.