plan-design v1.0.0A

Immutable. This exact content never changes and is served at /api/v1/blob/581b889041d659b3.

---
name: plan-design
license: MIT
metadata:
  version: "1.0.0"
description: |
  USE FOR: Implementation plans and durable task tracking: reduce ambiguity,
  compare options, parallel investigation, multi-source synthesis, review
  gates, planning evidence, handoff/resume, DONE/BLOCKED verification, and
  Secret-Gist handoff semantics. DO NOT USE FOR: artifact storage mechanics,
  machine-only outputs, internal logs, code/config artifacts, unrelated tasks,
  broad rewrites outside the request, or generated runtime outputs.
---

# Plan Design

Owns implementation-plan authoring and durable task tracking for plan-ready
tasks: ambiguity reduction, option framing, multi-source synthesis, review
gates, task artifacts, evidence logs, and handoff/resume.

This skill owns planning semantics and evidence expectations, not artifact
storage or delivery mechanics. Leave a durable artifact of your work; where
and how it is created, reused, discovered, and delivered is governed
elsewhere in this environment.

Follow the output language designated by the active runtime/session policy or
explicit request. Do not establish an independent language policy in this
skill.

## 1. Workflow

1. Inspect the relevant files, current repo conventions, and `git status`.
2. Read [Plan Authoring](references/plan-authoring.md) before changing
   behavior or giving detailed instructions.
3. If the task is fuzzy or has multiple viable approaches, read
   [Brainstorming](references/brainstorming.md) and stabilize the direction
   before drafting the execution plan.
4. If plan terms, states, conditions, cause categories, or mitigation names are
   ambiguous, use `clarify-concepts` before the plan language hardens.
5. Make the smallest scoped change that satisfies the request.
6. Run the checks named in the plan authoring guide or the nearest repo
   harness.
7. Report verification results and any remaining risk.

## 2. References

- [Plan Authoring](references/plan-authoring.md)
- [Brainstorming](references/brainstorming.md)
- [Durable Task Tracking](references/durable-task-tracking.md)