feat: moved review-agent instructions to shared file (#154)

Author: RuiMiguel

skills/build/SKILL.md

@@ -138,7 +138,7 @@ After all implementation tasks are complete, run 5 review agents **in parallel**
 
 ### Agent instructions
 
-Each agent prompt must include the [review agent instructions](references/review-agent-instructions.md).
+Each agent prompt must include the [review agent instructions](references/review-agent-instructions.md) with `REPORT_DIR` set to `docs/reviews/`.
 
 The 5 agents and their report filenames:
 

skills/build/references/review-agent-instructions.md

@@ -0,0 +1 @@
+../../shared/references/review-agent-instructions.md

skills/build/references/review-agent-instructions.md

@@ -122,7 +122,7 @@ Run review agents **in parallel** to validate the fix. Use a reduced set — spe
 
 ### Agent instructions
 
-Each agent prompt must include the [review agent instructions](references/review-agent-instructions.md).
+Each agent prompt must include the [review agent instructions](references/review-agent-instructions.md) with `REPORT_DIR` set to `docs/hotfix-review/`.
 
 The 2 agents and their report filenames:
 

skills/hotfix/SKILL.md

@@ -0,0 +1 @@
+../../shared/references/review-agent-instructions.md

skills/hotfix/references/review-agent-instructions.md

@@ -0,0 +1,16 @@
+# Review Agent Instructions
+
+Write your full detailed report to `<REPORT_DIR>/<name>.md` (create the directory if needed).
+Then return ONLY a short structured summary to the parent context in this format:
+
+```markdown
+## <Agent Name> Summary
+**Report**: `<REPORT_DIR>/<name>.md` (<word_count> words)
+**Critical**: <count> | **Important**: <count> | **Suggestions**: <count>
+### Findings
+- [Critical] <one-line description>
+- [Important] <one-line description>
+- [Suggestion] <one-line description>
+```
+
+Do NOT return the full report text. Only return the summary above.