jumpstart-mode 1.0.4 → 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,10 +1,10 @@
1
1
  ---
2
2
  name: "Jump Start: Analyst"
3
3
  description: "Phase 1 -- Create personas, map journeys, define value proposition and MVP scope"
4
- tools: ['search', 'fetch', 'read', 'editFiles', 'createFile', 'askQuestions', 'manageTodoList']
4
+ tools: ['search', 'web', 'read', 'edit', 'vscode/askQuestions', 'todo']
5
5
  handoffs:
6
6
  - label: "Proceed to Phase 2: Planning"
7
- agent: jumpstart-pm
7
+ agent: Jump Start: PM
8
8
  prompt: "The Product Brief at specs/product-brief.md has been approved. Begin Phase 2 planning."
9
9
  send: false
10
10
  ---
@@ -1,10 +1,10 @@
1
1
  ---
2
2
  name: "Jump Start: Architect"
3
3
  description: "Phase 3 -- Select tech stack, design components, model data, specify APIs, create implementation plan"
4
- tools: ['search', 'fetch', 'read', 'editFiles', 'createFile', 'askQuestions', 'manageTodoList', 'githubRepo']
4
+ tools: ['search', 'web', 'read', 'edit', 'vscode/askQuestions', 'todo']
5
5
  handoffs:
6
6
  - label: "Proceed to Phase 4: Build"
7
- agent: jumpstart-developer
7
+ agent: Jump Start: Developer
8
8
  prompt: "The Architecture Document and Implementation Plan have been approved. Begin Phase 4 implementation."
9
9
  send: false
10
10
  ---
@@ -1,10 +1,10 @@
1
1
  ---
2
2
  name: "Jump Start: Challenger"
3
3
  description: "Phase 0 -- Interrogate assumptions, find root causes, reframe the problem before any building begins"
4
- tools: ['search', 'fetch', 'read', 'editFiles', 'createFile', 'askQuestions', 'manageTodoList']
4
+ tools: ['search', 'web', 'read', 'edit', 'vscode/askQuestions', 'todo']
5
5
  handoffs:
6
6
  - label: "Proceed to Phase 1: Analysis"
7
- agent: jumpstart-analyst
7
+ agent: Jump Start: Analyst
8
8
  prompt: "The Challenger Brief at specs/challenger-brief.md has been approved. Begin Phase 1 analysis."
9
9
  send: false
10
10
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: "Jump Start: Developer"
3
3
  description: "Phase 4 -- Execute the implementation plan task by task, writing tested code"
4
- tools: ['editFiles', 'runInTerminal', 'search', 'fetch', 'read', 'createFile', 'askQuestions', 'manageTodoList', 'getErrors', 'runTests', 'getChangedFiles', 'usages']
4
+ tools: ['edit', 'execute', 'search', 'web', 'read', 'vscode/askQuestions', 'todo', 'agent']
5
5
  ---
6
6
 
7
7
  # The Developer -- Phase 4: Implementing
@@ -1,10 +1,10 @@
1
1
  ---
2
2
  name: "Jump Start: PM"
3
3
  description: "Phase 2 -- Write epics, user stories with acceptance criteria, NFRs, and milestones"
4
- tools: ['search', 'fetch', 'read', 'editFiles', 'createFile', 'askQuestions', 'manageTodoList']
4
+ tools: ['search', 'web', 'read', 'edit', 'vscode/askQuestions', 'todo']
5
5
  handoffs:
6
6
  - label: "Proceed to Phase 3: Architecture"
7
- agent: jumpstart-architect
7
+ agent: Jump Start: Architect
8
8
  prompt: "The PRD at specs/prd.md has been approved. Begin Phase 3 solutioning."
9
9
  send: false
10
10
  ---
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  description: "Validate current Jump Start artifacts against their templates and gate criteria"
3
- mode: agent
3
+ agent: agent
4
4
  ---
5
5
 
6
6
  # Jump Start Artifact Review
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  description: "Show the current state of the Jump Start workflow"
3
- mode: agent
3
+ agent: agent
4
4
  ---
5
5
 
6
6
  # Jump Start Status Check
@@ -136,7 +136,8 @@ Track progress through the 9-step Planning Protocol.
136
136
  - [ ] Step 6: Dependencies and Risk Register
