@hustle-together/api-dev-tools 3.3.0 → 3.5.0

package/commands/api-create.md

@@ -16,29 +16,75 @@ This workflow requires REAL user input at each phase. You are **FORBIDDEN** from
 
 ### How to Ask Questions Correctly
 
-At every `[Y/n]` or multiple-choice prompt in this workflow, you MUST call:
+At every `[Y/n]` or multiple-choice prompt in this workflow, you MUST call the `AskUserQuestion` tool with this EXACT schema:
 
+```json
+{
+  "questions": [
+    {
+      "question": "Your question here? (must end with ?)",
+      "header": "Phase",
+      "multiSelect": false,
+      "options": [
+        {"label": "Option A", "description": "What this option means"},
+        {"label": "Option B", "description": "What this option means"},
+        {"label": "Other", "description": "I'll type my own answer"}
+      ]
+    }
+  ]
+}
 ```
-AskUserQuestion({
-  questions: [{
-    question: "Your question here?",
-    header: "Phase",
-    options: ["Option A", "Option B", "Option C", "Type something else..."]
-  }]
-})
-```
 
-**WAIT for the user's response before proceeding.** The tool will pause execution until the user answers.
+**CRITICAL REQUIREMENTS:**
+- `header`: Max 12 characters (e.g., "Scope", "Research", "Format")
+- `options`: 2-4 options, each with `label` (1-5 words) and `description`
+- `multiSelect`: Required boolean (true for checkboxes, false for radio)
+- `question`: Must end with a question mark
+- Users can always select "Other" to provide custom input
+
+**WAIT for the user's response before proceeding.** The tool will show a UI dialog and pause execution until the user answers. Do NOT continue until you receive the response.
 
 ### Violation Detection
 
 The enforcement hooks will BLOCK your progress if:
 - `user_question_asked` is false for any phase
 - `user_confirmed`/`user_approved`/`user_completed` is false
+- `phase_exit_confirmed` is false (user must explicitly approve proceeding to next phase)
 - Questions were not asked via the AskUserQuestion tool
 
 If you see "BLOCKED" messages, it means you skipped user interaction.
 
+### Phase Exit Confirmation (NEW in v3.5.0)
+
+**Every phase requires an EXIT CONFIRMATION question** before proceeding to the next phase. This prevents Claude from self-answering and moving on without explicit user approval.
+
+The exit confirmation question MUST:
+1. Summarize what was accomplished in the current phase
+2. Ask if user is ready to proceed to the next phase
+3. Include options like "Yes, proceed", "No, I have changes", "Add more"
+
+Example exit confirmation:
+```json
+{
+  "questions": [{
+    "question": "Phase complete. Research found 5 sources. Ready to proceed to Interview phase?",
+    "header": "Proceed",
+    "multiSelect": false,
+    "options": [
+      {"label": "Yes, proceed", "description": "Move to next phase"},
+      {"label": "No, more research", "description": "I need additional research on [topic]"},
+      {"label": "Review sources", "description": "Show me what was found"}
+    ]
+  }]
+}
+```
+
+The `phase_exit_confirmed` flag is automatically set when:
+1. An `AskUserQuestion` is called with a question containing words like "proceed", "continue", "ready", "confirm", "approve"
+2. The user responds with an affirmative answer (yes, proceed, confirm, approve, etc.)
+
+Both conditions must be true for the flag to be set.
+
 ---
 
 ## Key Principles
@@ -62,21 +108,20 @@ If you see "BLOCKED" messages, it means you skipped user interaction.
 │   • "[term] SDK"                                          │
 │   • "[term] npm package"                                  │
 │                                                           │
-│ ⚠️ REQUIRED: Use AskUserQuestion tool:                    │
-│                                                           │
-│   AskUserQuestion({                                       │
-│     questions: [{                                         │
-│       question: "I found multiple things matching         │
-│                  '[term]'. Which should we use?",         │
-│       header: "Disambig",                                 │
-│       options: [                                          │
-│         "Option A - Description",                         │
-│         "Option B - Description",                         │
-│         "Both A and B",                                   │
-│         "Something else (I'll describe)"                  │
+│ ⚠️ REQUIRED: Use AskUserQuestion tool with EXACT schema:  │
+│                                                           │
+│   {                                                       │
+│     "questions": [{                                       │
+│       "question": "Which interpretation of [term]?",      │
+│       "header": "Disambig",                               │
+│       "multiSelect": false,                               │
+│       "options": [                                        │
+│         {"label": "REST API", "description": "Official API"},│
+│         {"label": "SDK/Package", "description": "NPM wrapper"},│
+│         {"label": "Both", "description": "API + SDK"}     │
 │       ]                                                   │
 │     }]                                                    │
-│   })                                                      │
+│   }                                                      │
 │                                                           │
 │ WAIT for user response. Do NOT proceed without it.        │
 │ ──── Loop back if user selects "Something else" ────      │

package/demo/hustle-together/blog/gemini-vs-claude-widgets.html

@@ -7,7 +7,7 @@
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@300;400;500;700&family=Fredoka:wght@600;700&display=swap" rel="stylesheet">
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.2/gsap.min.js"></script>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.14.1/gsap.min.js"></script>
   <style>
     * { margin: 0; padding: 0; box-sizing: border-box; }
 

package/demo/hustle-together/blog/interview-driven-api-development.html

@@ -7,7 +7,7 @@
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@300;400;500;700&family=Fredoka:wght@600;700&display=swap" rel="stylesheet">
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.2/gsap.min.js"></script>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.14.1/gsap.min.js"></script>
   <style>
     * {
       margin: 0;

package/demo/hustle-together/blog/tdd-for-ai.html

@@ -7,7 +7,7 @@
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@300;400;500;700&family=Fredoka:wght@600;700&display=swap" rel="stylesheet">
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.2/gsap.min.js"></script>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.14.1/gsap.min.js"></script>
   <style>
     * { margin: 0; padding: 0; box-sizing: border-box; }
 

package/demo/hustle-together/index.html

@@ -7,8 +7,8 @@
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@300;400;500;700&family=Righteous&family=Bungee&family=Fredoka:wght@600;700&display=swap" rel="stylesheet">
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.2/gsap.min.js"></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.2/ScrollTrigger.min.js"></script>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.14.1/gsap.min.js"></script>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.14.1/ScrollTrigger.min.js"></script>
   <style>
     /* ============================================
        HUSTLE TOGETHER - 90s BOXY AESTHETIC