@codemcp/workflows 6.0.1 → 6.0.3

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 (138) hide show
  1. package/package.json +3 -2
  2. package/packages/cli/dist/{dist-UGVUJIDN.js → dist-6TO57O6M.js} +3 -2
  3. package/packages/cli/dist/index.js +4 -2
  4. package/packages/cli/package.json +1 -1
  5. package/packages/cli/resources/agents/architect.yaml +61 -0
  6. package/packages/cli/resources/agents/business-analyst.yaml +60 -0
  7. package/packages/cli/resources/agents/developer.yaml +61 -0
  8. package/packages/cli/resources/templates/architecture/arc42/arc42-template-EN.md +1077 -0
  9. package/packages/cli/resources/templates/architecture/arc42/images/01_2_iso-25010-topics-EN.drawio-2023.png +0 -0
  10. package/packages/cli/resources/templates/architecture/arc42/images/01_2_iso-25010-topics-EN.drawio.png +0 -0
  11. package/packages/cli/resources/templates/architecture/arc42/images/05_building_blocks-EN.png +0 -0
  12. package/packages/cli/resources/templates/architecture/arc42/images/08-concepts-EN.drawio.png +0 -0
  13. package/packages/cli/resources/templates/architecture/arc42/images/arc42-logo.png +0 -0
  14. package/packages/cli/resources/templates/architecture/c4.md +224 -0
  15. package/packages/cli/resources/templates/architecture/freestyle.md +53 -0
  16. package/packages/cli/resources/templates/architecture/game.md +250 -0
  17. package/packages/cli/resources/templates/architecture/none.md +17 -0
  18. package/packages/cli/resources/templates/design/comprehensive.md +207 -0
  19. package/packages/cli/resources/templates/design/freestyle.md +37 -0
  20. package/packages/cli/resources/templates/design/game.md +66 -0
  21. package/packages/cli/resources/templates/design/none.md +17 -0
  22. package/packages/cli/resources/templates/requirements/ears.md +90 -0
  23. package/packages/cli/resources/templates/requirements/freestyle.md +42 -0
  24. package/packages/cli/resources/templates/requirements/game.md +162 -0
  25. package/packages/cli/resources/templates/requirements/none.md +17 -0
  26. package/packages/cli/resources/templates/skills/POWER.md +23 -0
  27. package/packages/cli/resources/templates/skills/SKILL.md +19 -0
  28. package/packages/cli/resources/workflows/adr.yaml +157 -0
  29. package/packages/cli/resources/workflows/big-bang-conversion.yaml +592 -0
  30. package/packages/cli/resources/workflows/boundary-testing.yaml +376 -0
  31. package/packages/cli/resources/workflows/bugfix.yaml +177 -0
  32. package/packages/cli/resources/workflows/business-analysis.yaml +597 -0
  33. package/packages/cli/resources/workflows/c4-analysis.yaml +471 -0
  34. package/packages/cli/resources/workflows/epcc.yaml +183 -0
  35. package/packages/cli/resources/workflows/game-beginner.yaml +434 -0
  36. package/packages/cli/resources/workflows/greenfield.yaml +201 -0
  37. package/packages/cli/resources/workflows/minor.yaml +138 -0
  38. package/packages/cli/resources/workflows/posts.yaml +193 -0
  39. package/packages/cli/resources/workflows/sdd-bugfix-crowd.yaml +608 -0
  40. package/packages/cli/resources/workflows/sdd-bugfix.yaml +381 -0
  41. package/packages/cli/resources/workflows/sdd-feature-crowd.yaml +713 -0
  42. package/packages/cli/resources/workflows/sdd-feature.yaml +471 -0
  43. package/packages/cli/resources/workflows/sdd-greenfield-crowd.yaml +336 -0
  44. package/packages/cli/resources/workflows/sdd-greenfield.yaml +463 -0
  45. package/packages/cli/resources/workflows/slides.yaml +237 -0
  46. package/packages/cli/resources/workflows/tdd.yaml +160 -0
  47. package/packages/cli/resources/workflows/waterfall.yaml +209 -0
  48. package/packages/core/package.json +1 -1
  49. package/packages/core/resources/agents/architect.yaml +61 -0
  50. package/packages/core/resources/agents/business-analyst.yaml +60 -0
  51. package/packages/core/resources/agents/developer.yaml +61 -0
  52. package/packages/core/resources/templates/architecture/arc42/arc42-template-EN.md +1077 -0
  53. package/packages/core/resources/templates/architecture/arc42/images/01_2_iso-25010-topics-EN.drawio-2023.png +0 -0
  54. package/packages/core/resources/templates/architecture/arc42/images/01_2_iso-25010-topics-EN.drawio.png +0 -0
  55. package/packages/core/resources/templates/architecture/arc42/images/05_building_blocks-EN.png +0 -0
  56. package/packages/core/resources/templates/architecture/arc42/images/08-concepts-EN.drawio.png +0 -0
  57. package/packages/core/resources/templates/architecture/arc42/images/arc42-logo.png +0 -0
  58. package/packages/core/resources/templates/architecture/c4.md +224 -0
  59. package/packages/core/resources/templates/architecture/freestyle.md +53 -0
  60. package/packages/core/resources/templates/architecture/game.md +250 -0
  61. package/packages/core/resources/templates/architecture/none.md +17 -0
  62. package/packages/core/resources/templates/design/comprehensive.md +207 -0
  63. package/packages/core/resources/templates/design/freestyle.md +37 -0
  64. package/packages/core/resources/templates/design/game.md +66 -0
  65. package/packages/core/resources/templates/design/none.md +17 -0
  66. package/packages/core/resources/templates/requirements/ears.md +90 -0
  67. package/packages/core/resources/templates/requirements/freestyle.md +42 -0
  68. package/packages/core/resources/templates/requirements/game.md +162 -0
  69. package/packages/core/resources/templates/requirements/none.md +17 -0
  70. package/packages/core/resources/templates/skills/POWER.md +23 -0
  71. package/packages/core/resources/templates/skills/SKILL.md +19 -0
  72. package/packages/core/resources/workflows/adr.yaml +157 -0
  73. package/packages/core/resources/workflows/big-bang-conversion.yaml +592 -0
  74. package/packages/core/resources/workflows/boundary-testing.yaml +376 -0
  75. package/packages/core/resources/workflows/bugfix.yaml +177 -0
  76. package/packages/core/resources/workflows/business-analysis.yaml +597 -0
  77. package/packages/core/resources/workflows/c4-analysis.yaml +471 -0
  78. package/packages/core/resources/workflows/epcc.yaml +183 -0
  79. package/packages/core/resources/workflows/game-beginner.yaml +434 -0
  80. package/packages/core/resources/workflows/greenfield.yaml +201 -0
  81. package/packages/core/resources/workflows/minor.yaml +138 -0
  82. package/packages/core/resources/workflows/posts.yaml +193 -0
  83. package/packages/core/resources/workflows/sdd-bugfix-crowd.yaml +608 -0
  84. package/packages/core/resources/workflows/sdd-bugfix.yaml +381 -0
  85. package/packages/core/resources/workflows/sdd-feature-crowd.yaml +713 -0
  86. package/packages/core/resources/workflows/sdd-feature.yaml +471 -0
  87. package/packages/core/resources/workflows/sdd-greenfield-crowd.yaml +336 -0
  88. package/packages/core/resources/workflows/sdd-greenfield.yaml +463 -0
  89. package/packages/core/resources/workflows/slides.yaml +237 -0
  90. package/packages/core/resources/workflows/tdd.yaml +160 -0
  91. package/packages/core/resources/workflows/waterfall.yaml +209 -0
  92. package/packages/docs/package.json +1 -1
  93. package/packages/mcp-server/dist/index.js +3 -2
  94. package/packages/mcp-server/package.json +1 -1
  95. package/packages/mcp-server/resources/agents/architect.yaml +61 -0
  96. package/packages/mcp-server/resources/agents/business-analyst.yaml +60 -0
  97. package/packages/mcp-server/resources/agents/developer.yaml +61 -0
  98. package/packages/mcp-server/resources/templates/architecture/arc42/arc42-template-EN.md +1077 -0
  99. package/packages/mcp-server/resources/templates/architecture/arc42/images/01_2_iso-25010-topics-EN.drawio-2023.png +0 -0
  100. package/packages/mcp-server/resources/templates/architecture/arc42/images/01_2_iso-25010-topics-EN.drawio.png +0 -0
  101. package/packages/mcp-server/resources/templates/architecture/arc42/images/05_building_blocks-EN.png +0 -0
  102. package/packages/mcp-server/resources/templates/architecture/arc42/images/08-concepts-EN.drawio.png +0 -0
  103. package/packages/mcp-server/resources/templates/architecture/arc42/images/arc42-logo.png +0 -0
  104. package/packages/mcp-server/resources/templates/architecture/c4.md +224 -0
  105. package/packages/mcp-server/resources/templates/architecture/freestyle.md +53 -0
  106. package/packages/mcp-server/resources/templates/architecture/game.md +250 -0
  107. package/packages/mcp-server/resources/templates/architecture/none.md +17 -0
  108. package/packages/mcp-server/resources/templates/design/comprehensive.md +207 -0
  109. package/packages/mcp-server/resources/templates/design/freestyle.md +37 -0
  110. package/packages/mcp-server/resources/templates/design/game.md +66 -0
  111. package/packages/mcp-server/resources/templates/design/none.md +17 -0
  112. package/packages/mcp-server/resources/templates/requirements/ears.md +90 -0
  113. package/packages/mcp-server/resources/templates/requirements/freestyle.md +42 -0
  114. package/packages/mcp-server/resources/templates/requirements/game.md +162 -0
  115. package/packages/mcp-server/resources/templates/requirements/none.md +17 -0
  116. package/packages/mcp-server/resources/templates/skills/POWER.md +23 -0
  117. package/packages/mcp-server/resources/templates/skills/SKILL.md +19 -0
  118. package/packages/mcp-server/resources/workflows/adr.yaml +157 -0
  119. package/packages/mcp-server/resources/workflows/big-bang-conversion.yaml +592 -0
  120. package/packages/mcp-server/resources/workflows/boundary-testing.yaml +376 -0
  121. package/packages/mcp-server/resources/workflows/bugfix.yaml +177 -0
  122. package/packages/mcp-server/resources/workflows/business-analysis.yaml +597 -0
  123. package/packages/mcp-server/resources/workflows/c4-analysis.yaml +471 -0
  124. package/packages/mcp-server/resources/workflows/epcc.yaml +183 -0
  125. package/packages/mcp-server/resources/workflows/game-beginner.yaml +434 -0
  126. package/packages/mcp-server/resources/workflows/greenfield.yaml +201 -0
  127. package/packages/mcp-server/resources/workflows/minor.yaml +138 -0
  128. package/packages/mcp-server/resources/workflows/posts.yaml +193 -0
  129. package/packages/mcp-server/resources/workflows/sdd-bugfix-crowd.yaml +608 -0
  130. package/packages/mcp-server/resources/workflows/sdd-bugfix.yaml +381 -0
  131. package/packages/mcp-server/resources/workflows/sdd-feature-crowd.yaml +713 -0
  132. package/packages/mcp-server/resources/workflows/sdd-feature.yaml +471 -0
  133. package/packages/mcp-server/resources/workflows/sdd-greenfield-crowd.yaml +336 -0
  134. package/packages/mcp-server/resources/workflows/sdd-greenfield.yaml +463 -0
  135. package/packages/mcp-server/resources/workflows/slides.yaml +237 -0
  136. package/packages/mcp-server/resources/workflows/tdd.yaml +160 -0
  137. package/packages/mcp-server/resources/workflows/waterfall.yaml +209 -0
  138. package/packages/visualizer/package.json +1 -1
