@hopla/claude-setup 1.2.1 → 1.2.3

package/files/commands/hopla-create-prd.md

@@ -201,12 +201,20 @@ Do NOT show the full PRD in the chat. Instead:
 1. Save the draft to `PRD.draft.md` at the project root
 2. Save any on-demand context documents created in Step 3 (also with `.draft` suffix if new)
 3. Tell the user:
-   > "Draft saved to `PRD.draft.md` — open it in your editor. Tell me what to change, or say 'looks good' to finalize."
+   > "Draft saved to `PRD.draft.md` — open it in your editor. You can add `<!-- TODO: your note -->` comments anywhere in the file and tell me 'apply comments', request changes in chat, or say 'looks good' to finalize."
 
 **Review loop:** Stay in this loop until the user finalizes:
-- If the user requests changes → apply them directly to `PRD.draft.md`, then say: "Updated — anything else, or ready to finalize?"
+
+- If the user says **"apply comments"** (or similar) → scan `PRD.draft.md` for `<!-- TODO: ... -->` comments, apply each one, remove the comment tags, update the file, then list what was changed: "Applied 3 changes: [list]. Anything else, or ready to finalize?"
+- If the user requests changes in chat → apply them directly to `PRD.draft.md`, then say: "Updated — anything else, or ready to finalize?"
 - If the user says the draft is ready (e.g. "looks good", "finalize", "listo") → proceed to Step 6
 
+**Comment format the user can add directly in the draft:**
+```
+<!-- TODO: your instruction here -->
+```
+Comments can be placed anywhere in the file — inline after a line, or on their own line above a section. Process them in order from top to bottom.
+
 Do not ask clarifying questions about changes — just apply them and confirm what was changed.
 
 ## Step 6: Finalize

package/files/commands/hopla-plan-feature.md

@@ -59,7 +59,7 @@ Based on research, define:
 
 ## Phase 5: Generate the Plan
 
-Save the plan to: `.agents/plans/[kebab-case-feature-name].md`
+Write the full plan in memory using the structure below, then save it as a draft (do NOT output the plan content in the chat).
 
 Use this structure:
 
@@ -122,7 +122,7 @@ Run in this order — do not proceed if a level fails:
 
 ## Phase 6: Verify the Plan
 
-Before finishing, review the plan against these criteria:
+Before saving the draft, review the plan against these criteria:
 
 - [ ] Every task has a specific file path (no vague "update the component")
 - [ ] Every task has: Action, File, Pattern, Details, Gotcha, Validate — no field left empty
@@ -130,10 +130,20 @@ Before finishing, review the plan against these criteria:
 - [ ] The plan is complete enough that another agent can execute it without this conversation
 - [ ] No ambiguous requirements left unresolved
 
-## Final Output
+## Phase 7: Save Draft and Enter Review Loop
 
-Confirm to the user:
-- Plan saved to: `.agents/plans/[feature-name].md`
-- Summary of tasks included
-- Any open questions or decisions that require human confirmation before execution
-- Suggest running `/hopla-commit` to save the plan to the repository
+1. Save the plan to `.agents/plans/[kebab-case-feature-name].draft.md`
+2. Tell the user:
+   > "Plan draft saved to `.agents/plans/[feature-name].draft.md` — open it in your editor. You can add `<!-- TODO: your note -->` comments anywhere and tell me 'apply comments', request changes in chat, or say 'looks good' to finalize."
+3. Also mention:
+   - How many tasks are in the plan
+   - Any open questions or decisions that require human input before execution
+
+**Review loop:** Stay in this loop until the user finalizes:
+- If the user says **"apply comments"** → scan the draft for `<!-- TODO: ... -->`, apply each one, remove the comment tags, update the file, report what changed
+- If the user requests changes in chat → apply directly to the draft, confirm what changed
+- If the user says the plan is ready → proceed to finalize
+
+**Finalize:**
+1. Rename `.agents/plans/[feature-name].draft.md` → `.agents/plans/[feature-name].md`
+2. Confirm: "✅ Plan saved to `.agents/plans/[feature-name].md`. Run `/hopla-execute .agents/plans/[feature-name].md` to implement it, or `/hopla-commit` to save the plan first."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hopla/claude-setup",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Hopla team agentic coding system for Claude Code",
   "type": "module",
   "bin": {