@amrhas82/agentic-kit 1.0.0 → 1.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.
@@ -16,13 +16,13 @@ workflows:
16
16
  - step: enhancement_classification
17
17
  agent: business-analyst
18
18
  action: classify enhancement scope
19
- notes: "Determine enhancement complexity to route to appropriate path:\n-\
20
- \ Single story (< 4 hours) \u2192 Use brownfield-create-story task\n- Small\
21
- \ feature (1-3 stories) \u2192 Use brownfield-create-epic task \n- Major\
22
- \ enhancement (multiple epics) \u2192 Continue with full workflow\n\nAsk\
23
- \ user: \"Can you describe the enhancement scope? Is this a small fix, a\
24
- \ feature addition, or a major enhancement requiring architectural changes?\"\
25
- \n"
19
+ notes: |
20
+ Determine enhancement complexity to route to appropriate path:
21
+ - Single story (< 4 hours) \u2192 Use brownfield-create-story task
22
+ - Small feature (1-3 stories) \u2192 Use brownfield-create-epic task
23
+ - Major enhancement (multiple epics) \u2192 Continue with full workflow
24
+
25
+ Ask user: "Can you describe the enhancement scope? Is this a small fix, a feature addition, or a major enhancement requiring architectural changes?"
26
26
  - step: routing_decision
27
27
  condition: based_on_classification
28
28
  routes:
@@ -77,11 +77,13 @@ workflows:
77
77
  agent: product-manager/architect
78
78
  action: determine if architecture document needed
79
79
  condition: after_prd_creation
80
- notes: "Review PRD to determine if architectural planning is needed:\n- New\
81
- \ architectural patterns \u2192 Create architecture doc\n- New libraries/frameworks\
82
- \ \u2192 Create architecture doc\n- Platform/infrastructure changes \u2192\
83
- \ Create architecture doc\n- Following existing patterns \u2192 Skip to\
84
- \ story creation\n"
80
+ notes: |
81
+ Review PRD to determine if architectural planning is needed:
82
+ - New architectural patterns \u2192 Create architecture doc
83
+ - New libraries/frameworks \u2192 Create architecture doc
84
+ - Platform/infrastructure changes \u2192 Create architecture doc
85
+ - Following existing patterns \u2192 Skip to story creation
86
+
85
87
  - agent: architect
86
88
  creates: architecture.md
87
89
  uses: brownfield-architecture-template
@@ -118,20 +120,26 @@ workflows:
118
120
  creates: story.md
119
121
  requires: sharded_docs_or_brownfield_docs
120
122
  repeats: for_each_epic_or_enhancement
121
- notes: "Story creation cycle:\n- For sharded PRD: @scrum-master \u2192 *create\
122
- \ (uses create-next-story)\n- For brownfield docs: @scrum-master \u2192\
123
- \ use create-brownfield-story task\n- Creates story from available documentation\n\
124
- - Story starts in \"Draft\" status\n- May require additional context gathering\
125
- \ for brownfield\n"
123
+ notes: |
124
+ Story creation cycle:
125
+ - For sharded PRD: @scrum-master \u2192 *create (uses create-next-story)
126
+ - For brownfield docs: @scrum-master \u2192 use create-brownfield-story task
127
+ - Creates story from available documentation
128
+ - Story starts in "Draft" status
129
+ - May require additional context gathering for brownfield
130
+
126
131
  - agent: business-analyst/product-manager
127
132
  action: review_draft_story
128
133
  updates: story.md
129
134
  requires: story.md
130
135
  optional: true
131
136
  condition: user_wants_story_review
132
- notes: "OPTIONAL: Review and approve draft story\n- NOTE: story-review task\
133
- \ coming soon\n- Review story completeness and alignment\n- Update story\
134
- \ status: Draft \u2192 Approved\n"
137
+ notes: |
138
+ OPTIONAL: Review and approve draft story
139
+ - NOTE: story-review task coming soon
140
+ - Review story completeness and alignment
141
+ - Update story status: Draft \u2192 Approved
142
+
135
143
  - agent: dev
136
144
  action: implement_story
137
145
  creates: implementation_files
@@ -150,10 +158,13 @@ workflows:
150
158
  updates: implementation_files
151
159
  requires: implementation_files
152
160
  optional: true
153
- notes: "OPTIONAL: QA Agent (New Chat): @qa \u2192 review-story\n- Senior dev\
154
- \ review with refactoring ability\n- Fixes small issues directly\n- Leaves\
155
- \ checklist for remaining items\n- Updates story status (Review \u2192 Done\
156
- \ or stays Review)\n"
161
+ notes: |
162
+ OPTIONAL: QA Agent (New Chat): @qa \u2192 review-story
163
+ - Senior dev review with refactoring ability
164
+ - Fixes small issues directly
165
+ - Leaves checklist for remaining items
166
+ - Updates story status (Review \u2192 Done or stays Review)
167
+
157
168
  - agent: dev
158
169
  action: address_qa_feedback
159
170
  updates: implementation_files
@@ -167,8 +178,10 @@ workflows:
167
178
  '
168
179
  - step: repeat_development_cycle
169
180
  action: continue_for_all_stories
170
- notes: "Repeat story cycle (scrum-master \u2192 Dev \u2192 QA) for all epic\
171
- \ stories\nContinue until all stories in PRD are complete\n"
181
+ notes: |
182
+ Repeat story cycle (scrum-master \u2192 Dev \u2192 QA) for all epic stories
183
+ Continue until all stories in PRD are complete
184
+
172
185
  - agent: product-owner
173
186
  action: epic_retrospective
174
187
  creates: epic-retrospective.md
@@ -193,31 +206,71 @@ workflows:
193
206
  Reference: ../resources/data.md#IDE Development Workflow
194
207
 
195
208
  '
