@intentsolutions/blueprint 2.0.0 โ†’ 2.1.0

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.
Files changed (37) hide show
  1. package/dist/cli.js +1 -1
  2. package/dist/cli.js.map +1 -1
  3. package/dist/core/index.d.ts +62 -0
  4. package/dist/core/index.d.ts.map +1 -0
  5. package/dist/core/index.js +137 -0
  6. package/dist/core/index.js.map +1 -0
  7. package/dist/index.d.ts +9 -0
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +11 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/mcp/index.d.ts +7 -0
  12. package/dist/mcp/index.d.ts.map +1 -0
  13. package/dist/mcp/index.js +216 -0
  14. package/dist/mcp/index.js.map +1 -0
  15. package/package.json +30 -10
  16. package/templates/core/01_prd.md +465 -0
  17. package/templates/core/02_adr.md +432 -0
  18. package/templates/core/03_generate_tasks.md +418 -0
  19. package/templates/core/04_process_task_list.md +430 -0
  20. package/templates/core/05_market_research.md +483 -0
  21. package/templates/core/06_architecture.md +561 -0
  22. package/templates/core/07_competitor_analysis.md +462 -0
  23. package/templates/core/08_personas.md +367 -0
  24. package/templates/core/09_user_journeys.md +385 -0
  25. package/templates/core/10_user_stories.md +582 -0
  26. package/templates/core/11_acceptance_criteria.md +687 -0
  27. package/templates/core/12_qa_gate.md +737 -0
  28. package/templates/core/13_risk_register.md +605 -0
  29. package/templates/core/14_project_brief.md +477 -0
  30. package/templates/core/15_brainstorming.md +653 -0
  31. package/templates/core/16_frontend_spec.md +1479 -0
  32. package/templates/core/17_test_plan.md +878 -0
  33. package/templates/core/18_release_plan.md +994 -0
  34. package/templates/core/19_operational_readiness.md +1100 -0
  35. package/templates/core/20_metrics_dashboard.md +1375 -0
  36. package/templates/core/21_postmortem.md +1122 -0
  37. package/templates/core/22_playtest_usability.md +1624 -0
