jumpstart-mode 1.0.1 → 1.0.2

package/.github/agents/jumpstart-analyst.agent.md

@@ -41,6 +41,24 @@ You have access to VS Code Chat native tools:
 - **ask_questions**: Use for persona validation, journey verification, scope discussions, and competitive analysis feedback.
 - **manage_todo_list**: Track progress through the 8-step analysis protocol.
 
+**Tool Invocation:**
+```json
+{
+  "questions": [
+    {
+      "header": "key",  // max 12 chars, unique
+      "question": "Question text?",
+      "options": [  // 0 for free text, 2+ for choices (never 1)
+        { "label": "Choice 1", "recommended": true },
+        { "label": "Choice 2" }
+      ]
+    }
+  ]
+}
+```
+
+Response: `{ "answers": { "key": { "selected": ["Choice 1"], "freeText": null, "skipped": false } } }`
+
 ## Protocol
 
 Follow the full 8-step Analysis Protocol in your agent file. Present the Product Brief and its insights file for explicit approval when complete. Both artifacts will be passed to Phase 2.

package/.github/agents/jumpstart-architect.agent.md

@@ -44,6 +44,24 @@ You have access to VS Code Chat native tools:
 - **ask_questions**: Use for technology stack decisions with multiple valid options, deployment strategy selection, and architectural trade-off discussions.
 - **manage_todo_list**: Track progress through the 9-step solutioning protocol and ADR generation.
 
+**Tool Invocation:**
+```json
+{
+  "questions": [
+    {
+      "header": "key",  // max 12 chars, unique
+      "question": "Question text?",
+      "options": [  // 0 for free text, 2+ for choices (never 1)
+        { "label": "Choice 1", "recommended": true },
+        { "label": "Choice 2" }
+      ]
+    }
+  ]
+}
+```
+
+Response: `{ "answers": { "key": { "selected": ["Choice 1"], "freeText": null, "skipped": false } } }`
+
 ## Protocol
 
 Follow the full 9-step Solutioning Protocol in your agent file. Present the Architecture Document, Implementation Plan, and insights file for explicit approval when complete. All artifacts including ADRs and insights will be passed to Phase 4.

package/.github/agents/jumpstart-challenger.agent.md

@@ -36,6 +36,24 @@ You have access to two native VS Code Chat tools when working through the protoc
 
 These are optional but recommended for a better user experience.
 
+**Tool Invocation:**
+```json
+{
+  "questions": [
+    {
+      "header": "key",  // max 12 chars, unique
+      "question": "Question text?",
+      "options": [  // 0 for free text, 2+ for choices (never 1)
+        { "label": "Choice 1", "recommended": true },
+        { "label": "Choice 2" }
+      ]
+    }
+  ]
+}
+```
+
+Response: `{ "answers": { "key": { "selected": ["Choice 1"], "freeText": null, "skipped": false } } }`
+
 ## Starting the Conversation
 
 If the human provided an initial idea with their message, use it as the starting point for Step 1 of the Elicitation Protocol in your agent file. If not, ask them to describe their idea, problem, or opportunity.

package/.github/agents/jumpstart-developer.agent.md

@@ -41,6 +41,24 @@ You have access to VS Code Chat native tools:
 - **ask_questions**: Use for minor deviation decisions, library selection, test strategy choices, and unanticipated edge case handling.
 - **manage_todo_list**: Track implementation progress task-by-task and milestone-by-milestone. Essential for Phase 4 transparency.
 
+**Tool Invocation:**
+```json
+{
+  "questions": [
+    {
+      "header": "key",  // max 12 chars, unique
+      "question": "Question text?",
+      "options": [  // 0 for free text, 2+ for choices (never 1)
+        { "label": "Choice 1", "recommended": true },
+        { "label": "Choice 2" }
+      ]
+    }
+  ]
+}
+```
+
+Response: `{ "answers": { "key": { "selected": ["Choice 1"], "freeText": null, "skipped": false } } }`
+
 ## Deviation Rules
 
 - **Minor deviations** (utility functions, import paths, implied error handling): handle autonomously, document as a note on the task.

package/.github/agents/jumpstart-pm.agent.md

@@ -41,6 +41,24 @@ You have access to VS Code Chat native tools:
 - **ask_questions**: Use for epic validation, story granularity decisions, prioritization discussions, and acceptance criteria clarification.
 - **manage_todo_list**: Track progress through the 9-step planning protocol. Particularly useful when decomposing many stories.
 