196
- flow_diagram: "```mermaid\ngraph TD\n A[Start: Brownfield Enhancement] -->\
197
- \ B[business-analyst: classify enhancement scope]\n B --> C{Enhancement\
198
- \ Size?}\n \n C -->|Single Story| D[product-manager: brownfield-create-story]\n\
199
- \ C -->|1-3 Stories| E[product-manager: brownfield-create-epic]\n C\
200
- \ -->|Major Enhancement| F[business-analyst: check documentation]\n \n\
201
- \ D --> END1[To Dev Implementation]\n E --> END2[To Story Creation]\n\
202
- \ \n F --> G{Docs Adequate?}\n G -->|No| H[architect: document-project]\n\
203
- \ G -->|Yes| I[product-manager: brownfield PRD]\n H --> I\n \n \
204
- \ I --> J{Architecture Needed?}\n J -->|Yes| K[architect: architecture.md]\n\
205
- \ J -->|No| L[product-owner: validate artifacts]\n K --> L\n \n \
206
- \ L --> M{product-owner finds issues?}\n M -->|Yes| N[Fix issues]\n \
207
- \ M -->|No| O[product-owner: shard documents]\n N --> L\n \n O\
208
- \ --> P[scrum-master: create story]\n P --> Q{Story Type?}\n Q -->|Sharded\
209
- \ PRD| R[create-next-story]\n Q -->|Brownfield Docs| S[create-brownfield-story]\n\
210
- \ \n R --> T{Review draft?}\n S --> T\n T -->|Yes| U[review &\
211
- \ approve]\n T -->|No| V[dev: implement]\n U --> V\n \n V -->\
212
- \ W{QA review?}\n W -->|Yes| X[qa: review]\n W -->|No| Y{More stories?}\n\
213
- \ X --> Z{Issues?}\n Z -->|Yes| AA[dev: fix]\n Z -->|No| Y\n AA\
214
- \ --> X\n Y -->|Yes| P\n Y -->|No| AB{Retrospective?}\n AB -->|Yes|\
215
- \ AC[product-owner: retrospective]\n AB -->|No| AD[Complete]\n AC -->\
216
- \ AD\n\n style AD fill:#90EE90\n style END1 fill:#90EE90\n style\
217
- \ END2 fill:#90EE90\n style D fill:#87CEEB\n style E fill:#87CEEB\n\
218
- \ style I fill:#FFE4B5\n style K fill:#FFE4B5\n style O fill:#ADD8E6\n\
219
- \ style P fill:#ADD8E6\n style V fill:#ADD8E6\n style U fill:#F0E68C\n\
220
- \ style X fill:#F0E68C\n style AC fill:#F0E68C\n```\n"
209
+ flow_diagram: |
210
+ ```mermaid
211
+ graph TD
212
+ A[Start: Brownfield Enhancement] --> B[business-analyst: classify enhancement scope]
213
+ B --> C{Enhancement Size?}
214
+
215
+ C -->|Single Story| D[product-manager: brownfield-create-story]
216
+ C -->|1-3 Stories| E[product-manager: brownfield-create-epic]
217
+ C -->|Major Enhancement| F[business-analyst: check documentation]
218
+
219
+ D --> END1[To Dev Implementation]
220
+ E --> END2[To Story Creation]
221
+ F --> G{Docs Adequate?}
222
+ G -->|No| H[architect: document-project]
223
+ G -->|Yes| I[product-manager: brownfield PRD]
224
+ H --> I
225
+
226
+ I --> J{Architecture Needed?}
227
+ J -->|Yes| K[architect: architecture.md]
228
+ J -->|No| L[product-owner: validate artifacts]
229
+ K --> L
230
+
231
+ L --> M{product-owner finds issues?}
232
+ M -->|Yes| N[Fix issues]
233
+ M -->|No| O[product-owner: shard documents]
234
+ N --> L
235
+
236
+ O --> P[scrum-master: create story]
237
+ P --> Q{Story Type?}
238
+ Q -->|Sharded PRD| R[create-next-story]
239
+ Q -->|Brownfield Docs| S[create-brownfield-story]
240
+ R --> T{Review draft?}
241
+ S --> T
242
+ T -->|Yes| U[review & approve]
243
+ T -->|No| V[dev: implement]
244
+ U --> V
245
+
246
+ V --> W{QA review?}
247
+ W -->|Yes| X[qa: review]
248
+ W -->|No| Y{More stories?}
249
+ X --> Z{Issues?}
250
+ Z -->|Yes| AA[dev: fix]
251
+ Z -->|No| Y
252
+ AA --> X
253
+ Y -->|Yes| P
254
+ Y -->|No| AB{Retrospective?}
255
+ AB -->|Yes| AC[product-owner: retrospective]
256
+ AB -->|No| AD[Complete]
257
+ AC --> AD
258
+
259
+ style AD fill:#90EE90
260
+ style END1 fill:#90EE90
261
+ style END2 fill:#90EE90
262
+ style D fill:#87CEEB
263
+ style E fill:#87CEEB
264
+ style I fill:#FFE4B5
265
+ style K fill:#FFE4B5
266
+ style O fill:#ADD8E6
267
+ style P fill:#ADD8E6
268
+ style V fill:#ADD8E6
269
+ style U fill:#F0E68C
270
+ style X fill:#F0E68C
271
+ style AC fill:#F0E68C
272
+ ```
273
+
221
274
  decision_guidance:
222
275
  when_to_use:
223
276
  - Enhancement requires coordinated stories
@@ -255,16 +308,19 @@ workflows:
255
308
  aspects.
256
309
 
257
310
  '
258
- product-manager_to_architect_decision: "PRD complete and saved as docs/prd.md.\
259
- \ \nArchitectural changes identified: {{yes/no}}\n{{if yes}}: Proceeding\
260
- \ to create architecture document for: {{specific_changes}}\n{{if no}}:\
261
- \ No architectural changes needed. Proceeding to validation.\n"
311
+ product-manager_to_architect_decision: |
312
+ PRD complete and saved as docs/prd.md.Architectural changes identified: {{yes/no}}
313
+ {{if yes}}: Proceeding to create architecture document for: {{specific_changes}}
314
+ {{if no}}: No architectural changes needed. Proceeding to validation.
315
+
262
316
  architect_to_po: Architecture complete. Save it as docs/architecture.md. Please
263
317
  validate all artifacts for integration safety.
264
- product-owner_to_scrum-master: "All artifacts validated. \nDocumentation type\
265
- \ available: {{sharded_prd / brownfield_docs}}\n{{if sharded}}: Use standard\
266
- \ create-next-story task.\n{{if brownfield}}: Use create-brownfield-story\
267
- \ task to handle varied documentation formats.\n"
318
+ product-owner_to_scrum-master: |
319
+ All artifacts validated.
320
+ Documentation type available: {{sharded_prd / brownfield_docs}}
321
+ {{if sharded}}: Use standard create-next-story task.
322
+ {{if brownfield}}: Use create-brownfield-story task to handle varied documentation formats.
323
+
268
324
  scrum-master_story_creation: 'Creating story from {{documentation_type}}.
