@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,170 @@
1
+ # yaml-language-server: $schema=../state-machine-schema.json
2
+ ---
3
+ name: 'tdd'
4
+ description: 'Test-Driven Development workflow: Explore → Red → Green → Refactor cycle for quality-focused development'
5
+ initial_state: 'explore'
6
+
7
+ # Enhanced metadata for better discoverability
8
+ metadata:
9
+ domain: 'code'
10
+ complexity: 'medium'
11
+ bestFor:
12
+ - 'TDD development'
13
+ - 'Test-first coding'
14
+ - 'Quality-focused development'
15
+ - 'Refactoring existing code'
16
+ useCases:
17
+ - 'Adding new features with comprehensive tests'
18
+ - 'Refactoring legacy code safely'
19
+ - 'Building robust, well-tested components'
20
+ examples:
21
+ - 'Add new API endpoint with full test coverage'
22
+ - 'Refactor existing function with safety net of tests'
23
+ - 'Build new feature following TDD principles'
24
+
25
+ # States with default instructions and transitions
26
+ states:
27
+ explore:
28
+ description: 'Research and exploration phase - understanding the problem space and codebase'
29
+ allowed_file_patterns:
30
+ - '**/*.md'
31
+ - '**/*.txt'
32
+ - '**/*.adoc'
33
+ default_instructions: |
34
+ **STEP 1:** Gather context about what needs to be developed. Focus on the WHY and WHAT, not the HOW.
35
+
36
+ **STEP 2:** Research the codebase and understand existing patterns.
37
+ - Ask the user about conventions or rules if uncertain
38
+ - Read relevant files and documentation
39
+ - If `$REQUIREMENTS_DOC` exists, understand and document requirements there, otherwise document in your task management system
40
+
41
+ **STEP 3:** Document your findings and create tasks as needed.
42
+ - Don't write code or tests yet
43
+ - Focus on understanding the problem space
44
+ - Prepare for the RED phase of the TDD cycle
45
+ transitions:
46
+ - trigger: 'exploration_complete'
47
+ to: 'red'
48
+ additional_instructions: 'Update task progress as you complete exploration work.'
49
+ transition_reason: 'Sufficient understanding gained, ready to start TDD cycle with failing test'
50
+
51
+ red:
52
+ description: 'RED phase - Write a failing test that defines the expected behavior'
53
+ allowed_file_patterns:
54
+ - '**/*'
55
+ default_instructions: |
56
+ Write a failing test that defines the expected behavior for the feature.
57
+
58
+ **STEP 1:** Validate test approach with the user before writing.
59
+ - Determine what type of test is appropriate (unit, integration, acceptance, etc.)
60
+ - Confirm your test will validate the actual requirements
61
+ - Ensure alignment with the feature specification
62
+
63
+ **STEP 2:** Write a focused, meaningful test.
64
+ - Clearly define the expected behavior
65
+ - Will fail initially since functionality doesn't exist yet
66
+ - Focus on one specific aspect of the functionality
67
+ - Use appropriate assertions (not meaningless checks like assert(true))
68
+
69
+ **STEP 3:** Validate test failure.
70
+ - Run the test to confirm it fails for the right reason
71
+ - Document the test and expected failure mode
72
+ - Update task progress
73
+ transitions:
74
+ - trigger: 'test_written_and_failing'
75
+ to: 'green'
76
+ additional_instructions: 'Update task progress as you complete test writing work.'
77
+ transition_reason: 'Failing test successfully written and validated, ready to implement'
78
+
79
+ - trigger: 'need_more_exploration'
80
+ to: 'explore'
81
+ transition_reason: 'Test writing revealed need for more exploration'
82
+
83
+ - trigger: 'abandon_feature'
84
+ to: 'explore'
85
+ additional_instructions: 'Clean up any test artifacts and prepare for new tasks.'
86
+ transition_reason: 'User decided to abandon feature during test phase'
87
+
88
+ green:
89
+ description: 'GREEN phase - Write only the necessary code to make the test pass'
90
+ allowed_file_patterns:
91
+ - '**/*'
92
+ default_instructions: |
93
+ Implement the necessary code to make the failing test pass with proper functionality.
94
+
95
+ **STEP 1:** Write real, working implementation.
96
+ - Make the test pass with actual logic, not shortcuts
97
+ - Write only what's necessary (no over-engineering)
98
+ - Avoid dirty hacks such as hardcoded return values or meaningless assertions
99
+ - Focus on solving the actual problem
100
+
101
+ **STEP 2:** Validate implementation quality.
102
+ - Run the test to confirm it passes
103
+ - Verify no shortcuts or copy-paste code without understanding
104
+ - Ensure the solution actually solves the problem
105
+ - Check that logic is proper, not a bypass
106
+
107
+ **STEP 3:** Document and track progress.
108
+ - Document your implementation approach
109
+ - Update task progress
110
+ transitions:
111
+ - trigger: 'test_passing'
112
+ to: 'refactor'
113
+ additional_instructions: 'Update task progress as you complete implementation work.'
114
+ transition_reason: 'Test passes with proper implementation, ready for refactoring'
115
+
116
+ - trigger: 'need_different_test'
117
+ to: 'red'
118
+ transition_reason: 'Implementation work revealed need to revise the test'
119
+
120
+ - trigger: 'need_more_exploration'
121
+ to: 'explore'
122
+ transition_reason: 'Implementation work revealed need for more exploration'
123
+
124
+ - trigger: 'abandon_feature'
125
+ to: 'explore'
126
+ additional_instructions: 'Clean up any incomplete code and prepare for new tasks.'
127
+ transition_reason: 'User decided to abandon feature during implementation'
128
+
129
+ refactor:
130
+ description: 'REFACTOR phase - Improve code quality while keeping tests green (cleanup phase)'
131
+ allowed_file_patterns:
132
+ - '**/*'
133
+ default_instructions: |
134
+ Improve code quality while keeping all tests green. This is the cleanup phase where you enhance readability and maintainability.
135
+
136
+ **STEP 1:** Identify improvement opportunities.
137
+ - Remove code duplication
138
+ - Improve variable and function names
139
+ - Extract methods for better organization
140
+ - Simplify complex logic
141
+ - Apply appropriate design patterns
142
+
143
+ **STEP 2:** Make incremental improvements safely.
144
+ - Run tests after each refactoring change
145
+ - Immediately revert any change that breaks tests
146
+ - Make small, focused improvements
147
+ - Stop when code is clean with no obvious improvements remaining
148
+
149
+ **STEP 3:** Document and complete.
150
+ - Document significant refactoring decisions
151
+ - Update task progress
152
+ transitions:
153
+ - trigger: 'refactoring_complete'
154
+ to: 'red'
155
+ additional_instructions: 'Update task progress as you complete refactoring work.'
156
+ transition_reason: 'Code cleanup complete, ready for next TDD cycle'
157
+
158
+ - trigger: 'need_different_approach'
159
+ to: 'green'
160
+ transition_reason: 'Refactoring revealed need to revise implementation'
161
+
162
+ - trigger: 'feature_complete'
163
+ to: 'explore'
164
+ additional_instructions: 'Update task progress to reflect feature completion.'
165
+ transition_reason: 'Feature fully implemented and cleaned up, ready for new tasks'
166
+
167
+ - trigger: 'abandon_feature'
168
+ to: 'explore'
169
+ additional_instructions: 'Clean up any refactoring work and prepare for new tasks.'
170
+ transition_reason: 'User decided to abandon feature during refactoring'
@@ -0,0 +1,225 @@
1
+ # yaml-language-server: $schema=../state-machine-schema.json
2
+ ---
3
+ name: 'waterfall'
4
+ description: 'V-Model: Specification down to test – the historical way. Ideal for larger, design-heavy tasks with well-defined requirements'
5
+ initial_state: 'requirements'
6
+
7
+ # Enhanced metadata for better discoverability
8
+ metadata:
9
+ domain: 'code'
10
+ complexity: 'high'
11
+ bestFor:
12
+ - 'Large feature development'
13
+ - 'Complex system changes'
14
+ - 'Well-defined requirements'
15
+ - 'Design-heavy projects'
16
+ useCases:
17
+ - 'Building a new module from scratch'
18
+ - 'Implementing complex business logic'
19
+ - 'Major architectural changes'
20
+ examples:
21
+ - 'Create a new authentication system'
22
+ - 'Build a reporting dashboard'
23
+ - 'Implement a payment processing workflow'
24
+ requiresDocumentation: true
25
+
26
+ # States with default instructions and transitions
27
+ states:
28
+ requirements:
29
+ description: 'Gathering and analyzing requirements'
30
+ allowed_file_patterns:
31
+ - '**/*.md'
32
+ - '**/*.txt'
33
+ - '**/*.adoc'
34
+ default_instructions: |
35
+ Familiarize yourself with the code base and understand project goals, scope, constraints, and success criteria.
36
+
37
+ - Who are the key stakeholders? (end users, business owners, technical teams)
38
+ - Which requirements are must-have vs nice-to-have?
39
+ - How will you measure success? What are the acceptance criteria?
40
+ - What are your time, budget, technical, or regulatory constraints?
41
+ - What existing systems must this integrate with?
42
+
43
+ Document all requirements in `$REQUIREMENTS_DOC`. Create actionable tasks referencing those requirements.
44
+ transitions:
45
+ - trigger: 'requirements_complete'
46
+ to: 'design'
47
+ transition_reason: 'All requirements tasks completed, moving to technical design'
48
+ review_perspectives:
49
+ - perspective: 'business_analyst'
50
+ prompt: 'Review requirements completeness, clarity, and business value. Ensure all stakeholder needs are captured and requirements are testable. Check for missing edge cases or unclear acceptance criteria.'
51
+ - perspective: 'ux_expert'
52
+ prompt: 'Evaluate user experience implications and usability requirements. Ensure user needs and workflows are properly defined. Identify potential UX challenges or accessibility concerns.'
53
+
54
+ design:
55
+ description: 'Technical design and architecture planning'
56
+ allowed_file_patterns:
57
+ - '**/*.md'
58
+ - '**/*.txt'
59
+ - '**/*.adoc'
60
+ default_instructions: |
61
+ Review requirements from `$REQUIREMENTS_DOC` and design the technical solution.
62
+
63
+ Focus on HOW to implement what's needed including architecture, technologies, data models, API design, and quality goals. Clarify performance expectations and technology preferences if not already obvious from the current analysis.
64
+
65
+ Document architectural decisions in `$ARCHITECTURE_DOC` and detailed design in `$DESIGN_DOC`. Create tasks and ensure the approach is solid before implementation.
66
+ transitions:
67
+ - trigger: 'need_more_requirements'
68
+ to: 'requirements'
69
+ additional_instructions: 'Design work revealed gaps in requirements understanding. Focus on clarifying the specific requirements that are blocking design decisions.'
70
+ transition_reason: 'Design work revealed need for additional requirements clarification'
71
+
72
+ - trigger: 'design_complete'
73
+ to: 'implementation'
74
+ transition_reason: 'Technical design is complete, ready for implementation'
75
+ review_perspectives:
76
+ - perspective: 'architect'
77
+ prompt: 'Review technical architecture, design patterns, and system integration. Ensure scalability, maintainability, and alignment with existing systems. Evaluate technology choices and architectural decisions.'
78
+ - perspective: 'security_expert'
79
+ prompt: 'Evaluate security considerations, data protection, and potential vulnerabilities in the proposed design. Review authentication, authorization, data handling, and potential attack vectors.'
80
+
81
+ implementation:
82
+ description: 'Building the solution according to design'
83
+ allowed_file_patterns:
84
+ - '**/*'
85
+ default_instructions: |
86
+ Follow the architecture from `$ARCHITECTURE_DOC` and detailed design from `$DESIGN_DOC` to build the solution.
87
+
88
+ Before starting, clarify the approach:
89
+ - Should this be implemented incrementally or all at once? Any specific order of implementation?
90
+ - Are there high-risk parts that need extra validation or careful implementation?
91
+
92
+ Ensure requirements from `$REQUIREMENTS_DOC` are met. Focus on code structure, error handling, security, and maintainability. Write clean, well-documented code and include basic testing. Update task progress during implementation work.
93
+ transitions:
94
+ - trigger: 'need_design_changes'
95
+ to: 'design'
96
+ additional_instructions: "Implementation revealed issues with the current design. Consider what you've learned during coding and adjust the design accordingly. Document the changes and reasons."
97
+ transition_reason: 'Implementation work revealed need to revise the design'
98
+
99
+ - trigger: 'need_more_requirements'
100
+ to: 'requirements'
101
+ additional_instructions: 'Implementation revealed gaps in requirements understanding. Focus on clarifying the specific requirements that are blocking implementation.'
102
+ transition_reason: 'Implementation work revealed need for additional requirements'
103
+
104
+ - trigger: 'implementation_complete'
105
+ to: 'qa'
106
+ transition_reason: 'Core implementation is complete, ready for quality assurance'
107
+ review_perspectives:
108
+ - perspective: 'senior_software_developer'
109
+ prompt: 'Review code quality, best practices, and implementation approach. Ensure clean, maintainable, and efficient code. Check for proper error handling, logging, and code organization.'
110
+ - perspective: 'performance_engineer'
111
+ prompt: 'Assess performance implications, resource usage, and potential bottlenecks in the implementation. Review algorithms, data structures, and system resource utilization.'
112
+
113
+ qa:
114
+ description: 'Quality assurance and code review'
115
+ allowed_file_patterns:
116
+ - '**/*'
117
+ default_instructions: |
118
+ Perform systematic quality checks and code review:
119
+
120
+ **STEP 1: Automated Quality Checks**
121
+ - Run syntax checking tools or validate syntax manually
122
+ - Build the project to verify it compiles without errors
123
+ - Execute linting tools to ensure code style consistency
124
+ - Run existing tests to verify functionality
125
+
126
+ **STEP 2: Multi-Perspective Code Review**
127
+ Conduct code review from security, performance, UX, maintainability, and requirement compliance perspectives. Verify implementation matches `$DESIGN_DOC` specifications and fulfills targeted requirements from `$REQUIREMENTS_DOC`.
128
+
129
+ Update task progress and mark completed work during QA review.
130
+ transitions:
131
+ - trigger: 'need_implementation_fixes'
132
+ to: 'implementation'
133
+ additional_instructions: 'Quality assurance revealed issues that require code changes. Focus on the specific problems identified during QA review.'
134
+ transition_reason: 'QA found issues requiring implementation fixes'
135
+
136
+ - trigger: 'need_design_changes'
137
+ to: 'design'
138
+ additional_instructions: 'Quality assurance revealed fundamental design issues. Consider the QA findings and adjust the design accordingly.'
139
+ transition_reason: 'QA found issues requiring design changes'
140
+
141
+ - trigger: 'qa_complete'
142
+ to: 'testing'
143
+ transition_reason: 'Quality assurance is complete, ready for comprehensive testing'
144
+
145
+ testing:
146
+ description: 'Comprehensive testing and validation'
147
+ allowed_file_patterns:
148
+ - '**/*'
149
+ default_instructions: |
150
+ Create and execute comprehensive test plans to validate feature completeness.
151
+
152
+ - Write and execute tests with focus on test coverage and edge cases
153
+ - Conduct integration testing to ensure all components work together
154
+ - Validate user acceptance and ensure everything works as expected
155
+ transitions:
156
+ - trigger: 'need_implementation_fixes'
157
+ to: 'implementation'
158
+ additional_instructions: 'Testing revealed bugs or issues that require code changes. Focus on the specific problems identified during testing.'
159
+ transition_reason: 'Testing found issues requiring implementation fixes'
160
+
161
+ - trigger: 'need_qa_review'
162
+ to: 'qa'
163
+ additional_instructions: 'Testing revealed quality issues that need additional QA review. Focus on the specific quality concerns identified.'
164
+ transition_reason: 'Testing found issues requiring additional QA review'
165
+
166
+ - trigger: 'testing_complete'
167
+ to: 'finalize'
168
+ transition_reason: 'All testing is complete, feature is ready for delivery'
169
+ review_perspectives:
170
+ - perspective: 'business_analyst'
171
+ prompt: 'Verify that all requirements have been met and business objectives are achieved. Ensure the solution delivers the expected business value and meets acceptance criteria.'
172
+ - perspective: 'ux_expert'
173
+ prompt: 'Confirm user experience goals are met and the solution is user-friendly and accessible. Validate that user workflows are intuitive and efficient.'
174
+
175
+ finalize:
176
+ description: 'Code cleanup and documentation finalization'
177
+ allowed_file_patterns:
178
+ - '**/*'
179
+ default_instructions: |
180
+ Complete the feature by cleaning up code and updating documentation.
181
+
182
+ **STEP 1: Code Cleanup**
183
+
184
+ Remove debug output and temporary code:
185
+ - Search for and remove all temporary debug output statements used during development
186
+ - Look for language-specific debug output methods (console logging, print statements, debug output functions)
187
+
188
+ Review and address TODO/FIXME comments:
189
+ - Address each TODO/FIXME comment by either implementing the solution or documenting why it's deferred
190
+ - Remove completed TODOs
191
+ - Convert remaining TODOs to proper issue tracking if needed
192
+
193
+ Remove debugging code blocks:
194
+ - Remove temporary debugging code, test code blocks, and commented-out code
195
+ - Clean up any experimental code that's no longer needed
196
+ - Ensure proper error handling replaces temporary debug logging
197
+
198
+ **STEP 2: Documentation Review**
199
+
200
+ Review and update documentation to reflect final implementation:
201
+ - Update `$REQUIREMENTS_DOC` if requirements changed during development
202
+ - Update `$ARCHITECTURE_DOC` if architectural decisions evolved
203
+ - Update `$DESIGN_DOC` if design details were refined or changed
204
+ - Compare documentation against actual implemented functionality
205
+ - Only modify documentation sections that have functional changes
206
+ - Remove references to development iterations, progress notes, and temporary decisions
207
+ - Ensure documentation describes the final implemented state, not the development process
208
+ - Ask user to review document updates
209
+
210
+ **STEP 3: Final Validation**
211
+
212
+ - Run existing tests to ensure cleanup didn't break functionality
213
+ - Verify documentation accuracy with a final review
214
+ - Ensure code is ready for production/delivery
215
+
216
+ Update task progress and mark completed work as you finalize the feature.
217
+ transitions:
218
+ - trigger: 'need_final_changes'
219
+ to: 'implementation'
220
+ additional_instructions: 'Finalization revealed issues that require code changes. Focus on the specific problems identified during final review.'
221
+ transition_reason: 'Final review found issues requiring implementation changes'
222
+
223
+ - trigger: 'finalization_complete'
224
+ to: 'requirements'
225
+ transition_reason: 'Feature delivery complete, beginning new development cycle'
@@ -0,0 +1,46 @@
1
+ {
2
+ "name": "@codemcp/workflows-opencode-tui",
3
+ "version": "6.5.1",
4
+ "description": "OpenCode TUI sidebar plugin that displays the current responsible-vibe workflow phase and name",
5
+ "main": "workflows-phase.tsx",
6
+ "exports": {
7
+ "./tui": "./workflows-phase.tsx"
8
+ },
9
+ "files": [
10
+ "workflows-phase.tsx"
11
+ ],
12
+ "publishConfig": {
13
+ "access": "public"
14
+ },
15
+ "scripts": {
16
+ "typecheck": "tsc --noEmit",
17
+ "lint": "oxlint .",
18
+ "lint:fix": "oxlint --fix .",
19
+ "format:check": "prettier --check .",
20
+ "format": "prettier --write ."
21
+ },
22
+ "peerDependencies": {
23
+ "@opencode-ai/plugin": "*",
24
+ "@opentui/solid": "*",
25
+ "solid-js": "*"
26
+ },
27
+ "devDependencies": {
28
+ "@opencode-ai/plugin": "*",
29
+ "@opentui/solid": "*",
30
+ "@types/node": "^22.0.0",
31
+ "solid-js": "*",
32
+ "typescript": "^5.9.3"
33
+ },
34
+ "keywords": [
35
+ "opencode",
36
+ "opencode-plugin",
37
+ "opencode-tui-plugin",
38
+ "workflows",
39
+ "responsible-vibe"
40
+ ],
41
+ "license": "MIT",
42
+ "repository": {
43
+ "type": "git",
44
+ "url": "https://github.com/mrsimpson/responsible-vibe-mcp"
45
+ }
46
+ }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@codemcp/workflows-visualizer",
3
- "version": "6.4.0",
3
+ "version": "6.5.1",
4
4
  "type": "module",