137
137
  - [ ] Step 7: Success Metrics
138
138
  - [ ] Step 8: Implementation Milestones
139
- - [ ] Step 9: Compile and Present the PRD
139
+ - [ ] Step 9: Task Breakdown
140
+ - [ ] Step 10: Compile and Present the PRD
140
141
  ```
141
142
 
142
143
  ---
@@ -317,7 +318,52 @@ For each milestone, list:
317
318
  - **Stories Included**: List of story IDs
318
319
  - **Depends On**: Previous milestones, if any
319
320
 
320
- ### Step 9: Compile and Present the PRD
321
+ ### Step 9: Task Breakdown
322
+
323
+ Decompose each user story into actionable development tasks for the Developer agent (Phase 4). This bridges requirements and implementation.
324
+
325
+ **Task Format:** `[Task ID] [P?] [Story] Description`
326
+ - **[P]**: Can run in parallel (different files, no dependencies)
327
+ - **[Story]**: Which user story this task belongs to (e.g., E1-S1, E2-S3)
328
+
329
+ **Phases to define:**
330
+
331
+ 1. **Setup (Phase 1):** Project initialization and basic structure
332
+ - Create project structure
333
+ - Initialize dependencies
334
+ - Configure linting/formatting
335
+ - Setup environment configuration
336
+
337
+ 2. **Foundational (Phase 2):** Core infrastructure that MUST be complete before ANY user story
338
+ - Database schema and migrations
339
+ - Authentication/authorization framework
340
+ - API routing and middleware
341
+ - Base models/entities
342
+ - Error handling and logging
343
+ - **Checkpoint marker** for foundation readiness
344
+
345
+ 3. **User Story Phases (Phase 3+):** One phase per story, organized by priority
346
+ - Goal and independent test description
347
+ - Test tasks (if tests requested) with [P] parallel markers
348
+ - Implementation tasks: models → services → endpoints → validation → logging
349
+ - **Checkpoint marker** for story completion
350
+
351
+ 4. **Polish (Phase N):** Cross-cutting concerns
352
+ - Documentation
353
+ - Refactoring
354
+ - Performance optimization
355
+ - Security hardening
356
+
357
+ **Guidelines for task breakdown:**
358
+ - Each task should be completable in a single development session
359
+ - Mark tasks that can run in parallel with [P]
360
+ - Include exact file paths in task descriptions
361
+ - Define clear dependencies between tasks
362
+ - Each user story phase should be independently implementable and testable
363
+
364
+ **Capture insights as you work:** Document decisions about task granularity—when to split vs. combine tasks. Note dependencies discovered during decomposition that weren't obvious from stories alone.
365
+
366
+ ### Step 10: Compile and Present the PRD
321
367
 
322
368
  Assemble all sections into the PRD template (see `.jumpstart/templates/prd.md`). Present the complete document to the human for review.
323
369
 
@@ -366,5 +412,6 @@ Phase 2 is complete when:
366
412
  - [ ] Acceptance criteria are specific and testable (no vague qualifiers)
367
413
  - [ ] Non-functional requirements have measurable thresholds
368
414
  - [ ] At least one implementation milestone is defined
415
+ - [ ] Task breakdown includes Setup, Foundational, and at least one user story phase
369
416
  - [ ] Dependencies and risks have identified mitigations
370
417
  - [ ] Success metrics map to Phase 0 validation criteria
@@ -28,9 +28,9 @@ agents:
28
28
  persona_file: "agents/challenger.md"
29
29
  capture_insights: true # Capture decision rationale and alternatives considered
30
30
  elicitation_depth: standard # quick | standard | deep
31
- # quick: 3 assumption checks, 3 Whys, minimal stakeholder mapping
32
- # standard: 5-7 assumption checks, 5 Whys, full stakeholder map
33
- # deep: 10+ assumption checks, 5 Whys with branching, stakeholder
31
+ # quick: 3 assumption checks, linear root cause analysis (approx 3 layers), minimal stakeholder mapping
32
+ # standard: 5-7 assumption checks, recursive root cause analysis (drill until root found, usually ~5 layers), full stakeholder map
33
+ # deep: 10+ assumption checks, multi-branch root cause analysis (Ishikawa/Fishbone style), stakeholder
34
34
  # interviews simulation, competitive problem framing
35
35
  max_assumptions: 10 # Cap on surfaced assumptions
36
36
  require_reframe: true # Force at least one problem reframe
@@ -88,7 +88,7 @@ agents:
88
88
  # Integration Settings
89
89
  # ---------------------------------------------------------------------------
90
90
  integrations:
91
- ai_assistant: "copilot" # copilot | claude-code | cursor | gemini | windsurf
91
+ ai_assistant: "copilot" # copilot | claude-code | cursor | gemini | windsurf | codex
92
92
  git_branch_per_phase: false # Create a branch for each phase
93
93
  branch_naming: "jumpstart/phase-{n}-{name}" # Branch name template
94
94
 
@@ -36,18 +36,25 @@
36
36
 
37
37
  **Starting point:** [The core problem extracted from the original statement]
38
38
 
39
- | Level | Question | Answer |
40
- |-------|----------|--------|
41
- | Why 1 | Why does this problem exist? | [Human's answer] |
42
- | Why 2 | Why does [answer to Why 1] happen? | [Human's answer] |
43
- | Why 3 | Why does [answer to Why 2] happen? | [Human's answer] |
44
- | Why 4 | Why does [answer to Why 3] happen? | [Human's answer] |
45
- | Why 5 | Why does [answer to Why 4] happen? | [Human's answer] |
46
-
47
- **Root cause identified:** [Summary of the deepest cause reached]
48
-
49
- **Alternative threads noted (if any):**
50
- - [Branch point and alternative direction not pursued]
39
+ > **Method:** Ask "Why?" until the root cause is revealed. This may take fewer or more than 5 iterations. Ensure the logic holds by checking backwards: "Root Cause > therefore > ... > Problem."
40
+
41
+ **Analysis Chain:**
42
+
43
+ 1. **Why?** [Answer 1]
44
+ 2. **Why?** [Answer 2]
45
+ 3. **Why?** [Answer 3]
46
+ 4. **Why?** [Answer 4]
47
+ 5. **Why?** [Answer 5 - add or remove steps as needed to reach root cause]
48
+
49
+ **Logic Check (Working Backwards):**
50
+ > [Root Cause] **therefore** [Answer N-1] ... **therefore** [Original Problem].
51
+ > *Does this chain of causality make logical sense without logical leaps?*
52
+
53
+ **Root Cause Identified:**
54
+ > [Summary of the deepest cause reached]
55
+
56
+ **Alternative branches (if any):**
57
+ - [Branch point] -> [Alternative root cause]
51
58
 
52
59
  ---
53
60
 
@@ -180,6 +180,162 @@ _Alternative checklist format (if configured):_
180
180
 
181
181
  ---
182
182
 
183
+ ## Task Breakdown
184
+
185
+ > **Purpose:** Decompose user stories into actionable development tasks for the Developer agent (Phase 4). This section bridges requirements and implementation.
186
+
187
+ **Format:** `[Task ID] [P?] [Story] Description`
188
+ - **[P]**: Can run in parallel (different files, no dependencies)
189
+ - **[Story]**: Which user story this task belongs to (e.g., E1-S1, E2-S3)
190
+
191
+ **Path Conventions:** Adjust paths based on project structure:
192
+ - Single project: `src/`, `tests/`
193
+ - Web app: `backend/src/`, `frontend/src/`
194
+ - Mobile: `api/src/`, `mobile/src/`
195
+
196
+ ---
197
+
198
+ ### Phase 1: Setup (Shared Infrastructure)
199
+
200
+ **Purpose:** Project initialization and basic structure
201
+
202
+ - [ ] T001 Create project structure per implementation plan
203
+ - [ ] T002 Initialize [language] project with [framework] dependencies
204
+ - [ ] T003 [P] Configure linting and formatting tools
205
+ - [ ] T004 [P] Setup environment configuration management
206
+
207
+ ---
208
+
209
+ ### Phase 2: Foundational (Blocking Prerequisites)
210
+
211
+ **Purpose:** Core infrastructure that MUST be complete before ANY user story implementation
212
+
213
+ **⚠️ CRITICAL:** No user story work can begin until this phase is complete
214
+
215
+ - [ ] T005 Setup database schema and migrations framework
216
+ - [ ] T006 [P] Implement authentication/authorization framework
217
+ - [ ] T007 [P] Setup API routing and middleware structure
218
+ - [ ] T008 Create base models/entities that all stories depend on
219
+ - [ ] T009 Configure error handling and logging infrastructure
220
+
221
+ **Checkpoint:** ☐ Foundation ready - user story implementation can now begin
222
+
223
+ ---
224
+
225
+ ### Phase 3: Story E1-S1 - [Story Title] (Priority: Must Have)
226
+
227
+ **Goal:** [Brief description of what this story delivers]
228
+ **Independent Test:** [How to verify this story works on its own]
229
+
230
+ #### Tests for E1-S1 (Include if tests requested)
231
+
232
+ > **NOTE:** Write tests FIRST, ensure they FAIL before implementation
233
+
234
+ - [ ] T010 [P] [E1-S1] Contract test for [endpoint] in `tests/contract/test_[name].[ext]`
235
+ - [ ] T011 [P] [E1-S1] Integration test for [user journey] in `tests/integration/test_[name].[ext]`
236
+
237
+ #### Implementation for E1-S1
238
+
239
+ - [ ] T012 [P] [E1-S1] Create [Entity] model in `src/models/[entity].[ext]`
240
+ - [ ] T013 [E1-S1] Implement [Service] in `src/services/[service].[ext]` (depends on T012)
241
+ - [ ] T014 [E1-S1] Implement [endpoint/feature] in `src/[location]/[file].[ext]`
242
+ - [ ] T015 [E1-S1] Add validation and error handling
243
+ - [ ] T016 [E1-S1] Add logging for story operations
244
+
245
+ **Checkpoint:** ☐ Story E1-S1 fully functional and independently testable
246
+
247
+ ---
248
+
249
+ ### Phase 4: Story E1-S2 - [Story Title] (Priority: Must Have)
250
+
251
+ **Goal:** [Brief description]
252
+ **Independent Test:** [How to verify this story works on its own]
253
+
254
+ #### Tests for E1-S2 (Include if tests requested)
255
+
256
+ - [ ] T017 [P] [E1-S2] Contract test for [endpoint] in `tests/contract/test_[name].[ext]`
257
+ - [ ] T018 [P] [E1-S2] Integration test in `tests/integration/test_[name].[ext]`
258
+
259
+ #### Implementation for E1-S2
260
+
261
+ - [ ] T019 [P] [E1-S2] Create [Entity] model in `src/models/[entity].[ext]`
262
+ - [ ] T020 [E1-S2] Implement [Service] in `src/services/[service].[ext]`
263
+ - [ ] T021 [E1-S2] Implement [endpoint/feature] in `src/[location]/[file].[ext]`
264
+ - [ ] T022 [E1-S2] Integrate with E1-S1 components (if needed)
265
+
266
+ **Checkpoint:** ☐ Stories E1-S1 AND E1-S2 both work independently
267
+
268
+ ---
269
+
270
+ <!-- TEMPLATE NOTE: Repeat Phase blocks for each user story -->
271
+ <!-- Organize by priority: Must Have → Should Have → Could Have -->
272
+ <!-- Each story should be independently implementable and testable -->
273
+
274
+ ---
275
+
276
+ ### Phase N: Polish & Cross-Cutting Concerns
277
+
278
+ **Purpose:** Improvements that affect multiple user stories
279
+
280
+ - [ ] TXXX [P] Documentation updates in `docs/`
281
+ - [ ] TXXX Code cleanup and refactoring
282
+ - [ ] TXXX Performance optimization across all stories
283
+ - [ ] TXXX [P] Additional unit tests (if requested) in `tests/unit/`
284
+ - [ ] TXXX Security hardening
285
+
286
+ ---
287
+
288
+ ### Dependencies & Execution Order
289
+
290
+ #### Phase Dependencies
291
+
292
+ ```
293
+ Setup (Phase 1)
294
+
295
+ Foundational (Phase 2) ← BLOCKS all user stories
296
+
297
+ User Stories (Phase 3+) → Can proceed in parallel or sequentially by priority
298
+
299
+ Polish (Phase N)
300
+ ```
301
+
302
+ #### Within Each User Story
303
+
304
+ 1. Tests (if included) MUST be written and FAIL before implementation
305
+ 2. Models before services
306
+ 3. Services before endpoints
307
+ 4. Core implementation before integration
308
+ 5. Story complete before moving to next priority
309
+
310
+ #### Parallel Opportunities
311
+
312
+ - All Setup tasks marked [P] can run in parallel
313
+ - All Foundational tasks marked [P] can run in parallel
314
+ - Once Foundational completes, all user stories can start in parallel
315
+ - Models within a story marked [P] can run in parallel
316
+ - Tests within a story marked [P] can run in parallel
317
+
318
+ ---
319
+
320
+ ### Implementation Strategy
321
+
322
+ #### MVP First (Highest Priority Stories Only)
323
+
324
+ 1. Complete Phase 1: Setup
325
+ 2. Complete Phase 2: Foundational (CRITICAL - blocks all stories)
326
+ 3. Complete highest priority user story (e.g., E1-S1)
327
+ 4. **STOP and VALIDATE:** Test story independently
328
+ 5. Deploy/demo if ready
329
+
330
+ #### Incremental Delivery
331
+
332
+ 1. Setup + Foundational → Foundation ready
333
+ 2. Add Story 1 → Test independently → Deploy/Demo (MVP!)
334
+ 3. Add Story 2 → Test independently → Deploy/Demo
335
+ 4. Each story adds value without breaking previous stories
336
+
337
+ ---
338
+
183
339
  ## Glossary
184
340
 
185
341
  | Term | Definition |
@@ -209,6 +365,7 @@ See the insights document for complete decision rationale, alternatives consider
209
365
  - [ ] Acceptance criteria are specific and testable (no vague qualifiers)
210
366
  - [ ] Non-functional requirements have measurable thresholds
211
367
  - [ ] At least one implementation milestone is defined
368
+ - [ ] Task breakdown includes Setup, Foundational, and at least one user story phase
212
369
  - [ ] Dependencies have identified mitigations
213
370
  - [ ] Risks have identified mitigations
214
371
  - [ ] Success metrics map to Phase 0 validation criteria
package/AGENTS.md CHANGED
@@ -1,28 +1,96 @@
1
1
  # Jump Start Framework -- Agent Instructions
2
2
 
3
- This repository uses the Jump Start spec-driven agentic coding framework. When performing tasks in this repository, follow these rules.
3
+ > **System Notice:** This repository is managed by the Jump Start spec-driven framework. All AI agents operating in this context must adhere strictly to the protocols defined below.
4
4
 
5
- ## Workflow
5
+ ## Workflow Overview
6
6
 
7
- Five sequential phases, each with a dedicated agent persona in `.jumpstart/agents/`:
7
+ The development lifecycle follows five strict, sequential phases. No phase may begin until the previous phase's artifact is **explicitly approved** by the human operator.
8
8
 
9
- | Phase | Agent | Command | Output |
10
- |-------|-------|---------|--------|
11
- | 0 | Challenger | Select "Jump Start: Challenger" agent | `specs/challenger-brief.md` |
12
- | 1 | Analyst | Select "Jump Start: Analyst" agent | `specs/product-brief.md` |
13
- | 2 | PM | Select "Jump Start: PM" agent | `specs/prd.md` |
14
- | 3 | Architect | Select "Jump Start: Architect" agent | `specs/architecture.md`, `specs/implementation-plan.md`, `specs/decisions/*.md` |
15
- | 4 | Developer | Select "Jump Start: Developer" agent | `src/`, `tests/`, `README.md` |
9
+ ```mermaid
10
+ flowchart TB
11
+ P0[Phase 0: Challenge] -->|Brief| P1[Phase 1: Analyze]
12
+ P1 -->|Product Brief| P2[Phase 2: Plan]
13
+ P2 -->|PRD| P3[Phase 3: Architect]
14
+ P3 -->|Specs| P4[Phase 4: Build]
15
+
16
+ C(Challenger) -.-> P0
17
+ A(Analyst) -.-> P1
18
+ PM(Product Manager) -.-> P2
19
+ Arch(Architect) -.-> P3
20
+ Dev(Developer) -.-> P4
16
21
 
17
- ## Rules
22
+ style P0 fill:#1976d2,stroke:#333,stroke-width:2px,color:#fff
23
+ style P4 fill:#43a047,stroke:#333,stroke-width:2px,color:#fff
24
+ ```
18
25
 
19
- 1. **Sequential enforcement.** Do not start a phase unless all preceding artifacts exist and are approved.
20
- 2. **Agent fidelity.** When operating as a specific agent, load and follow `.jumpstart/agents/<agent>.md` exactly.
21
- 3. **Human gates.** Never auto-approve phase transitions. Always present the artifact and ask for explicit approval.
22
- 4. **Templates.** Use `.jumpstart/templates/` for all artifact structures.
23
- 5. **Config.** Read `.jumpstart/config.yaml` at the start of every phase.
24
- 6. **Artifact locations.** Specs go in `specs/`. ADRs in `specs/decisions/`. Code in `src/`. Tests in `tests/`.
26
+ ## Agent Directory
25
27
 
26
- ## Checking Approval
28
+ | Phase | Agent Persona | Activation Command | Primary Responsibility | Output Artifact |
29
+ | --- | --- | --- | --- | --- |
30
+ | **0** | **The Challenger** | `/jumpstart.challenge` | Interrogates the problem, finds root causes, reframes assumptions. | `specs/challenger-brief.md` |
31
+ | **1** | **The Analyst** | `/jumpstart.analyze` | Defines personas, user journeys, and MVP scope. | `specs/product-brief.md` |
32
+ | **2** | **The PM** | `/jumpstart.plan` | Writes user stories, acceptance criteria, and NFRs. | `specs/prd.md` |
33
+ | **3** | **The Architect** | `/jumpstart.architect` | Selects tech stack, models data, designs APIs, plans tasks. | `specs/architecture.md`<br>
27
34
 
28
- An artifact is approved when its Phase Gate Approval section has all checkboxes checked and "Approved by" is not "Pending".
35
+ <br>`specs/implementation-plan.md` |
36
+ | **4** | **The Developer** | `/jumpstart.build` | Writes code and tests according to the plan. | `src/`, `tests/`, `README.md` |
37
+
38
+ ---
39
+
40
+ ## Operational Protocols
41
+
42
+ All agents must follow these directives without exception.
43
+
44
+ ### 1. The Context Protocol
45
+
46
+ * **Read Before Write:** Before generating any content, you must read `.jumpstart/config.yaml` and the specific agent instruction file in `.jumpstart/agents/`.
47
+ * **Upstream Traceability:** You must read the *approved* artifacts from previous phases.
48
+ * *Analyst* reads *Challenger Brief*.
49
+ * *Architect* reads *PRD*, *Product Brief*, and *Challenger Brief*.
50
+ * Do not hallucinate requirements that contradict upstream documents.
51
+
52
+
53
+
54
+ ### 2. The Execution Protocol
55
+
56
+ * **Stay in Lane:**
57
+ * The **Challenger** never suggests solutions or technologies.
58
+ * The **Analyst** never writes code or defines database schemas.
59
+ * The **Developer** never changes the architecture without flagging a deviation.
60
+
61
+
62
+ * **Use Templates:** All outputs must be generated using the markdown templates located in `.jumpstart/templates/`. Do not invent new document formats.
63
+ * **Living Insights:** Simultaneously maintain your phase's `insights.md` file to log your reasoning, trade-offs, and discarded alternatives.
64
+
65
+ ### 3. The Gate Protocol
66
+
67
+ * **No Auto-Approval:** You cannot mark a phase as complete. You must present the final artifact to the human and ask: *"Does this meet your expectations?"*
68
+ * **Checkboxes Matter:** An artifact is only considered "Approved" when:
69
+ 1. The `Phase Gate Approval` section at the bottom of the file is filled.
70
+ 2. All checkboxes in that section are marked `[x]`.
71
+ 3. The "Approved by" field is not "Pending".
72
+
73
+
74
+
75
+ ### 4. The Artifact Protocol
76
+
77
+ * **Specs Location:** All documentation goes into `specs/`.
78
+ * **Decisions:** Significant technical choices must be recorded in `specs/decisions/` as ADRs.
79
+ * **Source Code:** Application code goes into `src/`.
80
+ * **Tests:** Test code goes into `tests/`.
81
+
82
+ ---
83
+
84
+ ## Tool Usage (VS Code Copilot)
85
+
86
+ If running within VS Code Copilot, agents have access to native UI tools:
87
+
88
+ * **`ask_questions`:** Use this to present multiple-choice decisions to the user (e.g., selecting a tech stack or prioritizing a feature).
89
+ * **`manage_todo_list`:** Use this to display a dynamic progress bar for your phase's protocol (e.g., "Step 3 of 8: User Journey Mapping").
90
+
91
+ ---
92
+
93
+ ## Troubleshooting
94
+
95
+ * **Missing Context:** If an upstream artifact is missing (e.g., running `/jumpstart.plan` before Phase 1 is done), **stop** and instruct the user to complete the missing phase first.
96
+ * **Ambiguity:** If a requirement is unclear, ask the user for clarification using the `ask_questions` tool rather than guessing.
package/README.md CHANGED
@@ -1,22 +1,48 @@
1
- # Jump Start
1
+ # Jump Start
2
2
 
3
- A spec-driven agentic coding framework that transforms a raw idea into production-ready code through five sequential phases. Each phase is owned by a specialized AI agent. Every artifact lives in your repository, version-controlled and accessible.
3
+ ![Version](https://img.shields.io/npm/v/jumpstart-mode?style=flat-square)
4
+ ![License](https://img.shields.io/npm/l/jumpstart-mode?style=flat-square)
5
+ ![Node](https://img.shields.io/node/v/jumpstart-mode?style=flat-square)
6
+
7
+ **A spec-driven agentic coding framework that transforms a raw idea into production-ready code through five sequential, AI-governed phases.**
8
+
9
+ Every artifact lives in your repository, version-controlled, diffable, and transparent.
4
10
 
5
11
  ---
6
12
 
7
- ## How It Works
13
+ ## Table of Contents
14
+ - [How It Works](#how-it-works)
15
+ - [Prerequisites](#prerequisites)
16
+ - [Quick Start](#quick-start)
17
+ - [Example Workflow](#example-workflow)
18
+ - [Commands](#commands)
19
+ - [Configuration](#configuration)
20
+ - [Project Structure](#project-structure)
21
+ - [Living Insights](#living-insights)
22
+ - [VS Code Chat Features](#vs-code-chat-features)
23
+ - [Troubleshooting](#troubleshooting)
8
24
 
9
- Jump Start runs five phases in a strict sequence. Each phase produces Markdown artifacts that become the input for the next phase. A human gate sits between every phase transition.
25
+ ---
10
26
 
11
- ```
12
- Phase 0 Phase 1 Phase 2 Phase 3 Phase 4
13
- Challenge --> Analyze --> Plan --> Architect --> Build
14
- (Challenger) (Analyst) (PM) (Architect) (Developer)
15
- | | | | |
16
- v v v v v
17
- challenger- product- prd.md architecture.md src/
18
- brief.md brief.md impl-plan.md tests/
19
- decisions/*.md README.md
27
+ ## How It Works
28
+
29
+ Jump Start runs five phases in a strict sequence. Each phase is owned by a specialized AI agent and produces Markdown artifacts that serve as the input for the next phase. A human gate sits between every transition to ensure quality.
30
+
31
+ ```mermaid
32
+ flowchart TB
33
+ P0[Phase 0: Challenge] -->|Brief| P1[Phase 1: Analyze]
34
+ P1 -->|Product Brief| P2[Phase 2: Plan]
35
+ P2 -->|PRD| P3[Phase 3: Architect]
36
+ P3 -->|Specs| P4[Phase 4: Build]
37
+
38
+ C(Challenger) -.-> P0
39
+ A(Analyst) -.-> P1
40
+ PM(Product Manager) -.-> P2
41
+ Arch(Architect) -.-> P3
42
+ Dev(Developer) -.-> P4
43
+
44
+ style P0 fill:#1976d2,stroke:#333,stroke-width:2px,color:#fff
45
+ style P4 fill:#43a047,stroke:#333,stroke-width:2px,color:#fff
20
46
  ```
21
47
 
22
48
  **Phase 0 -- Problem Discovery.** The Challenger agent interrogates your idea, surfaces hidden assumptions, drills to root causes, and produces a validated problem statement.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "jumpstart-mode",
3
- "version": "1.0.4",
3
+ "version": "1.0.6",
4
4
  "description": "Spec-driven agentic coding framework that transforms ideas into production code through AI-powered sequential phases",
5
5
  "keywords": [
6
6
  "jumpstart",