269
325
 
270
326
  {{if missing_context}}: May need to gather additional context from user
@@ -337,18 +393,24 @@ workflows:
337
393
  creates: story.md
338
394
  requires: sharded_docs
339
395
  repeats: for_each_epic
340
- notes: "Story creation cycle:\n- scrum-master Agent (New Chat): @scrum-master\
341
- \ \u2192 *create\n- Creates next story from sharded docs\n- Story starts\
342
- \ in \"Draft\" status\n"
396
+ notes: |
397
+ Story creation cycle:
398
+ - scrum-master Agent (New Chat): @scrum-master \u2192 *create
399
+ - Creates next story from sharded docs
400
+ - Story starts in "Draft" status
401
+
343
402
  - agent: business-analyst/product-manager
344
403
  action: review_draft_story
345
404
  updates: story.md
346
405
  requires: story.md
347
406
  optional: true
348
407
  condition: user_wants_story_review
349
- notes: "OPTIONAL: Review and approve draft story\n- NOTE: story-review task\
350
- \ coming soon\n- Review story completeness and alignment\n- Update story\
351
- \ status: Draft \u2192 Approved\n"
408
+ notes: |
409
+ OPTIONAL: Review and approve draft story
410
+ - NOTE: story-review task coming soon
411
+ - Review story completeness and alignment
412
+ - Update story status: Draft \u2192 Approved
413
+
352
414
  - agent: dev
353
415
  action: implement_story
354
416
  creates: implementation_files
@@ -367,10 +429,13 @@ workflows:
367
429
  updates: implementation_files
368
430
  requires: implementation_files
369
431
  optional: true
370
- notes: "OPTIONAL: QA Agent (New Chat): @qa \u2192 review-story\n- Senior dev\
371
- \ review with refactoring ability\n- Fixes small issues directly\n- Leaves\
372
- \ checklist for remaining items\n- Updates story status (Review \u2192 Done\
373
- \ or stays Review)\n"
432
+ notes: |
433
+ OPTIONAL: QA Agent (New Chat): @qa \u2192 review-story
434
+ - Senior dev review with refactoring ability
435
+ - Fixes small issues directly
436
+ - Leaves checklist for remaining items
437
+ - Updates story status (Review \u2192 Done or stays Review)
438
+
374
439
  - agent: dev
375
440
  action: address_qa_feedback
376
441
  updates: implementation_files
@@ -384,8 +449,10 @@ workflows:
384
449
  '
385
450
  - step: repeat_development_cycle
386
451
  action: continue_for_all_stories
387
- notes: "Repeat story cycle (scrum-master \u2192 Dev \u2192 QA) for all epic\
388
- \ stories\nContinue until all stories in PRD are complete\n"
452
+ notes: |
453
+ Repeat story cycle (scrum-master \u2192 Dev \u2192 QA) for all epic stories
454
+ Continue until all stories in PRD are complete
455
+
389
456
  - agent: product-owner
390
457
  action: epic_retrospective
391
458
  creates: epic-retrospective.md
@@ -409,23 +476,47 @@ workflows:
409
476
  Reference: ../resources/data.md#IDE Development Workflow
410
477
 
411
478
  '
