@codemcp/workflows 6.4.0 → 6.5.1

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 (134) hide show
  1. package/package.json +2 -2
  2. package/packages/cli/dist/{chunk-D2Q6Y3QQ.js → chunk-4AZGS2GG.js} +321 -388
  3. package/packages/cli/dist/{cli-DXJJF56V.js → cli-ZCCFBQTP.js} +3 -3
  4. package/packages/cli/dist/{dist-W7PPKVFG.js → dist-I6VSREAJ.js} +11 -5
  5. package/packages/cli/dist/{dist-W7VMGB3G.js → dist-MW7THWM3.js} +875 -1136
  6. package/packages/cli/dist/index.js +2 -2
  7. package/packages/cli/package.json +1 -1
  8. package/packages/cli/resources/workflows/bugfix.yaml +14 -0
  9. package/packages/cli/resources/workflows/epcc.yaml +12 -0
  10. package/packages/cli/resources/workflows/greenfield.yaml +16 -0
  11. package/packages/cli/resources/workflows/minor.yaml +8 -0
  12. package/packages/cli/resources/workflows/tdd.yaml +10 -0
  13. package/packages/cli/resources/workflows/waterfall.yaml +16 -0
  14. package/packages/core/dist/beads-integration.d.ts +3 -5
  15. package/packages/core/dist/beads-integration.js +29 -35
  16. package/packages/core/dist/beads-integration.js.map +1 -1
  17. package/packages/core/dist/beads-state-manager.d.ts +3 -1
  18. package/packages/core/dist/beads-state-manager.js +17 -15
  19. package/packages/core/dist/beads-state-manager.js.map +1 -1
  20. package/packages/core/dist/file-detection-manager.js +15 -22
  21. package/packages/core/dist/file-detection-manager.js.map +1 -1
  22. package/packages/core/dist/index.d.ts +1 -0
  23. package/packages/core/dist/index.js +1 -0
  24. package/packages/core/dist/index.js.map +1 -1
  25. package/packages/core/dist/instruction-generator.d.ts +3 -7
  26. package/packages/core/dist/instruction-generator.js +17 -25
  27. package/packages/core/dist/instruction-generator.js.map +1 -1
  28. package/packages/core/dist/interfaces/instruction-generator.interface.d.ts +13 -4
  29. package/packages/core/dist/interfaces/plan-manager.interface.d.ts +9 -0
  30. package/packages/core/dist/logger.d.ts +49 -20
  31. package/packages/core/dist/logger.js +65 -141
  32. package/packages/core/dist/logger.js.map +1 -1
  33. package/packages/core/dist/plan-manager.d.ts +6 -4
  34. package/packages/core/dist/plan-manager.js +19 -15
  35. package/packages/core/dist/plan-manager.js.map +1 -1
  36. package/packages/core/dist/project-docs-manager.d.ts +3 -1
  37. package/packages/core/dist/project-docs-manager.js +11 -9
  38. package/packages/core/dist/project-docs-manager.js.map +1 -1
  39. package/packages/core/dist/state-machine-loader.d.ts +16 -0
  40. package/packages/core/dist/state-machine-loader.js +29 -0
  41. package/packages/core/dist/state-machine-loader.js.map +1 -1
  42. package/packages/core/dist/state-machine-types.d.ts +8 -0
  43. package/packages/core/dist/string-utils.d.ts +8 -0
  44. package/packages/core/dist/string-utils.js +14 -0
  45. package/packages/core/dist/string-utils.js.map +1 -0
  46. package/packages/core/dist/task-backend.d.ts +6 -3
  47. package/packages/core/dist/task-backend.js +10 -8
  48. package/packages/core/dist/task-backend.js.map +1 -1
  49. package/packages/core/dist/transition-engine.d.ts +3 -6
  50. package/packages/core/dist/transition-engine.js +31 -76
  51. package/packages/core/dist/transition-engine.js.map +1 -1
  52. package/packages/core/dist/workflow-manager.d.ts +2 -0
  53. package/packages/core/dist/workflow-manager.js +14 -2
  54. package/packages/core/dist/workflow-manager.js.map +1 -1
  55. package/packages/core/package.json +1 -1
  56. package/packages/core/resources/workflows/bugfix.yaml +14 -0
  57. package/packages/core/resources/workflows/epcc.yaml +12 -0
  58. package/packages/core/resources/workflows/greenfield.yaml +16 -0
  59. package/packages/core/resources/workflows/minor.yaml +8 -0
  60. package/packages/core/resources/workflows/tdd.yaml +10 -0
  61. package/packages/core/resources/workflows/waterfall.yaml +16 -0
  62. package/packages/docs/.vitepress/dist/workflows/bugfix.yaml +14 -0
  63. package/packages/docs/.vitepress/dist/workflows/epcc.yaml +12 -0
  64. package/packages/docs/.vitepress/dist/workflows/greenfield.yaml +16 -0
  65. package/packages/docs/.vitepress/dist/workflows/minor.yaml +8 -0
  66. package/packages/docs/.vitepress/dist/workflows/tdd.yaml +10 -0
  67. package/packages/docs/.vitepress/dist/workflows/waterfall.yaml +16 -0
  68. package/packages/docs/package.json +1 -1
  69. package/packages/mcp-server/dist/index.d.ts +1027 -0
  70. package/packages/mcp-server/dist/index.js +879 -1140
  71. package/packages/mcp-server/package.json +1 -1
  72. package/packages/mcp-server/resources/workflows/bugfix.yaml +14 -0
  73. package/packages/mcp-server/resources/workflows/epcc.yaml +12 -0
  74. package/packages/mcp-server/resources/workflows/greenfield.yaml +16 -0
  75. package/packages/mcp-server/resources/workflows/minor.yaml +8 -0
  76. package/packages/mcp-server/resources/workflows/tdd.yaml +10 -0
  77. package/packages/mcp-server/resources/workflows/waterfall.yaml +16 -0
  78. package/packages/opencode-plugin/dist/index.d.ts +220 -0
  79. package/packages/opencode-plugin/dist/index.js +28616 -0
  80. package/packages/opencode-plugin/package.json +55 -0
  81. package/packages/opencode-plugin/resources/agents/architect.yaml +61 -0
  82. package/packages/opencode-plugin/resources/agents/business-analyst.yaml +60 -0
  83. package/packages/opencode-plugin/resources/agents/developer.yaml +61 -0
  84. package/packages/opencode-plugin/resources/templates/architecture/arc42/arc42-template-EN.md +1077 -0
  85. package/packages/opencode-plugin/resources/templates/architecture/arc42/images/01_2_iso-25010-topics-EN.drawio-2023.png +0 -0
  86. package/packages/opencode-plugin/resources/templates/architecture/arc42/images/01_2_iso-25010-topics-EN.drawio.png +0 -0
  87. package/packages/opencode-plugin/resources/templates/architecture/arc42/images/05_building_blocks-EN.png +0 -0
  88. package/packages/opencode-plugin/resources/templates/architecture/arc42/images/08-concepts-EN.drawio.png +0 -0
  89. package/packages/opencode-plugin/resources/templates/architecture/arc42/images/arc42-logo.png +0 -0
  90. package/packages/opencode-plugin/resources/templates/architecture/c4.md +224 -0
  91. package/packages/opencode-plugin/resources/templates/architecture/freestyle.md +53 -0
  92. package/packages/opencode-plugin/resources/templates/architecture/game.md +250 -0
  93. package/packages/opencode-plugin/resources/templates/architecture/none.md +17 -0
  94. package/packages/opencode-plugin/resources/templates/design/comprehensive.md +207 -0
  95. package/packages/opencode-plugin/resources/templates/design/freestyle.md +37 -0
  96. package/packages/opencode-plugin/resources/templates/design/game.md +66 -0
  97. package/packages/opencode-plugin/resources/templates/design/none.md +17 -0
  98. package/packages/opencode-plugin/resources/templates/requirements/ears.md +90 -0
  99. package/packages/opencode-plugin/resources/templates/requirements/freestyle.md +42 -0
  100. package/packages/opencode-plugin/resources/templates/requirements/game.md +162 -0
  101. package/packages/opencode-plugin/resources/templates/requirements/none.md +17 -0
  102. package/packages/opencode-plugin/resources/templates/skills/POWER.md +23 -0
  103. package/packages/opencode-plugin/resources/templates/skills/SKILL.md +19 -0
  104. package/packages/opencode-plugin/resources/workflows/adr.yaml +157 -0
  105. package/packages/opencode-plugin/resources/workflows/big-bang-conversion.yaml +592 -0
  106. package/packages/opencode-plugin/resources/workflows/boundary-testing.yaml +376 -0
  107. package/packages/opencode-plugin/resources/workflows/bugfix.yaml +178 -0
  108. package/packages/opencode-plugin/resources/workflows/business-analysis.yaml +597 -0
  109. package/packages/opencode-plugin/resources/workflows/c4-analysis.yaml +471 -0
  110. package/packages/opencode-plugin/resources/workflows/epcc.yaml +195 -0
  111. package/packages/opencode-plugin/resources/workflows/game-beginner.yaml +434 -0
  112. package/packages/opencode-plugin/resources/workflows/greenfield.yaml +217 -0
  113. package/packages/opencode-plugin/resources/workflows/minor.yaml +146 -0
  114. package/packages/opencode-plugin/resources/workflows/posts.yaml +193 -0
  115. package/packages/opencode-plugin/resources/workflows/sdd-bugfix-crowd.yaml +608 -0
  116. package/packages/opencode-plugin/resources/workflows/sdd-bugfix.yaml +381 -0
  117. package/packages/opencode-plugin/resources/workflows/sdd-feature-crowd.yaml +713 -0
  118. package/packages/opencode-plugin/resources/workflows/sdd-feature.yaml +471 -0
  119. package/packages/opencode-plugin/resources/workflows/sdd-greenfield-crowd.yaml +336 -0
  120. package/packages/opencode-plugin/resources/workflows/sdd-greenfield.yaml +463 -0
  121. package/packages/opencode-plugin/resources/workflows/skilled-bugfix.yaml +174 -0
  122. package/packages/opencode-plugin/resources/workflows/skilled-epcc.yaml +171 -0
  123. package/packages/opencode-plugin/resources/workflows/skilled-greenfield.yaml +207 -0
  124. package/packages/opencode-plugin/resources/workflows/slides.yaml +237 -0
  125. package/packages/opencode-plugin/resources/workflows/tdd.yaml +170 -0
  126. package/packages/opencode-plugin/resources/workflows/waterfall.yaml +225 -0
  127. package/packages/opencode-tui-plugin/package.json +46 -0
  128. package/packages/visualizer/package.json +1 -1
  129. package/resources/workflows/bugfix.yaml +14 -0
  130. package/resources/workflows/epcc.yaml +12 -0
  131. package/resources/workflows/greenfield.yaml +16 -0
  132. package/resources/workflows/minor.yaml +8 -0
  133. package/resources/workflows/tdd.yaml +10 -0
  134. package/resources/workflows/waterfall.yaml +16 -0