5
5
  "main": "dist/index.ts",
6
6
  "module": "dist/index.ts",
@@ -26,6 +26,10 @@ metadata:
26
26
  states:
27
27
  reproduce:
28
28
  description: 'Reproduce and understand the bug'
29
+ allowed_file_patterns:
30
+ - '**/*.md'
31
+ - '**/*.txt'
32
+ - '**/*.adoc'
29
33
  default_instructions: |
30
34
  Gather specific information to reliably reproduce the reported bug:
31
35
  - What are the exact OS, browser/runtime versions, and hardware specs?
@@ -42,6 +46,10 @@ states:
42
46
 
43
47
  analyze:
44
48
  description: 'Analyze the bug and identify root cause'
49
+ allowed_file_patterns:
50
+ - '**/*.md'
51
+ - '**/*.txt'
52
+ - '**/*.adoc'
45
53
  default_instructions: Examine the code paths involved in the bug, identify the root cause, and understand why the issue occurs. Use debugging tools, add logging, and trace through the problematic code. Document your analysis and create tasks as needed.
46
54
  transitions:
47
55
  - trigger: 'need_more_reproduction'
@@ -66,6 +74,8 @@ states:
66
74
 
67
75
  fix:
68
76
  description: 'Implement the bug fix'
77
+ allowed_file_patterns:
78
+ - '**/*'
69
79
  default_instructions: |