412
- flow_diagram: "```mermaid\ngraph TD\n A[Start: Service Enhancement] --> B[business-analyst:\
413
- \ analyze existing service]\n B --> C[product-manager: prd.md]\n C -->\
414
- \ D[architect: architecture.md]\n D --> E[product-owner: validate with\
415
- \ po-master-checklist]\n E --> F{product-owner finds issues?}\n F -->|Yes|\
416
- \ G[Return to relevant agent for fixes]\n F -->|No| H[product-owner: shard\
417
- \ documents]\n G --> E\n \n H --> I[scrum-master: create story]\n\
418
- \ I --> J{Review draft story?}\n J -->|Yes| K[business-analyst/product-manager:\
419
- \ review & approve story]\n J -->|No| L[dev: implement story]\n K -->\
420
- \ L\n L --> M{QA review?}\n M -->|Yes| N[qa: review implementation]\n\
421
- \ M -->|No| O{More stories?}\n N --> P{QA found issues?}\n P -->|Yes|\
422
- \ Q[dev: address QA feedback]\n P -->|No| O\n Q --> N\n O -->|Yes|\
423
- \ I\n O -->|No| R{Epic retrospective?}\n R -->|Yes| S[product-owner:\
424
- \ epic retrospective]\n R -->|No| T[Project Complete]\n S --> T\n\n\
425
- \ style T fill:#90EE90\n style H fill:#ADD8E6\n style I fill:#ADD8E6\n\
426
- \ style L fill:#ADD8E6\n style C fill:#FFE4B5\n style D fill:#FFE4B5\n\
427
- \ style K fill:#F0E68C\n style N fill:#F0E68C\n style S fill:#F0E68C\n\
428
- ```\n"
479
+ flow_diagram: |
480
+ ```mermaid
481
+ graph TD
482
+ A[Start: Service Enhancement] --> B[business-analyst: analyze existing service]
483
+ B --> C[product-manager: prd.md]
484
+ C --> D[architect: architecture.md]
485
+ D --> E[product-owner: validate with po-master-checklist]
486
+ E --> F{product-owner finds issues?}
487
+ F -->|Yes| G[Return to relevant agent for fixes]
488
+ F -->|No| H[product-owner: shard documents]
489
+ G --> E
490
+
491
+ H --> I[scrum-master: create story]
492
+ I --> J{Review draft story?}
493
+ J -->|Yes| K[business-analyst/product-manager: review & approve story]
494
+ J -->|No| L[dev: implement story]
495
+ K --> L
496
+ L --> M{QA review?}
497
+ M -->|Yes| N[qa: review implementation]
498
+ M -->|No| O{More stories?}
499
+ N --> P{QA found issues?}
500
+ P -->|Yes| Q[dev: address QA feedback]
501
+ P -->|No| O
502
+ Q --> N
503
+ O -->|Yes| I
504
+ O -->|No| R{Epic retrospective?}
505
+ R -->|Yes| S[product-owner: epic retrospective]
506
+ R -->|No| T[Project Complete]
507
+ S --> T
508
+
509
+ style T fill:#90EE90
510
+ style H fill:#ADD8E6
511
+ style I fill:#ADD8E6
512
+ style L fill:#ADD8E6
513
+ style C fill:#FFE4B5
514
+ style D fill:#FFE4B5
515
+ style K fill:#F0E68C
516
+ style N fill:#F0E68C
517
+ style S fill:#F0E68C
518
+ ```
519
+
429
520
  decision_guidance:
430
521
  when_to_use:
431
522
  - Service enhancement requires coordinated stories
@@ -515,18 +606,24 @@ workflows:
515
606
  creates: story.md
516
607
  requires: sharded_docs
517
608
  repeats: for_each_epic
518
- notes: "Story creation cycle:\n- scrum-master Agent (New Chat): @scrum-master\
519
- \ \u2192 *create\n- Creates next story from sharded docs\n- Story starts\
520
- \ in \"Draft\" status\n"
609
+ notes: |
610
+ Story creation cycle:
611
+ - scrum-master Agent (New Chat): @scrum-master \u2192 *create
612
+ - Creates next story from sharded docs
613
+ - Story starts in "Draft" status
614
+
521
615
  - agent: business-analyst/product-manager
522
616
  action: review_draft_story
523
617
  updates: story.md
524
618
  requires: story.md
525
619
  optional: true
526
620
  condition: user_wants_story_review
527
- notes: "OPTIONAL: Review and approve draft story\n- NOTE: story-review task\
528
- \ coming soon\n- Review story completeness and alignment\n- Update story\
529
- \ status: Draft \u2192 Approved\n"
621
+ notes: |
622
+ OPTIONAL: Review and approve draft story
623
+ - NOTE: story-review task coming soon
624
+ - Review story completeness and alignment
625
+ - Update story status: Draft \u2192 Approved
626
+
530
627
  - agent: dev
531
628
  action: implement_story
532
629
  creates: implementation_files
@@ -545,10 +642,13 @@ workflows:
545
642
  updates: implementation_files
546
643
  requires: implementation_files
547
644
  optional: true
548
- notes: "OPTIONAL: QA Agent (New Chat): @qa \u2192 review-story\n- Senior dev\
549
- \ review with refactoring ability\n- Fixes small issues directly\n- Leaves\
550
- \ checklist for remaining items\n- Updates story status (Review \u2192 Done\
551
- \ or stays Review)\n"
645
+ notes: |
646
+ OPTIONAL: QA Agent (New Chat): @qa \u2192 review-story
647
+ - Senior dev review with refactoring ability
648
+ - Fixes small issues directly
649
+ - Leaves checklist for remaining items
650
+ - Updates story status (Review \u2192 Done or stays Review)
651
+
552
652
  - agent: dev
553
653
  action: address_qa_feedback
554
654
  updates: implementation_files
@@ -562,8 +662,10 @@ workflows:
562
662
  '
563
663
  - step: repeat_development_cycle
564
664
  action: continue_for_all_stories
565
- notes: "Repeat story cycle (scrum-master \u2192 Dev \u2192 QA) for all epic\
566
- \ stories\nContinue until all stories in PRD are complete\n"
665
+ notes: |
666
+ Repeat story cycle (scrum-master \u2192 Dev \u2192 QA) for all epic stories
667
+ Continue until all stories in PRD are complete
668
+
567
669
  - agent: po
568
670
  action: epic_retrospective
569
671
  creates: epic-retrospective.md
@@ -588,23 +690,49 @@ workflows:
588
690
  Reference: ../resources/data.md#IDE Development Workflow
589
691
 
590
692
  '
591
- flow_diagram: "```mermaid\ngraph TD\n A[Start: UI Enhancement] --> B[business-analyst:\
592
- \ analyze existing UI]\n B --> C[product-manager: prd.md]\n C --> D[ux-expert:\
593
- \ front-end-spec.md]\n D --> E[architect: architecture.md]\n E --> F[po:\
594
- \ validate with po-master-checklist]\n F --> G{PO finds issues?}\n G\
595
- \ -->|Yes| H[Return to relevant agent for fixes]\n G -->|No| I[po: shard\
596
- \ documents]\n H --> F\n \n I --> J[scrum-master: create story]\n\
597
- \ J --> K{Review draft story?}\n K -->|Yes| L[business-analyst/product-manager:\
598
- \ review & approve story]\n K -->|No| M[dev: implement story]\n L -->\
599
- \ M\n M --> N{QA review?}\n N -->|Yes| O[qa: review implementation]\n\
600
- \ N -->|No| P{More stories?}\n O --> Q{QA found issues?}\n Q -->|Yes|\
601
- \ R[dev: address QA feedback]\n Q -->|No| P\n R --> O\n P -->|Yes|\
602
- \ J\n P -->|No| S{Epic retrospective?}\n S -->|Yes| T[po: epic retrospective]\n\
603
- \ S -->|No| U[Project Complete]\n T --> U\n\n style U fill:#90EE90\n\
604
- \ style I fill:#ADD8E6\n style J fill:#ADD8E6\n style M fill:#ADD8E6\n\
605
- \ style C fill:#FFE4B5\n style D fill:#FFE4B5\n style E fill:#FFE4B5\n\
606
- \ style L fill:#F0E68C\n style O fill:#F0E68C\n style T fill:#F0E68C\n\
607
- ```\n"
693
+ flow_diagram: |
694
+ ```mermaid
695
+ graph TD
696
+ A[Start: UI Enhancement] --> B[business-analyst: analyze existing UI]
697
+ B --> C[product-manager: prd.md]
698
+ C --> D[ux-expert: front-end-spec.md]
699
+ D --> E[architect: architecture.md]
700
+ E --> F[po: validate with po-master-checklist]
701
+ F --> G{PO finds issues?}
702
+ G -->|Yes| H[Return to relevant agent for fixes]
703
+ G -->|No| I[po: shard documents]
704
+ H --> F
705
+
706
+ I --> J[scrum-master: create story]
707
+ J --> K{Review draft story?}
708
+ K -->|Yes| L[business-analyst/product-manager: review & approve story]
709
+ K -->|No| M[dev: implement story]
710
+ L --> M
711
+ M --> N{QA review?}
712
+ N -->|Yes| O[qa: review implementation]
713
+ N -->|No| P{More stories?}
714
+ O --> Q{QA found issues?}
715
+ Q -->|Yes| R[dev: address QA feedback]
716
+ Q -->|No| P
717
+ R --> O
718
+ P -->|Yes| J
719
+ P -->|No| S{Epic retrospective?}
720
+ S -->|Yes| T[po: epic retrospective]
721
+ S -->|No| U[Project Complete]
722
+ T --> U
723
+
724
+ style U fill:#90EE90
725
+ style I fill:#ADD8E6
726
+ style J fill:#ADD8E6
727
+ style M fill:#ADD8E6
728
+ style C fill:#FFE4B5
729
+ style D fill:#FFE4B5
730
+ style E fill:#FFE4B5
731
+ style L fill:#F0E68C
732
+ style O fill:#F0E68C
733
+ style T fill:#F0E68C
734
+ ```
735
+
608
736
  decision_guidance:
609
737
  when_to_use:
610
738
  - UI enhancement requires coordinated stories
@@ -726,18 +854,24 @@ workflows:
726
854
  creates: story.md
727
855
  requires: sharded_docs
728
856
  repeats: for_each_epic
729
- notes: "Story creation cycle:\n- scrum-master Agent (New Chat): @scrum-master\
730
- \ \u2192 *create\n- Creates next story from sharded docs\n- Story starts\
731
- \ in \"Draft\" status\n"
857
+ notes: |
858
+ Story creation cycle:
859
+ - scrum-master Agent (New Chat): @scrum-master \u2192 *create
860
+ - Creates next story from sharded docs
861
+ - Story starts in "Draft" status
862
+
732
863
  - agent: business-analyst/product-manager
733
864
  action: review_draft_story
734
865
  updates: story.md
735
866
  requires: story.md
736
867
  optional: true
737
868
  condition: user_wants_story_review
738
- notes: "OPTIONAL: Review and approve draft story\n- NOTE: story-review task\
739
- \ coming soon\n- Review story completeness and alignment\n- Update story\
740
- \ status: Draft \u2192 Approved\n"
869
+ notes: |
870
+ OPTIONAL: Review and approve draft story
871
+ - NOTE: story-review task coming soon
872
+ - Review story completeness and alignment
873
+ - Update story status: Draft \u2192 Approved
874
+
741
875
  - agent: dev
742
876
  action: implement_story
743
877
  creates: implementation_files
@@ -756,10 +890,13 @@ workflows:
756
890
  updates: implementation_files
757
891
  requires: implementation_files
758
892
  optional: true
759
- notes: "OPTIONAL: QA Agent (New Chat): @qa \u2192 review-story\n- Senior dev\
760
- \ review with refactoring ability\n- Fixes small issues directly\n- Leaves\
761
- \ checklist for remaining items\n- Updates story status (Review \u2192 Done\
762
- \ or stays Review)\n"
893
+ notes: |
894
+ OPTIONAL: QA Agent (New Chat): @qa \u2192 review-story
895
+ - Senior dev review with refactoring ability
896
+ - Fixes small issues directly
897
+ - Leaves checklist for remaining items
898
+ - Updates story status (Review \u2192 Done or stays Review)
899
+
763
900
  - agent: dev
764
901
  action: address_qa_feedback
765
902
  updates: implementation_files
@@ -773,8 +910,10 @@ workflows:
773
910
  '
774
911
  - step: repeat_development_cycle
775
912
  action: continue_for_all_stories
776
- notes: "Repeat story cycle (scrum-master \u2192 Dev \u2192 QA) for all epic\
777
- \ stories\nContinue until all stories in PRD are complete\n"
913
+ notes: |
914
+ Repeat story cycle (scrum-master \u2192 Dev \u2192 QA) for all epic stories
915
+ Continue until all stories in PRD are complete
916
+
778
917
  - agent: po
779
918
  action: epic_retrospective
780
919
  creates: epic-retrospective.md
@@ -799,29 +938,64 @@ workflows:
799
938
  Reference: ../resources/data.md#IDE Development Workflow
800
939
 
801
940
  '
802
- flow_diagram: "```mermaid\ngraph TD\n A[Start: Greenfield Project] --> B[business-analyst:\
803
- \ project-brief.md]\n B --> C[product-manager: prd.md]\n C --> D[ux-expert:\
804
- \ front-end-spec.md]\n D --> D2{Generate v0 prompt?}\n D2 -->|Yes| D3[ux-expert:\
805
- \ create v0 prompt]\n D2 -->|No| E[architect: fullstack-architecture.md]\n\
806
- \ D3 --> D4[User: generate UI in v0/Lovable]\n D4 --> E\n E --> F{Architecture\
807
- \ suggests PRD changes?}\n F -->|Yes| G[product-manager: update prd.md]\n\
808
- \ F -->|No| H[po: validate all artifacts]\n G --> H\n H --> I{PO\
809
- \ finds issues?}\n I -->|Yes| J[Return to relevant agent for fixes]\n \
810
- \ I -->|No| K[po: shard documents]\n J --> H\n \n K --> L[scrum-master:\
811
- \ create story]\n L --> M{Review draft story?}\n M -->|Yes| N[business-analyst/product-manager:\
812
- \ review & approve story]\n M -->|No| O[dev: implement story]\n N -->\
813
- \ O\n O --> P{QA review?}\n P -->|Yes| Q[qa: review implementation]\n\
814
- \ P -->|No| R{More stories?}\n Q --> S{QA found issues?}\n S -->|Yes|\
815
- \ T[dev: address QA feedback]\n S -->|No| R\n T --> Q\n R -->|Yes|\
816
- \ L\n R -->|No| U{Epic retrospective?}\n U -->|Yes| V[po: epic retrospective]\n\
817
- \ U -->|No| W[Project Complete]\n V --> W\n\n B -.-> B1[Optional:\
818
- \ brainstorming]\n B -.-> B2[Optional: market research]\n D -.-> D1[Optional:\
819
- \ user research]\n E -.-> E1[Optional: technical research]\n\n style\
820
- \ W fill:#90EE90\n style K fill:#ADD8E6\n style L fill:#ADD8E6\n \
821
- \ style O fill:#ADD8E6\n style D3 fill:#E6E6FA\n style D4 fill:#E6E6FA\n\
822
- \ style B fill:#FFE4B5\n style C fill:#FFE4B5\n style D fill:#FFE4B5\n\
823
- \ style E fill:#FFE4B5\n style N fill:#F0E68C\n style Q fill:#F0E68C\n\
824
- \ style V fill:#F0E68C\n```\n"
941
+ flow_diagram: |
942
+ ```mermaid
943
+ graph TD
944
+ A[Start: Greenfield Project] --> B[business-analyst: project-brief.md]
945
+ B --> C[product-manager: prd.md]
946
+ C --> D[ux-expert: front-end-spec.md]
947
+ D --> D2{Generate v0 prompt?}
948
+ D2 -->|Yes| D3[ux-expert: create v0 prompt]
949
+ D2 -->|No| E[architect: fullstack-architecture.md]
950
+ D3 --> D4[User: generate UI in v0/Lovable]
951
+ D4 --> E
952
+ E --> F{Architecture suggests PRD changes?}
953
+ F -->|Yes| G[product-manager: update prd.md]
954
+ F -->|No| H[po: validate all artifacts]
955
+ G --> H
956
+ H --> I{PO finds issues?}
957
+ I -->|Yes| J[Return to relevant agent for fixes]
958
+ I -->|No| K[po: shard documents]
959
+ J --> H
960
+
961
+ K --> L[scrum-master: create story]
962
+ L --> M{Review draft story?}
963
+ M -->|Yes| N[business-analyst/product-manager: review & approve story]
964
+ M -->|No| O[dev: implement story]
965
+ N --> O
966
+ O --> P{QA review?}
967
+ P -->|Yes| Q[qa: review implementation]
968
+ P -->|No| R{More stories?}
969
+ Q --> S{QA found issues?}
970
+ S -->|Yes| T[dev: address QA feedback]
971
+ S -->|No| R
972
+ T --> Q
973
+ R -->|Yes| L
974
+ R -->|No| U{Epic retrospective?}
975
+ U -->|Yes| V[po: epic retrospective]
976
+ U -->|No| W[Project Complete]
977
+ V --> W
978
+
979
+ B -.-> B1[Optional: brainstorming]
980
+ B -.-> B2[Optional: market research]
981
+ D -.-> D1[Optional: user research]
982
+ E -.-> E1[Optional: technical research]
983
+
984
+ style W fill:#90EE90
985
+ style K fill:#ADD8E6
986
+ style L fill:#ADD8E6
987
+ style O fill:#ADD8E6
988
+ style D3 fill:#E6E6FA
989
+ style D4 fill:#E6E6FA
990
+ style B fill:#FFE4B5
991
+ style C fill:#FFE4B5
992
+ style D fill:#FFE4B5
993
+ style E fill:#FFE4B5
994
+ style N fill:#F0E68C
995
+ style Q fill:#F0E68C
996
+ style V fill:#F0E68C
997
+ ```
998
+
825
999
  decision_guidance:
