review-plan

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

1. Locate the plan — find the target proposed/*.md file (passed as argument or most recent)
2. Read platform context — check /src/Miadi/app/api/ for existing routes that overlap
3. Run gap analysis — apply the 5-point checklist (payload, idempotency, failure path, write-back, naming)
4. Check tracking issue — search jgwill/src for an existing issue; create one if absent
5. 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.