| name | plan-eng-review |
| description | Use after PRD is ready but before implementation. Locks architecture, data flow, edge cases, and test plan so scope cannot silently creep during build. |
Plan Engineering Review
๊ตฌํ ์์ ์ ์ architecture / data flow / edge cases / test plan ์
์ ๊ทธ๋ skill. Scope freeze ์ง์ ๋จ๊ณ.
์ธ์ ์ฐ๋๊ฐ
- PRD.md ๊ฐ ์์ฑ๋ผ ์๊ณ Prompt.md ์ done-when ์ด ๋ช
์๋จ
- Plan.md ์ด์์ด ์์ง๋ง ์์ง ๊ฐ์ฅ์๋ฆฌ ์ผ์ด์ค๋ฅผ ๊ฒํ ์ ํจ
- tier ๊ฐ normal ๋๋ high-risk
์ธ์ ์ฐ์ง ์๋๊ฐ
- trivial tier ๋ณ๊ฒฝ
- PRD ์์ฒด๊ฐ ์์ง ํ๋ค๋ฆผ โ ๋จผ์
/office-hours ๋ก ๋์๊ฐ๊ธฐ
๋ฐฉ์
Plan.md ๋ฅผ ์ ๋์ ์ผ๋ก ์ฝ๊ณ ๋ค์์ ์ ๊ทผ๋ค.
1. Architecture ์ ๊ธ
- ์ด ๋ณ๊ฒฝ์ด ๊ฑด๋๋ฆฌ๋ ์ถ์ ๊ฒฝ๊ณ ๋? (API / DB / queue / etc)
- ์๋ก ์ถ๊ฐ๋๋ ์ถ์ ์? (์ ํด๋์ค / ์๋น์ค / ํ
์ด๋ธ)
- ๊ทธ ์ถ์์ด ์ง๊ธ ๊ผญ ํ์ํ๊ฐ โ ๋์ค์ ๋ง๋ค์ด๋ ๋๋๊ฐ?
2. Data flow ์ ๊ธ
- ์
๋ ฅ โ ๋ณํ โ ์ ์ฅ โ ์ถ๋ ฅ ๊ฒฝ๋ก๋ฅผ ํ ๊ทธ๋ฆผ์ผ๋ก ๊ทธ๋ฆฐ๋ค.
- ๊ฐ ๊ฒฝ๊ณ์์ ๋ฐ์ดํฐ ํ์๊ณผ ์ฑ
์ ์ ๊ธฐ๋ก.
- ์คํจ ์ ๋ฐ์ดํฐ๋ ์ด๋ป๊ฒ ๋๋ (๋ฉ์ถ๋ / ๋กค๋ฐฑํ๋ / ์ผ๊ด์ฑ ๊นจ์ง๋)?
3. Edge cases ์ ๊ธ
๋ช
์์ ์ผ๋ก ๋ค์์ ์ ๊ฒ:
- ๋น ์
๋ ฅ / ํฐ ์
๋ ฅ / ์ค๋ณต ์์ฒญ
- ๋์์ฑ (lock order, race condition)
- ํ์์์ / ์ฌ์๋ / ๋ถ๋ถ ์คํจ
- ๊ถํ ์๋ ์ฌ์ฉ์ / tenant boundary
- ์คํค๋ง ๋ณ๊ฒฝ ์ ๊ธฐ์กด ๋ฐ์ดํฐ ํธํ์ฑ
- ์ฑ๋ฅ: O(nยฒ) ๊ฒฝ๋ก ์๋?
4. Test plan ์ ๊ธ
- ๊ฐ AC (acceptance criterion) ์ ๋์ํ๋ ํ
์คํธ ๊ฐ ์๋?
- ์คํจ ๊ฒฝ๋ก๋ฅผ ํ
์คํธํ๋ fixture ๊ฐ ์๋?
- E2E vs ๋จ์ vs ํตํฉ ๊ตฌ๋ถ์ด ๋ช
ํํ๊ฐ?
- ๊ธฐ์กด ํ
์คํธ๋ฅผ ์์ ํ ๊ณํ์ด ์๋ โ ๊ทธ๊ฑด red flag
5. Tier ํ์
size_check.py ๋ก ์์ tier / complexity ํ์ธ
- ์์๊ณผ ๋ค๋ฅด๋ฉด Plan ์ ์ชผ๊ฐ ๋ค
์ถ๋ ฅ ํ์
# Plan-Eng Review โ <๋ ์ง>
## Architecture verdict
- Accept / Revise
- Issues found: <list>
## Data flow verdict
- Accept / Revise
- Missing boundaries: <list>
## Edge cases checklist
- [x] empty input
- [x] large input
- [x] concurrency
- [ ] <ํญ๋ชฉ> โ NOT covered in plan
## Test plan verdict
- Accept / Revise
- AC โ test mapping: <table>
- Risky test modifications: <list>
## Tier confirmation
- Classified: <tier> / <complexity>
- Plan says: <tier>
- Match: yes / no
## Blocking issues (must fix before scope_lock)
1. ...
## Non-blocking suggestions
1. ...
## Next gate
If Accept โ `runtime_gate.py lock-scope` + `runtime_gate.py review-plan`
๊ฐ๋๋ ์ผ
- "looks good" ๊ธ์ง. ์ต์ 3๊ฐ objection ๋๋
<INSUFFICIENT_OBJECTIONS>.
- Plan ์ ์๋ edge case ๋ฅผ ์ฐพ์ผ๋ฉด plan ์ ์ถ๊ฐ ํ๊ณ ๋ค์ ๊ฒํ .
- ์ด skill ์๋ฃ ํ์๋ง
lock-scope / review-plan gate flag ๋ฅผ flip.
- Layer 2 review-matrix ์์
planner ์ required_reviewers ์ญํ ์ ์ํ.
๋จผ์ ์ฝ์ ๊ฒ
Plan.md
PRD.md
CLAUDE.md, AGENTS.md
.claude/sealed-prompts/plan-redteam.md