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.
- package/.github/agents/jumpstart-analyst.agent.md +2 -2
- package/.github/agents/jumpstart-architect.agent.md +2 -2
- package/.github/agents/jumpstart-challenger.agent.md +2 -2
- package/.github/agents/jumpstart-developer.agent.md +1 -1
- package/.github/agents/jumpstart-pm.agent.md +2 -2
- package/.github/prompts/jumpstart-review.prompt.md +1 -1
- package/.github/prompts/jumpstart-status.prompt.md +1 -1
- package/.jumpstart/agents/pm.md +49 -2
- package/.jumpstart/config.yaml +4 -4
- package/.jumpstart/templates/challenger-brief.md +19 -12
- package/.jumpstart/templates/prd.md +157 -0
- package/AGENTS.md +87 -19
- package/README.md +39 -13
- package/package.json +1 -1
|
@@ -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', '
|
|
4
|
+
tools: ['search', 'web', 'read', 'edit', 'vscode/askQuestions', 'todo']
|
|
5
5
|
handoffs:
|
|
6
6
|
- label: "Proceed to Phase 2: Planning"
|
|
7
|
-
agent:
|
|
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', '
|
|
4
|
+
tools: ['search', 'web', 'read', 'edit', 'vscode/askQuestions', 'todo']
|
|
5
5
|
handoffs:
|
|
6
6
|
- label: "Proceed to Phase 4: Build"
|
|
7
|
-
agent:
|
|
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', '
|
|
4
|
+
tools: ['search', 'web', 'read', 'edit', 'vscode/askQuestions', 'todo']
|
|
5
5
|
handoffs:
|
|
6
6
|
- label: "Proceed to Phase 1: Analysis"
|
|
7
|
-
agent:
|
|
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: ['
|
|
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', '
|
|
4
|
+
tools: ['search', 'web', 'read', 'edit', 'vscode/askQuestions', 'todo']
|
|
5
5
|
handoffs:
|
|
6
6
|
- label: "Proceed to Phase 3: Architecture"
|
|
7
|
-
agent:
|
|
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
|
---
|
package/.jumpstart/agents/pm.md
CHANGED
|
@@ -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:
|
|
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:
|
|
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
|
package/.jumpstart/config.yaml
CHANGED
|
@@ -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
|
|
32
|
-
# standard: 5-7 assumption checks, 5
|
|
33
|
-
# deep: 10+ assumption checks,
|
|
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
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
**
|
|
48
|
-
|
|
49
|
-
**
|
|
50
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
3
|
+

|
|
4
|
+

|
|
5
|
+

|
|
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
|
-
##
|
|
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
|
-
|
|
25
|
+
---
|
|
10
26
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
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