메뉴
Catch oversized phases BEFORE implementation begins! This skill reviews plans for sizing, dependencies, and completeness - flagging phases that need decomposition before a single line of code is written. Load this when validating plans pre-implementation.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | plan-review |
| description | Catch oversized phases BEFORE implementation begins! This skill reviews plans for sizing, dependencies, and completeness - flagging phases that need decomposition before a single line of code is written. Load this when validating plans pre-implementation. |
Review implementation plans before execution to catch sizing issues, dependency problems, and gaps that would cause implementation failures. This is a pre-flight check that prevents wasted effort.
For each phase, evaluate:
| Factor | Acceptable | Concerning | Flag for Decomposition |
|---|---|---|---|
| File changes | 1-3 files | 4-6 files | 7+ files |
| New functions/classes | 1-5 | 6-10 | 10+ |
| Test additions | 1-10 tests | 11-20 tests | 20+ tests |
| Estimated context | <30% | 30-40% | >40% |
Context estimation heuristic:
For each phase, verify:
For each phase, verify it includes:
Identify missing elements:
Read the entire plan without making judgments. Understand:
For each phase, create an assessment:
### Phase N: [Title]
**Sizing**: ✓ Acceptable / ⚠️ Borderline / ✗ Too Large
- Estimated files: X
- Estimated context: Y%
**Dependencies**: ✓ Clear / ⚠️ Implicit / ✗ Circular
**Completeness**: ✓ Complete / ⚠️ Missing details / ✗ Insufficient
**Notes**: [Any specific concerns or suggestions]
Based on all assessments:
APPROVED - Plan is ready for implementation
NEEDS DECOMPOSITION - Specific phases must be broken down
NEEDS REVISION - Plan has structural issues
# Plan Review: [Plan Name]
## Overview
[1-2 sentence summary of what the plan implements]
## Phase Assessments
### Phase 1: [Title]
**Sizing**: ✓ / ⚠️ / ✗
**Dependencies**: ✓ / ⚠️ / ✗
**Completeness**: ✓ / ⚠️ / ✗
**Notes**: ...
[Repeat for each phase]
## Dependency Graph
Phase 1 → Phase 2 → Phase 3 ↘ Phase 4 (parallel)
## Issues Found
### Must Fix Before Implementation
- [Critical issue 1]
- [Critical issue 2]
### Recommendations (Optional)
- [Suggestion 1]
- [Suggestion 2]
## Verdict
**[APPROVED / NEEDS DECOMPOSITION / NEEDS REVISION]**
[Explanation of verdict with specific action items if not approved]
When operating within RPIV:
Guides creation of dubstack agent source files (agent.yaml + frontmatter.md + agent-body.md) through discovery, template selection, and iterative filling. Produces complete vera-cli native agent directories ready for `vera build`. Self-documenting templates teach the fill conversation; the skill orchestrates the process while the templates own the content knowledge. Primary entry point for adding a new agent to dubstack.
D-phase skill for the codesmith implementation workflow. Invokes render-design-doc-skeleton.py to overwrite the design.md placeholder with a tag-aware skeleton grounded in R-phase findings. Runs the always-interactive brain-surgery alignment conversation per Lock 6: agent presents each design section, human stress-tests via Question tool per substantive decision, iterate until aligned. Tracks the foundational-reversal strike counter per Lock 31. May identify multiple architecturally-distinct plans (NOT sub-tickets). Hands off to code-structure when D-phase is locked.
Q↔R loop skill for the codesmith implementation workflow. Applies Kipling structure (What/How/Who/When/Why/Where) × grill-with-docs discipline × per-tag emphasis matrix to derive code-layer questions. Composes research dispatch instructions (in-memory, NOT a written artifact) per the 7 composable research patterns. Dispatches `researcher` across the hide-the-intent boundary — researcher receives questions + scope only, not the ticket. Synthesizes returns into the bundle's research file. Updates CONTEXT.md inline as terms surface. Scaffolds Decision Records when the three-condition gate fires. Loops until five readiness criteria are met (problem scoped, current state mapped, impact understood, edge cases identified, agent can articulate unprompted). Hands off to code-design when readiness is confirmed.
I-phase orchestration skill per Lock 10. Iterates over the locked plan's slices in dependency order. For each slice: invokes worktree-setup (first slice only or once per parallel plan); dispatches `codesmith-worker` subagent with slice scope (plan + slice boundary + verification commands + commit convention + worktree path); awaits PHASE_COMPLETE or NEEDS_DECOMPOSITION; on decomposition triggers mini-replan per Lock 19; on completion invokes `code-verify` for the I-per-slice gate. Owns the plan-as-living-doc's structural sections; worker owns the per-slice log subsections. Tracks decomposition strike count (abort after 3 consecutive on the same slice per Lock 17.2).
Entry-point skill for the codesmith implementation workflow. Detects dual mode (planning vs execution) from initial input shape — ticket reference → planning mode; bundle directory → execution mode. In planning mode: loads the `status: ready` ticket, scaffolds the implementation bundle via scaffold-implementation-bundle.py, transitions ticket status `ready → active`, and hands off to code-grill. In execution mode: loads the existing bundle (ticket + design + structure + plans + optional research), confirms preconditions, and hands off to code-implement. Detects PR mode vs local-only mode based on remote configuration and user confirmation.
P-phase skill for the codesmith implementation workflow. Converts the structural skeleton into per-slice tactical steps (TDD vertical: failing test → minimal impl → green → verify → commit) per Lock 8. Produces one plan doc per plan identified in D-phase. Runs the Parallel-Safety Evaluation per Lock 27 to determine whether multiple plans execute in parallel worktrees or serialize. Spot-check user review; no open questions in the final plan. Hands off to worktree-setup (or directly to code-implement if Work-Tree is bypassed).