826
1000
  when_to_use:
827
1001
  - Building production-ready applications
@@ -919,18 +1093,24 @@ workflows:
919
1093
  creates: story.md
920
1094
  requires: sharded_docs
921
1095
  repeats: for_each_epic
922
- notes: "Story creation cycle:\n- scrum-master Agent (New Chat): @scrum-master\
923
- \ \u2192 *create\n- Creates next story from sharded docs\n- Story starts\
924
- \ in \"Draft\" status\n"
1096
+ notes: |
1097
+ Story creation cycle:
1098
+ - scrum-master Agent (New Chat): @scrum-master \u2192 *create
1099
+ - Creates next story from sharded docs
1100
+ - Story starts in "Draft" status
1101
+
925
1102
  - agent: business-analyst/product-manager
926
1103
  action: review_draft_story
927
1104
  updates: story.md
928
1105
  requires: story.md
929
1106
  optional: true
930
1107
  condition: user_wants_story_review
931
- notes: "OPTIONAL: Review and approve draft story\n- NOTE: story-review task\
932
- \ coming soon\n- Review story completeness and alignment\n- Update story\
933
- \ status: Draft \u2192 Approved\n"
1108
+ notes: |
1109
+ OPTIONAL: Review and approve draft story
1110
+ - NOTE: story-review task coming soon
1111
+ - Review story completeness and alignment
1112
+ - Update story status: Draft \u2192 Approved
1113
+
934
1114
  - agent: dev