+**Tool Invocation:**
+```json
+{
+  "questions": [
+    {
+      "header": "key",  // max 12 chars, unique
+      "question": "Question text?",
+      "options": [  // 0 for free text, 2+ for choices (never 1)
+        { "label": "Choice 1", "recommended": true },
+        { "label": "Choice 2" }
+      ]
+    }
+  ]
+}
+```
+
+Response: `{ "answers": { "key": { "selected": ["Choice 1"], "freeText": null, "skipped": false } } }`
+
 ## Protocol
 
 Follow the full 9-step Planning Protocol in your agent file. Present the PRD and its insights file for explicit approval when complete. Both artifacts plus all prior insights will be passed to Phase 3.

package/.jumpstart/agents/analyst.md

@@ -61,6 +61,51 @@ Use this tool to gather structured feedback and make collaborative choices durin
 - Step 6 (Scope Recommendation): When discussing Must Have vs. Should Have items that could go either way
 - Any time you need user input to resolve ambiguity or validate findings
 
+**How to invoke ask_questions:**
+
+The tool accepts a `questions` array. Each question requires:
+- `header` (string, required): Unique identifier, max 12 chars, used as key in response
+- `question` (string, required): The question text to display
+- `multiSelect` (boolean, optional): Allow multiple selections (default: false)
+- `options` (array, optional): 0 options = free text input, 2+ options = choice menu
+  - Each option has: `label` (required), `description` (optional), `recommended` (optional)
+- `allowFreeformInput` (boolean, optional): Allow custom text alongside options (default: false)
+
+**Validation rules:**
+- ❌ Single-option questions are INVALID (must be 0 for free text or 2+ for choices)
+- ✓ Maximum 4 questions per invocation
+- ✓ Maximum 6 options per question
+- ✓ Headers must be unique within the questions array
+
+**Tool invocation format:**
+```json
+{
+  "questions": [
+    {
+      "header": "choice",
+      "question": "Which approach do you prefer?",
+      "options": [
+        { "label": "Option A", "description": "Brief explanation", "recommended": true },
+        { "label": "Option B", "description": "Alternative approach" }
+      ]
+    }
+  ]
+}
+```
+
+**Response format:**
+```json
+{
+  "answers": {
+    "choice": {
+      "selected": ["Option A"],
+      "freeText": null,
+      "skipped": false
+    }
+  }
+}
+```
+
 **Example usage:**
 ```
 When presenting 3-4 personas, use ask_questions to let the human select which ones feel accurate and flag any that need revision.

package/.jumpstart/agents/architect.md

@@ -66,6 +66,51 @@ Use this tool when architectural decisions require human input or when multiple
 - Step 6 (ADRs): When a decision has meaningful trade-offs and you want to confirm the human agrees with your assessment
 - Deployment strategy: Cloud provider selection, hosting approach, CI/CD tooling
 
+**How to invoke ask_questions:**
+
+The tool accepts a `questions` array. Each question requires:
+- `header` (string, required): Unique identifier, max 12 chars, used as key in response
+- `question` (string, required): The question text to display
+- `multiSelect` (boolean, optional): Allow multiple selections (default: false)
+- `options` (array, optional): 0 options = free text input, 2+ options = choice menu
+  - Each option has: `label` (required), `description` (optional), `recommended` (optional)
+- `allowFreeformInput` (boolean, optional): Allow custom text alongside options (default: false)
+
+**Validation rules:**
+- ❌ Single-option questions are INVALID (must be 0 for free text or 2+ for choices)
+- ✓ Maximum 4 questions per invocation
+- ✓ Maximum 6 options per question
+- ✓ Headers must be unique within the questions array
+
+**Tool invocation format:**
+```json
+{
+  "questions": [
+    {
+      "header": "choice",
+      "question": "Which approach do you prefer?",
+      "options": [
+        { "label": "Option A", "description": "Brief explanation", "recommended": true },
+        { "label": "Option B", "description": "Alternative approach" }
+      ]
+    }
+  ]
+}
+```
+
+**Response format:**
+```json
+{
+  "answers": {
+    "choice": {
+      "selected": ["Option A"],
+      "freeText": null,
+      "skipped": false
+    }
+  }
+}
+```
+
 **Example usage:**
 ```
 When choosing between serverless and container-based deployment, present both options with pros/cons

package/.jumpstart/agents/challenger.md

@@ -53,6 +53,51 @@ Use this tool to gather clarifications and user choices during the elicitation p
 - Testing the human's knowledge (no recommended options for quiz-like questions)
 - Forcing choices when open discussion would be better
 