70
80
  Implement the solution based on your analysis:
71
81
 
@@ -100,6 +110,8 @@ states:
100
110
 
101
111
  verify:
102
112
  description: 'Verify the fix and ensure no regressions'
113
+ allowed_file_patterns:
114
+ - '**/*'
103
115
  default_instructions: Test the fix thoroughly to ensure the original bug is resolved and no new issues were introduced. Run existing tests, create new ones if needed, and verify the solution is robust.
104
116
  transitions:
105
117
  - trigger: 'fix_needs_adjustment'
@@ -123,6 +135,8 @@ states:
123
135
 
124
136
  finalize:
125
137
  description: 'Code cleanup and documentation finalization'
138
+ allowed_file_patterns:
139
+ - '**/*'
126
140
  default_instructions: |
127
141
  Ensure code quality and documentation accuracy through systematic cleanup and review.
128
142
 
@@ -26,6 +26,10 @@ metadata:
26
26
  states:
27
27
  explore:
28
28
  description: 'Research and exploration phase - understanding the problem space'
29
+ allowed_file_patterns:
30
+ - '**/*.md'
31
+ - '**/*.txt'
32
+ - '**/*.adoc'
29
33
  default_instructions: |
30
34
  Research the codebase to understand existing patterns and gather context about the problem space.