935
1115
  action: implement_story
936
1116
  creates: implementation_files
@@ -949,10 +1129,13 @@ workflows:
949
1129
  updates: implementation_files
950
1130
  requires: implementation_files
951
1131
  optional: true
952
- notes: "OPTIONAL: QA Agent (New Chat): @qa \u2192 review-story\n- Senior dev\
953
- \ review with refactoring ability\n- Fixes small issues directly\n- Leaves\
954
- \ checklist for remaining items\n- Updates story status (Review \u2192 Done\
955
- \ or stays Review)\n"
1132
+ notes: |
1133
+ OPTIONAL: QA Agent (New Chat): @qa \u2192 review-story
1134
+ - Senior dev review with refactoring ability
1135
+ - Fixes small issues directly
1136
+ - Leaves checklist for remaining items
1137
+ - Updates story status (Review \u2192 Done or stays Review)
1138
+
956
1139
  - agent: dev
957
1140
  action: address_qa_feedback
958
1141
  updates: implementation_files
@@ -966,8 +1149,10 @@ workflows:
966
1149
  '
967
1150
  - step: repeat_development_cycle
968
1151
  action: continue_for_all_stories
969
- notes: "Repeat story cycle (scrum-master \u2192 Dev \u2192 QA) for all epic\
970
- \ stories\nContinue until all stories in PRD are complete\n"
1152
+ notes: |
1153
+ Repeat story cycle (scrum-master \u2192 Dev \u2192 QA) for all epic stories
1154
+ Continue until all stories in PRD are complete
1155
+
971
1156
  - agent: product-owner
972
1157
  action: epic_retrospective
973
1158
  creates: epic-retrospective.md
@@ -992,26 +1177,55 @@ workflows:
992
1177
  Reference: ../resources/data.md#IDE Development Workflow
993
1178
 
994
1179
  '
