planning

Original：🇺🇸 English

Translated

PRD construction for work planning. Compulsory in PLAN phase. Builds .prd file as frozen dependency graph of every possible work item before execution begins. Triggers on any new task, multi-step work, or when gm enters PLAN state.

2installs

Sourceanentrypoint/plugforge

Added on2026-03-19

NPX Install

npx skill4agent add anentrypoint/plugforge planning

SKILL.md Content

View Translation Comparison →

PRD Construction

Purpose

The

.prd

is the single source of truth for remaining work. It is a frozen dependency graph created in PLAN phase before any execution. It captures every possible item — steps, substeps, edge cases, corner cases, dependencies, transitive dependencies, unknowns, assumptions to validate, decisions, trade-offs, factors, variables, acceptance criteria, scenarios, failure paths, recovery paths, integration points, state transitions, race conditions, concurrency concerns, input variations, output validations, error conditions, boundary conditions, configuration variants, environment differences, platform concerns, backwards compatibility, data migration, rollback paths, monitoring checkpoints, verification steps.

Longer is better. Missing items means missing work. Err towards every possible item.

File Rules

Path: exactly

./.prd

in current working directory. No variants (.prd-rename, .prd-temp, .prd-backup), no subdirectories, no path transformations, no extensions. Valid JSON.

Item Schema

json

{
  "id": "descriptive-kebab-id",
  "subject": "Imperative verb describing outcome",
  "status": "pending",
  "description": "What must be true when this is done",
  "blocking": ["ids-this-prevents"],
  "blockedBy": ["ids-that-must-finish-first"],
  "effort": "small|medium|large",
  "category": "feature|bug|refactor|docs|infra",
  "acceptance": ["measurable criteria"],
  "edge_cases": ["known complications"]
}

Subject: imperative form — "Fix auth bug", "Add webhook support", "Consolidate templates". Never "Bug: auth" or "New feature".

Blocking/blockedBy: bidirectional. If A blocks B, then B blockedBy A. Every dependency explicit.

Status:

pending

→

in_progress

→

completed

. No other values.

Effort:

small

(one attempt, <15min),

medium

(2 rounds, <45min),

large

(multiple rounds, 1h+).

Construction

Enumerate every possible unknown as a work item.
Map every possible dependency (blocking/blockedBy).
Group independent items into parallel waves (max 3 per wave).
Capture every possible edge case as either a separate item or an edge_case field.
Write
```
./.prd
```
to disk.
FREEZE — no additions or reorganizations after creation. Only mutation: removing finished items.

Execution

Find all
```
pending
```
items with empty
```
blockedBy
```
.
Launch ≤3 parallel subagents (
```
subagent_type: gm:gm
```
) per wave.
Each subagent completes one item, verifies via witnessed execution.
On completion: remove item from
```
.prd
```
, write updated file.
Check for newly unblocked items. Launch next wave.
Continue until
```
.prd
```
is empty.

Never execute independent items sequentially. Never launch more than 3 at once.

Completion

.prd

must be empty at COMPLETE — zero pending, zero in_progress items. The stop hook blocks session end when items remain. Empty

.prd

= all work done.

Do Not Use

Skip this skill if the task is trivially single-step (under 5 minutes, no dependencies, no unknowns).