31
35
 
@@ -43,6 +47,10 @@ states:
43
47
 
44
48
  plan:
45
49
  description: 'Planning phase - creating a detailed implementation strategy'
50
+ allowed_file_patterns:
51
+ - '**/*.md'
52
+ - '**/*.txt'
53
+ - '**/*.adoc'
46
54
  default_instructions: |
47
55
  Create a detailed implementation strategy based on your exploration:
48
56
 
@@ -83,6 +91,8 @@ states:
83
91
 
84
92
  code:
85
93
  description: 'Implementation phase - writing and building the solution'
94
+ allowed_file_patterns:
95
+ - '**/*'
86
96
  default_instructions: |
87
97
  Follow your plan to build the solution:
88
98
 
@@ -124,6 +134,8 @@ states:
124
134
 
125
135
  commit:
126
136
  description: 'Code cleanup and documentation finalization'
137
+ allowed_file_patterns:
138
+ - '**/*'
127
139
  default_instructions: >
128
140
  Ensure code quality and documentation accuracy through systematic cleanup and review.
129
141
 
@@ -27,6 +27,10 @@ metadata:
27
27
  states:
28
28
  ideation:
29
29
  description: 'Deep requirements discovery and PRD creation phase'
30
+ allowed_file_patterns:
31
+ - '**/*.md'
32
+ - '**/*.txt'
33
+ - '**/*.adoc'
30
34
  default_instructions: |