@@ -0,0 +1,430 @@
1
+ # ๐Ÿ“Š Agile Task Execution & Process Management
2
+
3
+ **Metadata**
4
+ - Last Updated: {{DATE}}
5
+ - Maintainer: AI-Dev Toolkit
6
+ - Related Docs: Consumes 03_generate_tasks.md, gates 17_test_plan.md
7
+
8
+ > **๐ŸŽฏ Purpose**
9
+ > Comprehensive agile execution framework for managing task workflows, team performance, and delivery metrics. This template provides enterprise-grade process management with built-in quality gates and escalation procedures.
10
+
11
+ ---
12
+
13
+ ## ๐Ÿ”„ 1. Workflow Framework & Board Configuration
14
+
15
+ ### 1.1 Kanban Board Structure
16
+ **Primary Flow:**
17
+ ```
18
+ ๐Ÿ“‹ Backlog โ†’ ๐Ÿ” Ready โ†’ ๐Ÿ—๏ธ In Progress โ†’ ๐Ÿ‘€ Review โ†’ โœ… Done
19
+ ```
20
+
21
+ **Detailed Columns:**
22
+ | Column | Purpose | WIP Limit | Entry Criteria | Exit Criteria |
23
+ |--------|---------|-----------|----------------|---------------|
24
+ | **๐Ÿ“‹ Backlog** | All identified work | โˆž | Task created | Acceptance criteria defined |
25
+ | **๐Ÿ” Ready** | Sprint-ready tasks | 20 | DoR satisfied | Developer assigned |
26
+ | **๐Ÿ—๏ธ In Progress** | Active development | 8 | Work started | Code complete |
27
+ | **๐Ÿ‘€ Code Review** | Peer review | 5 | PR submitted | Review approved |
28
+ | **๐Ÿงช Testing** | QA validation | 10 | Review passed | Tests passing |
29
+ | **๐Ÿš€ Staging** | Pre-production | 5 | Tests passed | Stakeholder approval |
30
+ | **โœ… Done** | Completed work | โˆž | DoD satisfied | Production deployed |
31
+
32
+ ### 1.2 Swim Lanes (Optional)
33
+ - **๐Ÿ”ฅ Expedite:** Critical production issues
34
+ - **๐ŸŽฏ Feature:** New functionality
35
+ - **๐Ÿ› Bug:** Defect resolution
36
+ - **โš™๏ธ Tech Debt:** Code quality improvements
37
+ - **๐Ÿ“š Docs:** Documentation updates
38
+
39
+ ### 1.3 Work Item Types
40
+ | Type | Icon | Color | SLA | Escalation |
41
+ |------|------|-------|-----|------------|
42
+ | **Epic** | ๐ŸŽญ | Purple | 3 months | Director level |
43
+ | **Story** | ๐Ÿ“– | Blue | 2 weeks | Team lead |
44
+ | **Task** | โ˜‘๏ธ | Green | 3 days | Scrum master |
45
+ | **Bug** | ๐Ÿ› | Red | 24 hours | Immediate |
46
+ | **Spike** | ๐Ÿ”ฌ | Orange | 1 week | Tech lead |
47
+
48
+ ---
49
+
50
+ ## ๐Ÿ“ 2. Definition of Ready (DoR) & Done (DoD)
51
+
52
+ ### 2.1 Definition of Ready
53
+ **Before moving to "Ready" column:**
54
+ - [ ] **Clear Description:** Task purpose and scope defined
55
+ - [ ] **Acceptance Criteria:** Testable conditions specified
56
+ - [ ] **Dependencies:** All blockers identified and resolved
57
+ - [ ] **Estimation:** Story points or hours assigned
58
+ - [ ] **Priority:** Business value ranking assigned
59
+ - [ ] **Assignee:** Resource allocated and available
60
+ - [ ] **Prerequisites:** Required tools/access provisioned
61
+
62
+ **Story-Specific DoR:**
63
+ - [ ] User story follows INVEST criteria
64
+ - [ ] Wireframes/mockups available (if UI work)
65
+ - [ ] API contracts defined (if backend work)
66
+ - [ ] Performance requirements specified
67
+ - [ ] Security considerations documented
68
+
69
+ ### 2.2 Definition of Done
70
+ **Before moving to "Done" column:**
71
+ - [ ] **Code Complete:** All acceptance criteria implemented
72
+ - [ ] **Code Review:** Peer review approved
73
+ - [ ] **Tests Written:** Unit tests โ‰ฅ80% coverage
74
+ - [ ] **Tests Passing:** All automated tests green
75
+ - [ ] **Security Review:** Security requirements met
76
+ - [ ] **Documentation Updated:** Code and user docs current
77
+ - [ ] **Performance Validated:** Meets specified requirements
78
+ - [ ] **Accessibility Checked:** WCAG compliance verified
79
+ - [ ] **Deployment Ready:** Can be released to production
80
+
81
+ **Additional DoD for Features:**
82
+ - [ ] End-to-end testing completed
83
+ - [ ] User acceptance testing passed
84
+ - [ ] Monitoring and alerting configured
85
+ - [ ] Rollback plan documented
86
+
87
+ ---
88
+
89
+ ## ๐ŸŽฏ 3. Sprint Planning & Execution
90
+
91
+ ### 3.1 Sprint Planning Process
92
+ **Pre-Planning (1 week before):**
93
+ - [ ] Backlog refinement completed
94
+ - [ ] Dependencies resolved
95
+ - [ ] Team capacity calculated
96
+ - [ ] Sprint goal defined
97
+
98
+ **Sprint Planning Meeting (2-4 hours):**
99
+ 1. **Review Sprint Goal** (15 mins)
100
+ 2. **Capacity Planning** (30 mins)
101
+ 3. **Story Selection** (60-120 mins)
102
+ 4. **Task Breakdown** (45-90 mins)
103
+ 5. **Commitment** (15 mins)
104
+
105
+ ### 3.2 Sprint Capacity Planning
106
+ **Team Capacity Matrix:**
107
+ | Team Member | Role | Available Hours | Specialties | Previous Velocity |
108
+ |--------------|------|----------------|-------------|-------------------|
109
+ | _{Name}_ | Frontend Dev | 32h | React, TypeScript | 21 SP/sprint |
110
+ | _{Name}_ | Backend Dev | 40h | Node.js, PostgreSQL | 18 SP/sprint |
111
+ | _{Name}_ | DevOps | 20h | AWS, Docker | 13 SP/sprint |
112
+ | _{Name}_ | QA Engineer | 35h | Automation | 16 SP/sprint |
113
+
114
+ **Capacity Adjustments:**
115
+ - **Holidays:** _{-8 hours per holiday}_
116
+ - **Meetings:** _{-6 hours per person}_
117
+ - **Support:** _{-10% for production support}_
118
+ - **Learning:** _{-20% for new team members}_
119
+
120
+ ### 3.3 Sprint Execution Framework
121
+ **Daily Standup Structure (15 mins max):**
122
+ 1. **Progress Updates** (2 mins per person)
123
+ - What I completed yesterday
124
+ - What I'm working on today
125
+ - Any blockers or impediments
126
+
127
+ 2. **Board Walk** (5 mins)
128
+ - Review work flow
129
+ - Identify bottlenecks
130
+ - Check WIP limits
131
+
132
+ 3. **Action Items** (3 mins)
133
+ - Blocker resolution
134
+ - Collaboration needs
135
+ - Risk mitigation
136
+
137
+ ### 3.4 Sprint Metrics & Tracking
138
+ **Real-time Metrics:**
139
+ | Metric | Current | Target | Status |
140
+ |--------|---------|--------|---------|
141
+ | **Sprint Burndown** | _{X SP remaining}_ | _{On track}_ | ๐ŸŸข/๐ŸŸก/๐Ÿ”ด |
142
+ | **WIP Violations** | _{0 columns}_ | _{0}_ | ๐ŸŸข/๐ŸŸก/๐Ÿ”ด |
143
+ | **Blocked Items** | _{2 items}_ | _{<3}_ | ๐ŸŸข/๐ŸŸก/๐Ÿ”ด |
144
+ | **Velocity Trend** | _{18 SP}_ | _{20 ยฑ3}_ | ๐ŸŸข/๐ŸŸก/๐Ÿ”ด |
145
+
146
+ ---
147
+
148
+ ## โš ๏ธ 4. Risk Management & Escalation
149
+
150
+ ### 4.1 Risk Identification Matrix
151
+ | Risk Level | Indicators | Response Time | Escalation Path |
152
+ |------------|-----------|---------------|-----------------|
153
+ | ๐ŸŸข **Low** | Minor delays, non-critical bugs | 48 hours | Team self-manages |
154
+ | ๐ŸŸก **Medium** | Sprint goal at risk, key dependencies | 24 hours | Scrum Master โ†’ Team Lead |
155
+ | ๐Ÿ”ด **High** | Major blockers, critical path delays | 4 hours | Team Lead โ†’ Director |
156
+ | โšซ **Critical** | Production down, security breach | Immediate | Director โ†’ VP/CTO |
157
+
158
+ ### 4.2 Escalation Procedures
159
+ **Level 1: Team Resolution**
160
+ - **Trigger:** Task blocked >24 hours
161
+ - **Action:** Team collaboration, pair programming
162
+ - **Owner:** Scrum Master
163
+ - **Timeline:** 48 hours
164
+
165
+ **Level 2: Management Intervention**
166
+ - **Trigger:** Sprint goal at risk
167
+ - **Action:** Resource reallocation, scope adjustment
168
+ - **Owner:** Team Lead/Manager
169
+ - **Timeline:** 24 hours
170
+
171
+ **Level 3: Executive Decision**
172
+ - **Trigger:** Release timeline jeopardized
173
+ - **Action:** Priority reset, external resources
174
+ - **Owner:** Director/VP
175
+ - **Timeline:** 4 hours
176
+
177
+ ### 4.3 Blocker Resolution Framework
178
+ **Blocker Categories:**
179
+ - **Technical:** Code/architecture issues
180
+ - **Resource:** People/infrastructure constraints
181
+ - **Dependency:** External team/vendor delays
182
+ - **Requirement:** Unclear/changing specifications
183
+
184
+ **Resolution Process:**
185
+ 1. **Identify** blocker type and impact
186
+ 2. **Document** in tracking system
187
+ 3. **Assign** resolution owner
188
+ 4. **Set** target resolution date
189
+ 5. **Escalate** if timeline exceeded
190
+ 6. **Communicate** resolution to stakeholders
191
+
192
+ ---
193
+
194
+ ## ๐Ÿ“Š 5. Performance Metrics & KPIs
195
+
196
+ ### 5.1 Velocity & Predictability
197
+ **Velocity Tracking:**
198
+ | Sprint | Planned SP | Delivered SP | Variance | Notes |
199
+ |--------|------------|--------------|----------|-------|
200
+ | Sprint N-2 | 23 | 21 | -2 (9%) | Holiday impact |
201
+ | Sprint N-1 | 20 | 22 | +2 (10%) | Simple stories |
202
+ | Sprint N | 21 | _{TBD}_ | _{TBD}_ | Current sprint |
203
+
204
+ **Predictability Metrics:**
205
+ - **Average Velocity:** _{21.3 SP/sprint}_
206
+ - **Velocity Range:** _{18-24 SP}_
207
+ - **Commitment Reliability:** _{87% stories completed}_
208
+
209
+ ### 5.2 Quality Metrics
210
+ | Metric | Current | Target | Trend |
211
+ |--------|---------|--------|-------|
212
+ | **Defect Rate** | 2.1 bugs/story | <3 | ๐Ÿ“ˆ Improving |
213
+ | **Rework Rate** | 8% of stories | <10% | ๐Ÿ“‰ Stable |
214
+ | **Technical Debt** | 15% velocity | <20% | ๐Ÿ“ˆ Growing |
215
+ | **Code Coverage** | 78% | โ‰ฅ80% | ๐Ÿ“ˆ Improving |
216
+
217
+ ### 5.3 Flow Efficiency
218
+ **Lead Time Analysis:**
219
+ | Stage | Average Time | Target | Bottleneck Score |
220
+ |-------|-------------|--------|------------------|
221
+ | **Ready โ†’ In Progress** | 0.5 days | <1 day | Low |
222
+ | **In Progress โ†’ Review** | 2.8 days | <3 days | Medium |
223
+ | **Review โ†’ Testing** | 1.2 days | <1 day | High |
224
+ | **Testing โ†’ Done** | 0.8 days | <1 day | Low |
225
+
226
+ **Cycle Time:** _{5.3 days average}_
227
+ **Flow Efficiency:** _{64% (time in active work vs waiting)}_
228
+
229
+ ### 5.4 Team Health Indicators
230
+ | Indicator | Current | Target | Action Needed |
231
+ |-----------|---------|--------|---------------|
232
+ | **Team Satisfaction** | 8.2/10 | >8.0 | None |
233
+ | **Burnout Risk** | Low | Low | Monitor |
234
+ | **Skill Gaps** | 2 areas | <3 | Training plan |
235
+ | **Collaboration Score** | 7.8/10 | >7.5 | None |
236
+
237
+ ---
238
+
239
+ ## ๐Ÿ”„ 6. Continuous Improvement Framework
240
+
241
+ ### 6.1 Sprint Retrospective Structure
242
+ **Retrospective Format (90 mins):**
243
+ 1. **Check-in** (10 mins) - Team mood and energy
244
+ 2. **Data Review** (15 mins) - Metrics and achievements
245
+ 3. **What Went Well** (20 mins) - Celebrate successes
246
+ 4. **What Didn't Work** (20 mins) - Identify problems
247
+ 5. **Root Cause Analysis** (15 mins) - Dig deeper
248
+ 6. **Action Planning** (10 mins) - Next sprint improvements
249
+
250
+ ### 6.2 Improvement Tracking
251
+ **Action Item Format:**
252
+ | Action | Owner | Target Date | Success Metric | Status |
253
+ |--------|-------|-------------|----------------|--------|
254
+ | _{Improve code review time}_ | _{Dev Team}_ | _{Next sprint}_ | _{<4 hours avg}_ | In Progress |
255
+ | _{Automate deployment}_ | _{DevOps}_ | _{Sprint +2}_ | _{Zero manual steps}_ | Planned |
256
+
257
+ ### 6.3 Team Learning & Development
258
+ **Knowledge Sharing Sessions:**
259
+ - **Weekly:** Technical talks (30 mins)
260
+ - **Bi-weekly:** Industry trends discussion
261
+ - **Monthly:** Tool evaluations and demos
262
+ - **Quarterly:** Architecture reviews
263
+
264
+ **Skill Development Matrix:**
265
+ | Team Member | Current Skills | Growth Areas | Training Plan |
266
+ |-------------|----------------|--------------|---------------|
267
+ | _{Name}_ | React, Jest | TypeScript, GraphQL | Online course + mentoring |
268
+ | _{Name}_ | Node.js, Express | Microservices, Docker | Hands-on project |
269
+
270
+ ---
271
+
272
+ ## ๐Ÿšจ 7. Exception Handling & Crisis Management
273
+
274
+ ### 7.1 Production Incident Response
275
+ **Severity Levels:**
276
+ - **P0:** System down, revenue impact
277
+ - **P1:** Major feature broken, user impact
278
+ - **P2:** Minor feature issues, limited impact
279
+ - **P3:** Cosmetic issues, no user impact
280
+
281
+ **Response Procedures:**
282
+ **P0/P1 Incidents:**
283
+ 1. **Immediate:** Stop sprint work, all hands on deck
284
+ 2. **Communication:** Stakeholder notification within 15 mins
285
+ 3. **War Room:** Video conference with all necessary people
286
+ 4. **Resolution:** Fix and deploy, then postmortem
287
+ 5. **Recovery:** Return to sprint work after stabilization
288
+
289
+ ### 7.2 Scope Change Management
290
+ **Change Request Process:**
291
+ 1. **Submit:** Formal change request with justification
292
+ 2. **Assess:** Impact on current sprint/release
293
+ 3. **Decide:** Product Owner + Stakeholder approval
294
+ 4. **Implement:** Adjust sprint scope and communicate
295
+ 5. **Track:** Monitor impact on velocity and morale
296
+
297
+ ### 7.3 Resource Crisis Handling
298
+ **Common Scenarios:**
299
+ - Team member sick/unavailable
300
+ - Key dependency failure
301
+ - Infrastructure outage
302
+ - Requirement clarification needed
303
+
304
+ **Response Framework:**
305
+ - **Assess:** Impact on sprint goal
306
+ - **Mitigate:** Reassign work, adjust scope
307
+ - **Communicate:** Update stakeholders
308
+ - **Learn:** Capture lessons for future prevention
309
+
310
+ ---
311
+
312
+ ## ๐Ÿ“ˆ 8. Reporting & Communication
313
+
314
+ ### 8.1 Sprint Status Dashboard
315
+ **Daily Updates (Automated):**
316
+ - Sprint burndown chart
317
+ - Current velocity trend
318
+ - Blocked item count
319
+ - WIP limit violations
320
+ - Quality metrics
321
+
322
+ ### 8.2 Stakeholder Communication
323
+ **Weekly Sprint Update:**
324
+ - Progress toward sprint goal
325
+ - Completed stories and features
326
+ - Upcoming deliverables
327
+ - Risks and mitigation plans
328
+ - Requests for stakeholder support
329
+
330
+ **Sprint Review Presentation:**
331
+ - Demo of completed features
332
+ - Velocity and quality metrics
333
+ - Customer feedback integration
334
+ - Next sprint preview
335
+
336
+ ### 8.3 Management Reporting
337
+ **Monthly Metrics Summary:**
338
+ | Category | Metric | Current | Target | Trend |
339
+ |----------|--------|---------|--------|-------|
340
+ | **Delivery** | Features delivered | 12 | 10-15 | ๐Ÿ“ˆ |
341
+ | **Quality** | Bug rate | 2.1/story | <3 | ๐Ÿ“ˆ |
342
+ | **Velocity** | Story points/sprint | 21.3 | 20ยฑ3 | ๐Ÿ“Š |
343
+ | **Team** | Satisfaction score | 8.2/10 | >8.0 | ๐Ÿ“Š |
344
+
345
+ ---
346
+
347
+ ## ๐Ÿ› ๏ธ 9. Tools & Automation
348
+
349
+ ### 9.1 Essential Tool Stack
350
+ **Project Management:**
351
+ - **Primary:** _{Jira, Azure DevOps, Linear}_
352
+ - **Visualization:** _{Burndown charts, CFD diagrams}_
353
+ - **Reporting:** _{Automated dashboards}_
354
+
355
+ **Communication:**
356
+ - **Daily:** _{Slack, Microsoft Teams}_
357
+ - **Video:** _{Zoom, Google Meet}_
358
+ - **Async:** _{Confluence, Notion}_
359
+
360
+ **Development:**
361
+ - **Version Control:** _{Git with PR workflows}_
362
+ - **CI/CD:** _{GitHub Actions, Jenkins}_
363
+ - **Testing:** _{Jest, Cypress, Postman}_
364
+
365
+ ### 9.2 Automation Opportunities
366
+ **Automated Workflows:**
367
+ - [ ] Story point estimation reminders
368
+ - [ ] WIP limit violation alerts
369
+ - [ ] Standup meeting preparation
370
+ - [ ] Sprint burndown updates
371
+ - [ ] Code review assignment
372
+ - [ ] Deployment status notifications
373
+
374
+ ### 9.3 Integration Configuration
375
+ ```yaml
376
+ # Example workflow automation
377
+ sprint_automation:
378
+ daily_standup:
379
+ reminder: "9:00 AM"
380
+ prep_report: true
381
+
382
+ wip_limits:
383
+ monitor: true
384
+ alert_threshold: 80%
385
+
386
+ velocity_tracking:
387
+ auto_calculate: true
388
+ trend_analysis: true
389
+
390
+ quality_gates:
391
+ code_coverage: 80%
392
+ review_required: true
393
+ tests_passing: true
394
+ ```
395
+
396
+ ---
397
+
398
+ ## ๐Ÿ“‹ 10. Process Health Checklist
399
+
400
+ ### 10.1 Weekly Health Check
401
+ - [ ] **Velocity on track** (within ยฑ20% of plan)
402
+ - [ ] **WIP limits respected** (no violations >24h)
403
+ - [ ] **Blockers resolved** (average <48h)
404
+ - [ ] **Quality gates met** (DoD compliance 100%)
405
+ - [ ] **Team engagement high** (standup participation)
406
+
407
+ ### 10.2 Monthly Process Review
408
+ - [ ] **Retrospective actions completed** (>80% success rate)
409
+ - [ ] **Metrics trending positively** (velocity, quality)
410
+ - [ ] **Stakeholder satisfaction maintained** (feedback positive)
411
+ - [ ] **Team health stable** (satisfaction >7.5/10)
412
+ - [ ] **Process improvements identified** (continuous learning)
413
+
414
+ ### 10.3 Quarterly Framework Assessment
415
+ - [ ] **Process effectiveness evaluated**
416
+ - [ ] **Tool stack optimized**
417
+ - [ ] **Team skills assessed**
418
+ - [ ] **Scaling readiness confirmed**
419
+ - [ ] **Industry best practices benchmarked**
420
+
421
+ ---
422
+
423
+ **๐ŸŽฏ Process Management Success Metrics:**
424
+ - Sprint goal achievement: 90%+
425
+ - Velocity predictability: ยฑ15%
426
+ - Team satisfaction: 8.0+/10
427
+ - Defect rate: <3 bugs/story
428
+ - Lead time: <5 days average
429
+
430
+ **Next Steps:** Implement process framework and proceed to quality validation with 12_qa_gate.md.