ai-coding-skills/skills/do-task/pi/templates/task-plan.md

Task Plan: [Short Title]

Variant guardrail (pi): Required workflow skills (brainstorming, test-driven-development, verification-before-completion, finishing-a-development-branch, using-git-worktrees) must be available to pi as documented in docs/PI-SUPERPOWERS.md. Load the relevant workflow skill before entering its matching phase.

Metadata

Field	Value
Created	YYYY-MM-DD
Slug	YYYY-MM-DD-
Runtime	pi
Reviewer CLI	codex | claude | cursor | opencode | pi
Reviewer Model
MAX_ROUNDS	10
Branch Strategy	current-branch | worktree
Branch Name	<current branch name, or new branch name when worktree is used>
Worktree Path	<absolute path to worktree dir; blank when Branch Strategy = current-branch>
Status	draft

Status Enum (authoritative)

Value	Meaning
draft	Newly created; plan review not yet started
plan-approved	Plan review loop returned APPROVED
implementation-in-progress	Phase 6 executing
implementation-approved	Phase 8 review loop returned APPROVED; awaiting commit
pushed	Committed + pushed to remote
local-only	Committed locally; user declined push
aborted-plan-review	MAX_ROUNDS reached in Phase 5; user aborted
aborted-impl-review	MAX_ROUNDS reached in Phase 8; user aborted
aborted-verification	Phase 7 retries exhausted; user aborted
failed	Hard tooling failure

---

Prompt

Interpretation

Assumptions

Files

Action	Path	Why

Approach

TDD Approach

Acceptance Criteria

• <criterion 1>
• <criterion 2>

Verification

Rollback

---

Runtime State

plan_review_round: 0
implementation_review_round: 0
CODEX_PLAN_SESSION_ID:
CODEX_IMPL_SESSION_ID:
CURSOR_PLAN_SESSION_ID:
CURSOR_IMPL_SESSION_ID:
OPENCODE_PLAN_SESSION_ID:
OPENCODE_IMPL_SESSION_ID:
last_phase_entered:
last_round_ts:
last_scan_outcome_plan:
last_scan_outcome_impl:
verification_attempts: 0
tests_added_count: 0
tdd_used: false

Review History

Timestamp (ISO-8601)	Loop	Round	Verdict	Summary

Final Status

---

Guardrails (do NOT remove)

• This file is the single persistent artifact for do-task. Do not split it or delete it on success.
• Status must always match one of the enum values.
• Runtime State is updated by the skill, not by the user.
• Review History is append-only.