31
35
  Understand WHAT the system should do, WHO will use it, WHY it's needed, and WHAT'S in/out of scope by exploring:
32
36
  - Are there existing solutions? What gaps do they have?
@@ -47,6 +51,10 @@ states:
47
51
 
48
52
  architecture:
49
53
  description: 'Tech stack selection and architecture design phase'
54
+ allowed_file_patterns:
55
+ - '**/*.md'
56
+ - '**/*.txt'
57
+ - '**/*.adoc'
50
58
  default_instructions: |
51
59
  Design the technical solution based on requirements from `$REQUIREMENTS_DOC`.
52
60
 
@@ -82,6 +90,10 @@ states:
82
90
 
83
91
  plan:
84
92
  description: 'Implementation planning phase based on established architecture'
93
+ allowed_file_patterns:
94
+ - '**/*.md'
95
+ - '**/*.txt'
96
+ - '**/*.adoc'
85
97
  default_instructions: |
86
98
  Create a detailed implementation strategy based on your completed architecture in `$ARCHITECTURE_DOC` and requirements from `$REQUIREMENTS_DOC`.
87
99
 
@@ -118,6 +130,8 @@ states:
118
130
 
119
131
  code:
120
132
  description: 'Implementation phase following the established plan and architecture'
133
+ allowed_file_patterns:
134
+ - '**/*'
121
135
  default_instructions: |
