| name | review-plan |
| description | Full plan-review cycle: read a proposed/ file, run 5-point gap analysis, create or update the jgwill/src tracking issue, output revision prompt. Use when the user says "review the plan", "check the proposal", or when a new proposed/ file has landed and needs analysis before the implementing agent gets the next prompt.
|
| version | 0.1.0 |
Review Plan Skill
This skill runs the full complementary-review cycle for a Miadi proposed plan file.
Steps
- Locate the plan — find the target
proposed/*.md file (passed as argument or most recent)
- Read platform context — check
/src/Miadi/app/api/ for existing routes that overlap
- Run gap analysis — apply the 5-point checklist (payload, idempotency, failure path, write-back, naming)
- Check tracking issue — search
jgwill/src for an existing issue; create one if absent
- Output revision prompt — paste-ready instructions for the implementing agent
5-Point Checklist
| # | Check | Pass condition |
|---|
| 1 | plan_content inline | POST payload contains content, not just file path |
| 2 | Idempotency key | API deduplicates on session_id + plan_filename |
| 3 | Failure observability | Langfuse error trace on async failure, not just success |
| 4 | Write-back resolved | One of: return-content pattern OR explicit mount documented |
| 5 | Naming consistent | plan_file / plan_filename unified across schema + tables |
Output contract
Always produce both:
- Gap Report (numbered, severity-tagged)
- Revision Prompt (under 250 words, paste-ready, references tracking issue)
Never implement. Never modify the proposed/ file directly. Hand the prompt to the user.
