@codemcp/workflows 6.3.1 → 6.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +2 -2
- package/packages/cli/dist/{chunk-D2Q6Y3QQ.js → chunk-4AZGS2GG.js} +321 -388
- package/packages/cli/dist/{cli-QV7U6L54.js → cli-ZCCFBQTP.js} +12 -17
- package/packages/cli/dist/{dist-W7PPKVFG.js → dist-I6VSREAJ.js} +11 -5
- package/packages/cli/dist/{dist-W7VMGB3G.js → dist-MW7THWM3.js} +875 -1136
- package/packages/cli/dist/index.js +2 -2
- package/packages/cli/package.json +1 -1
- package/packages/cli/resources/workflows/bugfix.yaml +14 -0
- package/packages/cli/resources/workflows/epcc.yaml +12 -0
- package/packages/cli/resources/workflows/greenfield.yaml +16 -0
- package/packages/cli/resources/workflows/minor.yaml +8 -0
- package/packages/cli/resources/workflows/skilled-bugfix.yaml +6 -6
- package/packages/cli/resources/workflows/skilled-epcc.yaml +8 -8
- package/packages/cli/resources/workflows/skilled-greenfield.yaml +8 -7
- package/packages/cli/resources/workflows/tdd.yaml +10 -0
- package/packages/cli/resources/workflows/waterfall.yaml +16 -0
- package/packages/core/dist/beads-integration.d.ts +3 -5
- package/packages/core/dist/beads-integration.js +29 -35
- package/packages/core/dist/beads-integration.js.map +1 -1
- package/packages/core/dist/beads-state-manager.d.ts +3 -1
- package/packages/core/dist/beads-state-manager.js +17 -15
- package/packages/core/dist/beads-state-manager.js.map +1 -1
- package/packages/core/dist/file-detection-manager.js +15 -22
- package/packages/core/dist/file-detection-manager.js.map +1 -1
- package/packages/core/dist/index.d.ts +1 -0
- package/packages/core/dist/index.js +1 -0
- package/packages/core/dist/index.js.map +1 -1
- package/packages/core/dist/instruction-generator.d.ts +3 -7
- package/packages/core/dist/instruction-generator.js +17 -25
- package/packages/core/dist/instruction-generator.js.map +1 -1
- package/packages/core/dist/interfaces/instruction-generator.interface.d.ts +13 -4
- package/packages/core/dist/interfaces/plan-manager.interface.d.ts +9 -0
- package/packages/core/dist/logger.d.ts +49 -20
- package/packages/core/dist/logger.js +65 -141
- package/packages/core/dist/logger.js.map +1 -1
- package/packages/core/dist/plan-manager.d.ts +6 -4
- package/packages/core/dist/plan-manager.js +19 -15
- package/packages/core/dist/plan-manager.js.map +1 -1
- package/packages/core/dist/project-docs-manager.d.ts +3 -1
- package/packages/core/dist/project-docs-manager.js +11 -9
- package/packages/core/dist/project-docs-manager.js.map +1 -1
- package/packages/core/dist/state-machine-loader.d.ts +16 -0
- package/packages/core/dist/state-machine-loader.js +29 -0
- package/packages/core/dist/state-machine-loader.js.map +1 -1
- package/packages/core/dist/state-machine-types.d.ts +8 -0
- package/packages/core/dist/string-utils.d.ts +8 -0
- package/packages/core/dist/string-utils.js +14 -0
- package/packages/core/dist/string-utils.js.map +1 -0
- package/packages/core/dist/task-backend.d.ts +6 -3
- package/packages/core/dist/task-backend.js +10 -8
- package/packages/core/dist/task-backend.js.map +1 -1
- package/packages/core/dist/transition-engine.d.ts +3 -6
- package/packages/core/dist/transition-engine.js +31 -76
- package/packages/core/dist/transition-engine.js.map +1 -1
- package/packages/core/dist/workflow-manager.d.ts +2 -0
- package/packages/core/dist/workflow-manager.js +14 -2
- package/packages/core/dist/workflow-manager.js.map +1 -1
- package/packages/core/package.json +1 -1
- package/packages/core/resources/workflows/bugfix.yaml +14 -0
- package/packages/core/resources/workflows/epcc.yaml +12 -0
- package/packages/core/resources/workflows/greenfield.yaml +16 -0
- package/packages/core/resources/workflows/minor.yaml +8 -0
- package/packages/core/resources/workflows/skilled-bugfix.yaml +6 -6
- package/packages/core/resources/workflows/skilled-epcc.yaml +8 -8
- package/packages/core/resources/workflows/skilled-greenfield.yaml +8 -7
- package/packages/core/resources/workflows/tdd.yaml +10 -0
- package/packages/core/resources/workflows/waterfall.yaml +16 -0
- package/packages/docs/.vitepress/dist/404.html +1 -1
- package/packages/docs/.vitepress/dist/assets/{user_advanced-engineering.md.MkETYNtq.js → user_advanced-engineering.md.PD-xOFno.js} +2 -2
- package/packages/docs/.vitepress/dist/assets/{user_agent-setup.md.l0oJQxTR.js → user_agent-setup.md.BhcuRdG8.js} +1 -1
- package/packages/docs/.vitepress/dist/dev/ARCHITECTURE.html +1 -1
- package/packages/docs/.vitepress/dist/dev/DEVELOPMENT.html +1 -1
- package/packages/docs/.vitepress/dist/dev/LOGGING.html +1 -1
- package/packages/docs/.vitepress/dist/dev/PUBLISHING.html +1 -1
- package/packages/docs/.vitepress/dist/hashmap.json +1 -1
- package/packages/docs/.vitepress/dist/index.html +1 -1
- package/packages/docs/.vitepress/dist/user/advanced-engineering.html +4 -4
- package/packages/docs/.vitepress/dist/user/agent-setup.html +3 -3
- package/packages/docs/.vitepress/dist/user/beads-integration.html +1 -1
- package/packages/docs/.vitepress/dist/user/crowd-mcp-integration.html +1 -1
- package/packages/docs/.vitepress/dist/user/custom-workflows.html +1 -1
- package/packages/docs/.vitepress/dist/user/git-commit-feature.html +1 -1
- package/packages/docs/.vitepress/dist/user/how-it-works.html +1 -1
- package/packages/docs/.vitepress/dist/user/long-term-memory.html +1 -1
- package/packages/docs/.vitepress/dist/user/packaged-workflows.html +1 -1
- package/packages/docs/.vitepress/dist/user/tutorial.html +1 -1
- package/packages/docs/.vitepress/dist/user/workflow-selection.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/adr.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/big-bang-conversion.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/boundary-testing.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/bugfix.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/bugfix.yaml +14 -0
- package/packages/docs/.vitepress/dist/workflows/business-analysis.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/c4-analysis.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/epcc.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/epcc.yaml +12 -0
- package/packages/docs/.vitepress/dist/workflows/game-beginner.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/greenfield.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/greenfield.yaml +16 -0
- package/packages/docs/.vitepress/dist/workflows/minor.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/minor.yaml +8 -0
- package/packages/docs/.vitepress/dist/workflows/posts.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/sdd-bugfix-crowd.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/sdd-bugfix.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/sdd-feature-crowd.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/sdd-feature.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/sdd-greenfield-crowd.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/sdd-greenfield.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/skilled-bugfix.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/skilled-bugfix.yaml +6 -6
- package/packages/docs/.vitepress/dist/workflows/skilled-epcc.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/skilled-epcc.yaml +8 -8
- package/packages/docs/.vitepress/dist/workflows/skilled-greenfield.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/skilled-greenfield.yaml +8 -7
- package/packages/docs/.vitepress/dist/workflows/slides.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/tdd.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/tdd.yaml +10 -0
- package/packages/docs/.vitepress/dist/workflows/waterfall.html +1 -1
- package/packages/docs/.vitepress/dist/workflows/waterfall.yaml +16 -0
- package/packages/docs/.vitepress/dist/workflows.html +1 -1
- package/packages/docs/package.json +1 -1
- package/packages/mcp-server/dist/index.d.ts +1027 -0
- package/packages/mcp-server/dist/index.js +879 -1140
- package/packages/mcp-server/package.json +1 -1
- package/packages/mcp-server/resources/workflows/bugfix.yaml +14 -0
- package/packages/mcp-server/resources/workflows/epcc.yaml +12 -0
- package/packages/mcp-server/resources/workflows/greenfield.yaml +16 -0
- package/packages/mcp-server/resources/workflows/minor.yaml +8 -0
- package/packages/mcp-server/resources/workflows/skilled-bugfix.yaml +6 -6
- package/packages/mcp-server/resources/workflows/skilled-epcc.yaml +8 -8
- package/packages/mcp-server/resources/workflows/skilled-greenfield.yaml +8 -7
- package/packages/mcp-server/resources/workflows/tdd.yaml +10 -0
- package/packages/mcp-server/resources/workflows/waterfall.yaml +16 -0
- package/packages/opencode-plugin/dist/index.d.ts +9 -0
- package/packages/opencode-plugin/dist/index.js +11 -0
- package/packages/opencode-plugin/dist/index.js.map +1 -0
- package/packages/opencode-plugin/dist/opencode-logger.d.ts +21 -0
- package/packages/opencode-plugin/dist/opencode-logger.js +104 -0
- package/packages/opencode-plugin/dist/opencode-logger.js.map +1 -0
- package/packages/opencode-plugin/dist/plugin.d.ts +23 -0
- package/packages/opencode-plugin/dist/plugin.js +395 -0
- package/packages/opencode-plugin/dist/plugin.js.map +1 -0
- package/packages/opencode-plugin/dist/server-context.d.ts +40 -0
- package/packages/opencode-plugin/dist/server-context.js +96 -0
- package/packages/opencode-plugin/dist/server-context.js.map +1 -0
- package/packages/opencode-plugin/dist/tool-handlers/conduct-review.d.ts +3 -0
- package/packages/opencode-plugin/dist/tool-handlers/conduct-review.js +37 -0
- package/packages/opencode-plugin/dist/tool-handlers/conduct-review.js.map +1 -0
- package/packages/opencode-plugin/dist/tool-handlers/proceed-to-phase.d.ts +3 -0
- package/packages/opencode-plugin/dist/tool-handlers/proceed-to-phase.js +74 -0
- package/packages/opencode-plugin/dist/tool-handlers/proceed-to-phase.js.map +1 -0
- package/packages/opencode-plugin/dist/tool-handlers/reset-development.d.ts +3 -0
- package/packages/opencode-plugin/dist/tool-handlers/reset-development.js +63 -0
- package/packages/opencode-plugin/dist/tool-handlers/reset-development.js.map +1 -0
- package/packages/opencode-plugin/dist/tool-handlers/setup-project-docs.d.ts +3 -0
- package/packages/opencode-plugin/dist/tool-handlers/setup-project-docs.js +74 -0
- package/packages/opencode-plugin/dist/tool-handlers/setup-project-docs.js.map +1 -0
- package/packages/opencode-plugin/dist/tool-handlers/start-development.d.ts +3 -0
- package/packages/opencode-plugin/dist/tool-handlers/start-development.js +69 -0
- package/packages/opencode-plugin/dist/tool-handlers/start-development.js.map +1 -0
- package/packages/opencode-plugin/dist/tool-handlers/tool-helper.d.ts +10 -0
- package/packages/opencode-plugin/dist/tool-handlers/tool-helper.js +7 -0
- package/packages/opencode-plugin/dist/tool-handlers/tool-helper.js.map +1 -0
- package/packages/opencode-plugin/dist/types.d.ts +193 -0
- package/packages/opencode-plugin/dist/types.js +8 -0
- package/packages/opencode-plugin/dist/types.js.map +1 -0
- package/packages/opencode-plugin/dist/utils.d.ts +14 -0
- package/packages/opencode-plugin/dist/utils.js +26 -0
- package/packages/opencode-plugin/dist/utils.js.map +1 -0
- package/packages/opencode-plugin/package.json +52 -0
- package/packages/opencode-tui-plugin/package.json +46 -0
- package/packages/visualizer/package.json +1 -1
- package/resources/workflows/bugfix.yaml +14 -0
- package/resources/workflows/epcc.yaml +12 -0
- package/resources/workflows/greenfield.yaml +16 -0
- package/resources/workflows/minor.yaml +8 -0
- package/resources/workflows/skilled-bugfix.yaml +6 -6
- package/resources/workflows/skilled-epcc.yaml +8 -8
- package/resources/workflows/skilled-greenfield.yaml +8 -7
- package/resources/workflows/tdd.yaml +10 -0
- package/resources/workflows/waterfall.yaml +16 -0
- /package/packages/docs/.vitepress/dist/assets/{user_advanced-engineering.md.MkETYNtq.lean.js → user_advanced-engineering.md.PD-xOFno.lean.js} +0 -0
- /package/packages/docs/.vitepress/dist/assets/{user_agent-setup.md.l0oJQxTR.lean.js → user_agent-setup.md.BhcuRdG8.lean.js} +0 -0
- /package/resources/skills/application-design/{application-design.md → SKILL.md} +0 -0
- /package/resources/skills/architecture/{SKILL.md.md → SKILL.md} +0 -0
|
@@ -28,13 +28,14 @@ states:
|
|
|
28
28
|
description: 'Deep requirements discovery and PRD creation phase'
|
|
29
29
|
default_instructions: |
|
|
30
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
|
+
|
|
31
34
|
- Are there existing solutions? What gaps do they have?
|
|
32
35
|
- What technologies must/cannot be used? Why?
|
|
33
36
|
- How will you measure product success?
|
|
34
37
|
- Have you validated this need with potential users?
|
|
35
38
|
|
|
36
|
-
Use your **starting-project** skill if available, or ask the user about their project setup practices and conventions.
|
|
37
|
-
|
|
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.
|
|
39
40
|
transitions:
|
|
40
41
|
- trigger: 'ideation_complete'
|
|
@@ -51,11 +52,11 @@ states:
|
|
|
51
52
|
default_instructions: |
|
|
52
53
|
Design the technical solution based on the requirements discovered during ideation.
|
|
53
54
|
|
|
55
|
+
- **Apply your architecture skill.** If unavailable, ask user about architectural conventions.
|
|
54
56
|
- Ask about the user's technical preferences and experience
|
|
55
57
|
- Challenge their choices by presenting alternatives
|
|
56
58
|
- Evaluate pros and cons of different tech stacks, frameworks, and architectural patterns
|
|
57
59
|
- Consider non-functional requirements like scalability, performance, maintainability, and deployment
|
|
58
|
-
- Use your **architecture** skill if available, or ask the user about their architectural conventions
|
|
59
60
|
|
|
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.
|
|
61
62
|
transitions:
|
|
@@ -87,7 +88,7 @@ states:
|
|
|
87
88
|
default_instructions: |
|
|
88
89
|
Create a detailed implementation strategy based on your completed architecture and requirements.
|
|
89
90
|
|
|
90
|
-
-
|
|
91
|
+
- **Apply your application-design skill.** If unavailable, ask user about application design practices.
|
|
91
92
|
- Check whether there is a design document in the project and adhere to it
|
|
92
93
|
|
|
93
94
|
**STEP 1: Break Down Work**
|
|
@@ -126,10 +127,10 @@ states:
|
|
|
126
127
|
default_instructions: |
|
|
127
128
|
Build the solution following your plan and architecture.
|
|
128
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.
|
|
129
132
|
- Check whether there is a design document in the project and follow it
|
|
130
133
|
- Check whether there is a requirements document in the project and ensure all requirements you are currently working on are met
|
|
131
|
-
- Use your **coding** skill if available, or ask the user about their coding practices and patterns
|
|
132
|
-
- Use your **testing** skill if available, or ask the user about their testing practices
|
|
133
134
|
- Write clean, well-structured code with proper error handling
|
|
134
135
|
- Prevent regression by building, linting, and executing existing tests
|
|
135
136
|
- Stay flexible and adapt the plan as you learn more during implementation, but maintain alignment with your architecture decisions
|
|
@@ -186,7 +187,7 @@ states:
|
|
|
186
187
|
Ensure project has complete documentation for newcomers including setup, usage, architecture overview, and contribution guidelines.
|
|
187
188
|
|
|
188
189
|
**STEP 4: Final Validation**
|
|
189
|
-
-
|
|
190
|
+
- **Apply your testing skill.** If unavailable, ask user about testing practices.
|
|
190
191
|
- Verify documentation accuracy with a final review
|
|
191
192
|
- Ensure project is ready for users and contributors
|
|
192
193
|
- Update task progress and mark completed work as you finalize the project
|
|
@@ -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
|
|
|
@@ -27,6 +27,10 @@ metadata:
|
|
|
27
27
|
states:
|
|
28
28
|
requirements:
|
|
29
29
|
description: 'Gathering and analyzing requirements'
|
|
30
|
+
allowed_file_patterns:
|
|
31
|
+
- '**/*.md'
|
|
32
|
+
- '**/*.txt'
|
|
33
|
+
- '**/*.adoc'
|
|
30
34
|
default_instructions: |
|
|
31
35
|
Familiarize yourself with the code base and understand project goals, scope, constraints, and success criteria.
|
|
32
36
|
|
|
@@ -49,6 +53,10 @@ states:
|
|
|
49
53
|
|
|
50
54
|
design:
|
|
51
55
|
description: 'Technical design and architecture planning'
|
|
56
|
+
allowed_file_patterns:
|
|
57
|
+
- '**/*.md'
|
|
58
|
+
- '**/*.txt'
|
|
59
|
+
- '**/*.adoc'
|
|
52
60
|
default_instructions: |
|
|
53
61
|
Review requirements from `$REQUIREMENTS_DOC` and design the technical solution.
|
|
54
62
|
|
|
@@ -72,6 +80,8 @@ states:
|
|
|
72
80
|
|
|
73
81
|
implementation:
|
|
74
82
|
description: 'Building the solution according to design'
|
|
83
|
+
allowed_file_patterns:
|
|
84
|
+
- '**/*'
|
|
75
85
|
default_instructions: |
|
|
76
86
|
Follow the architecture from `$ARCHITECTURE_DOC` and detailed design from `$DESIGN_DOC` to build the solution.
|
|
77
87
|
|
|
@@ -102,6 +112,8 @@ states:
|
|
|
102
112
|
|
|
103
113
|
qa:
|
|
104
114
|
description: 'Quality assurance and code review'
|
|
115
|
+
allowed_file_patterns:
|
|
116
|
+
- '**/*'
|
|
105
117
|
default_instructions: |
|
|
106
118
|
Perform systematic quality checks and code review:
|
|
107
119
|
|
|
@@ -132,6 +144,8 @@ states:
|
|
|
132
144
|
|
|
133
145
|
testing:
|
|
134
146
|
description: 'Comprehensive testing and validation'
|
|
147
|
+
allowed_file_patterns:
|
|
148
|
+
- '**/*'
|
|
135
149
|
default_instructions: |
|
|
136
150
|
Create and execute comprehensive test plans to validate feature completeness.
|
|
137
151
|
|
|
@@ -160,6 +174,8 @@ states:
|
|
|
160
174
|
|
|
161
175
|
finalize:
|
|
162
176
|
description: 'Code cleanup and documentation finalization'
|
|
177
|
+
allowed_file_patterns:
|
|
178
|
+
- '**/*'
|
|
163
179
|
default_instructions: |
|
|
164
180
|
Complete the feature by cleaning up code and updating documentation.
|
|
165
181
|
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
</head>
|
|
18
18
|
<body>
|
|
19
19
|
<div id="app"></div>
|
|
20
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"da_vFDwM\",\"dev_development.md\":\"DWl9cccE\",\"dev_logging.md\":\"BebvbW7z\",\"dev_publishing.md\":\"CQqbiIOF\",\"index.md\":\"D6ROLohf\",\"user_advanced-engineering.md\":\"
|
|
20
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"da_vFDwM\",\"dev_development.md\":\"DWl9cccE\",\"dev_logging.md\":\"BebvbW7z\",\"dev_publishing.md\":\"CQqbiIOF\",\"index.md\":\"D6ROLohf\",\"user_advanced-engineering.md\":\"PD-xOFno\",\"user_agent-setup.md\":\"BhcuRdG8\",\"user_beads-integration.md\":\"BzdR5Fif\",\"user_crowd-mcp-integration.md\":\"C15kSdIJ\",\"user_custom-workflows.md\":\"Cz4IYCXa\",\"user_git-commit-feature.md\":\"UcTvDR-O\",\"user_how-it-works.md\":\"DiOXNgaL\",\"user_long-term-memory.md\":\"DZh0tjNa\",\"user_packaged-workflows.md\":\"s1HT89ZU\",\"user_tutorial.md\":\"Dmj8zLB2\",\"user_workflow-selection.md\":\"CrPGw9Hr\",\"workflows.md\":\"Bm5sGt3u\",\"workflows_adr.md\":\"DEaXkbRp\",\"workflows_big-bang-conversion.md\":\"BA5R1LxZ\",\"workflows_boundary-testing.md\":\"DBcYnMhx\",\"workflows_bugfix.md\":\"CZRCL0Hp\",\"workflows_business-analysis.md\":\"fGLml8Hw\",\"workflows_c4-analysis.md\":\"Dnssqzuf\",\"workflows_epcc.md\":\"M6DnIhpp\",\"workflows_game-beginner.md\":\"CNxzWLtd\",\"workflows_greenfield.md\":\"vx_g-WOe\",\"workflows_minor.md\":\"DdnfwMf4\",\"workflows_posts.md\":\"SOldXvq7\",\"workflows_sdd-bugfix-crowd.md\":\"-lSf42gJ\",\"workflows_sdd-bugfix.md\":\"oRAsEVbc\",\"workflows_sdd-feature-crowd.md\":\"DAtnfCAd\",\"workflows_sdd-feature.md\":\"Ce3-H_g3\",\"workflows_sdd-greenfield-crowd.md\":\"8DUvcmLe\",\"workflows_sdd-greenfield.md\":\"eEN6U0J4\",\"workflows_skilled-bugfix.md\":\"YyOU6NjA\",\"workflows_skilled-epcc.md\":\"BGeI6g1n\",\"workflows_skilled-greenfield.md\":\"CKxrbPQ-\",\"workflows_slides.md\":\"Cqt-19_1\",\"workflows_tdd.md\":\"BjVC69tu\",\"workflows_waterfall.md\":\"CL6jTZP9\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Responsible Vibe MCP\",\"description\":\"Model Context Protocol server for intelligent conversation state management and development guidance\",\"base\":\"/responsible-vibe-mcp/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"Documentation\",\"link\":\"/\"},{\"text\":\"Workflows\",\"link\":\"/workflows\"},{\"text\":\"Github\",\"link\":\"https://github.com/mrsimpson/responsible-vibe-mcp\"}],\"sidebar\":[{\"text\":\"User Guide\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"How It Works\",\"link\":\"/user/how-it-works\"},{\"text\":\"Agent Setup\",\"link\":\"/user/agent-setup\"},{\"text\":\"Vibe Engineering\",\"link\":\"/user/advanced-engineering\"},{\"text\":\"Long-Term Memory\",\"link\":\"/user/long-term-memory\"},{\"text\":\"Beads-Integration\",\"link\":\"/user/beads-integration\"},{\"text\":\"Tutorial\",\"link\":\"/user/tutorial\"}]},{\"text\":\"Workflows\",\"items\":[{\"text\":\"Workflow-Selection\",\"link\":\"/user/workflow-selection\"},{\"text\":\"Packaged Workflows\",\"link\":\"/user/packaged-workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
|
|
21
21
|
|
|
22
22
|
</body>
|
|
23
23
|
</html>
|
|
@@ -8,7 +8,7 @@ import{_ as s,c as a,o as n,a0 as i}from"./chunks/framework.DZS7lpav.js";const g
|
|
|
8
8
|
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Can reference .vibe/docs/ for long-term memory when needed</span></span></code></pre></div><h3 id="explicit-reference-documentation" tabindex="-1">Explicit Reference Documentation <a class="header-anchor" href="#explicit-reference-documentation" aria-label="Permalink to "Explicit Reference Documentation""></a></h3><p>Development plans serve as <strong>process memory</strong> (actively maintained by AI) but can also be <strong>explicitly referenced</strong>:</p><p><strong>Through Commits:</strong></p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> commit</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -m</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> "implement user authentication</span></span>
|
|
9
9
|
<span class="line"></span>
|
|
10
10
|
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">See development-plan-feature-auth.md for architectural decisions</span></span>
|
|
11
|
-
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">and requirements analysis from the planning phase."</span></span></code></pre></div><p>When your AI reads this commit, it can reference the plan file to understand the context and decisions made.</p><p><strong>Through Direct Reference:</strong></p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">"Check @.vibe/development-plan-auth.md to see what we thought about back then"</span></span></code></pre></div><h2 id="rule-files-integration" tabindex="-1">Rule Files Integration <a class="header-anchor" href="#rule-files-integration" aria-label="Permalink to "Rule Files Integration""></a></h2><h3 id="process-vs-deliverable-guidance" tabindex="-1">Process vs Deliverable Guidance <a class="header-anchor" href="#process-vs-deliverable-guidance" aria-label="Permalink to "Process vs Deliverable Guidance""></a></h3><p><strong>Responsible Vibe</strong> provides <strong>HOW of the process</strong> (what phase, what to focus on)<br><strong>Rule files</strong> provide <strong>HOW of the deliverables</strong> (coding standards, conventions)</p><p><strong>Example Rule File</strong> (<code>.
|
|
11
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">and requirements analysis from the planning phase."</span></span></code></pre></div><p>When your AI reads this commit, it can reference the plan file to understand the context and decisions made.</p><p><strong>Through Direct Reference:</strong></p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">"Check @.vibe/development-plan-auth.md to see what we thought about back then"</span></span></code></pre></div><h2 id="rule-files-integration" tabindex="-1">Rule Files Integration <a class="header-anchor" href="#rule-files-integration" aria-label="Permalink to "Rule Files Integration""></a></h2><h3 id="process-vs-deliverable-guidance" tabindex="-1">Process vs Deliverable Guidance <a class="header-anchor" href="#process-vs-deliverable-guidance" aria-label="Permalink to "Process vs Deliverable Guidance""></a></h3><p><strong>Responsible Vibe</strong> provides <strong>HOW of the process</strong> (what phase, what to focus on)<br><strong>Rule files</strong> provide <strong>HOW of the deliverables</strong> (coding standards, conventions)</p><p><strong>Example Rule File</strong> (<code>.kiro/rules/comments.md</code>):</p><div class="language-markdown vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">markdown</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-light-font-weight:bold;--shiki-dark:#E1E4E8;--shiki-dark-font-weight:bold;">**Use**</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> comments to explain the purpose of a variable/method/function/class.</span></span>
|
|
12
12
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-light-font-weight:bold;--shiki-dark:#E1E4E8;--shiki-dark-font-weight:bold;">**Use**</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> meaningful variable/method/function/class names.</span></span>
|
|
13
13
|
<span class="line"></span>
|
|
14
14
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-light-font-weight:bold;--shiki-dark:#E1E4E8;--shiki-dark-font-weight:bold;">**Avoid**</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> comments that describe what the code is doing.</span></span>
|
|
@@ -34,7 +34,7 @@ import{_ as s,c as a,o as n,a0 as i}from"./chunks/framework.DZS7lpav.js";const g
|
|
|
34
34
|
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># AI automatically:</span></span>
|
|
35
35
|
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># 1. Creates development-plan-feature-payment.md for this branch's context</span></span>
|
|
36
36
|
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># 2. Can reference existing .vibe/docs/architecture.md via workflow variables</span></span>
|
|
37
|
-
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># 3. Follows your .
|
|
37
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># 3. Follows your .kiro/rules/ coding standards</span></span>
|
|
38
38
|
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># 4. Maintains separate conversation context for this branch</span></span>
|
|
39
39
|
<span class="line"></span>
|
|
40
40
|
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Document decisions in plan file during development</span></span>
|
|
@@ -5,7 +5,7 @@ import{_ as i,c as t,o as e,a0 as a}from"./chunks/framework.DZS7lpav.js";const c
|
|
|
5
5
|
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "args"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"-y"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"@codemcp/workflows-server"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]</span></span>
|
|
6
6
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
|
|
7
7
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
|
|
8
|
-
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h2 id="setup-via-cli" tabindex="-1">Setup via CLI <a class="header-anchor" href="#setup-via-cli" aria-label="Permalink to "Setup via CLI""></a></h2><p>The CLI generates both the system prompt and MCP configuration for your agent:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @codemcp/workflows</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> setup</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">targe</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">t</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [--mode </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">config</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">skill]</span></span></code></pre></div><h3 id="modes" tabindex="-1">Modes <a class="header-anchor" href="#modes" aria-label="Permalink to "Modes""></a></h3><table tabindex="0"><thead><tr><th>Mode</th><th>Description</th></tr></thead><tbody><tr><td><code>config</code></td><td>Embeds system prompt in agent configuration files (traditional approach)</td></tr><tr><td><code>skill</code></td><td>Creates <a href="https://agentskills.io" target="_blank" rel="noreferrer">agentskills.io</a> compatible skill files (on-demand loading)</td></tr></tbody></table><p><strong>Config mode</strong> is best when you always want the workflow guidance active.</p><p><strong>Skill mode</strong> is best when you want the agent to load workflow instructions only when needed.</p><h3 id="targets" tabindex="-1">Targets <a class="header-anchor" href="#targets" aria-label="Permalink to "Targets""></a></h3><table tabindex="0"><thead><tr><th>Target</th><th>Aliases</th><th>Description</th></tr></thead><tbody><tr><td><code>kiro</code></td><td><code>
|
|
8
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h2 id="setup-via-cli" tabindex="-1">Setup via CLI <a class="header-anchor" href="#setup-via-cli" aria-label="Permalink to "Setup via CLI""></a></h2><p>The CLI generates both the system prompt and MCP configuration for your agent:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @codemcp/workflows</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> setup</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">targe</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">t</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [--mode </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">config</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">skill]</span></span></code></pre></div><h3 id="modes" tabindex="-1">Modes <a class="header-anchor" href="#modes" aria-label="Permalink to "Modes""></a></h3><table tabindex="0"><thead><tr><th>Mode</th><th>Description</th></tr></thead><tbody><tr><td><code>config</code></td><td>Embeds system prompt in agent configuration files (traditional approach)</td></tr><tr><td><code>skill</code></td><td>Creates <a href="https://agentskills.io" target="_blank" rel="noreferrer">agentskills.io</a> compatible skill files (on-demand loading)</td></tr></tbody></table><p><strong>Config mode</strong> is best when you always want the workflow guidance active.</p><p><strong>Skill mode</strong> is best when you want the agent to load workflow instructions only when needed.</p><h3 id="targets" tabindex="-1">Targets <a class="header-anchor" href="#targets" aria-label="Permalink to "Targets""></a></h3><table tabindex="0"><thead><tr><th>Target</th><th>Aliases</th><th>Description</th></tr></thead><tbody><tr><td><code>kiro</code></td><td><code>kiro-cli</code>.</td><td>Kiro / Kiro CLI</td></tr><tr><td><code>claude</code></td><td><code>claude-code</code>, <code>claude-desktop</code></td><td>Claude Code</td></tr><tr><td><code>gemini</code></td><td><code>gemini-cli</code></td><td>Gemini CLI</td></tr><tr><td><code>opencode</code></td><td>-</td><td>OpenCode CLI</td></tr><tr><td><code>copilot</code></td><td><code>copilot-vscode</code>, <code>vscode</code>, <code>github-copilot</code></td><td>GitHub Copilot</td></tr></tbody></table><h3 id="examples" tabindex="-1">Examples <a class="header-anchor" href="#examples" aria-label="Permalink to "Examples""></a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Config mode - embeds system prompt (default)</span></span>
|
|
9
9
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @codemcp/workflows</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> setup</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> claude</span></span>
|
|
10
10
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @codemcp/workflows</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> setup</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> kiro</span></span>
|
|
11
11
|
<span class="line"></span>
|
|
@@ -149,7 +149,7 @@
|
|
|
149
149
|
<span class="line"></span>
|
|
150
150
|
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Pretty-print with jq</span></span>
|
|
151
151
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">cat</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .vibe/conversations/my-project-main-abc123/interactions.jsonl</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> |</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> jq</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .</span></span></code></pre></div><p><strong>Note</strong>: All interaction data is stored locally on your system and is never transmitted to external services.</p><h2 id="task-backend-architecture" tabindex="-1">Task Backend Architecture <a class="header-anchor" href="#task-backend-architecture" aria-label="Permalink to "Task Backend Architecture""></a></h2><p>The system supports multiple task management backends through a factory pattern for component substitution.</p><h3 id="backend-detection" tabindex="-1">Backend Detection <a class="header-anchor" href="#backend-detection" aria-label="Permalink to "Backend Detection""></a></h3><p>At startup, the system auto-detects the task backend. If the <code>bd</code> command is available, beads is used; otherwise markdown is used. This can be overridden via the <code>TASK_BACKEND</code> environment variable (<code>markdown</code> or <code>beads</code>).</p><h3 id="component-factory" tabindex="-1">Component Factory <a class="header-anchor" href="#component-factory" aria-label="Permalink to "Component Factory""></a></h3><p>The ServerComponentsFactory creates appropriate implementations based on detected task backend configuration.</p><h3 id="component-responsibilities" tabindex="-1">Component Responsibilities <a class="header-anchor" href="#component-responsibilities" aria-label="Permalink to "Component Responsibilities""></a></h3><p>Task management functionality varies between backends:</p><ul><li><strong>Plan Management</strong>: Markdown backends use traditional plan files with checkboxes; beads backends reference task hierarchies</li><li><strong>Instruction Generation</strong>: Markdown backends provide generic task guidance; beads backends provide CLI command guidance</li><li><strong>Task Operations</strong>: Markdown backends store tasks in plan files; beads backends integrate with CLI tools for task lifecycle management</li></ul></div></div></main><footer class="VPDocFooter" data-v-cda1d691 data-v-5253e96b><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-5253e96b><span class="visually-hidden" id="doc-footer-aria-label" data-v-5253e96b>Pager</span><div class="pager" data-v-5253e96b><!----></div><div class="pager" data-v-5253e96b><a class="VPLink link pager-link next" href="/responsible-vibe-mcp/" data-v-5253e96b><!--[--><span class="desc" data-v-5253e96b>Next page</span><span class="title" data-v-5253e96b>Overview</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
|
|
152
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"da_vFDwM\",\"dev_development.md\":\"DWl9cccE\",\"dev_logging.md\":\"BebvbW7z\",\"dev_publishing.md\":\"CQqbiIOF\",\"index.md\":\"D6ROLohf\",\"user_advanced-engineering.md\":\"
|
|
152
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"da_vFDwM\",\"dev_development.md\":\"DWl9cccE\",\"dev_logging.md\":\"BebvbW7z\",\"dev_publishing.md\":\"CQqbiIOF\",\"index.md\":\"D6ROLohf\",\"user_advanced-engineering.md\":\"PD-xOFno\",\"user_agent-setup.md\":\"BhcuRdG8\",\"user_beads-integration.md\":\"BzdR5Fif\",\"user_crowd-mcp-integration.md\":\"C15kSdIJ\",\"user_custom-workflows.md\":\"Cz4IYCXa\",\"user_git-commit-feature.md\":\"UcTvDR-O\",\"user_how-it-works.md\":\"DiOXNgaL\",\"user_long-term-memory.md\":\"DZh0tjNa\",\"user_packaged-workflows.md\":\"s1HT89ZU\",\"user_tutorial.md\":\"Dmj8zLB2\",\"user_workflow-selection.md\":\"CrPGw9Hr\",\"workflows.md\":\"Bm5sGt3u\",\"workflows_adr.md\":\"DEaXkbRp\",\"workflows_big-bang-conversion.md\":\"BA5R1LxZ\",\"workflows_boundary-testing.md\":\"DBcYnMhx\",\"workflows_bugfix.md\":\"CZRCL0Hp\",\"workflows_business-analysis.md\":\"fGLml8Hw\",\"workflows_c4-analysis.md\":\"Dnssqzuf\",\"workflows_epcc.md\":\"M6DnIhpp\",\"workflows_game-beginner.md\":\"CNxzWLtd\",\"workflows_greenfield.md\":\"vx_g-WOe\",\"workflows_minor.md\":\"DdnfwMf4\",\"workflows_posts.md\":\"SOldXvq7\",\"workflows_sdd-bugfix-crowd.md\":\"-lSf42gJ\",\"workflows_sdd-bugfix.md\":\"oRAsEVbc\",\"workflows_sdd-feature-crowd.md\":\"DAtnfCAd\",\"workflows_sdd-feature.md\":\"Ce3-H_g3\",\"workflows_sdd-greenfield-crowd.md\":\"8DUvcmLe\",\"workflows_sdd-greenfield.md\":\"eEN6U0J4\",\"workflows_skilled-bugfix.md\":\"YyOU6NjA\",\"workflows_skilled-epcc.md\":\"BGeI6g1n\",\"workflows_skilled-greenfield.md\":\"CKxrbPQ-\",\"workflows_slides.md\":\"Cqt-19_1\",\"workflows_tdd.md\":\"BjVC69tu\",\"workflows_waterfall.md\":\"CL6jTZP9\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Responsible Vibe MCP\",\"description\":\"Model Context Protocol server for intelligent conversation state management and development guidance\",\"base\":\"/responsible-vibe-mcp/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"Documentation\",\"link\":\"/\"},{\"text\":\"Workflows\",\"link\":\"/workflows\"},{\"text\":\"Github\",\"link\":\"https://github.com/mrsimpson/responsible-vibe-mcp\"}],\"sidebar\":[{\"text\":\"User Guide\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"How It Works\",\"link\":\"/user/how-it-works\"},{\"text\":\"Agent Setup\",\"link\":\"/user/agent-setup\"},{\"text\":\"Vibe Engineering\",\"link\":\"/user/advanced-engineering\"},{\"text\":\"Long-Term Memory\",\"link\":\"/user/long-term-memory\"},{\"text\":\"Beads-Integration\",\"link\":\"/user/beads-integration\"},{\"text\":\"Tutorial\",\"link\":\"/user/tutorial\"}]},{\"text\":\"Workflows\",\"items\":[{\"text\":\"Workflow-Selection\",\"link\":\"/user/workflow-selection\"},{\"text\":\"Packaged Workflows\",\"link\":\"/user/packaged-workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
|
|
153
153
|
|
|
154
154
|
</body>
|
|
155
155
|
</html>
|
|
@@ -91,7 +91,7 @@
|
|
|
91
91
|
<span class="line"><span>fix: resolve database connection issue</span></span>
|
|
92
92
|
<span class="line"><span>docs: update API documentation</span></span>
|
|
93
93
|
<span class="line"><span>test: add integration tests for phase transitions</span></span></code></pre></div><h3 id="pull-request-process" tabindex="-1">Pull Request Process <a class="header-anchor" href="#pull-request-process" aria-label="Permalink to "Pull Request Process""></a></h3><ol><li>Fork the repository</li><li>Create a feature branch</li><li>Make your changes with tests</li><li>Ensure all tests pass (<code>npm run test:all</code>)</li><li>Update documentation as needed</li><li>Submit a pull request</li></ol><h3 id="automated-checks" tabindex="-1">Automated Checks <a class="header-anchor" href="#automated-checks" aria-label="Permalink to "Automated Checks""></a></h3><p>The project includes several automated checks that run on every PR:</p><ul><li><strong>Tests</strong>: Comprehensive test suite including MCP contract tests</li><li><strong>Linting</strong>: Code style and quality checks</li><li><strong>Type Checking</strong>: TypeScript compilation verification</li><li><strong>Build Verification</strong>: Ensures the project builds successfully</li></ul><h3 id="dependency-management" tabindex="-1">Dependency Management <a class="header-anchor" href="#dependency-management" aria-label="Permalink to "Dependency Management""></a></h3><p>This project uses <strong>Renovate</strong> for automated dependency management:</p><ul><li>Automatically creates PRs for dependency updates</li><li>Follows semantic versioning for update scheduling</li><li>Includes security updates with higher priority</li><li>Configuration in <code>.github/renovate.json</code></li><li>Helps keep dependencies current and secure</li></ul><h3 id="release-process" tabindex="-1">Release Process <a class="header-anchor" href="#release-process" aria-label="Permalink to "Release Process""></a></h3><p>The project uses automated releases based on conventional commits:</p><ul><li><code>feat:</code> commits trigger minor version bumps</li><li><code>fix:</code> commits trigger patch version bumps</li><li><code>BREAKING CHANGE:</code> in commit body triggers major version bumps</li></ul></div></div></main><footer class="VPDocFooter" data-v-cda1d691 data-v-5253e96b><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-5253e96b><span class="visually-hidden" id="doc-footer-aria-label" data-v-5253e96b>Pager</span><div class="pager" data-v-5253e96b><!----></div><div class="pager" data-v-5253e96b><a class="VPLink link pager-link next" href="/responsible-vibe-mcp/" data-v-5253e96b><!--[--><span class="desc" data-v-5253e96b>Next page</span><span class="title" data-v-5253e96b>Overview</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
|
|
94
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"da_vFDwM\",\"dev_development.md\":\"DWl9cccE\",\"dev_logging.md\":\"BebvbW7z\",\"dev_publishing.md\":\"CQqbiIOF\",\"index.md\":\"D6ROLohf\",\"user_advanced-engineering.md\":\"
|
|
94
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"da_vFDwM\",\"dev_development.md\":\"DWl9cccE\",\"dev_logging.md\":\"BebvbW7z\",\"dev_publishing.md\":\"CQqbiIOF\",\"index.md\":\"D6ROLohf\",\"user_advanced-engineering.md\":\"PD-xOFno\",\"user_agent-setup.md\":\"BhcuRdG8\",\"user_beads-integration.md\":\"BzdR5Fif\",\"user_crowd-mcp-integration.md\":\"C15kSdIJ\",\"user_custom-workflows.md\":\"Cz4IYCXa\",\"user_git-commit-feature.md\":\"UcTvDR-O\",\"user_how-it-works.md\":\"DiOXNgaL\",\"user_long-term-memory.md\":\"DZh0tjNa\",\"user_packaged-workflows.md\":\"s1HT89ZU\",\"user_tutorial.md\":\"Dmj8zLB2\",\"user_workflow-selection.md\":\"CrPGw9Hr\",\"workflows.md\":\"Bm5sGt3u\",\"workflows_adr.md\":\"DEaXkbRp\",\"workflows_big-bang-conversion.md\":\"BA5R1LxZ\",\"workflows_boundary-testing.md\":\"DBcYnMhx\",\"workflows_bugfix.md\":\"CZRCL0Hp\",\"workflows_business-analysis.md\":\"fGLml8Hw\",\"workflows_c4-analysis.md\":\"Dnssqzuf\",\"workflows_epcc.md\":\"M6DnIhpp\",\"workflows_game-beginner.md\":\"CNxzWLtd\",\"workflows_greenfield.md\":\"vx_g-WOe\",\"workflows_minor.md\":\"DdnfwMf4\",\"workflows_posts.md\":\"SOldXvq7\",\"workflows_sdd-bugfix-crowd.md\":\"-lSf42gJ\",\"workflows_sdd-bugfix.md\":\"oRAsEVbc\",\"workflows_sdd-feature-crowd.md\":\"DAtnfCAd\",\"workflows_sdd-feature.md\":\"Ce3-H_g3\",\"workflows_sdd-greenfield-crowd.md\":\"8DUvcmLe\",\"workflows_sdd-greenfield.md\":\"eEN6U0J4\",\"workflows_skilled-bugfix.md\":\"YyOU6NjA\",\"workflows_skilled-epcc.md\":\"BGeI6g1n\",\"workflows_skilled-greenfield.md\":\"CKxrbPQ-\",\"workflows_slides.md\":\"Cqt-19_1\",\"workflows_tdd.md\":\"BjVC69tu\",\"workflows_waterfall.md\":\"CL6jTZP9\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Responsible Vibe MCP\",\"description\":\"Model Context Protocol server for intelligent conversation state management and development guidance\",\"base\":\"/responsible-vibe-mcp/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"Documentation\",\"link\":\"/\"},{\"text\":\"Workflows\",\"link\":\"/workflows\"},{\"text\":\"Github\",\"link\":\"https://github.com/mrsimpson/responsible-vibe-mcp\"}],\"sidebar\":[{\"text\":\"User Guide\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"How It Works\",\"link\":\"/user/how-it-works\"},{\"text\":\"Agent Setup\",\"link\":\"/user/agent-setup\"},{\"text\":\"Vibe Engineering\",\"link\":\"/user/advanced-engineering\"},{\"text\":\"Long-Term Memory\",\"link\":\"/user/long-term-memory\"},{\"text\":\"Beads-Integration\",\"link\":\"/user/beads-integration\"},{\"text\":\"Tutorial\",\"link\":\"/user/tutorial\"}]},{\"text\":\"Workflows\",\"items\":[{\"text\":\"Workflow-Selection\",\"link\":\"/user/workflow-selection\"},{\"text\":\"Packaged Workflows\",\"link\":\"/user/packaged-workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
|
|
95
95
|
|
|
96
96
|
</body>
|
|
97
97
|
</html>
|
|
@@ -53,7 +53,7 @@
|
|
|
53
53
|
<span class="line"></span>
|
|
54
54
|
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Monitor logs in real-time</span></span>
|
|
55
55
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">LOG_LEVEL</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">DEBUG</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> tsx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> src/index.ts</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> 2>&1</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> |</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> tee</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> server.log</span></span></code></pre></div><h2 id="best-practices" tabindex="-1">Best Practices <a class="header-anchor" href="#best-practices" aria-label="Permalink to "Best Practices""></a></h2><ol><li><strong>Use appropriate log levels</strong>: Debug for tracing, Info for milestones, Warn for recoverable issues, Error for failures</li><li><strong>Include context</strong>: Always provide relevant context data with log messages</li><li><strong>Avoid sensitive data</strong>: Don't log passwords, tokens, or other sensitive information</li><li><strong>Use structured logging</strong>: Provide context as objects rather than string interpolation</li><li><strong>Component-specific loggers</strong>: Use dedicated loggers for different components</li><li><strong>Centralized logging</strong>: Use the logger module for all logging needs</li></ol><h2 id="performance-considerations" tabindex="-1">Performance Considerations <a class="header-anchor" href="#performance-considerations" aria-label="Permalink to "Performance Considerations""></a></h2><ul><li>Log level filtering happens before message formatting for efficiency</li><li>MCP client notifications are sent asynchronously to avoid blocking operations</li><li>Failed MCP notifications fall back to stderr logging</li><li>Context objects are JSON-serialized only when the log level permits output</li><li>Enhanced notifications only process important events to reduce overhead</li></ul><h2 id="troubleshooting" tabindex="-1">Troubleshooting <a class="header-anchor" href="#troubleshooting" aria-label="Permalink to "Troubleshooting""></a></h2><h3 id="no-log-output" tabindex="-1">No Log Output <a class="header-anchor" href="#no-log-output" aria-label="Permalink to "No Log Output""></a></h3><p>Check the <code>LOG_LEVEL</code> environment variable. Default is <code>INFO</code>.</p><h3 id="mcp-client-not-receiving-notifications" tabindex="-1">MCP Client Not Receiving Notifications <a class="header-anchor" href="#mcp-client-not-receiving-notifications" aria-label="Permalink to "MCP Client Not Receiving Notifications""></a></h3><p>Ensure the server is properly initialized and connected to the MCP transport. Client notifications are only sent after successful server initialization. In test environments, "Not connected" errors are expected and harmless.</p><h3 id="performance-issues" tabindex="-1">Performance Issues <a class="header-anchor" href="#performance-issues" aria-label="Permalink to "Performance Issues""></a></h3><p>Consider raising the log level to <code>WARN</code> or <code>ERROR</code> in production environments to reduce log volume.</p><h2 id="integration-with-mcp-inspector" tabindex="-1">Integration with MCP Inspector <a class="header-anchor" href="#integration-with-mcp-inspector" aria-label="Permalink to "Integration with MCP Inspector""></a></h2><p>When using the MCP Inspector for debugging, set debug logging to see detailed protocol interactions:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">LOG_LEVEL</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">DEBUG</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @modelcontextprotocol/inspector</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> tsx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> src/index.ts</span></span></code></pre></div><p>The enhanced logging system provides comprehensive visibility into the server's operation while maintaining MCP compliance and optimal performance through centralized, structured logging.</p></div></div></main><footer class="VPDocFooter" data-v-cda1d691 data-v-5253e96b><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-5253e96b><span class="visually-hidden" id="doc-footer-aria-label" data-v-5253e96b>Pager</span><div class="pager" data-v-5253e96b><!----></div><div class="pager" data-v-5253e96b><a class="VPLink link pager-link next" href="/responsible-vibe-mcp/" data-v-5253e96b><!--[--><span class="desc" data-v-5253e96b>Next page</span><span class="title" data-v-5253e96b>Overview</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
|
|
56
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"da_vFDwM\",\"dev_development.md\":\"DWl9cccE\",\"dev_logging.md\":\"BebvbW7z\",\"dev_publishing.md\":\"CQqbiIOF\",\"index.md\":\"D6ROLohf\",\"user_advanced-engineering.md\":\"
|
|
56
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"da_vFDwM\",\"dev_development.md\":\"DWl9cccE\",\"dev_logging.md\":\"BebvbW7z\",\"dev_publishing.md\":\"CQqbiIOF\",\"index.md\":\"D6ROLohf\",\"user_advanced-engineering.md\":\"PD-xOFno\",\"user_agent-setup.md\":\"BhcuRdG8\",\"user_beads-integration.md\":\"BzdR5Fif\",\"user_crowd-mcp-integration.md\":\"C15kSdIJ\",\"user_custom-workflows.md\":\"Cz4IYCXa\",\"user_git-commit-feature.md\":\"UcTvDR-O\",\"user_how-it-works.md\":\"DiOXNgaL\",\"user_long-term-memory.md\":\"DZh0tjNa\",\"user_packaged-workflows.md\":\"s1HT89ZU\",\"user_tutorial.md\":\"Dmj8zLB2\",\"user_workflow-selection.md\":\"CrPGw9Hr\",\"workflows.md\":\"Bm5sGt3u\",\"workflows_adr.md\":\"DEaXkbRp\",\"workflows_big-bang-conversion.md\":\"BA5R1LxZ\",\"workflows_boundary-testing.md\":\"DBcYnMhx\",\"workflows_bugfix.md\":\"CZRCL0Hp\",\"workflows_business-analysis.md\":\"fGLml8Hw\",\"workflows_c4-analysis.md\":\"Dnssqzuf\",\"workflows_epcc.md\":\"M6DnIhpp\",\"workflows_game-beginner.md\":\"CNxzWLtd\",\"workflows_greenfield.md\":\"vx_g-WOe\",\"workflows_minor.md\":\"DdnfwMf4\",\"workflows_posts.md\":\"SOldXvq7\",\"workflows_sdd-bugfix-crowd.md\":\"-lSf42gJ\",\"workflows_sdd-bugfix.md\":\"oRAsEVbc\",\"workflows_sdd-feature-crowd.md\":\"DAtnfCAd\",\"workflows_sdd-feature.md\":\"Ce3-H_g3\",\"workflows_sdd-greenfield-crowd.md\":\"8DUvcmLe\",\"workflows_sdd-greenfield.md\":\"eEN6U0J4\",\"workflows_skilled-bugfix.md\":\"YyOU6NjA\",\"workflows_skilled-epcc.md\":\"BGeI6g1n\",\"workflows_skilled-greenfield.md\":\"CKxrbPQ-\",\"workflows_slides.md\":\"Cqt-19_1\",\"workflows_tdd.md\":\"BjVC69tu\",\"workflows_waterfall.md\":\"CL6jTZP9\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Responsible Vibe MCP\",\"description\":\"Model Context Protocol server for intelligent conversation state management and development guidance\",\"base\":\"/responsible-vibe-mcp/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"Documentation\",\"link\":\"/\"},{\"text\":\"Workflows\",\"link\":\"/workflows\"},{\"text\":\"Github\",\"link\":\"https://github.com/mrsimpson/responsible-vibe-mcp\"}],\"sidebar\":[{\"text\":\"User Guide\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"How It Works\",\"link\":\"/user/how-it-works\"},{\"text\":\"Agent Setup\",\"link\":\"/user/agent-setup\"},{\"text\":\"Vibe Engineering\",\"link\":\"/user/advanced-engineering\"},{\"text\":\"Long-Term Memory\",\"link\":\"/user/long-term-memory\"},{\"text\":\"Beads-Integration\",\"link\":\"/user/beads-integration\"},{\"text\":\"Tutorial\",\"link\":\"/user/tutorial\"}]},{\"text\":\"Workflows\",\"items\":[{\"text\":\"Workflow-Selection\",\"link\":\"/user/workflow-selection\"},{\"text\":\"Packaged Workflows\",\"link\":\"/user/packaged-workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
|
|
57
57
|
|
|
58
58
|
</body>
|
|
59
59
|
</html>
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> commit</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -m</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> "feat!: redesign API structure</span></span>
|
|
25
25
|
<span class="line"></span>
|
|
26
26
|
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">BREAKING CHANGE: API endpoints have changed"</span></span></code></pre></div><h2 id="publishing-process" tabindex="-1">Publishing Process <a class="header-anchor" href="#publishing-process" aria-label="Permalink to "Publishing Process""></a></h2><ol><li><strong>Development</strong>: Work on feature branches</li><li><strong>Pull Request</strong>: Create PR to main branch (triggers tests)</li><li><strong>Review & Merge</strong>: After approval, merge to main</li><li><strong>Automatic Release</strong>: GitHub Actions handles the rest: <ul><li>Tests pass → Version bump → npm publish → Git tag → Release notes</li></ul></li></ol><h2 id="manual-override" tabindex="-1">Manual Override <a class="header-anchor" href="#manual-override" aria-label="Permalink to "Manual Override""></a></h2><p>If needed, you can manually trigger releases:</p><ol><li>Go to Actions tab in GitHub</li><li>Select "Release and Publish" workflow</li><li>Click "Run workflow" on main branch</li></ol><h2 id="troubleshooting" tabindex="-1">Troubleshooting <a class="header-anchor" href="#troubleshooting" aria-label="Permalink to "Troubleshooting""></a></h2><h3 id="common-issues" tabindex="-1">Common Issues: <a class="header-anchor" href="#common-issues" aria-label="Permalink to "Common Issues:""></a></h3><ol><li><strong>npm publish fails</strong>: Check NPM_TOKEN secret is set correctly</li><li><strong>No version bump</strong>: Ensure commits follow conventional format</li><li><strong>Tests fail</strong>: Fix tests before merging to main</li><li><strong>Permission denied</strong>: Verify GitHub Actions permissions</li></ol><h3 id="checking-status" tabindex="-1">Checking Status: <a class="header-anchor" href="#checking-status" aria-label="Permalink to "Checking Status:""></a></h3><ul><li><strong>npm package</strong>: <a href="https://www.npmjs.com/package/@codemcp/workflows" target="_blank" rel="noreferrer">https://www.npmjs.com/package/@codemcp/workflows</a></li><li><strong>GitHub releases</strong>: <a href="https://github.com/mrsimpson/vibe-feature-mcp/releases" target="_blank" rel="noreferrer">https://github.com/mrsimpson/vibe-feature-mcp/releases</a></li><li><strong>Actions logs</strong>: <a href="https://github.com/mrsimpson/vibe-feature-mcp/actions" target="_blank" rel="noreferrer">https://github.com/mrsimpson/vibe-feature-mcp/actions</a></li></ul><h2 id="version-history" tabindex="-1">Version History <a class="header-anchor" href="#version-history" aria-label="Permalink to "Version History""></a></h2><p>Versions and changelogs are automatically maintained in:</p><ul><li>GitHub Releases</li><li>CHANGELOG.md (auto-generated)</li><li>Git tags (v1.2.3 format)</li></ul></div></div></main><footer class="VPDocFooter" data-v-cda1d691 data-v-5253e96b><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-5253e96b><span class="visually-hidden" id="doc-footer-aria-label" data-v-5253e96b>Pager</span><div class="pager" data-v-5253e96b><!----></div><div class="pager" data-v-5253e96b><a class="VPLink link pager-link next" href="/responsible-vibe-mcp/" data-v-5253e96b><!--[--><span class="desc" data-v-5253e96b>Next page</span><span class="title" data-v-5253e96b>Overview</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
|
|
27
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"da_vFDwM\",\"dev_development.md\":\"DWl9cccE\",\"dev_logging.md\":\"BebvbW7z\",\"dev_publishing.md\":\"CQqbiIOF\",\"index.md\":\"D6ROLohf\",\"user_advanced-engineering.md\":\"
|
|
27
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"da_vFDwM\",\"dev_development.md\":\"DWl9cccE\",\"dev_logging.md\":\"BebvbW7z\",\"dev_publishing.md\":\"CQqbiIOF\",\"index.md\":\"D6ROLohf\",\"user_advanced-engineering.md\":\"PD-xOFno\",\"user_agent-setup.md\":\"BhcuRdG8\",\"user_beads-integration.md\":\"BzdR5Fif\",\"user_crowd-mcp-integration.md\":\"C15kSdIJ\",\"user_custom-workflows.md\":\"Cz4IYCXa\",\"user_git-commit-feature.md\":\"UcTvDR-O\",\"user_how-it-works.md\":\"DiOXNgaL\",\"user_long-term-memory.md\":\"DZh0tjNa\",\"user_packaged-workflows.md\":\"s1HT89ZU\",\"user_tutorial.md\":\"Dmj8zLB2\",\"user_workflow-selection.md\":\"CrPGw9Hr\",\"workflows.md\":\"Bm5sGt3u\",\"workflows_adr.md\":\"DEaXkbRp\",\"workflows_big-bang-conversion.md\":\"BA5R1LxZ\",\"workflows_boundary-testing.md\":\"DBcYnMhx\",\"workflows_bugfix.md\":\"CZRCL0Hp\",\"workflows_business-analysis.md\":\"fGLml8Hw\",\"workflows_c4-analysis.md\":\"Dnssqzuf\",\"workflows_epcc.md\":\"M6DnIhpp\",\"workflows_game-beginner.md\":\"CNxzWLtd\",\"workflows_greenfield.md\":\"vx_g-WOe\",\"workflows_minor.md\":\"DdnfwMf4\",\"workflows_posts.md\":\"SOldXvq7\",\"workflows_sdd-bugfix-crowd.md\":\"-lSf42gJ\",\"workflows_sdd-bugfix.md\":\"oRAsEVbc\",\"workflows_sdd-feature-crowd.md\":\"DAtnfCAd\",\"workflows_sdd-feature.md\":\"Ce3-H_g3\",\"workflows_sdd-greenfield-crowd.md\":\"8DUvcmLe\",\"workflows_sdd-greenfield.md\":\"eEN6U0J4\",\"workflows_skilled-bugfix.md\":\"YyOU6NjA\",\"workflows_skilled-epcc.md\":\"BGeI6g1n\",\"workflows_skilled-greenfield.md\":\"CKxrbPQ-\",\"workflows_slides.md\":\"Cqt-19_1\",\"workflows_tdd.md\":\"BjVC69tu\",\"workflows_waterfall.md\":\"CL6jTZP9\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Responsible Vibe MCP\",\"description\":\"Model Context Protocol server for intelligent conversation state management and development guidance\",\"base\":\"/responsible-vibe-mcp/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"Documentation\",\"link\":\"/\"},{\"text\":\"Workflows\",\"link\":\"/workflows\"},{\"text\":\"Github\",\"link\":\"https://github.com/mrsimpson/responsible-vibe-mcp\"}],\"sidebar\":[{\"text\":\"User Guide\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"How It Works\",\"link\":\"/user/how-it-works\"},{\"text\":\"Agent Setup\",\"link\":\"/user/agent-setup\"},{\"text\":\"Vibe Engineering\",\"link\":\"/user/advanced-engineering\"},{\"text\":\"Long-Term Memory\",\"link\":\"/user/long-term-memory\"},{\"text\":\"Beads-Integration\",\"link\":\"/user/beads-integration\"},{\"text\":\"Tutorial\",\"link\":\"/user/tutorial\"}]},{\"text\":\"Workflows\",\"items\":[{\"text\":\"Workflow-Selection\",\"link\":\"/user/workflow-selection\"},{\"text\":\"Packaged Workflows\",\"link\":\"/user/packaged-workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
|
|
28
28
|
|
|
29
29
|
</body>
|
|
30
30
|
</html>
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"dev_architecture.md":"da_vFDwM","dev_development.md":"DWl9cccE","dev_logging.md":"BebvbW7z","dev_publishing.md":"CQqbiIOF","index.md":"D6ROLohf","user_advanced-engineering.md":"
|
|
1
|
+
{"dev_architecture.md":"da_vFDwM","dev_development.md":"DWl9cccE","dev_logging.md":"BebvbW7z","dev_publishing.md":"CQqbiIOF","index.md":"D6ROLohf","user_advanced-engineering.md":"PD-xOFno","user_agent-setup.md":"BhcuRdG8","user_beads-integration.md":"BzdR5Fif","user_crowd-mcp-integration.md":"C15kSdIJ","user_custom-workflows.md":"Cz4IYCXa","user_git-commit-feature.md":"UcTvDR-O","user_how-it-works.md":"DiOXNgaL","user_long-term-memory.md":"DZh0tjNa","user_packaged-workflows.md":"s1HT89ZU","user_tutorial.md":"Dmj8zLB2","user_workflow-selection.md":"CrPGw9Hr","workflows.md":"Bm5sGt3u","workflows_adr.md":"DEaXkbRp","workflows_big-bang-conversion.md":"BA5R1LxZ","workflows_boundary-testing.md":"DBcYnMhx","workflows_bugfix.md":"CZRCL0Hp","workflows_business-analysis.md":"fGLml8Hw","workflows_c4-analysis.md":"Dnssqzuf","workflows_epcc.md":"M6DnIhpp","workflows_game-beginner.md":"CNxzWLtd","workflows_greenfield.md":"vx_g-WOe","workflows_minor.md":"DdnfwMf4","workflows_posts.md":"SOldXvq7","workflows_sdd-bugfix-crowd.md":"-lSf42gJ","workflows_sdd-bugfix.md":"oRAsEVbc","workflows_sdd-feature-crowd.md":"DAtnfCAd","workflows_sdd-feature.md":"Ce3-H_g3","workflows_sdd-greenfield-crowd.md":"8DUvcmLe","workflows_sdd-greenfield.md":"eEN6U0J4","workflows_skilled-bugfix.md":"YyOU6NjA","workflows_skilled-epcc.md":"BGeI6g1n","workflows_skilled-greenfield.md":"CKxrbPQ-","workflows_slides.md":"Cqt-19_1","workflows_tdd.md":"BjVC69tu","workflows_waterfall.md":"CL6jTZP9"}
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
<body>
|
|
22
22
|
<div id="app"><div class="Layout" data-v-c1df4d5c><!--[--><!--]--><!--[--><span tabindex="-1" data-v-ecac0ce8></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-ecac0ce8>Skip to content</a><!--]--><!----><header class="VPNav" data-v-c1df4d5c data-v-b2fedd30><div class="VPNavBar" data-v-b2fedd30 data-v-37a0846a><div class="wrapper" data-v-37a0846a><div class="container" data-v-37a0846a><div class="title" data-v-37a0846a><div class="VPNavBarTitle has-sidebar" data-v-37a0846a data-v-b408e164><a class="title" href="/responsible-vibe-mcp/" data-v-b408e164><!--[--><!--]--><!----><span data-v-b408e164>Responsible Vibe MCP</span><!--[--><!--]--></a></div></div><div class="content" data-v-37a0846a><div class="content-body" data-v-37a0846a><!--[--><!--]--><div class="VPNavBarSearch search" data-v-37a0846a><!----></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-37a0846a data-v-27d7d4fe><span id="main-nav-aria-label" class="visually-hidden" data-v-27d7d4fe> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/responsible-vibe-mcp/" tabindex="0" data-v-27d7d4fe data-v-e70ce59d><!--[--><span data-v-e70ce59d>Documentation</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/responsible-vibe-mcp/workflows.html" tabindex="0" data-v-27d7d4fe data-v-e70ce59d><!--[--><span data-v-e70ce59d>Workflows</span><!--]--></a><!--]--><!--[--><a class="VPLink link vp-external-link-icon VPNavBarMenuLink" href="https://github.com/mrsimpson/responsible-vibe-mcp" target="_blank" rel="noreferrer" tabindex="0" data-v-27d7d4fe data-v-e70ce59d><!--[--><span data-v-e70ce59d>Github</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-37a0846a data-v-34a9cb79><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-34a9cb79 data-v-9e7dfa94 data-v-c055c202><span class="check" data-v-c055c202><span class="icon" data-v-c055c202><!--[--><span class="vpi-sun sun" data-v-9e7dfa94></span><span class="vpi-moon moon" data-v-9e7dfa94></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-37a0846a data-v-abbdfbda data-v-8b861926><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-8b861926><span class="vpi-more-horizontal icon" data-v-8b861926></span></button><div class="menu" data-v-8b861926><div class="VPMenu" data-v-8b861926 data-v-5713f977><!----><!--[--><!--[--><!----><div class="group" data-v-abbdfbda><div class="item appearance" data-v-abbdfbda><p class="label" data-v-abbdfbda>Appearance</p><div class="appearance-action" data-v-abbdfbda><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-abbdfbda data-v-9e7dfa94 data-v-c055c202><span class="check" data-v-c055c202><span class="icon" data-v-c055c202><!--[--><span class="vpi-sun sun" data-v-9e7dfa94></span><span class="vpi-moon moon" data-v-9e7dfa94></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-37a0846a data-v-923ccc68><span class="container" data-v-923ccc68><span class="top" data-v-923ccc68></span><span class="middle" data-v-923ccc68></span><span class="bottom" data-v-923ccc68></span></span></button></div></div></div></div><div class="divider" data-v-37a0846a><div class="divider-line" data-v-37a0846a></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-c1df4d5c data-v-d06e114f><div class="container" data-v-d06e114f><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-d06e114f><span class="vpi-align-left menu-icon" data-v-d06e114f></span><span class="menu-text" data-v-d06e114f>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-d06e114f data-v-aab1d107><button data-v-aab1d107>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-c1df4d5c data-v-026681b8><div class="curtain" data-v-026681b8></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-026681b8><span class="visually-hidden" id="sidebar-aria-label" data-v-026681b8> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-03a62be3><section class="VPSidebarItem level-0 has-active" data-v-03a62be3 data-v-cb4e7117><div class="item" role="button" tabindex="0" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><h2 class="text" data-v-cb4e7117>User Guide</h2><!----></div><div class="items" data-v-cb4e7117><!--[--><div class="VPSidebarItem level-1 is-link" data-v-cb4e7117 data-v-cb4e7117><div class="item" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><a class="VPLink link link" href="/responsible-vibe-mcp/" data-v-cb4e7117><!--[--><p class="text" data-v-cb4e7117>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cb4e7117 data-v-cb4e7117><div class="item" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/how-it-works.html" data-v-cb4e7117><!--[--><p class="text" data-v-cb4e7117>How It Works</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cb4e7117 data-v-cb4e7117><div class="item" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/agent-setup.html" data-v-cb4e7117><!--[--><p class="text" data-v-cb4e7117>Agent Setup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cb4e7117 data-v-cb4e7117><div class="item" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/advanced-engineering.html" data-v-cb4e7117><!--[--><p class="text" data-v-cb4e7117>Vibe Engineering</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cb4e7117 data-v-cb4e7117><div class="item" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/long-term-memory.html" data-v-cb4e7117><!--[--><p class="text" data-v-cb4e7117>Long-Term Memory</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cb4e7117 data-v-cb4e7117><div class="item" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/beads-integration.html" data-v-cb4e7117><!--[--><p class="text" data-v-cb4e7117>Beads-Integration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cb4e7117 data-v-cb4e7117><div class="item" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/tutorial.html" data-v-cb4e7117><!--[--><p class="text" data-v-cb4e7117>Tutorial</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-03a62be3><section class="VPSidebarItem level-0" data-v-03a62be3 data-v-cb4e7117><div class="item" role="button" tabindex="0" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><h2 class="text" data-v-cb4e7117>Workflows</h2><!----></div><div class="items" data-v-cb4e7117><!--[--><div class="VPSidebarItem level-1 is-link" data-v-cb4e7117 data-v-cb4e7117><div class="item" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/workflow-selection.html" data-v-cb4e7117><!--[--><p class="text" data-v-cb4e7117>Workflow-Selection</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cb4e7117 data-v-cb4e7117><div class="item" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/packaged-workflows.html" data-v-cb4e7117><!--[--><p class="text" data-v-cb4e7117>Packaged Workflows</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cb4e7117 data-v-cb4e7117><div class="item" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/custom-workflows.html" data-v-cb4e7117><!--[--><p class="text" data-v-cb4e7117>Custom Workflows</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cb4e7117 data-v-cb4e7117><div class="item" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><a class="VPLink link link" href="/responsible-vibe-mcp/workflows.html" data-v-cb4e7117><!--[--><p class="text" data-v-cb4e7117>Explore All Workflows</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cb4e7117 data-v-cb4e7117><div class="item" data-v-cb4e7117><div class="indicator" data-v-cb4e7117></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/crowd-mcp-integration.html" data-v-cb4e7117><!--[--><p class="text" data-v-cb4e7117>Crowd MCP Integration</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-c1df4d5c data-v-28fa4ed1><div class="VPDoc has-sidebar has-aside" data-v-28fa4ed1 data-v-cda1d691><!--[--><!--]--><div class="container" data-v-cda1d691><div class="aside" data-v-cda1d691><div class="aside-curtain" data-v-cda1d691></div><div class="aside-container" data-v-cda1d691><div class="aside-content" data-v-cda1d691><div class="VPDocAside" data-v-cda1d691 data-v-0199d109><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-0199d109 data-v-9d908c55><div class="content" data-v-9d908c55><div class="outline-marker" data-v-9d908c55></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-9d908c55>On this page</div><ul class="VPDocOutlineItem root" data-v-9d908c55 data-v-f1d87f0d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-0199d109></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-cda1d691><div class="content-container" data-v-cda1d691><!--[--><!--]--><main class="main" data-v-cda1d691><div style="position:relative;" class="vp-doc _responsible-vibe-mcp_" data-v-cda1d691><div><h1 id="responsible-vibe-mcp" tabindex="-1">Responsible Vibe MCP <a class="header-anchor" href="#responsible-vibe-mcp" aria-label="Permalink to "Responsible Vibe MCP""></a></h1><p>Transform any AI coding agent into a structured development partner with battle-tested engineering workflows.</p><h2 id="the-problem-with-ai-coding-tools" tabindex="-1">The Problem with AI Coding Tools <a class="header-anchor" href="#the-problem-with-ai-coding-tools" aria-label="Permalink to "The Problem with AI Coding Tools""></a></h2><p>Most AI coding tools are glorified autocomplete on steroids. They research you code base, may even check guide on the internet – end then they spit out a full blown solution. But here's the thing: <strong>software engineering isn't just about writing code</strong>. It's about thinking through problems, making architectural decisions, and following proven methodologies that prevent you from painting yourself into corners.</p><p>The faster these tools get, the easier it becomes to skip the thinking part. Before you know it, you're three hours deep in a refactor that could have been avoided with 10 minutes of upfront design.</p><h2 id="how-responsible-vibe-changes-the-game" tabindex="-1">How Responsible Vibe Changes the Game <a class="header-anchor" href="#how-responsible-vibe-changes-the-game" aria-label="Permalink to "How Responsible Vibe Changes the Game""></a></h2><p>Instead of just responding to your requests, Responsible Vibe <strong>proactively guides your AI agent</strong> through proven engineering workflows. Your agent doesn't just write code – it engineers solutions.</p><p>Think of it as having a senior engineer sitting next to your AI, constantly asking: <em>"Did you think about the how it integrates with the existing architecture? What about edge cases? We're doing TDD – let's create a red test case first"</em></p><h2 id="🎬-see-it-in-action" tabindex="-1">🎬 See It In Action <a class="header-anchor" href="#🎬-see-it-in-action" aria-label="Permalink to "🎬 See It In Action""></a></h2><div class="demo-container" style="position:relative;display:inline-block;cursor:pointer;border-radius:8px;overflow:hidden;box-shadow:0 4px 12px rgba(0,0,0,0.15);"><img src="/responsible-vibe-mcp/assets/placeholder-demo-greenfield.B8lG_tBI.png" alt="Interactive demo showing Responsible Vibe MCP in action" style="width:100%;max-width:600px;height:auto;display:block;"><div style="position:absolute;top:50%;left:50%;transform:translate(-50%, -50%);background:rgba(0,0,0,0.7);border-radius:50%;width:80px;height:80px;display:flex;align-items:center;justify-content:center;transition:all 0.3s ease;"><div style="width:0;height:0;border-left:25px solid white;border-top:15px solid transparent;border-bottom:15px solid transparent;margin-left:5px;"></div></div></div><div style="position:fixed;top:0;left:0;width:100%;height:100%;background:rgba(0,0,0,0.9);z-index:1000;padding:20px;box-sizing:border-box;display:none;"><div style="position:relative;width:95%;height:100%;margin:0 auto;"><button style="position:absolute;top:-10px;right:-10px;background:white;border:none;border-radius:50%;width:40px;height:40px;font-size:24px;cursor:pointer;z-index:1001;display:flex;align-items:center;justify-content:center;" aria-label="Close demo">×</button><iframe src="" style="width:100%;height:100%;border:none;border-radius:8px;" title="Responsible Vibe MCP Interactive Demo"></iframe></div></div><h2 id="what-you-actually-get" tabindex="-1">What You Actually Get <a class="header-anchor" href="#what-you-actually-get" aria-label="Permalink to "What You Actually Get""></a></h2><p><strong>Multiple Battle-Tested Workflows</strong>: Not just one-size-fits-all. Building a new project? Use the traditional V-model or the more ideation-focused greenfield. Adding a feature? EPCC works great. Fixing a bug? There's a workflow for that too.</p><p><strong>Your AI Remembers Everything</strong>: Conversations, decisions, architectural choices – all persisted across sessions and even git branches.</p><p><strong>Process Guidance That Actually Works</strong>: Your AI knows what phase it's in and what to focus on next. No more random code generation – structured, methodical development.</p><h2 id="universal-mcp-support" tabindex="-1">Universal MCP Support <a class="header-anchor" href="#universal-mcp-support" aria-label="Permalink to "Universal MCP Support""></a></h2><p>Works with any agent that supports the Model Context Protocol. Amazon Q CLI, Claude Code, Gemini CLI – doesn't matter. When the next "revolutionary" coding IDE launches next month, you won't need to change how you work.</p><h2 id="quick-start" tabindex="-1">Quick Start <a class="header-anchor" href="#quick-start" aria-label="Permalink to "Quick Start""></a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Setup your coding agent (works with any MCP-compatible agent)</span></span>
|
|
23
23
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @codemcp/workflows</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> setup</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> config</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> kiro</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # or claude, gemini, opencode, copilot</span></span></code></pre></div><p>Head to an empty directory and try: <em>"Build a simple todo app with a terminal interface"</em></p><p>Watch your agent start with architecture decisions instead of jumping straight into code. That's engineering.</p><h2 id="next-steps" tabindex="-1">Next Steps <a class="header-anchor" href="#next-steps" aria-label="Permalink to "Next Steps""></a></h2><ul><li><strong><a href="./user/how-it-works.html">How It Works</a></strong> – The technical details and what makes it different</li><li><strong><a href="./user/agent-setup.html">Quick Setup</a></strong> – Get your agent configured in 2 minutes</li><li><strong><a href="./user/tutorial.html">Hands-On Tutorial</a></strong> – Learn by building (todo app → enhancement → bugfix)</li><li><strong><a href="./workflows.html">Interactive Workflows</a></strong> – Explore all available methodologies</li><li><strong><a href="./user/crowd-mcp-integration.html">Crowd MCP Integration</a></strong> – Multi-agent collaboration with specialized roles</li></ul><hr><p><em>Because software engineering is a creative process that happens in your brain – not in the LLM's context window.</em></p></div></div></main><footer class="VPDocFooter" data-v-cda1d691 data-v-5253e96b><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-5253e96b><span class="visually-hidden" id="doc-footer-aria-label" data-v-5253e96b>Pager</span><div class="pager" data-v-5253e96b><!----></div><div class="pager" data-v-5253e96b><a class="VPLink link pager-link next" href="/responsible-vibe-mcp/user/how-it-works.html" data-v-5253e96b><!--[--><span class="desc" data-v-5253e96b>Next page</span><span class="title" data-v-5253e96b>How It Works</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
|
|
24
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"da_vFDwM\",\"dev_development.md\":\"DWl9cccE\",\"dev_logging.md\":\"BebvbW7z\",\"dev_publishing.md\":\"CQqbiIOF\",\"index.md\":\"D6ROLohf\",\"user_advanced-engineering.md\":\"
|
|
24
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"da_vFDwM\",\"dev_development.md\":\"DWl9cccE\",\"dev_logging.md\":\"BebvbW7z\",\"dev_publishing.md\":\"CQqbiIOF\",\"index.md\":\"D6ROLohf\",\"user_advanced-engineering.md\":\"PD-xOFno\",\"user_agent-setup.md\":\"BhcuRdG8\",\"user_beads-integration.md\":\"BzdR5Fif\",\"user_crowd-mcp-integration.md\":\"C15kSdIJ\",\"user_custom-workflows.md\":\"Cz4IYCXa\",\"user_git-commit-feature.md\":\"UcTvDR-O\",\"user_how-it-works.md\":\"DiOXNgaL\",\"user_long-term-memory.md\":\"DZh0tjNa\",\"user_packaged-workflows.md\":\"s1HT89ZU\",\"user_tutorial.md\":\"Dmj8zLB2\",\"user_workflow-selection.md\":\"CrPGw9Hr\",\"workflows.md\":\"Bm5sGt3u\",\"workflows_adr.md\":\"DEaXkbRp\",\"workflows_big-bang-conversion.md\":\"BA5R1LxZ\",\"workflows_boundary-testing.md\":\"DBcYnMhx\",\"workflows_bugfix.md\":\"CZRCL0Hp\",\"workflows_business-analysis.md\":\"fGLml8Hw\",\"workflows_c4-analysis.md\":\"Dnssqzuf\",\"workflows_epcc.md\":\"M6DnIhpp\",\"workflows_game-beginner.md\":\"CNxzWLtd\",\"workflows_greenfield.md\":\"vx_g-WOe\",\"workflows_minor.md\":\"DdnfwMf4\",\"workflows_posts.md\":\"SOldXvq7\",\"workflows_sdd-bugfix-crowd.md\":\"-lSf42gJ\",\"workflows_sdd-bugfix.md\":\"oRAsEVbc\",\"workflows_sdd-feature-crowd.md\":\"DAtnfCAd\",\"workflows_sdd-feature.md\":\"Ce3-H_g3\",\"workflows_sdd-greenfield-crowd.md\":\"8DUvcmLe\",\"workflows_sdd-greenfield.md\":\"eEN6U0J4\",\"workflows_skilled-bugfix.md\":\"YyOU6NjA\",\"workflows_skilled-epcc.md\":\"BGeI6g1n\",\"workflows_skilled-greenfield.md\":\"CKxrbPQ-\",\"workflows_slides.md\":\"Cqt-19_1\",\"workflows_tdd.md\":\"BjVC69tu\",\"workflows_waterfall.md\":\"CL6jTZP9\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Responsible Vibe MCP\",\"description\":\"Model Context Protocol server for intelligent conversation state management and development guidance\",\"base\":\"/responsible-vibe-mcp/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"Documentation\",\"link\":\"/\"},{\"text\":\"Workflows\",\"link\":\"/workflows\"},{\"text\":\"Github\",\"link\":\"https://github.com/mrsimpson/responsible-vibe-mcp\"}],\"sidebar\":[{\"text\":\"User Guide\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"How It Works\",\"link\":\"/user/how-it-works\"},{\"text\":\"Agent Setup\",\"link\":\"/user/agent-setup\"},{\"text\":\"Vibe Engineering\",\"link\":\"/user/advanced-engineering\"},{\"text\":\"Long-Term Memory\",\"link\":\"/user/long-term-memory\"},{\"text\":\"Beads-Integration\",\"link\":\"/user/beads-integration\"},{\"text\":\"Tutorial\",\"link\":\"/user/tutorial\"}]},{\"text\":\"Workflows\",\"items\":[{\"text\":\"Workflow-Selection\",\"link\":\"/user/workflow-selection\"},{\"text\":\"Packaged Workflows\",\"link\":\"/user/packaged-workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
|
|
25
25
|
|
|
26
26
|
</body>
|
|
27
27
|
</html>
|