+**How to invoke ask_questions:**
+
+The tool accepts a `questions` array. Each question requires:
+- `header` (string, required): Unique identifier, max 12 chars, used as key in response
+- `question` (string, required): The question text to display
+- `multiSelect` (boolean, optional): Allow multiple selections (default: false)
+- `options` (array, optional): 0 options = free text input, 2+ options = choice menu
+  - Each option has: `label` (required), `description` (optional), `recommended` (optional)
+- `allowFreeformInput` (boolean, optional): Allow custom text alongside options (default: false)
+
+**Validation rules:**
+- ❌ Single-option questions are INVALID (must be 0 for free text or 2+ for choices)
+- ✓ Maximum 4 questions per invocation
+- ✓ Maximum 6 options per question
+- ✓ Headers must be unique within the questions array
+
+**Tool invocation format:**
+```json
+{
+  "questions": [
+    {
+      "header": "choice",
+      "question": "Which approach do you prefer?",
+      "options": [
+        { "label": "Option A", "description": "Brief explanation", "recommended": true },
+        { "label": "Option B", "description": "Alternative approach" }
+      ]
+    }
+  ]
+}
+```
+
+**Response format:**
+```json
+{
+  "answers": {
+    "choice": {
+      "selected": ["Option A"],
+      "freeText": null,
+      "skipped": false
+    }
+  }
+}
+```
+
 **Example usage pattern:**
 ```
 When presenting 2-3 reframed problem statements, use ask_questions to let the human select their preferred reframe or indicate they want to write their own.

package/.jumpstart/agents/developer.md

@@ -66,6 +66,51 @@ Use this tool when you encounter situations requiring human guidance during impl
 - **Test strategy:** When acceptance criteria could be verified with different test approaches
 - **Error handling:** When an error scenario wasn't anticipated in acceptance criteria and you need guidance on desired behavior
 
+**How to invoke ask_questions:**
+
+The tool accepts a `questions` array. Each question requires:
+- `header` (string, required): Unique identifier, max 12 chars, used as key in response
+- `question` (string, required): The question text to display
+- `multiSelect` (boolean, optional): Allow multiple selections (default: false)
+- `options` (array, optional): 0 options = free text input, 2+ options = choice menu
+  - Each option has: `label` (required), `description` (optional), `recommended` (optional)
+- `allowFreeformInput` (boolean, optional): Allow custom text alongside options (default: false)
+
+**Validation rules:**
+- ❌ Single-option questions are INVALID (must be 0 for free text or 2+ for choices)
+- ✓ Maximum 4 questions per invocation
+- ✓ Maximum 6 options per question
+- ✓ Headers must be unique within the questions array
+
+**Tool invocation format:**
+```json
+{
+  "questions": [
+    {
+      "header": "choice",
+      "question": "Which approach do you prefer?",
+      "options": [
+        { "label": "Option A", "description": "Brief explanation", "recommended": true },
+        { "label": "Option B", "description": "Alternative approach" }
+      ]
+    }
+  ]
+}
+```
+
+**Response format:**
+```json
+{
+  "answers": {
+    "choice": {
+      "selected": ["Option A"],
+      "freeText": null,
+      "skipped": false
+    }
+  }
+}
+```
+
 **Example usage:**
 ```
 When you encounter an edge case not covered in acceptance criteria ("What should happen when a user 

package/.jumpstart/agents/pm.md

@@ -64,6 +64,51 @@ Use this tool for collaborative prioritization and clarification of requirements
 - Prioritization decisions: When using RICE or ICE scoring, gather human input on scores
 - Any time you need to resolve a judgment call between two valid options
 
+**How to invoke ask_questions:**
+
+The tool accepts a `questions` array. Each question requires:
+- `header` (string, required): Unique identifier, max 12 chars, used as key in response
+- `question` (string, required): The question text to display
+- `multiSelect` (boolean, optional): Allow multiple selections (default: false)
+- `options` (array, optional): 0 options = free text input, 2+ options = choice menu
+  - Each option has: `label` (required), `description` (optional), `recommended` (optional)
+- `allowFreeformInput` (boolean, optional): Allow custom text alongside options (default: false)
+
+**Validation rules:**
+- ❌ Single-option questions are INVALID (must be 0 for free text or 2+ for choices)
+- ✓ Maximum 4 questions per invocation
+- ✓ Maximum 6 options per question
+- ✓ Headers must be unique within the questions array
+
+**Tool invocation format:**
+```json
+{
+  "questions": [
+    {
+      "header": "choice",
+      "question": "Which approach do you prefer?",
+      "options": [
+        { "label": "Option A", "description": "Brief explanation", "recommended": true },
+        { "label": "Option B", "description": "Alternative approach" }
+      ]
+    }
+  ]
+}
+```
+
+**Response format:**
+```json
+{
+  "answers": {
+    "choice": {
+      "selected": ["Option A"],
+      "freeText": null,
+      "skipped": false
+    }
+  }
+}
+```
+
 **Example usage:**
 ```
 When a story feels large but not clearly splittable, present the options: 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jumpstart-mode",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Spec-driven agentic coding framework that transforms ideas into production code through AI-powered sequential phases",
   "keywords": [
     "jumpstart",