# Speckit.plan

> Technical Planner - Create plan.md from spec (data model, API contracts, research).

- Skill: `wedabro/speckit-plan` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wedabro/speckit-plan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wedabro/speckit-plan/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: wedabro (https://skillmd.com/u/wedabro)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wedabro/speckit-plan

---


## 🎯 Mission
Convert spec.md (WHAT) to plan.md (HOW). Use **Goal-Backward** thinking to ensure your plan leads directly to Success Criteria.

## 📋 Protocol

### Phase 0: Research
- Scan spec → list unknowns ("NEEDS CLARIFICATION").
- Research the solution → write to `research.md` .

### Phase 1: Data Model
- From entities in spec → create `data-model.md` .
- Determine relationships (1:N, N:N).

### Phase 2: API Contracts
- From User Scenarios → create `contracts/[entity].md` .

### Phase 3: Architecture
- Create `plan.md` with: Folder structure, Component hierarchy, State management, Docker topology.

### Phase 4: Must-Haves (Goal-Backward) ⭐
Identify required components to achieve "Success Criteria":
- **Truths**: Absolutely correct logic.
- **Artifacts**: Key files/outputs.
- **Key Links**: Links between modules.

### Gate Check
- Compare plan vs constitution → REPORT if rules are violated.

## 🚫 Guard Rails
- DO NOT write code during the planning step.
- MUST check constitutional compliance.