995
- flow_diagram: "```mermaid\ngraph TD\n A[Start: Service Development] --> B[business-analyst:\
996
- \ project-brief.md]\n B --> C[product-manager: prd.md]\n C --> D[architect:\
997
- \ architecture.md]\n D --> E{Architecture suggests PRD changes?}\n E\
998
- \ -->|Yes| F[product-manager: update prd.md]\n E -->|No| G[product-owner:\
999
- \ validate all artifacts]\n F --> G\n G --> H{product-owner finds issues?}\n\
1000
- \ H -->|Yes| I[Return to relevant agent for fixes]\n H -->|No| J[product-owner:\
1001
- \ shard documents]\n I --> G\n \n J --> K[scrum-master: create story]\n\
1002
- \ K --> L{Review draft story?}\n L -->|Yes| M[business-analyst/product-manager:\
1003
- \ review & approve story]\n L -->|No| N[dev: implement story]\n M -->\
1004
- \ N\n N --> O{QA review?}\n O -->|Yes| P[qa: review implementation]\n\
1005
- \ O -->|No| Q{More stories?}\n P --> R{QA found issues?}\n R -->|Yes|\
1006
- \ S[dev: address QA feedback]\n R -->|No| Q\n S --> P\n Q -->|Yes|\
1007
- \ K\n Q -->|No| T{Epic retrospective?}\n T -->|Yes| U[product-owner:\
1008
- \ epic retrospective]\n T -->|No| V[Project Complete]\n U --> V\n\n\
1009
- \ B -.-> B1[Optional: brainstorming]\n B -.-> B2[Optional: market research]\n\
1010
- \ D -.-> D1[Optional: technical research]\n\n style V fill:#90EE90\n\
1011
- \ style J fill:#ADD8E6\n style K fill:#ADD8E6\n style N fill:#ADD8E6\n\
1012
- \ style B fill:#FFE4B5\n style C fill:#FFE4B5\n style D fill:#FFE4B5\n\
1013
- \ style M fill:#F0E68C\n style P fill:#F0E68C\n style U fill:#F0E68C\n\
1014
- ```\n"
1180
+ flow_diagram: |
1181
+ ```mermaid
1182
+ graph TD
1183
+ A[Start: Service Development] --> B[business-analyst: project-brief.md]
1184
+ B --> C[product-manager: prd.md]
1185
+ C --> D[architect: architecture.md]
1186
+ D --> E{Architecture suggests PRD changes?}
1187
+ E -->|Yes| F[product-manager: update prd.md]
1188
+ E -->|No| G[product-owner: validate all artifacts]
1189
+ F --> G
1190
+ G --> H{product-owner finds issues?}
1191
+ H -->|Yes| I[Return to relevant agent for fixes]
1192
+ H -->|No| J[product-owner: shard documents]
1193
+ I --> G
1194
+
1195
+ J --> K[scrum-master: create story]
1196
+ K --> L{Review draft story?}
1197
+ L -->|Yes| M[business-analyst/product-manager: review & approve story]
1198
+ L -->|No| N[dev: implement story]
1199
+ M --> N
1200
+ N --> O{QA review?}
1201
+ O -->|Yes| P[qa: review implementation]
1202
+ O -->|No| Q{More stories?}
1203
+ P --> R{QA found issues?}
1204
+ R -->|Yes| S[dev: address QA feedback]
1205
+ R -->|No| Q
1206
+ S --> P
1207
+ Q -->|Yes| K
1208
+ Q -->|No| T{Epic retrospective?}
1209
+ T -->|Yes| U[product-owner: epic retrospective]
1210
+ T -->|No| V[Project Complete]
1211
+ U --> V
1212
+
1213
+ B -.-> B1[Optional: brainstorming]
1214
+ B -.-> B2[Optional: market research]
1215
+ D -.-> D1[Optional: technical research]
1216
+
1217
+ style V fill:#90EE90
1218
+ style J fill:#ADD8E6
1219
+ style K fill:#ADD8E6
1220
+ style N fill:#ADD8E6
1221
+ style B fill:#FFE4B5
1222
+ style C fill:#FFE4B5
1223
+ style D fill:#FFE4B5
1224
+ style M fill:#F0E68C
1225
+ style P fill:#F0E68C
1226
+ style U fill:#F0E68C
1227
+ ```
1228
+
1015
1229
  decision_guidance:
1016
1230
  when_to_use:
1017
1231
  - Building production APIs or microservices
@@ -1128,18 +1342,24 @@ workflows:
1128
1342
  creates: story.md
1129
1343
  requires: sharded_docs
1130
1344
  repeats: for_each_epic
1131
- notes: "Story creation cycle:\n- scrum-master Agent (New Chat): @scrum-master\
1132
- \ \u2192 *create\n- Creates next story from sharded docs\n- Story starts\
1133
- \ in \"Draft\" status\n"
1345
+ notes: |
1346
+ Story creation cycle:
1347
+ - scrum-master Agent (New Chat): @scrum-master \u2192 *create
1348
+ - Creates next story from sharded docs
1349
+ - Story starts in "Draft" status
1350
+
1134
1351
  - agent: business-analyst/product-manager
1135
1352
  action: review_draft_story
1136
1353
  updates: story.md
1137
1354
  requires: story.md
1138
1355
  optional: true
1139
1356
  condition: user_wants_story_review
1140
- notes: "OPTIONAL: Review and approve draft story\n- NOTE: story-review task\
1141
- \ coming soon\n- Review story completeness and alignment\n- Update story\
1142
- \ status: Draft \u2192 Approved\n"
1357
+ notes: |
1358
+ OPTIONAL: Review and approve draft story
1359
+ - NOTE: story-review task coming soon
1360
+ - Review story completeness and alignment
1361
+ - Update story status: Draft \u2192 Approved
1362
+
1143
1363
  - agent: dev
1144
1364
  action: implement_story
1145
1365
  creates: implementation_files
@@ -1158,10 +1378,13 @@ workflows:
1158
1378
  updates: implementation_files
1159
1379
  requires: implementation_files
1160
1380
  optional: true
1161
- notes: "OPTIONAL: QA Agent (New Chat): @qa \u2192 review-story\n- Senior dev\
1162
- \ review with refactoring ability\n- Fixes small issues directly\n- Leaves\
1163
- \ checklist for remaining items\n- Updates story status (Review \u2192 Done\
1164
- \ or stays Review)\n"
1381
+ notes: |
1382
+ OPTIONAL: QA Agent (New Chat): @qa \u2192 review-story
1383
+ - Senior dev review with refactoring ability
1384
+ - Fixes small issues directly
1385
+ - Leaves checklist for remaining items
1386
+ - Updates story status (Review \u2192 Done or stays Review)
1387
+
1165
1388
  - agent: dev
1166
1389
  action: address_qa_feedback
1167
1390
  updates: implementation_files
@@ -1175,8 +1398,10 @@ workflows:
1175
1398
  '
1176
1399
  - step: repeat_development_cycle
1177
1400
  action: continue_for_all_stories
1178
- notes: "Repeat story cycle (scrum-master \u2192 Dev \u2192 QA) for all epic\
1179
- \ stories\nContinue until all stories in PRD are complete\n"
1401
+ notes: |
1402
+ Repeat story cycle (scrum-master \u2192 Dev \u2192 QA) for all epic stories
1403
+ Continue until all stories in PRD are complete
1404
+
1180
1405
  - agent: po
1181
1406
  action: epic_retrospective
1182
1407
  creates: epic-retrospective.md
@@ -1201,29 +1426,64 @@ workflows:
1201
1426
  Reference: ../resources/data.md#IDE Development Workflow
1202
1427
 
1203
1428
  '
1204
- flow_diagram: "```mermaid\ngraph TD\n A[Start: UI Development] --> B[business-analyst:\
1205
- \ project-brief.md]\n B --> C[product-manager: prd.md]\n C --> D[ux-expert:\
1206
- \ front-end-spec.md]\n D --> D2{Generate v0 prompt?}\n D2 -->|Yes| D3[ux-expert:\
1207
- \ create v0 prompt]\n D2 -->|No| E[architect: front-end-architecture.md]\n\
1208
- \ D3 --> D4[User: generate UI in v0/Lovable]\n D4 --> E\n E --> F{Architecture\
1209
- \ suggests PRD changes?}\n F -->|Yes| G[product-manager: update prd.md]\n\
1210
- \ F -->|No| H[po: validate all artifacts]\n G --> H\n H --> I{PO\
1211
- \ finds issues?}\n I -->|Yes| J[Return to relevant agent for fixes]\n \
1212
- \ I -->|No| K[po: shard documents]\n J --> H\n \n K --> L[scrum-master:\
1213
- \ create story]\n L --> M{Review draft story?}\n M -->|Yes| N[business-analyst/product-manager:\
1214
- \ review & approve story]\n M -->|No| O[dev: implement story]\n N -->\
1215
- \ O\n O --> P{QA review?}\n P -->|Yes| Q[qa: review implementation]\n\
1216
- \ P -->|No| R{More stories?}\n Q --> S{QA found issues?}\n S -->|Yes|\
1217
- \ T[dev: address QA feedback]\n S -->|No| R\n T --> Q\n R -->|Yes|\
1218
- \ L\n R -->|No| U{Epic retrospective?}\n U -->|Yes| V[po: epic retrospective]\n\
1219
- \ U -->|No| W[Project Complete]\n V --> W\n\n B -.-> B1[Optional:\
1220
- \ brainstorming]\n B -.-> B2[Optional: market research]\n D -.-> D1[Optional:\
1221
- \ user research]\n E -.-> E1[Optional: technical research]\n\n style\
1222
- \ W fill:#90EE90\n style K fill:#ADD8E6\n style L fill:#ADD8E6\n \
1223
- \ style O fill:#ADD8E6\n style D3 fill:#E6E6FA\n style D4 fill:#E6E6FA\n\
1224
- \ style B fill:#FFE4B5\n style C fill:#FFE4B5\n style D fill:#FFE4B5\n\
1225
- \ style E fill:#FFE4B5\n style N fill:#F0E68C\n style Q fill:#F0E68C\n\
1226
- \ style V fill:#F0E68C\n```\n"
1429
+ flow_diagram: |
1430
+ ```mermaid
1431
+ graph TD
1432
+ A[Start: UI Development] --> B[business-analyst: project-brief.md]
1433
+ B --> C[product-manager: prd.md]
1434
+ C --> D[ux-expert: front-end-spec.md]
1435
+ D --> D2{Generate v0 prompt?}
1436
+ D2 -->|Yes| D3[ux-expert: create v0 prompt]
1437
+ D2 -->|No| E[architect: front-end-architecture.md]
1438
+ D3 --> D4[User: generate UI in v0/Lovable]
1439
+ D4 --> E
1440
+ E --> F{Architecture suggests PRD changes?}
1441
+ F -->|Yes| G[product-manager: update prd.md]
1442
+ F -->|No| H[po: validate all artifacts]
1443
+ G --> H
1444
+ H --> I{PO finds issues?}
1445
+ I -->|Yes| J[Return to relevant agent for fixes]
1446
+ I -->|No| K[po: shard documents]
1447
+ J --> H
1448
+
1449
+ K --> L[scrum-master: create story]
1450
+ L --> M{Review draft story?}
1451
+ M -->|Yes| N[business-analyst/product-manager: review & approve story]
1452
+ M -->|No| O[dev: implement story]
1453
+ N --> O
1454
+ O --> P{QA review?}
1455
+ P -->|Yes| Q[qa: review implementation]
1456
+ P -->|No| R{More stories?}
1457
+ Q --> S{QA found issues?}
1458
+ S -->|Yes| T[dev: address QA feedback]
1459
+ S -->|No| R
1460
+ T --> Q
1461
+ R -->|Yes| L
1462
+ R -->|No| U{Epic retrospective?}
1463
+ U -->|Yes| V[po: epic retrospective]
1464
+ U -->|No| W[Project Complete]
1465
+ V --> W
1466
+
1467
+ B -.-> B1[Optional: brainstorming]
1468
+ B -.-> B2[Optional: market research]
1469
+ D -.-> D1[Optional: user research]
1470
+ E -.-> E1[Optional: technical research]
1471
+
1472
+ style W fill:#90EE90
1473
+ style K fill:#ADD8E6
1474
+ style L fill:#ADD8E6
1475
+ style O fill:#ADD8E6
1476
+ style D3 fill:#E6E6FA
1477
+ style D4 fill:#E6E6FA
1478
+ style B fill:#FFE4B5
1479
+ style C fill:#FFE4B5
1480
+ style D fill:#FFE4B5
1481
+ style E fill:#FFE4B5
1482
+ style N fill:#F0E68C
1483
+ style Q fill:#F0E68C
1484
+ style V fill:#F0E68C
1485
+ ```
1486
+
1227
1487
  decision_guidance:
1228
1488
  when_to_use:
1229
1489
  - Building production frontend applications