122
136
  Build the solution following your plan and detailed design from `$DESIGN_DOC` using the architecture from `$ARCHITECTURE_DOC`.
123
137
 
@@ -151,6 +165,8 @@ states:
151
165
 
152
166
  finalize:
153
167
  description: 'Code cleanup and documentation finalization'
168
+ allowed_file_patterns:
169
+ - '**/*'
154
170
  default_instructions: |
155
171
  This phase ensures code quality and documentation accuracy through systematic cleanup and review.
156
172
 
@@ -26,6 +26,10 @@ metadata:
26
26
  states:
27
27
  explore:
28
28
  description: 'Analysis and design phase - understanding and planning without implementation'
29
+ allowed_file_patterns:
30
+ - '**/*.md'
31
+ - '**/*.txt'
32
+ - '**/*.adoc'
29
33
  default_instructions: >
30
34
  Understand the problem, analyze existing patterns, and design your approach.
31
35
  Consider the scope and impact of the change.
@@ -49,6 +53,8 @@ states:
49
53
 
50
54
  implement:
51
55
  description: 'Combined implementation phase - code, test, and commit'
56
+ allowed_file_patterns:
57
+ - '**/*'
52
58
  default_instructions: >
53
59
  Write clean, focused code for the minor enhancement, test your changes, and prepare for commit.