@@ -0,0 +1,592 @@
1
+ # yaml-language-server: $schema=../state-machine-schema.json
2
+ ---
3
+ name: 'big-bang-conversion'
4
+ description: 'A comprehensive workflow for executing test-driven big-bang conversion of legacy systems. Focuses on complete system replacement with behavioral validation and conversion readiness.'
5
+ initial_state: 'conversion_planning'
6
+
7
+ # Enhanced metadata for better discoverability
8
+ metadata:
9
+ domain: 'architecture'
10
+ complexity: 'high'
11
+ bestFor:
12
+ - 'Complete system replacement'
13
+ - 'Big-bang technology migration'
14
+ - 'Test-driven conversion execution'
15
+ - 'Legacy system modernization'
16
+ useCases:
17
+ - 'Convert legacy system to modern technology stack'
18
+ - 'Execute complete system replacement with validation'
19
+ - 'Implement new system with behavioral equivalence'
20
+ examples:
21
+ - 'Convert Smalltalk system to Java with full replacement'
22
+ - 'Migrate monolith to microservices architecture'
23
+ - 'Replace legacy technology with modern stack'
24
+
25
+ # States with default instructions and transitions
26
+ states:
27
+ conversion_planning:
28
+ description: 'Plan the complete system replacement strategy and approach'
29
+ default_instructions: >
30
+ **STEP 1: Reference Architecture Documentation**
31
+ - Check if `$ARCHITECTURE_DOC` exists
32
+ - Review current system understanding from documentation
33
+ - If unavailable, search for architecture docs (README.md, docs/, ARCHITECTURE.md)
34
+ - Enhance `$ARCHITECTURE_DOC` with your findings
35
+
36
+ **STEP 2: Analyze Current System**
37
+ - Examine codebase to understand system architecture
38
+ - Review existing boundary tests and system baselines if available
39
+ - Document current functionality and constraints
40
+
41
+ **STEP 3: Define Conversion Scope**
42
+ - Establish what will be replaced
43
+ - Identify what will remain unchanged
44
+ - Document scope boundaries clearly
45
+
46
+ **STEP 4: Plan Conversion Strategy**
47
+ - Design the approach for complete system replacement
48
+ - Identify risks and mitigation strategies
49
+ - Establish realistic timeline for conversion execution
50
+
51
+ **STEP 5: Interview the User (Business & Operational Context)**
52
+ - What business constraints or deadlines apply to this conversion?
53
+ - What is the acceptable downtime window?
54
+ - What are the rollback criteria if conversion encounters issues?
55
+
56
+ **STEP 6: Apply Best Practices**
57
+ - Plan every aspect of conversion thoroughly
58
+ - Identify and plan for potential failure scenarios
59
+ - Have a plan to revert if conversion fails
60
+ - Keep all stakeholders informed of the plan
61
+ - Plan validation checkpoints throughout conversion
62
+ - Ensure adequate resources for conversion execution
63
+
64
+ Update the plan file with conversion planning decisions and mark completed tasks.
65
+ transitions:
66
+ - trigger: 'continue_planning'
67
+ to: 'conversion_planning'
68
+ transition_reason: 'Conversion planning needs more refinement and detail'
69
+
70
+ - trigger: 'planning_complete'
71
+ to: 'target_architecture_design'
72
+ transition_reason: 'Conversion strategy is planned, ready for target architecture design'
73
+
74
+ target_architecture_design:
75
+ description: 'Design the architecture for the new system in target technology'
76
+ default_instructions: >
77
+ **STEP 1: Reference Architecture Documentation**
78
+ - If `$ARCHITECTURE_DOC` exists: Review current system understanding from it
79
+ - Otherwise: Elaborate architectural options and present them to the user
80
+
81
+ **STEP 2: Create/Update Design Documentation**
82
+ - If `$DESIGN_DOC` exists: Reference it for existing design decisions
83
+ - Otherwise: Document design decisions in the plan file
84
+
85
+ **STEP 3: Analyze Current Architecture**
86
+ - Examine existing system architecture and patterns
87
+ - Identify architectural constraints and requirements
88
+
89
+ **STEP 4: Select Technology Stack**
90
+ - Finalize the target technology stack and frameworks
91
+ - Align with organizational technology standards
92
+
93
+ **STEP 5: Design Architecture Patterns**
94
+ - Choose appropriate architectural patterns for new system
95
+ - Design component reimplementation approach
96
+ - Plan external system integration strategy
97
+ - Design data storage and management approach
98
+ - Plan deployment and operational architecture
99
+
100
+ **STEP 6: Interview the User (Requirements & Constraints)**
101
+ - What are the performance requirements for the new system?
102
+ - Are there any scalability requirements we need to design for?
103
+ - Are there any budget constraints that affect technology choices?
104
+
105
+ **STEP 7: Apply Best Practices**
106
+ - Leverage modern architectural approaches
107
+ - Design for future growth and scalability
108
+ - Choose patterns that improve long-term maintainability
109
+ - Align with organizational technology standards
110
+ - Design for optimal performance characteristics
111
+ - Incorporate security considerations from the start
112
+
113
+ **STEP 8: Validate Design Framework**
114
+ - Ensure new architecture supports all current functionality
115
+ - Apply microservices, event-driven, or other modern patterns as appropriate
116
+ - Follow best practices for the target technology stack
117
+ - Design clean integration patterns with external systems
118
+ - Plan data migration from current system to new system
119
+
120
+ Update the plan file with architecture design decisions and validate with the user.
121
+ transitions:
122
+ - trigger: 'refine_architecture'
123
+ to: 'target_architecture_design'
124
+ transition_reason: 'Architecture design needs refinement based on user feedback'
125
+
126
+ - trigger: 'need_more_planning'
127
+ to: 'conversion_planning'
128
+ additional_instructions: 'Architecture design revealed issues with conversion planning. Refine the conversion strategy based on architectural insights.'
129
+ transition_reason: 'Architecture work revealed need to refine conversion planning'
130
+
131
+ - trigger: 'architecture_complete'
132
+ to: 'behavioral_comparison_setup'
133
+ transition_reason: 'Target architecture is designed, ready for behavioral comparison setup'
134
+
135
+ behavioral_comparison_setup:
136
+ description: 'Set up mechanisms to compare behavior between current and new systems'
137
+ default_instructions: >
138
+ **STEP 1: Design Comparison Strategy**
139
+ - Design approach for comparing current and new system behavior
140
+ - Choose appropriate comparison mechanisms for your infrastructure
141
+ - Plan how to implement the chosen comparison approach
142
+
143
+ **STEP 2: Design Data Capture**
144
+ - Design how to capture system behavior
145
+ - Design how to compare behavior between systems
146
+ - Define what constitutes successful behavioral equivalence
147
+
148
+ **STEP 3: Plan Automation**
149
+ - Plan automated comparison processes
150
+ - Plan automated validation processes
151
+ - Define measurement and reporting mechanisms
152
+
153
+ **STEP 4: Suggest Best Practice Mechanisms**
154
+ - Sidecar Pattern: Deploy comparison logic alongside applications
155
+ - Proxy/Gateway: Route traffic through comparison proxy
156
+ - Shadow Traffic: Send duplicate traffic to both systems
157
+ - Event Streaming: Compare system events and state changes
158
+ - API Response Comparison: Compare API responses between systems
159
+ - Database State Comparison: Compare database states after operations
160
+ - Log Analysis: Compare system logs and behavior patterns
161
+ - Synthetic Testing: Use automated tests to compare behavior
162
+
163
+ **STEP 5: Recommend Implementation Approaches**
164
+ - Traffic Mirroring: Mirror production traffic to new system
165
+ - Parallel Execution: Run both systems in parallel with comparison
166
+ - Staged Rollout: Gradually shift traffic while comparing
167
+ - A/B Testing: Compare systems with controlled traffic splits
168
+ - Canary Deployment: Test new system with small traffic percentage
169
+
170
+ **STEP 6: Interview the User (Infrastructure & Operational Context)**
171
+ - What level of traffic or load do you need to validate against?
172
+ - Are there any operational constraints for running parallel systems?
173
+
174
+ Update the plan file with comparison setup decisions.
175
+ transitions:
176
+ - trigger: 'refine_comparison'
177
+ to: 'behavioral_comparison_setup'
178
+ transition_reason: 'Comparison setup needs refinement based on user feedback'
179
+
180
+ - trigger: 'need_architecture_refinement'
181
+ to: 'target_architecture_design'
182
+ additional_instructions: 'Comparison setup revealed issues with target architecture. Refine the architecture design to better support behavioral comparison.'
183
+ transition_reason: 'Comparison work revealed need to refine target architecture'
184
+
185
+ - trigger: 'comparison_setup_complete'
186
+ to: 'implementation_strategy'
187
+ transition_reason: 'Comparison mechanisms are designed, ready for implementation strategy'
188
+
189
+ implementation_strategy:
190
+ description: 'Plan detailed implementation approach for the new system'
191
+ default_instructions: >
192
+ **STEP 1: Reference Design Documentation**
193
+ - If `$DESIGN_DOC` exists: Check it for target architecture and design decisions
194
+ - Otherwise: Elaborate design options and present them to the user
195
+ - Review implementation constraints and requirements
196
+
197
+ **STEP 2: Break Down Implementation**
198
+ - Break implementation into manageable phases
199
+ - Define logical phases that deliver business value
200
+ - Establish sequence and dependencies
201
+
202
+ **STEP 3: Plan Development Approach**
203
+ - Plan development methodology and practices
204
+ - Plan testing and quality assurance throughout implementation
205
+ - Plan how development team will coordinate work
206
+
207
+ **STEP 4: Plan Integration Strategy**
208
+ - Plan how to integrate new components as they're built
209
+ - Plan regular validation against functional equivalence
210
+ - Plan continuous integration and testing practices
211
+
212
+ **STEP 5: Plan Risk Management**
213
+ - Identify highest risks first
214
+ - Address implementation risks systematically
215
+ - Plan contingency approaches for high-risk areas
216
+
217
+ **STEP 6: Interview the User (Team & Process)**
218
+ - What development methodology does your team prefer (Agile, Scrum, etc.)?
219
+ - How large is the development team for this conversion?
220
+
221
+ **STEP 7: Apply Best Practices**
222
+ - Build and validate incrementally
223
+ - Integrate and test frequently
224
+ - Write tests before implementation
225
+ - Maintain high code quality standards
226
+ - Document decisions and implementation details
227
+ - Validate against legacy system frequently
228
+
229
+ **STEP 8: Create Strategy Framework**
230
+ - Define logical phases that deliver business value
231
+ - Establish regular checkpoints to validate functional equivalence
232
+ - Plan comprehensive testing at each phase
233
+ - Address highest risks first
234
+ - Establish clear communication and coordination processes
235
+ - Define measurable progress indicators
236
+
237
+ Update the plan file with implementation strategy and validate with the user.
238
+ transitions:
239
+ - trigger: 'refine_strategy'
240
+ to: 'implementation_strategy'
241
+ transition_reason: 'Implementation strategy needs refinement based on user feedback'
242
+
243
+ - trigger: 'need_comparison_refinement'
244
+ to: 'behavioral_comparison_setup'
245
+ additional_instructions: 'Implementation strategy revealed issues with comparison setup. Refine the behavioral comparison mechanisms based on implementation insights.'
246
+ transition_reason: 'Implementation work revealed need to refine comparison setup'
247
+
248
+ - trigger: 'strategy_complete'
249
+ to: 'parallel_implementation'
250
+ transition_reason: 'Implementation strategy is complete, ready for parallel implementation'
251
+
252
+ parallel_implementation:
253
+ description: 'Build new system while maintaining test compatibility and validation'
254
+ default_instructions: >
255
+ **STEP 1: Reference Design Documentation**
256
+ - If `$DESIGN_DOC` exists: Check it for implementation guidance and architectural decisions
257
+ - Otherwise: Elaborate implementation options and present them to the user
258
+
259
+ **STEP 2: Build System Components**
260
+ - Build new system components according to implementation strategy
261
+ - Ensure new system passes existing functional equivalence tests
262
+ - Validate new system behavior against legacy system regularly
263
+
264
+ **STEP 3: Maintain Quality Standards**
265
+ - Maintain high code quality and testing standards
266
+ - Test integration between new components as they're built
267
+ - Ensure new system meets performance requirements
268
+
269
+ **STEP 4: Document Implementation**
270
+ - Document implementation decisions as they're made
271
+ - Document system behavior and design rationale
272
+ - Keep implementation documentation current
273
+
274
+ **STEP 5: Interview the User (Implementation Priorities)**
275
+ - Which components or business domains should we implement first?
276
+
277
+ **STEP 6: Apply Best Practices**
278
+ - Build and validate one component at a time
279
+ - Run tests continuously as implementation progresses
280
+ - Integrate new components frequently
281
+ - Monitor performance throughout implementation
282
+ - Maintain code quality through regular reviews
283
+ - Keep implementation documentation current
284
+
285
+ **STEP 7: Follow Implementation Guidelines**
286
+ - Start with core business functionality
287
+ - Validate each component against existing tests
288
+ - Maintain backward compatibility during development
289
+ - Use feature flags for gradual rollout
290
+ - Monitor system behavior continuously
291
+ - Address performance issues early
292
+
293
+ Update the plan file with implementation progress and mark completed tasks.
294
+ transitions:
295
+ - trigger: 'continue_implementation'
296
+ to: 'parallel_implementation'
297
+ transition_reason: 'Implementation continues with more components to build'
298
+
299
+ - trigger: 'need_strategy_refinement'
300
+ to: 'implementation_strategy'
301
+ additional_instructions: 'Implementation revealed issues with the strategy. Refine the implementation approach based on development learnings.'
302
+ transition_reason: 'Implementation work revealed need to refine strategy'
303
+
304
+ - trigger: 'implementation_complete'
305
+ to: 'conversion_readiness'
306
+ additional_instructions: |
307
+ Create the CONVERSION_PLAN.md file at .vibe/CONVERSION_PLAN.md with this exact template content:
308
+
309
+ ```markdown
310
+ # Big-Bang Conversion Plan
311
+
312
+ *This document provides post-completion guidance for executing the big-bang conversion in production. It serves as an actionable checklist for operations teams to execute the conversion outside of the development conversation.*
313
+
314
+ ## Conversion Overview
315
+
316
+ ### System Information
317
+ - **Legacy System**: [Description of current system]
318
+ - **Target System**: [Description of new system]
319
+ - **Technology Migration**: [From X to Y technology stack]
320
+ - **Conversion Date**: [Planned conversion date]
321
+ - **Rollback Deadline**: [Maximum time before rollback decision]
322
+
323
+ ### Conversion Scope
324
+ - **Components Being Replaced**: [List of components]
325
+ - **Components Remaining**: [List of unchanged components]
326
+ - **Data Migration Required**: [Yes/No and details]
327
+ - **External System Updates**: [List of external systems requiring updates]
328
+
329
+ ## Pre-Conversion Checklist
330
+
331
+ ### Test Suite Validation
332
+ - [ ] All boundary tests pass on legacy system (baseline established)
333
+ - [ ] All boundary tests pass on new system (functional equivalence proven)
334
+ - [ ] Performance tests meet requirements on new system
335
+ - [ ] Integration tests with external systems pass
336
+ - [ ] Error handling tests validate identical behavior
337
+ - [ ] Edge case and boundary condition tests pass
338
+
339
+ ### Behavioral Comparison Validation
340
+ - [ ] Behavioral comparison mechanism is operational
341
+ - [ ] Comparison validation shows functional equivalence
342
+ - [ ] Performance comparison meets requirements
343
+ - [ ] Error handling comparison validates identical behavior
344
+ - [ ] Data consistency validation passes
345
+
346
+ ### Infrastructure Readiness
347
+ - [ ] Production environment for new system is ready
348
+ - [ ] Database migration scripts are tested and ready
349
+ - [ ] Network configuration supports new system
350
+ - [ ] Security configurations are validated
351
+ - [ ] Monitoring and alerting are configured
352
+ - [ ] Backup and recovery procedures are tested
353
+
354
+ ### Team Readiness
355
+ - [ ] Operations team trained on new system
356
+ - [ ] Support team has new system documentation
357
+ - [ ] Rollback procedures are documented and understood
358
+ - [ ] Communication plan is ready for stakeholders
359
+ - [ ] Emergency contacts and escalation procedures defined
360
+
361
+ ## Conversion Execution Plan
362
+
363
+ ### Phase 1: Pre-Conversion (T-2 hours)
364
+ - [ ] **Freeze Legacy System**: Stop all non-critical changes to legacy system
365
+ - [ ] **Final Backup**: Create final backup of legacy system and data
366
+ - [ ] **Team Assembly**: Assemble conversion team and establish communication
367
+ - [ ] **Final Validation**: Run final test suite validation on both systems
368
+ - [ ] **Go/No-Go Decision**: Make final decision to proceed with conversion
369
+
370
+ ### Phase 2: Traffic Cutover (T-0)
371
+ - [ ] **Enable Behavioral Comparison**: Start behavioral comparison mechanism
372
+ - [ ] **Traffic Routing**: Route traffic from legacy to new system
373
+ - [ ] **Database Cutover**: Switch database connections to new system
374
+ - [ ] **External System Updates**: Update external systems to use new endpoints
375
+ - [ ] **Legacy System Isolation**: Isolate legacy system from production traffic
376
+
377
+ ### Phase 3: Validation (T+15 minutes)
378
+ - [ ] **Functional Validation**: Verify all critical functions work correctly
379
+ - [ ] **Performance Validation**: Confirm performance meets requirements
380
+ - [ ] **Integration Validation**: Verify external system integrations work
381
+ - [ ] **Error Handling Validation**: Test error scenarios work correctly
382
+ - [ ] **User Acceptance**: Confirm user-facing functionality works
383
+
384
+ ### Phase 4: Monitoring (T+1 hour)
385
+ - [ ] **System Monitoring**: Monitor new system performance and errors
386
+ - [ ] **Behavioral Comparison**: Validate ongoing behavioral equivalence
387
+ - [ ] **User Feedback**: Monitor user feedback and support requests
388
+ - [ ] **Performance Metrics**: Validate performance metrics meet requirements
389
+ - [ ] **Stability Assessment**: Assess overall system stability
390
+
391
+ ## Rollback Procedures
392
+
393
+ ### Rollback Triggers
394
+ - Critical functionality failure in new system
395
+ - Performance degradation beyond acceptable limits
396
+ - Data integrity issues discovered
397
+ - Security vulnerabilities identified
398
+ - User-impacting errors that cannot be quickly resolved
399
+
400
+ ### Rollback Execution (if needed)
401
+ - [ ] **Stop New System**: Immediately stop traffic to new system
402
+ - [ ] **Restore Legacy System**: Restore legacy system to production
403
+ - [ ] **Database Rollback**: Restore database to pre-conversion state
404
+ - [ ] **External System Revert**: Revert external systems to legacy endpoints
405
+ - [ ] **Communication**: Notify stakeholders of rollback execution
406
+ - [ ] **Post-Mortem Planning**: Plan post-mortem analysis of rollback
407
+
408
+ ### Rollback Validation
409
+ - [ ] **Functional Validation**: Verify legacy system functions correctly
410
+ - [ ] **Data Integrity**: Validate data integrity after rollback
411
+ - [ ] **Integration Validation**: Verify external integrations work
412
+ - [ ] **Performance Validation**: Confirm performance is restored
413
+ - [ ] **User Communication**: Communicate status to users
414
+
415
+ ## Post-Conversion Activities
416
+
417
+ ### Success Validation (T+24 hours)
418
+ - [ ] **24-Hour Stability**: Confirm system stability over 24 hours
419
+ - [ ] **Performance Validation**: Validate sustained performance
420
+ - [ ] **User Acceptance**: Confirm user satisfaction with new system
421
+ - [ ] **Support Metrics**: Review support ticket volume and types
422
+ - [ ] **Behavioral Comparison**: Validate continued functional equivalence
423
+
424
+ ### Legacy System Decommission (T+1 week)
425
+ - [ ] **Final Data Backup**: Create final backup of legacy system
426
+ - [ ] **System Shutdown**: Safely shutdown legacy system
427
+ - [ ] **Resource Cleanup**: Clean up legacy system resources
428
+ - [ ] **Documentation Archive**: Archive legacy system documentation
429
+ - [ ] **Team Notification**: Notify teams of successful decommission
430
+
431
+ ### Post-Conversion Review (T+2 weeks)
432
+ - [ ] **Conversion Review**: Conduct post-conversion review meeting
433
+ - [ ] **Lessons Learned**: Document lessons learned from conversion
434
+ - [ ] **Process Improvement**: Identify improvements for future conversions
435
+ - [ ] **Team Recognition**: Recognize team contributions to successful conversion
436
+ - [ ] **Documentation Update**: Update procedures based on experience
437
+
438
+ ## Emergency Contacts
439
+
440
+ ### Conversion Team
441
+ - **Conversion Lead**: [Name, Phone, Email]
442
+ - **Technical Lead**: [Name, Phone, Email]
443
+ - **Operations Lead**: [Name, Phone, Email]
444
+ - **Database Administrator**: [Name, Phone, Email]
445
+
446
+ ### Escalation Contacts
447
+ - **Engineering Manager**: [Name, Phone, Email]
448
+ - **Operations Manager**: [Name, Phone, Email]
449
+ - **Business Stakeholder**: [Name, Phone, Email]
450
+ - **Executive Sponsor**: [Name, Phone, Email]
451
+
452
+ ### External Contacts
453
+ - **Infrastructure Support**: [Contact Information]
454
+ - **Database Support**: [Contact Information]
455
+ - **Network Support**: [Contact Information]
456
+ - **Security Team**: [Contact Information]
457
+
458
+ ## Risk Mitigation
459
+
460
+ ### High-Risk Scenarios
461
+ - **Data Loss**: [Mitigation strategy and recovery procedures]
462
+ - **Extended Downtime**: [Mitigation strategy and communication plan]
463
+ - **Performance Degradation**: [Mitigation strategy and scaling procedures]
464
+ - **Security Breach**: [Mitigation strategy and incident response]
465
+ - **Integration Failure**: [Mitigation strategy and fallback procedures]
466
+
467
+ ### Contingency Plans
468
+ - **Partial Rollback**: [Procedures for rolling back specific components]
469
+ - **Extended Validation**: [Procedures for extended validation period]
470
+ - **Gradual Cutover**: [Procedures for gradual traffic migration]
471
+ - **Emergency Support**: [Procedures for emergency support escalation]
472
+
473
+ ## Success Criteria
474
+
475
+ ### Technical Success Criteria
476
+ - All functional tests pass on new system
477
+ - Performance meets or exceeds legacy system
478
+ - No data integrity issues
479
+ - All integrations function correctly
480
+ - Error rates within acceptable limits
481
+
482
+ ### Business Success Criteria
483
+ - No business disruption during conversion
484
+ - User satisfaction maintained or improved
485
+ - Support ticket volume within normal range
486
+ - All critical business functions operational
487
+ - Stakeholder approval of conversion success
488
+
489
+ ---
490
+
491
+ ## Instructions for Use
492
+
493
+ **Purpose**: This document provides actionable guidance for executing the big-bang conversion in production environments outside of development conversations.
494
+
495
+ **For Operations Teams**:
496
+ - Use this as a checklist during conversion execution
497
+ - Follow phases sequentially and validate each step
498
+ - Have rollback procedures ready at all times
499
+ - Maintain communication throughout the process
500
+
501
+ **For Management**:
502
+ - Use this to understand conversion scope and risks
503
+ - Monitor progress through defined checkpoints
504
+ - Be prepared for go/no-go decisions
505
+ - Support team with necessary resources
506
+
507
+ **Post-Conversion**: This document serves as a record of the conversion process and can be used to improve future conversion procedures.
508
+
509
+ ---
510
+
511
+ *This conversion plan was created during the big-bang-conversion workflow and provides comprehensive guidance for production execution of the system conversion.*
512
+ ```
513
+
514
+ Now validate the new system and prepare for production conversion readiness.
515
+ Update the plan file with conversion readiness tasks and mark completed implementation tasks.
516
+ transition_reason: 'New system implementation complete, ready for conversion readiness validation'
517
+
518
+ conversion_readiness:
519
+ description: 'Validate conversion readiness and finalize preparation for production execution'
520
+ default_instructions: >
521
+ The `CONVERSION_PLAN.md` file has been created at `.vibe/CONVERSION_PLAN.md`.
522
+
523
+ **STEP 1: Validate System Functionality**
524
+ - Validate that new system passes all functional equivalence tests
525
+ - Ensure behavioral comparison mechanisms work correctly
526
+ - Verify new system meets performance requirements
527
+
528
+ **STEP 2: Validate Integrations**
529
+ - Validate all external system integrations work correctly
530
+ - Test integration endpoints and data flows
531
+ - Confirm integration error handling works properly
532
+
533
+ **STEP 3: Review Conversion Plan**
534
+ - Review `.vibe/CONVERSION_PLAN.md` for completeness
535
+ - Customize the plan for your specific environment
536
+ - Ensure rollback procedures are documented and tested
537
+
538
+ **STEP 4: Ensure Team Readiness**
539
+ - Confirm operations team is ready for production conversion
540
+ - Verify all teams have necessary documentation
541
+ - Confirm emergency contacts and escalation procedures are defined
542
+
543
+ **STEP 5: Assess Final Readiness**
544
+ - Make final assessment of conversion readiness
545
+ - Identify and address any remaining concerns
546
+ - Validate all risk mitigation strategies are in place
547
+
548
+ **STEP 6: Review and Present Findings to User**
549
+ - Review new system functional equivalence test results
550
+ - Present behavioral comparison mechanism status
551
+ - Review `CONVERSION_PLAN.md` customization needs
552
+ - Present final conversion readiness assessment
553
+
554
+ **STEP 7: Apply Best Practices**
555
+ - Validate every aspect of system readiness
556
+ - Assess and mitigate all identified risks
557
+ - Ensure all teams are prepared for conversion
558
+ - Ensure all documentation is complete and accurate
559
+ - Have backup plans for all scenarios
560
+ - Keep stakeholders informed of readiness status
561
+
562
+ **STEP 8: Verify Conversion Readiness Checklist**
563
+ - New system passes all boundary tests (functional equivalence proven)
564
+ - Behavioral comparison mechanism validates system equivalence
565
+ - Performance requirements are met or exceeded
566
+ - All external integrations work correctly
567
+ - `CONVERSION_PLAN.md` is customized for your environment
568
+ - Operations team is trained and ready
569
+ - Rollback procedures are tested and ready
570
+
571
+ **STEP 9: Confirm Final Deliverables**
572
+ - Fully functional new system with proven equivalence
573
+ - Operational behavioral comparison mechanism
574
+ - Comprehensive `CONVERSION_PLAN.md` for production execution
575
+ - Validated rollback procedures
576
+ - Ready operations team
577
+
578
+ Update the plan file with readiness validation results and mark completed tasks.
579
+ transitions:
580
+ - trigger: 'refine_readiness'
581
+ to: 'conversion_readiness'
582
+ transition_reason: 'Conversion readiness needs additional validation and refinement'
583
+
584
+ - trigger: 'need_more_implementation'
585
+ to: 'parallel_implementation'
586
+ additional_instructions: 'Readiness validation revealed issues requiring additional implementation. Focus on addressing the identified gaps in system functionality.'
587
+ transition_reason: 'Readiness validation revealed need for additional implementation'
588
+
589
+ - trigger: 'conversion_ready'
590
+ to: 'conversion_readiness'
591
+ additional_instructions: 'Big-bang conversion workflow complete! System ready for production conversion using CONVERSION_PLAN.md guidance.'
592
+ transition_reason: 'System conversion readiness validated, ready for production execution'