@@ -0,0 +1,171 @@
1
+ ---
2
+ name: 'skilled-epcc'
3
+ description: "A comprehensive development workflow based on Anthropic's best practices: Explore, Plan, Code, Commit - ideal for smaller features and iterative development"
4
+ initial_state: 'explore'
5
+
6
+ # Enhanced metadata for better discoverability
7
+ metadata:
8
+ domain: 'skilled'
9
+ complexity: 'medium'
10
+ bestFor:
11
+ - 'Medium-sized features'
12
+ - 'Iterative development'
13
+ - 'Research-heavy tasks'
14
+ - 'Exploratory coding'
15
+ useCases:
16
+ - 'Adding a new API endpoint'
17
+ - 'Implementing a new algorithm'
18
+ - 'Integrating a third-party service'
19
+ examples:
20
+ - 'Add user profile management'
21
+ - 'Implement search functionality'
22
+ - 'Create data export feature'
23
+
24
+ # States with default instructions and transitions
25
+ states:
26
+ explore:
27
+ description: 'Research and exploration phase - understanding the problem space'
28
+ default_instructions: |
29
+ Research the codebase to understand existing patterns and gather context about the problem space.
30
+
31
+ - **Apply your starting-project skill.** If unavailable, ask user about project setup practices.
32
+ - **Apply your architecture skill.** If unavailable, ask user about architectural conventions.
33
+ - If uncertain about conventions or rules, ask the user about them
34
+ - Read relevant files and documentation
35
+ - Check whether there is a requirements document in the project and if so, read it carefully)
36
+
37
+ Focus on understanding without writing code yet. Document your findings and create tasks as needed.
38
+ transitions:
39
+ - trigger: 'exploration_complete'
40
+ to: 'plan'
41
+ additional_instructions: 'Present the plan to the user, describing the impact of the changes.'
42
+ transition_reason: 'Sufficient understanding gained, ready to create implementation plan'
43
+
44
+ plan:
45
+ description: 'Planning phase - creating a detailed implementation strategy'
46
+ default_instructions: |
47
+ Create a detailed implementation strategy based on your exploration:
48
+
49
+ - **Apply your architecture skill.** If unavailable, ask user about architectural conventions.
50
+ - **Apply your application-design skill.** If unavailable, ask user about application design practices.
51
+ - Check whether there is a requirements document in the project and base your strategy on it
52
+ - Check whether there is a design document in the project and adhere to it; if not, elaborate design options and present them to the user
53
+
54
+ Break down the work into specific, actionable tasks. Consider edge cases, dependencies, and potential challenges. Document the planning work thoroughly and create implementation tasks as part of the code phase as needed.
55
+ transitions:
56
+ - trigger: 'need_more_exploration'
57
+ to: 'explore'
58
+ additional_instructions: 'Focus on the specific areas that need clarification and ask the user about needs and preferences.'
59
+ transition_reason: 'Planning work revealed need for more exploration'
60
+
61
+ - trigger: 'plan_complete'
62
+ to: 'code'
63
+ transition_reason: 'Implementation plan is complete and ready for coding'
64
+ review_perspectives:
65
+ - perspective: 'architect'
66
+ prompt: 'Review implementation strategy, design decisions, and integration approach for soundness and maintainability. Ensure the plan aligns with existing system architecture and follows best practices.'
67
+ - perspective: 'security_expert'
68
+ prompt: 'Assess security considerations and potential risks in the planned implementation approach. Review data handling, authentication, and potential vulnerabilities.'
69
+
70
+ - trigger: 'abandon_feature'
71
+ to: 'explore'
72
+ instructions: >
73
+ Feature development abandoned during planning. Return to exploration state for new tasks.
74
+ Task history will remain for future reference.
75
+ additional_instructions: 'Feature development abandoned during planning. Clean up any planning work and prepare for new tasks.'
76
+ transition_reason: 'User decided to abandon feature during planning phase'
77
+
78
+ code:
79
+ description: 'Implementation phase - writing and building the solution'
80
+ default_instructions: |
81
+ Follow your plan to build the solution:
82
+
83
+ - **Apply your coding skill.** If unavailable, ask user about coding practices.
84
+ - **Apply your testing skill.** If unavailable, ask user about testing practices.
85
+ - Check whether there is a design document in the project and follow it; if not, elaborate design options and present them to the user
86
+ - Check whether there is a requirements document in the project and ensure all requirements are met
87
+
88
+ Write clean, well-structured code with proper error handling. Prevent regression by building, linting, and executing existing tests. Stay flexible and adapt the plan as you learn more during implementation. Update task progress and create new tasks as needed.
89
+ transitions:
90
+ - trigger: 'need_replanning'
91
+ to: 'plan'
92
+ additional_instructions: "Consider what you've learned during coding and adjust the plan accordingly. Document the changes and reasons."
93
+ transition_reason: 'Implementation work revealed need to revise the plan'
94
+
95
+ - trigger: 'need_more_exploration'
96
+ to: 'explore'
97
+ additional_instructions: 'Focus on the specific areas that are blocking implementation progress.'
98
+ transition_reason: 'Implementation work revealed need for more exploration'
99
+
100
+ - trigger: 'code_complete'
101
+ to: 'commit'
102
+ transition_reason: 'Core implementation is complete, ready for finalization'
103
+ review_perspectives:
104
+ - perspective: 'senior_software_developer'
105
+ prompt: 'Review code quality, best practices, testing coverage, and readiness for production deployment. Ensure the implementation follows coding standards and is maintainable.'
106
+ - perspective: 'performance_engineer'
107
+ prompt: 'Evaluate performance impact, resource efficiency, and scalability of the implemented solution. Check for potential bottlenecks or optimization opportunities.'
108
+
109
+ - trigger: 'abandon_feature'
110
+ to: 'explore'
111
+ instructions: >
112
+ Feature development abandoned during implementation. Clean up any incomplete code and return to exploration.
113
+ Task history and any completed work will remain for future reference.
114
+ additional_instructions: 'Clean up any incomplete code and prepare for new tasks.'
115
+ transition_reason: 'User decided to abandon feature during implementation'
116
+
117
+ commit:
118
+ description: 'Code cleanup and documentation finalization'
119
+ default_instructions: >
120
+ Ensure code quality and documentation accuracy through systematic cleanup and review.
121
+
122
+ **STEP 1: Code Cleanup**
123
+
124
+ Systematically clean up development artifacts:
125
+
126
+ 1. **Remove Debug Output**: Search for and remove all temporary debug output statements used during development.
127
+ Look for language-specific debug output methods (console logging, print statements, debug output functions).
128
+ Remove any debugging statements that were added for development purposes.
129
+
130
+ 2. **Review TODO/FIXME Comments**:
131
+ - Address each TODO/FIXME comment by either implementing the solution or documenting why it's deferred
132
+ - Remove completed TODOs
133
+ - Convert remaining TODOs to proper issue tracking if needed
134
+
135
+ 3. **Remove Debugging Code Blocks**:
136
+ - Remove temporary debugging code, test code blocks, and commented-out code
137
+ - Clean up any experimental code that's no longer needed
138
+ - Ensure proper error handling replaces temporary debug logging
139
+
140
+ **STEP 2: Documentation Review**
141
+
142
+ Review and update documentation to reflect final implementation:
143
+
144
+ 1. Check whether there is a requirements, architecture, or design document in the project and update any that are affected by the implementation
145
+ 2. **Compare Against Implementation**: Review documentation against actual implemented functionality
146
+ 3. **Update Changed Sections**: Only modify documentation sections that have functional changes
147
+ 4. **Remove Development Progress**: Remove references to development iterations, progress notes, and temporary decisions
148
+ 5. **Focus on Final State**: Ensure documentation describes the final implemented state, not the development process
149
+ 6. **Ask User to Review Document Updates**
150
+
151
+ **STEP 3: Final Validation**
152
+
153
+ - **Apply your testing skill.** If unavailable, ask user about testing practices.
154
+ - Verify documentation accuracy with a final review
155
+ - Ensure code is ready for production/delivery
156
+
157
+ Update task progress and mark completed work as you finalize the feature.
158
+ transitions:
159
+ - trigger: 'need_code_changes'
160
+ to: 'code'
161
+ additional_instructions: 'Focus on the problems identified during final review.'
162
+ transition_reason: 'Final review found issues requiring code changes'
163
+
164
+ - trigger: 'commit_complete'
165
+ to: 'explore'
166
+ transition_reason: 'Feature delivery complete, ready for next task'
167
+
168
+ - trigger: 'abandon_feature'
169
+ to: 'explore'
170
+ additional_instructions: 'Clean up any finalization artifacts and prepare for new tasks.'
171
+ transition_reason: 'User decided to abandon feature during finalization'
@@ -0,0 +1,207 @@
1
+ ---
2
+ name: 'skilled-greenfield'
3
+ description: 'A comprehensive workflow for starting new projects from scratch: Ideation, Architecture, Plan, Code, Document - ideal for greenfield projects requiring thorough upfront planning'
4
+ initial_state: 'ideation'
5
+
6
+ # Enhanced metadata for better discoverability
7
+ metadata:
8
+ domain: 'skilled'
9
+ complexity: 'high'
10
+ bestFor:
11
+ - 'New projects from scratch'
12
+ - 'Greenfield development'
13
+ - 'Complex system design'
14
+ - 'Comprehensive planning needed'
15
+ useCases:
16
+ - 'Starting a new application'
17
+ - 'Building a new service'
18
+ - 'Creating a new library'
19
+ examples:
20
+ - 'Build a new web application'
21
+ - 'Create a microservice architecture'
22
+ - 'Develop a new CLI tool'
23
+ requiresDocumentation: true
24
+
25
+ # States with default instructions and transitions
26
+ states:
27
+ ideation:
28
+ description: 'Deep requirements discovery and PRD creation phase'
29
+ default_instructions: |
30
+ Understand WHAT the system should do, WHO will use it, WHY it's needed, and WHAT'S in/out of scope by exploring:
31
+
32
+ **Apply your starting-project skill.** If unavailable, ask user about project setup practices.
33
+
34
+ - Are there existing solutions? What gaps do they have?
35
+ - What technologies must/cannot be used? Why?
36
+ - How will you measure product success?
37
+ - Have you validated this need with potential users?
38
+
39
+ Don't discuss technical implementation yet - focus purely on understanding the problem space and requirements. Check whether there is a requirements document in the project and if so, read it carefully. Create tasks as needed.
40
+ transitions:
41
+ - trigger: 'ideation_complete'
42
+ to: 'architecture'
43
+ transition_reason: 'PRD is complete with clear requirements, ready for technical architecture design'
44
+ review_perspectives:
45
+ - perspective: 'business_analyst'
46
+ prompt: 'Review the Product Requirements Document for completeness, clarity, and business value. Ensure all stakeholder needs are captured, requirements are testable, and scope is well-defined.'
47
+ - perspective: 'ux_expert'
48
+ prompt: 'Evaluate user experience requirements and usability considerations. Ensure user personas, workflows, and interaction patterns are properly defined for the greenfield project.'
49
+
50
+ architecture:
51
+ description: 'Tech stack selection and architecture design phase'
52
+ default_instructions: |
53
+ Design the technical solution based on the requirements discovered during ideation.
54
+
55
+ - **Apply your architecture skill.** If unavailable, ask user about architectural conventions.
56
+ - Ask about the user's technical preferences and experience
57
+ - Challenge their choices by presenting alternatives
58
+ - Evaluate pros and cons of different tech stacks, frameworks, and architectural patterns
59
+ - Consider non-functional requirements like scalability, performance, maintainability, and deployment
60
+
61
+ Check whether there is an architecture document in the project and if so, read and build on it. Don't start coding yet - focus on technical design decisions.
62
+ transitions:
63
+ - trigger: 'need_more_ideation'
64
+ to: 'ideation'
65
+ additional_instructions: 'Architecture work revealed gaps in requirements understanding. Focus on the specific requirements areas that need clarification before continuing with technical design.'
66
+ transition_reason: 'Architecture work revealed need for more requirements clarification'
67
+
68
+ - trigger: 'architecture_complete'
69
+ to: 'plan'
70
+ additional_instructions: 'Present the implementation plan to the user and document it thoroughly.'
71
+ transition_reason: 'Technical architecture is complete, ready for implementation planning'
72
+ review_perspectives:
73
+ - perspective: 'architect'
74
+ prompt: 'Review the technical architecture for completeness, scalability, and maintainability. Ensure technology choices are appropriate and architectural patterns are sound for a greenfield project.'
75
+ - perspective: 'security_expert'
76
+ prompt: 'Evaluate security architecture, data protection strategies, and potential vulnerabilities. Ensure security is built into the foundation of the greenfield project from the start.'
77
+
78
+ - trigger: 'abandon_project'
79
+ to: 'ideation'
80
+ instructions: >
81
+ Project development abandoned during architecture phase. Return to ideation state for new projects.
82
+ Task history and PRD will remain for future reference.
83
+ additional_instructions: 'Project development abandoned during architecture phase. Clean up any architecture work and prepare for new projects.'
84
+ transition_reason: 'User decided to abandon project during architecture phase'
85
+
86
+ plan:
87
+ description: 'Implementation planning phase based on established architecture'
88
+ default_instructions: |
89
+ Create a detailed implementation strategy based on your completed architecture and requirements.
90
+
91
+ - **Apply your application-design skill.** If unavailable, ask user about application design practices.
92
+ - Check whether there is a design document in the project and adhere to it
93
+
94
+ **STEP 1: Break Down Work**
95
+ - Break down the work into specific, actionable tasks
96
+ - Consider the chosen tech stack and architectural decisions
97
+ - Plan the implementation order and identify dependencies
98
+
99
+ **STEP 2: Assess Risks**
100
+ - Consider potential risks and mitigation strategies
101
+ - Document the detailed design if needed
102
+
103
+ **STEP 3: Create Tasks**
104
+ - Create tasks thoroughly with clear milestones for implementation work
105
+ - Ensure each task is actionable and has clear acceptance criteria
106
+ transitions:
107
+ - trigger: 'need_architecture_changes'
108
+ to: 'architecture'
109
+ additional_instructions: "Planning revealed issues with the current architecture. Consider what you've learned during planning and adjust the technical design accordingly. Document the changes and reasons."
110
+ transition_reason: 'Planning work revealed need to revise the architecture'
111
+
112
+ - trigger: 'plan_complete'
113
+ to: 'code'
114
+ additional_instructions: "Implementation plan is complete! ✅ Now transition to coding phase. Read specific documentation before using the chosen libraries and frameworks. Follow the architectural patterns and tech stack decisions you've made. Modularize your code according to best practices. Stay focused on the current project scope defined in your PRD. Update task progress as you complete planning work."
115
+ transition_reason: 'Implementation plan is complete and ready for coding'
116
+
117
+ - trigger: 'abandon_project'
118
+ to: 'ideation'
119
+ instructions: >
120
+ Project development abandoned during planning. Return to ideation state for new projects.
121
+ Task history, PRD, and architecture documentation will remain for future reference.
122
+ additional_instructions: 'Project development abandoned during planning. Clean up any planning work and prepare for new projects.'
123
+ transition_reason: 'User decided to abandon project during planning phase'
124
+
125
+ code:
126
+ description: 'Implementation phase following the established plan and architecture'
127
+ default_instructions: |
128
+ Build the solution following your plan and architecture.
129
+
130
+ - **Apply your coding skill.** If unavailable, ask user about coding practices.
131
+ - **Apply your testing skill.** If unavailable, ask user about testing practices.
132
+ - Check whether there is a design document in the project and follow it
133
+ - Check whether there is a requirements document in the project and ensure all requirements you are currently working on are met
134
+ - Write clean, well-structured code with proper error handling
135
+ - Prevent regression by building, linting, and executing existing tests
136
+ - Stay flexible and adapt the plan as you learn more during implementation, but maintain alignment with your architecture decisions
137
+ - Update task progress and create new tasks as needed for current phase work
138
+ transitions:
139
+ - trigger: 'need_replanning'
140
+ to: 'plan'
141
+ additional_instructions: "Implementation revealed issues with the current plan. Consider what you've learned during coding and adjust the implementation strategy accordingly while maintaining architectural consistency. Document the changes and reasons."
142
+ transition_reason: 'Implementation work revealed need to revise the plan'
143
+
144
+ - trigger: 'need_architecture_changes'
145
+ to: 'architecture'
146
+ additional_instructions: 'Implementation revealed fundamental issues with the architecture that require design changes. Focus on the specific architectural problems that are blocking implementation progress.'
147
+ transition_reason: 'Implementation work revealed need for architectural changes'
148
+
149
+ - trigger: 'code_complete'
150
+ to: 'finalize'
151
+ transition_reason: 'Core implementation is complete, ready for comprehensive documentation'
152
+
153
+ - trigger: 'abandon_project'
154
+ to: 'ideation'
155
+ instructions: >
156
+ Project development abandoned during implementation. Clean up any incomplete code and return to ideation.
157
+ Task history, PRD, architecture documentation, and any completed work will remain for future reference.
158
+ additional_instructions: 'Project development abandoned during implementation. Clean up any incomplete code and prepare for new projects.'
159
+ transition_reason: 'User decided to abandon project during implementation'
160
+
161
+ finalize:
162
+ description: 'Code cleanup and documentation finalization'
163
+ default_instructions: |
164
+ This phase ensures code quality and documentation accuracy through systematic cleanup and review.
165
+
166
+ **STEP 1: Code Cleanup**
167
+ Systematically clean up development artifacts:
168
+
169
+ 1. Remove all temporary debug output statements used during development (console logging, print statements, debug functions)
170
+ 2. Address each TODO/FIXME comment by either implementing the solution or documenting why it's deferred
171
+ - Remove completed TODOs
172
+ - Convert remaining TODOs to proper issue tracking if needed
173
+ 3. Remove debugging code blocks, temporary test code, and commented-out code
174
+ - Ensure proper error handling replaces temporary debug logging
175
+
176
+ **STEP 2: Documentation Review**
177
+ Update documentation to reflect final implementation:
178
+
179
+ 1. Check whether there is a requirements, architecture, or design document in the project and update any that are affected by the implementation
180
+ 2. Review documentation against actual implemented functionality
181
+ 3. Only modify documentation sections that have functional changes
182
+ 4. Remove references to development iterations, progress notes, and temporary decisions
183
+ 5. Ensure documentation describes the final implemented state, not the development process
184
+ 6. Ask user to review document updates
185
+
186
+ **STEP 3: Comprehensive Documentation**
187
+ Ensure project has complete documentation for newcomers including setup, usage, architecture overview, and contribution guidelines.
188
+
189
+ **STEP 4: Final Validation**
190
+ - **Apply your testing skill.** If unavailable, ask user about testing practices.
191
+ - Verify documentation accuracy with a final review
192
+ - Ensure project is ready for users and contributors
193
+ - Update task progress and mark completed work as you finalize the project
194
+ transitions:
195
+ - trigger: 'need_code_changes'
196
+ to: 'code'
197
+ additional_instructions: 'Finalization revealed issues that require code changes. Focus on the problems identified during final review that affect usability or functionality.'
198
+ transition_reason: 'Finalization revealed issues requiring code changes'
199
+
200
+ - trigger: 'finalization_complete'
201
+ to: 'ideation'
202
+ transition_reason: 'Project delivery complete with finalized code and documentation, ready for next greenfield project'
203
+
204
+ - trigger: 'abandon_project'
205
+ to: 'ideation'
206
+ additional_instructions: 'Project development abandoned during finalization. Clean up any finalization artifacts and prepare for new projects.'
207
+ transition_reason: 'User decided to abandon project during finalization phase'
@@ -0,0 +1,237 @@
1
+ name: slides
2
+ description: 'A comprehensive workflow for creating presentations - tool-agnostic approach that works with Slidev, PowerPoint, Google Slides, or any presentation platform'
3
+ initial_state: ideate
4
+
5
+ # Enhanced metadata for better discoverability
6
+ metadata:
7
+ domain: 'office'
8
+ complexity: 'medium'
9
+ bestFor:
10
+ - 'Presentation creation'
11
+ - 'Slide deck development'
12
+ - 'Conference talks'
13
+ - 'Training materials'
14
+ useCases:
15
+ - 'Creating a technical presentation'
16
+ - 'Building training slides'
17
+ - 'Preparing a conference talk'
18
+ examples:
19
+ - 'Create a product demo presentation'
20
+ - 'Build onboarding slides'
21
+ - 'Develop a technical workshop'
22
+
23
+ states:
24
+ ideate:
25
+ description: 'Brainstorm presentation concept and define strategic foundation'
26
+ default_instructions: |
27
+ **Clarify the presentation foundation** with the user by gathering essential information:
28
+
29
+ - Brainstorm presentation topic and key messages
30
+ - Define target audience and their knowledge level
31
+ - Set presentation goals and success criteria
32
+ - Research topic and gather reference materials
33
+ - Define scope, time constraints, and context
34
+
35
+ **Update** the plan file with ideation progress and key decisions before proceeding to structure.
36
+
37
+ transitions:
38
+ - trigger: ideation_complete
39
+ to: structure
40
+ transition_reason: 'Presentation concept and goals clearly defined, ready for content structuring'
41
+
42
+ structure:
43
+ description: 'Organize content flow and logical progression'
44
+ default_instructions: |
45
+ **Create a detailed presentation structure** by organizing your content logically and effectively:
46
+
47
+ - Create detailed presentation outline with main sections
48
+ - Define slide sequence and narrative flow
49
+ - Plan smooth transitions between topics
50
+ - Identify key examples, case studies, or demonstrations needed
51
+ - Estimate timing for each section and overall presentation
52
+ - Consider audience engagement points and interaction opportunities
53
+
54
+ **Update** the plan file with structural decisions and progress before moving to content drafting.
55
+
56
+ transitions:
57
+ - trigger: structure_complete
58
+ to: draft
59
+ additional_instructions: |
60
+ **Structure phase complete!** You have a well-organized outline and clear content flow.
61
+
62
+ Update the plan file with drafting tasks and mark completed structural work.
63
+ transition_reason: 'Content structure and flow established, ready for content creation'
64
+
65
+ - trigger: need_more_ideation
66
+ to: ideate
67
+ additional_instructions: 'Structural work revealed gaps in the initial concept or goals. Focus on clarifying these fundamental aspects.'
68
+ transition_reason: 'Structure work revealed need for more ideation or concept refinement'
69
+
70
+ - trigger: abandon_presentation
71
+ to: ideate
72
+ instructions: |
73
+ **Abandon structural work** - Clean up structural work and return to ideation.
74
+
75
+ The plan file and any completed work will remain for future reference.
76
+ additional_instructions: 'Presentation abandoned during structure phase. Clean up and prepare for new topics.'
77
+ transition_reason: 'User decided to abandon presentation during structure phase'
78
+
79
+ draft:
80
+ description: 'Create content, speaker notes, and visual planning'
81
+ default_instructions: |
82
+ **Create content and speaker notes** to establish the presentation material and delivery guide:
83
+
84
+ - Write clear, engaging content for each slide/section
85
+ - Create comprehensive speaker notes as a main deliverable
86
+ - Make strategic decisions about visual vs. spoken content split
87
+ - Identify concepts that can be effectively visualized
88
+ - Define what each visualization should communicate
89
+ - Create placeholders and specifications for visual content
90
+ - Ensure content aligns with timing and audience needs
91
+
92
+ **Update** the plan file with drafting progress and content decisions before moving to styling.
93
+
94
+ transitions:
95
+ - trigger: draft_complete
96
+ to: style
97
+ additional_instructions: |
98
+ **Draft phase complete!** You have solid content, speaker notes, and visual planning.
99
+
100
+ Update the plan file with styling tasks and mark completed drafting work.
101
+ transition_reason: 'Content and speaker notes complete, ready for visual design and styling'
102
+
103
+ - trigger: need_more_structure
104
+ to: structure
105
+ additional_instructions: 'Drafting revealed issues with content organization or flow. Focus on refining the structural foundation.'
106
+ transition_reason: 'Content creation revealed need for better structure or organization'
107
+
108
+ - trigger: abandon_presentation
109
+ to: ideate
110
+ instructions: |
111
+ **Abandon drafting work** - Clean up content work and return to ideation.
112
+
113
+ The plan file and any completed work will remain for future reference.
114
+ additional_instructions: 'Presentation abandoned during draft phase. Clean up and prepare for new topics.'
115
+ transition_reason: 'User decided to abandon presentation during draft phase'
116
+
117
+ style:
118
+ description: 'Apply design, create visuals, and enhance presentation aesthetics'
119
+ default_instructions: |
120
+ **Apply visual design and create presentation aesthetics** to bring professional appeal and consistency:
121
+
122
+ - Evaluate presentation requirements and choose appropriate tool/platform
123
+ - Select themes, templates, and establish visual design approach
124
+ - Source existing visuals, images, and graphic elements
125
+ - Create detailed AI image generation prompts for missing visuals
126
+ - Generate or create required visual content using AI tools or other methods
127
+ - Apply consistent visual design, colors, and branding
128
+ - Ensure visual elements effectively support and enhance the content
129
+ - Test visual consistency across all slides/sections
130
+
131
+ **Update** the plan file with styling progress and design decisions before moving to review.
132
+
133
+ transitions:
134
+ - trigger: style_complete
135
+ to: review
136
+ additional_instructions: |
137
+ **Style phase complete!** You have a visually appealing presentation with consistent design.
138
+
139
+ Update the plan file with review tasks and mark completed styling work.
140
+ transition_reason: 'Visual design and styling complete, ready for content and delivery review'
141
+
142
+ - trigger: need_more_content
143
+ to: draft
144
+ additional_instructions: 'Styling work revealed gaps in content or speaker notes. Focus on completing the content foundation.'
145
+ transition_reason: 'Visual design revealed need for additional content or speaker note refinement'
146
+
147
+ - trigger: abandon_presentation
148
+ to: ideate
149
+ instructions: |
150
+ **Abandon styling work** - Clean up design work and return to ideation.
151
+
152
+ The plan file and any completed work will remain for future reference.
153
+ additional_instructions: 'Presentation abandoned during style phase. Clean up and prepare for new topics.'
154
+ transition_reason: 'User decided to abandon presentation during style phase'
155
+
156
+ review:
157
+ description: 'Validate content quality and presentation effectiveness'
158
+ default_instructions: |
159
+ **Validate presentation quality** by reviewing content, timing, visuals, and delivery readiness:
160
+
161
+ - Review content flow, narrative coherence, and logical progression
162
+ - Test presentation timing and pacing for your allocated time
163
+ - Verify visual quality, consistency, and professional appearance
164
+ - Practice delivery to identify potential issues or improvements
165
+ - Gather feedback from test audience, colleagues, or stakeholders
166
+ - Check technical setup, compatibility, and backup plans
167
+ - Ensure all interactive elements and visuals work correctly
168
+ - Refine speaker notes and delivery preparation
169
+
170
+ **Update** the plan file with review progress and refinements before moving to delivery preparation.
171
+
172
+ transitions:
173
+ - trigger: review_complete
174
+ to: deliver
175
+ additional_instructions: |
176
+ **Review phase complete!** Your presentation has been validated and refined for delivery.
177
+
178
+ Update the plan file with delivery preparation tasks and mark completed review work.
179
+ transition_reason: 'Presentation reviewed and validated, ready for final delivery preparation'
180
+
181
+ - trigger: need_style_changes
182
+ to: style
183
+ additional_instructions: 'Review revealed visual or design issues that need attention. Focus on addressing these styling concerns.'
184
+ transition_reason: 'Review process identified visual or design issues requiring style phase work'
185
+
186
+ - trigger: need_content_changes
187
+ to: draft
188
+ additional_instructions: 'Review revealed content gaps or issues that need addressing. Focus on refining the content and speaker notes.'
189
+ transition_reason: 'Review process identified content issues requiring draft phase work'
190
+
191
+ - trigger: abandon_presentation
192
+ to: ideate
193
+ instructions: |
194
+ **Abandon review work** - Clean up review work and return to ideation.
195
+
196
+ The plan file and any completed work will remain for future reference.
197
+ additional_instructions: 'Presentation abandoned during review phase. Clean up and prepare for new topics.'
198
+ transition_reason: 'User decided to abandon presentation during review phase'
199
+
200
+ deliver:
201
+ description: 'Prepare final presentation for delivery'
202
+ default_instructions: |
203
+ **Prepare final delivery** by exporting formats, testing setup, and ensuring flawless execution:
204
+
205
+ - Export presentation to all required formats (native, PDF, backup formats)
206
+ - Finalize speaker setup, notes, and delivery materials
207
+ - Configure and test presentation environment and technical setup
208
+ - Create comprehensive contingency plans for potential technical issues
209
+ - Conduct final rehearsal in actual delivery environment if possible
210
+ - Prepare handouts, follow-up materials, or additional resources
211
+ - Ensure all backup plans and alternatives are ready
212
+ - Final check of timing, flow, and delivery readiness
213
+
214
+ **Update** the plan file with delivery preparation progress to ensure successful delivery.
215
+
216
+ transitions:
217
+ - trigger: delivery_complete
218
+ to: ideate
219
+ additional_instructions: |
220
+ **Delivery phase complete!** Your presentation has been successfully delivered.
221
+
222
+ Mark all delivery tasks as complete in the plan file and prepare for new work.
223
+ transition_reason: 'Presentation delivery completed successfully, ready for new projects'
224
+
225
+ - trigger: need_final_review
226
+ to: review
227
+ additional_instructions: 'Final preparation revealed issues requiring additional review. Focus on addressing these concerns before delivery.'
228
+ transition_reason: 'Delivery preparation identified issues requiring additional review'
229
+
230
+ - trigger: abandon_presentation
231
+ to: ideate
232
+ instructions: |
233
+ **Abandon delivery preparation** - Clean up delivery preparation and return to ideation.
234
+
235
+ The plan file and completed work will remain for future reference.
236
+ additional_instructions: 'Presentation abandoned before delivery. Clean up and prepare for new topics.'
237
+ transition_reason: 'User decided to abandon presentation before delivery'