54
60
 
@@ -85,6 +91,8 @@ states:
85
91
 
86
92
  finalize:
87
93
  description: 'Code cleanup and documentation finalization'
94
+ allowed_file_patterns:
95
+ - '**/*'
88
96
  default_instructions: >
89
97
  Ensure code quality and documentation accuracy through systematic cleanup and review.
90
98
 
@@ -26,6 +26,10 @@ metadata:
26
26
  states:
27
27
  explore:
28
28
  description: 'Research and exploration phase - understanding the problem space and codebase'
29
+ allowed_file_patterns:
30
+ - '**/*.md'
31
+ - '**/*.txt'
32
+ - '**/*.adoc'
29
33
  default_instructions: |
30
34
  **STEP 1:** Gather context about what needs to be developed. Focus on the WHY and WHAT, not the HOW.
31
35
 
@@ -46,6 +50,8 @@ states:
46
50
 
47
51
  red:
48
52
  description: 'RED phase - Write a failing test that defines the expected behavior'
53
+ allowed_file_patterns:
54
+ - '**/*'
49
55
  default_instructions: |
50
56
  Write a failing test that defines the expected behavior for the feature.
51
57
 
@@ -81,6 +87,8 @@ states:
81
87
 
82
88
  green:
83
89
  description: 'GREEN phase - Write only the necessary code to make the test pass'
90
+ allowed_file_patterns:
91
+ - '**/*'
84
92
  default_instructions: |
85
93
  Implement the necessary code to make the failing test pass with proper functionality.
86
94
 
@@ -120,6 +128,8 @@ states:
120
128
 
121
129
  refactor:
122
130
  description: 'REFACTOR phase - Improve code quality while keeping tests green (cleanup phase)'
131
+ allowed_file_patterns:
132
+ - '**/*'
123
133
  default_instructions: |
124
134
  Improve code quality while keeping all tests green. This is the cleanup phase where you enhance readability and maintainability.
125
135