responsible-vibe-mcp 4.6.0 → 4.6.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 (46) hide show
  1. package/package.json +2 -2
  2. package/packages/cli/package.json +1 -1
  3. package/packages/core/package.json +1 -1
  4. package/packages/docs/.vitepress/dist/404.html +1 -1
  5. package/packages/docs/.vitepress/dist/assets/user_beads-integration.md.BR4yrDRa.js +72 -0
  6. package/packages/docs/.vitepress/dist/assets/user_beads-integration.md.BR4yrDRa.lean.js +1 -0
  7. package/packages/docs/.vitepress/dist/dev/ARCHITECTURE.html +2 -2
  8. package/packages/docs/.vitepress/dist/dev/DEVELOPMENT.html +2 -2
  9. package/packages/docs/.vitepress/dist/dev/LOGGING.html +2 -2
  10. package/packages/docs/.vitepress/dist/dev/PUBLISHING.html +2 -2
  11. package/packages/docs/.vitepress/dist/hashmap.json +1 -1
  12. package/packages/docs/.vitepress/dist/index.html +2 -2
  13. package/packages/docs/.vitepress/dist/user/advanced-engineering.html +2 -2
  14. package/packages/docs/.vitepress/dist/user/agent-setup.html +2 -2
  15. package/packages/docs/.vitepress/dist/user/beads-integration.html +97 -0
  16. package/packages/docs/.vitepress/dist/user/crowd-mcp-integration.html +2 -2
  17. package/packages/docs/.vitepress/dist/user/custom-workflows.html +2 -2
  18. package/packages/docs/.vitepress/dist/user/git-commit-feature.html +2 -2
  19. package/packages/docs/.vitepress/dist/user/how-it-works.html +2 -2
  20. package/packages/docs/.vitepress/dist/user/long-term-memory.html +3 -3
  21. package/packages/docs/.vitepress/dist/user/tutorial.html +3 -3
  22. package/packages/docs/.vitepress/dist/user/workflow-selection.html +2 -2
  23. package/packages/docs/.vitepress/dist/workflows/adr.html +1 -1
  24. package/packages/docs/.vitepress/dist/workflows/big-bang-conversion.html +1 -1
  25. package/packages/docs/.vitepress/dist/workflows/boundary-testing.html +1 -1
  26. package/packages/docs/.vitepress/dist/workflows/bugfix.html +1 -1
  27. package/packages/docs/.vitepress/dist/workflows/business-analysis.html +1 -1
  28. package/packages/docs/.vitepress/dist/workflows/c4-analysis.html +1 -1
  29. package/packages/docs/.vitepress/dist/workflows/epcc.html +1 -1
  30. package/packages/docs/.vitepress/dist/workflows/game-beginner.html +1 -1
  31. package/packages/docs/.vitepress/dist/workflows/greenfield.html +1 -1
  32. package/packages/docs/.vitepress/dist/workflows/minor.html +1 -1
  33. package/packages/docs/.vitepress/dist/workflows/posts.html +1 -1
  34. package/packages/docs/.vitepress/dist/workflows/sdd-bugfix-crowd.html +1 -1
  35. package/packages/docs/.vitepress/dist/workflows/sdd-bugfix.html +1 -1
  36. package/packages/docs/.vitepress/dist/workflows/sdd-feature-crowd.html +1 -1
  37. package/packages/docs/.vitepress/dist/workflows/sdd-feature.html +1 -1
  38. package/packages/docs/.vitepress/dist/workflows/sdd-greenfield-crowd.html +1 -1
  39. package/packages/docs/.vitepress/dist/workflows/sdd-greenfield.html +1 -1
  40. package/packages/docs/.vitepress/dist/workflows/slides.html +1 -1
  41. package/packages/docs/.vitepress/dist/workflows/tdd.html +1 -1
  42. package/packages/docs/.vitepress/dist/workflows/waterfall.html +1 -1
  43. package/packages/docs/.vitepress/dist/workflows.html +1 -1
  44. package/packages/docs/package.json +1 -1
  45. package/packages/mcp-server/package.json +1 -1
  46. package/packages/visualizer/package.json +1 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "responsible-vibe-mcp",
3
- "version": "4.6.0",
3
+ "version": "4.6.1",
4
4
  "description": "A Model Context Protocol server that acts as an intelligent conversation state manager and development guide for LLMs, featuring comprehensive long-term memory with persistent project artifacts",
5
5
  "type": "module",
6
6
  "main": "packages/cli/dist/index.js",
@@ -32,7 +32,7 @@
32
32
  "@types/js-yaml": "4.0.9",
33
33
  "js-yaml": "4.1.1",
34
34
  "zod": "^3.25.76",
35
- "@codemcp/workflows-core": "4.6.0"
35
+ "@codemcp/workflows-core": "4.6.1"
36
36
  },
37
37
  "devDependencies": {
38
38
  "@modelcontextprotocol/inspector": "0.17.5",
package/packages/cli/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@codemcp/workflows-cli",
3
- "version": "4.6.0",
3
+ "version": "4.6.1",
4
4
  "description": "CLI tools for responsible-vibe development workflows",
5
5
  "type": "module",
6
6
  "scripts": {
package/packages/core/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@codemcp/workflows-core",
3
- "version": "4.6.0",
3
+ "version": "4.6.1",
4
4
  "main": "dist/index.js",
5
5
  "types": "dist/index.d.ts",
6
6
  "type": "module",
package/packages/docs/.vitepress/dist/404.html CHANGED
@@ -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\":\"v94YJS-p\",\"dev_development.md\":\"DUJdRHQV\",\"dev_logging.md\":\"DZNw81ne\",\"dev_publishing.md\":\"NaXiVuSC\",\"index.md\":\"CexYDH8O\",\"user_advanced-engineering.md\":\"CVjCpqmE\",\"user_agent-setup.md\":\"CfyzSeoq\",\"user_crowd-mcp-integration.md\":\"L2F3yTPt\",\"user_custom-workflows.md\":\"DyDxr2X_\",\"user_git-commit-feature.md\":\"BKn5HSBm\",\"user_how-it-works.md\":\"Cz8-c1YR\",\"user_long-term-memory.md\":\"BHVmeqSD\",\"user_tutorial.md\":\"3q3JM54h\",\"user_workflow-selection.md\":\"CDpPPRiE\",\"workflows.md\":\"DKfUCqv5\",\"workflows_adr.md\":\"WqKoCOsT\",\"workflows_big-bang-conversion.md\":\"B2uRBL_k\",\"workflows_boundary-testing.md\":\"BbV9tRHk\",\"workflows_bugfix.md\":\"B2sXKKGx\",\"workflows_business-analysis.md\":\"CcOMIlu-\",\"workflows_c4-analysis.md\":\"BvkdYdaJ\",\"workflows_epcc.md\":\"BvfhyoHC\",\"workflows_game-beginner.md\":\"Dmw0yenX\",\"workflows_greenfield.md\":\"gdHw7n8T\",\"workflows_minor.md\":\"CCpon9D_\",\"workflows_posts.md\":\"BB0Bx0Eh\",\"workflows_sdd-bugfix-crowd.md\":\"CXslslqL\",\"workflows_sdd-bugfix.md\":\"Ik57ZyHx\",\"workflows_sdd-feature-crowd.md\":\"B-Tg93H_\",\"workflows_sdd-feature.md\":\"Bc_1r0_Q\",\"workflows_sdd-greenfield-crowd.md\":\"CKxmKSuU\",\"workflows_sdd-greenfield.md\":\"BRyXknCo\",\"workflows_slides.md\":\"oNvoNIvP\",\"workflows_tdd.md\":\"tQIBQZGo\",\"workflows_waterfall.md\":\"DyNeDPq_\"}");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\":\"Tutorial\",\"link\":\"/user/tutorial\"}]},{\"text\":\"Workflows\",\"items\":[{\"text\":\"Workflow-Selection\",\"link\":\"/user/workflow-selection\"},{\"text\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
20
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"v94YJS-p\",\"dev_development.md\":\"DUJdRHQV\",\"dev_logging.md\":\"DZNw81ne\",\"dev_publishing.md\":\"NaXiVuSC\",\"index.md\":\"CexYDH8O\",\"user_advanced-engineering.md\":\"CVjCpqmE\",\"user_agent-setup.md\":\"CfyzSeoq\",\"user_beads-integration.md\":\"BR4yrDRa\",\"user_crowd-mcp-integration.md\":\"L2F3yTPt\",\"user_custom-workflows.md\":\"DyDxr2X_\",\"user_git-commit-feature.md\":\"BKn5HSBm\",\"user_how-it-works.md\":\"Cz8-c1YR\",\"user_long-term-memory.md\":\"BHVmeqSD\",\"user_tutorial.md\":\"3q3JM54h\",\"user_workflow-selection.md\":\"CDpPPRiE\",\"workflows.md\":\"DKfUCqv5\",\"workflows_adr.md\":\"WqKoCOsT\",\"workflows_big-bang-conversion.md\":\"B2uRBL_k\",\"workflows_boundary-testing.md\":\"BbV9tRHk\",\"workflows_bugfix.md\":\"B2sXKKGx\",\"workflows_business-analysis.md\":\"CcOMIlu-\",\"workflows_c4-analysis.md\":\"BvkdYdaJ\",\"workflows_epcc.md\":\"BvfhyoHC\",\"workflows_game-beginner.md\":\"Dmw0yenX\",\"workflows_greenfield.md\":\"gdHw7n8T\",\"workflows_minor.md\":\"CCpon9D_\",\"workflows_posts.md\":\"BB0Bx0Eh\",\"workflows_sdd-bugfix-crowd.md\":\"CXslslqL\",\"workflows_sdd-bugfix.md\":\"Ik57ZyHx\",\"workflows_sdd-feature-crowd.md\":\"B-Tg93H_\",\"workflows_sdd-feature.md\":\"Bc_1r0_Q\",\"workflows_sdd-greenfield-crowd.md\":\"CKxmKSuU\",\"workflows_sdd-greenfield.md\":\"BRyXknCo\",\"workflows_slides.md\":\"oNvoNIvP\",\"workflows_tdd.md\":\"tQIBQZGo\",\"workflows_waterfall.md\":\"DyNeDPq_\"}");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\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
21
21
 
22
22
  </body>
23
23
  </html>
package/packages/docs/.vitepress/dist/assets/user_beads-integration.md.BR4yrDRa.js ADDED
@@ -0,0 +1,72 @@
1
+ import{_ as s,c as i,o as e,a0 as n}from"./chunks/framework.gHPOTw96.js";const k=JSON.parse('{"title":"Beads Integration for Responsible-Vibe-MCP","description":"","frontmatter":{},"headers":[],"relativePath":"user/beads-integration.md","filePath":"user/beads-integration.md"}'),t={name:"user/beads-integration.md"};function l(o,a,r,h,p,d){return e(),i("div",null,[...a[0]||(a[0]=[n(`<h1 id="beads-integration-for-responsible-vibe-mcp" tabindex="-1">Beads Integration for Responsible-Vibe-MCP <a class="header-anchor" href="#beads-integration-for-responsible-vibe-mcp" aria-label="Permalink to &quot;Beads Integration for Responsible-Vibe-MCP&quot;">​</a></h1><p>This document describes the integration between responsible-vibe-mcp and the <a href="https://github.com/beads-data/beads" target="_blank" rel="noreferrer">beads distributed issue tracker</a>.</p><h2 id="overview" tabindex="-1">Overview <a class="header-anchor" href="#overview" aria-label="Permalink to &quot;Overview&quot;">​</a></h2><p>Responsible-vibe-mcp supports two task management backends:</p><ul><li><strong>Markdown Backend</strong> (default): Traditional plan files with checkbox tasks (<code>[ ]</code> and <code>[x]</code>)</li><li><strong>Beads Backend</strong> (optional): Integration with beads distributed issue tracker for enhanced task management</li></ul><h2 id="why-beads" tabindex="-1">Why Beads? <a class="header-anchor" href="#why-beads" aria-label="Permalink to &quot;Why Beads?&quot;">​</a></h2><p>Beads provides significant advantages over markdown checkboxes for complex development workflows:</p><h3 id="rich-task-management" tabindex="-1">Rich Task Management <a class="header-anchor" href="#rich-task-management" aria-label="Permalink to &quot;Rich Task Management&quot;">​</a></h3><ul><li><strong>Multiple states</strong>: open, in_progress, blocked, deferred, closed (+ custom statuses)</li><li><strong>Priority levels</strong>: P0 (critical) through P4 (low priority)</li><li><strong>Dependencies</strong>: Task blocking, relationships, and hierarchical structures</li><li><strong>Rich metadata</strong>: Assignees, due dates, estimates, external references, labels</li></ul><h3 id="ai-agent-optimized" tabindex="-1">AI Agent Optimized <a class="header-anchor" href="#ai-agent-optimized" aria-label="Permalink to &quot;AI Agent Optimized&quot;">​</a></h3><ul><li><strong>Context efficiency</strong>: 2-5k tokens vs 10-50k for large markdown task lists</li><li><strong>Git integration</strong>: Native git storage with branching and merging support</li><li><strong>Agent-first design</strong>: Built specifically for AI agent workflows</li><li><strong>Natural language interface</strong>: Agents can interact via natural language commands</li></ul><h3 id="development-integration" tabindex="-1">Development Integration <a class="header-anchor" href="#development-integration" aria-label="Permalink to &quot;Development Integration&quot;">​</a></h3><ul><li><strong>Project organization</strong>: Single beads instance manages multiple repositories</li><li><strong>Zero-conflict merging</strong>: Hash-based IDs prevent merge conflicts</li><li><strong>Bulk operations</strong>: Efficient multi-task management</li></ul><h2 id="configuration" tabindex="-1">Configuration <a class="header-anchor" href="#configuration" aria-label="Permalink to &quot;Configuration&quot;">​</a></h2><h3 id="environment-variable-control" tabindex="-1">Environment Variable Control <a class="header-anchor" href="#environment-variable-control" aria-label="Permalink to &quot;Environment Variable Control&quot;">​</a></h3><p>Set the task backend using the <code>TASK_BACKEND</code> environment variable:</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:#6A737D;--shiki-dark:#6A737D;"># Use markdown backend (default)</span></span>
2
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> TASK_BACKEND</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">markdown</span></span>
3
+ <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># or leave unset for default behavior</span></span>
4
+ <span class="line"></span>
5
+ <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Use beads backend</span></span>
6
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> TASK_BACKEND</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">beads</span></span></code></pre></div><h3 id="backend-detection" tabindex="-1">Backend Detection <a class="header-anchor" href="#backend-detection" aria-label="Permalink to &quot;Backend Detection&quot;">​</a></h3><p>The system automatically:</p><ol><li>Checks the <code>TASK_BACKEND</code> environment variable</li><li>If set to <code>beads</code>, validates that the <code>bd</code> command is available</li><li>Falls back to markdown mode if beads is unavailable</li><li>Provides helpful error messages with setup instructions if needed</li></ol><h2 id="beads-installation" tabindex="-1">Beads Installation <a class="header-anchor" href="#beads-installation" aria-label="Permalink to &quot;Beads Installation&quot;">​</a></h2><h3 id="prerequisites" tabindex="-1">Prerequisites <a class="header-anchor" href="#prerequisites" aria-label="Permalink to &quot;Prerequisites&quot;">​</a></h3><ul><li>Git repository for your project</li><li>Go development environment (for building beads)</li></ul><h3 id="installation-steps" tabindex="-1">Installation Steps <a class="header-anchor" href="#installation-steps" aria-label="Permalink to &quot;Installation Steps&quot;">​</a></h3><ol><li><p><strong>Clone beads repository</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;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/beads-data/beads.git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ~/beads</span></span>
7
+ <span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">cd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ~/beads</span></span></code></pre></div></li><li><p><strong>Build and install</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;">make</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span></span></code></pre></div></li><li><p><strong>Verify installation</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;">bd</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --version</span></span></code></pre></div></li><li><p><strong>Configure responsible-vibe-mcp</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:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> TASK_BACKEND</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">beads</span></span></code></pre></div></li></ol><h2 id="usage" tabindex="-1">Usage <a class="header-anchor" href="#usage" aria-label="Permalink to &quot;Usage&quot;">​</a></h2><h3 id="starting-development-with-beads" tabindex="-1">Starting Development with Beads <a class="header-anchor" href="#starting-development-with-beads" aria-label="Permalink to &quot;Starting Development with Beads&quot;">​</a></h3><p>When <code>TASK_BACKEND=beads</code> is set, calling <code>start_development()</code> will:</p><ol><li><strong>Create project epic</strong>: Main container for all development tasks</li><li><strong>Create phase tasks</strong>: One task per workflow phase (e.g., Explore, Plan, Code, Commit)</li><li><strong>Generate plan file</strong>: Modified plan file with beads integration</li><li><strong>Store task IDs</strong>: Phase task IDs stored in plan file comments</li></ol><p>Example plan file structure with beads:</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:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold;"># Development Plan: My Project (feature-branch)</span></span>
8
+ <span class="line"></span>
9
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-light-font-style:italic;--shiki-dark:#E1E4E8;--shiki-dark-font-style:italic;">_Task Management: Beads Issue Tracker_</span></span>
10
+ <span class="line"></span>
11
+ <span class="line"><span style="--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold;">## Explore</span></span>
12
+ <span class="line"></span>
13
+ <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">&lt;!-- beads-phase-id: bd-a1b2.1 --&gt;</span></span>
14
+ <span class="line"></span>
15
+ <span class="line"><span style="--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold;">### Tasks</span></span>
16
+ <span class="line"></span>
17
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">Tasks are managed via beads. Use beads tools to create and manage tasks for this phase.</span></span>
18
+ <span class="line"></span>
19
+ <span class="line"><span style="--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold;">### Completed</span></span>
20
+ <span class="line"></span>
21
+ <span class="line"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">-</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [</span><span style="--shiki-light:#032F62;--shiki-light-text-decoration:underline;--shiki-dark:#DBEDFF;--shiki-dark-text-decoration:underline;">x</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">] Created development plan file</span></span>
22
+ <span class="line"></span>
23
+ <span class="line"><span style="--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold;">## Plan</span></span>
24
+ <span class="line"></span>
25
+ <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">&lt;!-- beads-phase-id: bd-a1b2.2 --&gt;</span></span>
26
+ <span class="line"></span>
27
+ <span class="line"><span style="--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold;">### Tasks</span></span>
28
+ <span class="line"></span>
29
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">Tasks are managed via beads. Use beads tools to create and manage tasks for this phase.</span></span></code></pre></div><h3 id="task-hierarchy" tabindex="-1">Task Hierarchy <a class="header-anchor" href="#task-hierarchy" aria-label="Permalink to &quot;Task Hierarchy&quot;">​</a></h3><p>Beads creates a hierarchical task structure:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>Project Epic: &quot;responsible-vibe Development: My Project&quot; (bd-a1b2)</span></span>
30
+ <span class="line"><span>├── Explore Phase: &quot;Explore Phase&quot; (bd-a1b2.1)</span></span>
31
+ <span class="line"><span>│ ├── Task: &quot;Analyze current issues&quot; (bd-a1b2.1.1)</span></span>
32
+ <span class="line"><span>│ └── Task: &quot;Research alternatives&quot; (bd-a1b2.1.2)</span></span>
33
+ <span class="line"><span>├── Plan Phase: &quot;Plan Phase&quot; (bd-a1b2.2)</span></span>
34
+ <span class="line"><span>│ ├── Task: &quot;Design architecture&quot; (bd-a1b2.2.1)</span></span>
35
+ <span class="line"><span>│ └── Task: &quot;Create roadmap&quot; (bd-a1b2.2.2)</span></span>
36
+ <span class="line"><span>└── Code Phase: &quot;Code Phase&quot; (bd-a1b2.3)</span></span>
37
+ <span class="line"><span> ├── Task: &quot;Implement feature&quot; (bd-a1b2.3.1)</span></span>
38
+ <span class="line"><span> └── Task: &quot;Write tests&quot; (bd-a1b2.3.2)</span></span></code></pre></div><h3 id="using-whats-next-with-beads" tabindex="-1">Using whats_next() with Beads <a class="header-anchor" href="#using-whats-next-with-beads" aria-label="Permalink to &quot;Using whats_next() with Beads&quot;">​</a></h3><p>When beads backend is active, <code>whats_next()</code> responses include beads-specific instructions:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>**Beads Task Management Active**</span></span>
39
+ <span class="line"><span></span></span>
40
+ <span class="line"><span>Current phase task: \`bd-a1b2.1\` (Explore Phase)</span></span>
41
+ <span class="line"><span></span></span>
42
+ <span class="line"><span>Use beads tools for task management in this phase:</span></span>
43
+ <span class="line"><span>- Create sub-tasks: \`bd create &#39;Task title&#39; --parent bd-a1b2.1 -p 2\`</span></span>
44
+ <span class="line"><span>- List phase tasks: \`bd list --parent bd-a1b2.1\`</span></span>
45
+ <span class="line"><span>- Mark task complete: \`bd ready &lt;task-id&gt;\`</span></span>
46
+ <span class="line"><span>- Show task details: \`bd show &lt;task-id&gt;\`</span></span>
47
+ <span class="line"><span>- Update task: \`bd update &lt;task-id&gt; --status in_progress\`</span></span>
48
+ <span class="line"><span></span></span>
49
+ <span class="line"><span>**Important**: Create all tasks as children of the current phase task (bd-a1b2.1) to maintain proper hierarchy.</span></span></code></pre></div><h3 id="common-beads-commands" tabindex="-1">Common Beads Commands <a class="header-anchor" href="#common-beads-commands" aria-label="Permalink to &quot;Common Beads Commands&quot;">​</a></h3><h4 id="task-creation" tabindex="-1">Task Creation <a class="header-anchor" href="#task-creation" aria-label="Permalink to &quot;Task Creation&quot;">​</a></h4><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;"># Create a new task under current phase</span></span>
50
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> create</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Implement user authentication&quot;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --parent</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2.3</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -p</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 1</span></span>
51
+ <span class="line"></span>
52
+ <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Create task with description and due date</span></span>
53
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> create</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Write API tests&quot;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --parent</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2.3</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -p</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 2</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --description</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Unit tests for REST API endpoints&quot;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --due</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;2024-01-30&quot;</span></span></code></pre></div><h4 id="task-management" tabindex="-1">Task Management <a class="header-anchor" href="#task-management" aria-label="Permalink to &quot;Task Management&quot;">​</a></h4><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;"># List all tasks for current phase</span></span>
54
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --parent</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2.3</span></span>
55
+ <span class="line"></span>
56
+ <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Show task details</span></span>
57
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> show</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2.3.1</span></span>
58
+ <span class="line"></span>
59
+ <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Update task status</span></span>
60
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2.3.1</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --status</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> in_progress</span></span>
61
+ <span class="line"></span>
62
+ <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Mark task as complete</span></span>
63
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ready</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2.3.1</span></span>
64
+ <span class="line"></span>
65
+ <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Add dependencies</span></span>
66
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2.3.2</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --blocks</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2.3.1</span></span></code></pre></div><h4 id="project-overview" tabindex="-1">Project Overview <a class="header-anchor" href="#project-overview" aria-label="Permalink to &quot;Project Overview&quot;">​</a></h4><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;"># Show project epic and all phase tasks</span></span>
67
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> show</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2</span></span>
68
+ <span class="line"></span>
69
+ <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># List all tasks in project</span></span>
70
+ <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --parent</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --recursive</span></span></code></pre></div><h2 id="backwards-compatibility" tabindex="-1">Backwards Compatibility <a class="header-anchor" href="#backwards-compatibility" aria-label="Permalink to &quot;Backwards Compatibility&quot;">​</a></h2><p>The beads integration is fully backwards compatible:</p><h3 id="existing-projects" tabindex="-1">Existing Projects <a class="header-anchor" href="#existing-projects" aria-label="Permalink to &quot;Existing Projects&quot;">​</a></h3><ul><li><strong>No forced migration</strong>: Existing markdown-based projects continue working unchanged</li><li><strong>Per-project choice</strong>: Each project can choose its task backend independently</li><li><strong>Zero breaking changes</strong>: All existing responsible-vibe-mcp features remain available</li></ul><h3 id="migration-strategy" tabindex="-1">Migration Strategy <a class="header-anchor" href="#migration-strategy" aria-label="Permalink to &quot;Migration Strategy&quot;">​</a></h3><ul><li><strong>Optional adoption</strong>: Teams choose when/if to adopt beads</li><li><strong>Coexistence</strong>: Markdown and beads projects can coexist</li><li><strong>Gradual transition</strong>: Teams can experiment with beads on new projects</li></ul><h3 id="default-behavior" tabindex="-1">Default Behavior <a class="header-anchor" href="#default-behavior" aria-label="Permalink to &quot;Default Behavior&quot;">​</a></h3><ul><li><strong>Markdown default</strong>: New projects use markdown backend unless explicitly configured</li><li><strong>Graceful fallback</strong>: If beads is configured but unavailable, clear error messages provide guidance</li><li><strong>No installation required</strong>: Beads integration is purely opt-in</li></ul><h2 id="troubleshooting" tabindex="-1">Troubleshooting <a class="header-anchor" href="#troubleshooting" aria-label="Permalink to &quot;Troubleshooting&quot;">​</a></h2><h3 id="beads-command-not-found" tabindex="-1">Beads Command Not Found <a class="header-anchor" href="#beads-command-not-found" aria-label="Permalink to &quot;Beads Command Not Found&quot;">​</a></h3><p><strong>Error</strong>: <code>Beads command (bd) not found</code></p><p><strong>Solution</strong>: Install beads following the installation instructions above.</p><h3 id="beads-integration-setup-failed" tabindex="-1">Beads Integration Setup Failed <a class="header-anchor" href="#beads-integration-setup-failed" aria-label="Permalink to &quot;Beads Integration Setup Failed&quot;">​</a></h3><p><strong>Error</strong>: <code>Failed to create beads project epic</code></p><p><strong>Solutions</strong>:</p><ol><li>Ensure you&#39;re in a git repository</li><li>Verify beads is properly installed (<code>bd --version</code>)</li><li>Check beads is initialized in the project (<code>bd init</code> if needed)</li><li>Verify sufficient permissions in the project directory</li></ol><h3 id="phase-task-ids-not-found" tabindex="-1">Phase Task IDs Not Found <a class="header-anchor" href="#phase-task-ids-not-found" aria-label="Permalink to &quot;Phase Task IDs Not Found&quot;">​</a></h3><p><strong>Error</strong>: <code>Could not find beads phase task ID for current phase</code></p><p><strong>Solutions</strong>:</p><ol><li>Check the plan file contains proper <code>&lt;!-- beads-phase-id: bd-xxx --&gt;</code> comments</li><li>Verify the beads tasks exist (<code>bd show bd-xxx</code>)</li><li>Re-run <code>start_development()</code> to regenerate the beads integration</li></ol><h3 id="switching-between-backends" tabindex="-1">Switching Between Backends <a class="header-anchor" href="#switching-between-backends" aria-label="Permalink to &quot;Switching Between Backends&quot;">​</a></h3><p>To switch from beads to markdown:</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:#005CC5;--shiki-dark:#79B8FF;">unset</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> TASK_BACKEND</span></span>
71
+ <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># or</span></span>
72
+ <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> TASK_BACKEND</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">markdown</span></span></code></pre></div><p>To switch from markdown to beads:</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:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> TASK_BACKEND</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">beads</span></span></code></pre></div><p><strong>Note</strong>: Existing plan files are not automatically converted. Start a new development session to use the new backend.</p><h2 id="technical-details" tabindex="-1">Technical Details <a class="header-anchor" href="#technical-details" aria-label="Permalink to &quot;Technical Details&quot;">​</a></h2><h3 id="architecture" tabindex="-1">Architecture <a class="header-anchor" href="#architecture" aria-label="Permalink to &quot;Architecture&quot;">​</a></h3><p>The beads integration consists of several components:</p><ol><li><strong>TaskBackendManager</strong>: Detects and validates task backend configuration</li><li><strong>BeadsIntegration</strong>: Handles beads project creation and task management</li><li><strong>PlanManager</strong>: Generates appropriate plan files based on backend</li><li><strong>StartDevelopmentHandler</strong>: Orchestrates beads setup during project initialization</li><li><strong>WhatsNextHandler</strong>: Provides beads-specific instructions when active</li></ol><h3 id="plan-file-modifications" tabindex="-1">Plan File Modifications <a class="header-anchor" href="#plan-file-modifications" aria-label="Permalink to &quot;Plan File Modifications&quot;">​</a></h3><p>When using beads backend, plan files are modified:</p><ul><li><strong>Task sections</strong>: Replace checkbox lists with beads integration instructions</li><li><strong>Phase task IDs</strong>: Stored in comments for whats_next() reference</li><li><strong>Backend indication</strong>: Plan file header indicates active backend</li></ul><h3 id="error-handling" tabindex="-1">Error Handling <a class="header-anchor" href="#error-handling" aria-label="Permalink to &quot;Error Handling&quot;">​</a></h3><p>The integration includes comprehensive error handling:</p><ul><li><strong>Backend validation</strong>: Ensures beads is available when requested</li><li><strong>Setup instructions</strong>: Provides clear guidance when beads is missing</li><li><strong>Graceful degradation</strong>: Falls back to markdown mode when appropriate</li><li><strong>Detailed logging</strong>: Comprehensive logging for debugging</li></ul><h2 id="limitations" tabindex="-1">Limitations <a class="header-anchor" href="#limitations" aria-label="Permalink to &quot;Limitations&quot;">​</a></h2><h3 id="current-limitations" tabindex="-1">Current Limitations <a class="header-anchor" href="#current-limitations" aria-label="Permalink to &quot;Current Limitations&quot;">​</a></h3><ol><li><strong>No real-time sync</strong>: Plan files don&#39;t automatically update when beads tasks change</li><li><strong>Manual task creation</strong>: Tasks must be created manually using beads commands</li><li><strong>Limited metadata display</strong>: Plan files don&#39;t show full beads task metadata</li><li><strong>One-way integration</strong>: Changes in beads don&#39;t automatically update plan files</li></ol><h3 id="future-enhancements" tabindex="-1">Future Enhancements <a class="header-anchor" href="#future-enhancements" aria-label="Permalink to &quot;Future Enhancements&quot;">​</a></h3><p>Potential improvements for future versions:</p><ol><li><strong>Bidirectional sync</strong>: Automatic plan file updates from beads changes</li><li><strong>Task template integration</strong>: Pre-populate common tasks based on workflow phase</li><li><strong>Visual task management</strong>: Rich task display in plan files</li><li><strong>Advanced workflow integration</strong>: Custom beads workflows for different development phases</li></ol><h2 id="contributing" tabindex="-1">Contributing <a class="header-anchor" href="#contributing" aria-label="Permalink to &quot;Contributing&quot;">​</a></h2><p>To contribute to the beads integration:</p><ol><li><strong>Core logic</strong>: Located in <code>packages/core/src/task-backend.ts</code> and <code>packages/core/src/beads-integration.ts</code></li><li><strong>MCP handlers</strong>: Located in <code>packages/mcp-server/src/tool-handlers/</code></li><li><strong>Tests</strong>: Add tests to relevant test suites in both core and mcp-server packages</li><li><strong>Documentation</strong>: Update this document and related documentation</li></ol><h2 id="resources" tabindex="-1">Resources <a class="header-anchor" href="#resources" aria-label="Permalink to &quot;Resources&quot;">​</a></h2><ul><li><a href="https://github.com/beads-data/beads" target="_blank" rel="noreferrer">Beads GitHub Repository</a></li><li><a href="https://github.com/beads-data/beads/tree/main/integrations/beads-mcp" target="_blank" rel="noreferrer">Beads MCP Integration</a></li><li><a href="https://mrsimpson.github.io/responsible-vibe-mcp/" target="_blank" rel="noreferrer">Responsible-Vibe-MCP Documentation</a></li><li><a href="https://mrsimpson.github.io/responsible-vibe-mcp/workflows/" target="_blank" rel="noreferrer">Workflow Documentation</a></li></ul>`,91)])])}const g=s(t,[["render",l]]);export{k as __pageData,g as default};
package/packages/docs/.vitepress/dist/assets/user_beads-integration.md.BR4yrDRa.lean.js ADDED
@@ -0,0 +1 @@
1
+ import{_ as s,c as i,o as e,a0 as n}from"./chunks/framework.gHPOTw96.js";const k=JSON.parse('{"title":"Beads Integration for Responsible-Vibe-MCP","description":"","frontmatter":{},"headers":[],"relativePath":"user/beads-integration.md","filePath":"user/beads-integration.md"}'),t={name:"user/beads-integration.md"};function l(o,a,r,h,p,d){return e(),i("div",null,[...a[0]||(a[0]=[n("",91)])])}const g=s(t,[["render",l]]);export{k as __pageData,g as default};
package/packages/docs/.vitepress/dist/dev/ARCHITECTURE.html CHANGED
@@ -19,7 +19,7 @@
19
19
  <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
20
20
  </head>
21
21
  <body>
22
- <div id="app"><div class="Layout" data-v-793259ae><!--[--><!--]--><!--[--><span tabindex="-1" data-v-e4511067></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-e4511067>Skip to content</a><!--]--><!----><header class="VPNav" data-v-793259ae data-v-59bc048e><div class="VPNavBar" data-v-59bc048e data-v-969880ef><div class="wrapper" data-v-969880ef><div class="container" data-v-969880ef><div class="title" data-v-969880ef><div class="VPNavBarTitle has-sidebar" data-v-969880ef data-v-2c21f750><a class="title" href="/responsible-vibe-mcp/" data-v-2c21f750><!--[--><!--]--><!----><span data-v-2c21f750>Responsible Vibe MCP</span><!--[--><!--]--></a></div></div><div class="content" data-v-969880ef><div class="content-body" data-v-969880ef><!--[--><!--]--><div class="VPNavBarSearch search" data-v-969880ef><!----></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-969880ef data-v-afa464cc><span id="main-nav-aria-label" class="visually-hidden" data-v-afa464cc> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/responsible-vibe-mcp/" tabindex="0" data-v-afa464cc data-v-ffd80936><!--[--><span data-v-ffd80936>Documentation</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/responsible-vibe-mcp/workflows.html" tabindex="0" data-v-afa464cc data-v-ffd80936><!--[--><span data-v-ffd80936>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-afa464cc data-v-ffd80936><!--[--><span data-v-ffd80936>Github</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-969880ef data-v-6f54757f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6f54757f data-v-ec2a0fe5 data-v-12f28f6f><span class="check" data-v-12f28f6f><span class="icon" data-v-12f28f6f><!--[--><span class="vpi-sun sun" data-v-ec2a0fe5></span><span class="vpi-moon moon" data-v-ec2a0fe5></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-969880ef data-v-75fc7e88 data-v-e002db9a><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-e002db9a><span class="vpi-more-horizontal icon" data-v-e002db9a></span></button><div class="menu" data-v-e002db9a><div class="VPMenu" data-v-e002db9a data-v-d4309bd1><!----><!--[--><!--[--><!----><div class="group" data-v-75fc7e88><div class="item appearance" data-v-75fc7e88><p class="label" data-v-75fc7e88>Appearance</p><div class="appearance-action" data-v-75fc7e88><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-75fc7e88 data-v-ec2a0fe5 data-v-12f28f6f><span class="check" data-v-12f28f6f><span class="icon" data-v-12f28f6f><!--[--><span class="vpi-sun sun" data-v-ec2a0fe5></span><span class="vpi-moon moon" data-v-ec2a0fe5></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-969880ef data-v-7adb053c><span class="container" data-v-7adb053c><span class="top" data-v-7adb053c></span><span class="middle" data-v-7adb053c></span><span class="bottom" data-v-7adb053c></span></span></button></div></div></div></div><div class="divider" data-v-969880ef><div class="divider-line" data-v-969880ef></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-793259ae data-v-b7f341b3><div class="container" data-v-b7f341b3><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-b7f341b3><span class="vpi-align-left menu-icon" data-v-b7f341b3></span><span class="menu-text" data-v-b7f341b3>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-b7f341b3 data-v-454e3eda><button data-v-454e3eda>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-793259ae data-v-eb9664d6><div class="curtain" data-v-eb9664d6></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-eb9664d6><span class="visually-hidden" id="sidebar-aria-label" data-v-eb9664d6> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-75f10f97><section class="VPSidebarItem level-0" data-v-75f10f97 data-v-14b77bdf><div class="item" role="button" tabindex="0" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><h2 class="text" data-v-14b77bdf>User Guide</h2><!----></div><div class="items" data-v-14b77bdf><!--[--><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/how-it-works.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>How It Works</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/agent-setup.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Agent Setup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/advanced-engineering.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Vibe Engineering</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/long-term-memory.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Long-Term Memory</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/tutorial.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Tutorial</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-75f10f97><section class="VPSidebarItem level-0" data-v-75f10f97 data-v-14b77bdf><div class="item" role="button" tabindex="0" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><h2 class="text" data-v-14b77bdf>Workflows</h2><!----></div><div class="items" data-v-14b77bdf><!--[--><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/workflow-selection.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Workflow-Selection</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/workflows.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Explore All Workflows</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/custom-workflows.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Custom Workflows</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/crowd-mcp-integration.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Crowd MCP Integration</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-793259ae data-v-987f9636><div class="VPDoc has-sidebar has-aside" data-v-987f9636 data-v-e54aa9f7><!--[--><!--]--><div class="container" data-v-e54aa9f7><div class="aside" data-v-e54aa9f7><div class="aside-curtain" data-v-e54aa9f7></div><div class="aside-container" data-v-e54aa9f7><div class="aside-content" data-v-e54aa9f7><div class="VPDocAside" data-v-e54aa9f7 data-v-76d5b5ee><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-76d5b5ee data-v-9b7425cb><div class="content" data-v-9b7425cb><div class="outline-marker" data-v-9b7425cb></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-9b7425cb>On this page</div><ul class="VPDocOutlineItem root" data-v-9b7425cb data-v-ffee3cb7><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-76d5b5ee></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-e54aa9f7><div class="content-container" data-v-e54aa9f7><!--[--><!--]--><main class="main" data-v-e54aa9f7><div style="position:relative;" class="vp-doc _responsible-vibe-mcp_dev_ARCHITECTURE" data-v-e54aa9f7><div><h1 id="architecture" tabindex="-1">Architecture <a class="header-anchor" href="#architecture" aria-label="Permalink to &quot;Architecture&quot;">​</a></h1><p>This document provides detailed information about the Responsible Vibe MCP Server architecture, components, and design principles.</p><h2 id="information-architecture" tabindex="-1">Information Architecture <a class="header-anchor" href="#information-architecture" aria-label="Permalink to &quot;Information Architecture&quot;">​</a></h2><p>Responsible-Vibe-MCP implements a <strong>plan-file-centric information architecture</strong> with clear separation of responsibilities across different components:</p><h3 id="information-component-responsibilities" tabindex="-1">Information Component Responsibilities <a class="header-anchor" href="#information-component-responsibilities" aria-label="Permalink to &quot;Information Component Responsibilities&quot;">​</a></h3><table tabindex="0"><thead><tr><th><strong>Component</strong></th><th><strong>Responsibility</strong></th><th><strong>Information Type</strong></th><th><strong>Maintenance</strong></th></tr></thead><tbody><tr><td><strong>System Prompt</strong></td><td>Generic workflow guidance</td><td>How to use the system</td><td>Static</td></tr><tr><td><strong>Tool Descriptions</strong></td><td>Generic tool usage</td><td>What each tool does</td><td>Static</td></tr><tr><td><strong>Tool Responses</strong></td><td>Dynamic phase guidance</td><td>What to do right now</td><td>Dynamic</td></tr><tr><td><strong>Plan File</strong></td><td>Project context &amp; tasks</td><td>What we&#39;ve done/decided</td><td>LLM-maintained</td></tr></tbody></table><h3 id="core-principles" tabindex="-1">Core Principles <a class="header-anchor" href="#core-principles" aria-label="Permalink to &quot;Core Principles&quot;">​</a></h3><h4 id="_1-static-components-stay-generic" tabindex="-1"><strong>1. Static Components Stay Generic</strong> <a class="header-anchor" href="#_1-static-components-stay-generic" aria-label="Permalink to &quot;**1. Static Components Stay Generic**&quot;">​</a></h4><ul><li><strong>System Prompt</strong>: Workflow-agnostic instructions on tool usage patterns</li><li><strong>Tool Descriptions</strong>: Generic tool purposes without hardcoded phase names</li><li><strong>Benefit</strong>: Works with any workflow (built-in or custom)</li></ul><h4 id="_2-dynamic-guidance-through-tool-responses" tabindex="-1"><strong>2. Dynamic Guidance Through Tool Responses</strong> <a class="header-anchor" href="#_2-dynamic-guidance-through-tool-responses" aria-label="Permalink to &quot;**2. Dynamic Guidance Through Tool Responses**&quot;">​</a></h4><ul><li><strong>Tool responses provide</strong>: Phase-specific instructions, user interaction guidance, completion criteria</li><li><strong>Plan-file-referential</strong>: &quot;Check your plan file&#39;s Design section for current tasks&quot;</li><li><strong>Context-aware</strong>: Adapts to current project state and progress</li></ul><h4 id="_3-plan-file-as-single-source-of-truth" tabindex="-1"><strong>3. Plan File as Single Source of Truth</strong> <a class="header-anchor" href="#_3-plan-file-as-single-source-of-truth" aria-label="Permalink to &quot;**3. Plan File as Single Source of Truth**&quot;">​</a></h4><ul><li><strong>Contains</strong>: Task lists per phase, key decisions, project context</li><li><strong>Structure</strong>: Simple, LLM-maintainable (no complex dynamic elements)</li><li><strong>Purpose</strong>: Task tracker and decision log, not workflow guide</li></ul><h4 id="_4-clear-separation-of-concerns" tabindex="-1"><strong>4. Clear Separation of Concerns</strong> <a class="header-anchor" href="#_4-clear-separation-of-concerns" aria-label="Permalink to &quot;**4. Clear Separation of Concerns**&quot;">​</a></h4><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>System Prompt: &quot;How to use tools&quot;</span></span>
22
+ <div id="app"><div class="Layout" data-v-793259ae><!--[--><!--]--><!--[--><span tabindex="-1" data-v-e4511067></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-e4511067>Skip to content</a><!--]--><!----><header class="VPNav" data-v-793259ae data-v-59bc048e><div class="VPNavBar" data-v-59bc048e data-v-969880ef><div class="wrapper" data-v-969880ef><div class="container" data-v-969880ef><div class="title" data-v-969880ef><div class="VPNavBarTitle has-sidebar" data-v-969880ef data-v-2c21f750><a class="title" href="/responsible-vibe-mcp/" data-v-2c21f750><!--[--><!--]--><!----><span data-v-2c21f750>Responsible Vibe MCP</span><!--[--><!--]--></a></div></div><div class="content" data-v-969880ef><div class="content-body" data-v-969880ef><!--[--><!--]--><div class="VPNavBarSearch search" data-v-969880ef><!----></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-969880ef data-v-afa464cc><span id="main-nav-aria-label" class="visually-hidden" data-v-afa464cc> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/responsible-vibe-mcp/" tabindex="0" data-v-afa464cc data-v-ffd80936><!--[--><span data-v-ffd80936>Documentation</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/responsible-vibe-mcp/workflows.html" tabindex="0" data-v-afa464cc data-v-ffd80936><!--[--><span data-v-ffd80936>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-afa464cc data-v-ffd80936><!--[--><span data-v-ffd80936>Github</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-969880ef data-v-6f54757f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6f54757f data-v-ec2a0fe5 data-v-12f28f6f><span class="check" data-v-12f28f6f><span class="icon" data-v-12f28f6f><!--[--><span class="vpi-sun sun" data-v-ec2a0fe5></span><span class="vpi-moon moon" data-v-ec2a0fe5></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-969880ef data-v-75fc7e88 data-v-e002db9a><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-e002db9a><span class="vpi-more-horizontal icon" data-v-e002db9a></span></button><div class="menu" data-v-e002db9a><div class="VPMenu" data-v-e002db9a data-v-d4309bd1><!----><!--[--><!--[--><!----><div class="group" data-v-75fc7e88><div class="item appearance" data-v-75fc7e88><p class="label" data-v-75fc7e88>Appearance</p><div class="appearance-action" data-v-75fc7e88><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-75fc7e88 data-v-ec2a0fe5 data-v-12f28f6f><span class="check" data-v-12f28f6f><span class="icon" data-v-12f28f6f><!--[--><span class="vpi-sun sun" data-v-ec2a0fe5></span><span class="vpi-moon moon" data-v-ec2a0fe5></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-969880ef data-v-7adb053c><span class="container" data-v-7adb053c><span class="top" data-v-7adb053c></span><span class="middle" data-v-7adb053c></span><span class="bottom" data-v-7adb053c></span></span></button></div></div></div></div><div class="divider" data-v-969880ef><div class="divider-line" data-v-969880ef></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-793259ae data-v-b7f341b3><div class="container" data-v-b7f341b3><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-b7f341b3><span class="vpi-align-left menu-icon" data-v-b7f341b3></span><span class="menu-text" data-v-b7f341b3>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-b7f341b3 data-v-454e3eda><button data-v-454e3eda>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-793259ae data-v-eb9664d6><div class="curtain" data-v-eb9664d6></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-eb9664d6><span class="visually-hidden" id="sidebar-aria-label" data-v-eb9664d6> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-75f10f97><section class="VPSidebarItem level-0" data-v-75f10f97 data-v-14b77bdf><div class="item" role="button" tabindex="0" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><h2 class="text" data-v-14b77bdf>User Guide</h2><!----></div><div class="items" data-v-14b77bdf><!--[--><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/how-it-works.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>How It Works</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/agent-setup.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Agent Setup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/advanced-engineering.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Vibe Engineering</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/long-term-memory.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Long-Term Memory</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/beads-integration.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Beads-Integration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/tutorial.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Tutorial</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-75f10f97><section class="VPSidebarItem level-0" data-v-75f10f97 data-v-14b77bdf><div class="item" role="button" tabindex="0" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><h2 class="text" data-v-14b77bdf>Workflows</h2><!----></div><div class="items" data-v-14b77bdf><!--[--><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/workflow-selection.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Workflow-Selection</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/workflows.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Explore All Workflows</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/custom-workflows.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Custom Workflows</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/crowd-mcp-integration.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Crowd MCP Integration</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-793259ae data-v-987f9636><div class="VPDoc has-sidebar has-aside" data-v-987f9636 data-v-e54aa9f7><!--[--><!--]--><div class="container" data-v-e54aa9f7><div class="aside" data-v-e54aa9f7><div class="aside-curtain" data-v-e54aa9f7></div><div class="aside-container" data-v-e54aa9f7><div class="aside-content" data-v-e54aa9f7><div class="VPDocAside" data-v-e54aa9f7 data-v-76d5b5ee><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-76d5b5ee data-v-9b7425cb><div class="content" data-v-9b7425cb><div class="outline-marker" data-v-9b7425cb></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-9b7425cb>On this page</div><ul class="VPDocOutlineItem root" data-v-9b7425cb data-v-ffee3cb7><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-76d5b5ee></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-e54aa9f7><div class="content-container" data-v-e54aa9f7><!--[--><!--]--><main class="main" data-v-e54aa9f7><div style="position:relative;" class="vp-doc _responsible-vibe-mcp_dev_ARCHITECTURE" data-v-e54aa9f7><div><h1 id="architecture" tabindex="-1">Architecture <a class="header-anchor" href="#architecture" aria-label="Permalink to &quot;Architecture&quot;">​</a></h1><p>This document provides detailed information about the Responsible Vibe MCP Server architecture, components, and design principles.</p><h2 id="information-architecture" tabindex="-1">Information Architecture <a class="header-anchor" href="#information-architecture" aria-label="Permalink to &quot;Information Architecture&quot;">​</a></h2><p>Responsible-Vibe-MCP implements a <strong>plan-file-centric information architecture</strong> with clear separation of responsibilities across different components:</p><h3 id="information-component-responsibilities" tabindex="-1">Information Component Responsibilities <a class="header-anchor" href="#information-component-responsibilities" aria-label="Permalink to &quot;Information Component Responsibilities&quot;">​</a></h3><table tabindex="0"><thead><tr><th><strong>Component</strong></th><th><strong>Responsibility</strong></th><th><strong>Information Type</strong></th><th><strong>Maintenance</strong></th></tr></thead><tbody><tr><td><strong>System Prompt</strong></td><td>Generic workflow guidance</td><td>How to use the system</td><td>Static</td></tr><tr><td><strong>Tool Descriptions</strong></td><td>Generic tool usage</td><td>What each tool does</td><td>Static</td></tr><tr><td><strong>Tool Responses</strong></td><td>Dynamic phase guidance</td><td>What to do right now</td><td>Dynamic</td></tr><tr><td><strong>Plan File</strong></td><td>Project context &amp; tasks</td><td>What we&#39;ve done/decided</td><td>LLM-maintained</td></tr></tbody></table><h3 id="core-principles" tabindex="-1">Core Principles <a class="header-anchor" href="#core-principles" aria-label="Permalink to &quot;Core Principles&quot;">​</a></h3><h4 id="_1-static-components-stay-generic" tabindex="-1"><strong>1. Static Components Stay Generic</strong> <a class="header-anchor" href="#_1-static-components-stay-generic" aria-label="Permalink to &quot;**1. Static Components Stay Generic**&quot;">​</a></h4><ul><li><strong>System Prompt</strong>: Workflow-agnostic instructions on tool usage patterns</li><li><strong>Tool Descriptions</strong>: Generic tool purposes without hardcoded phase names</li><li><strong>Benefit</strong>: Works with any workflow (built-in or custom)</li></ul><h4 id="_2-dynamic-guidance-through-tool-responses" tabindex="-1"><strong>2. Dynamic Guidance Through Tool Responses</strong> <a class="header-anchor" href="#_2-dynamic-guidance-through-tool-responses" aria-label="Permalink to &quot;**2. Dynamic Guidance Through Tool Responses**&quot;">​</a></h4><ul><li><strong>Tool responses provide</strong>: Phase-specific instructions, user interaction guidance, completion criteria</li><li><strong>Plan-file-referential</strong>: &quot;Check your plan file&#39;s Design section for current tasks&quot;</li><li><strong>Context-aware</strong>: Adapts to current project state and progress</li></ul><h4 id="_3-plan-file-as-single-source-of-truth" tabindex="-1"><strong>3. Plan File as Single Source of Truth</strong> <a class="header-anchor" href="#_3-plan-file-as-single-source-of-truth" aria-label="Permalink to &quot;**3. Plan File as Single Source of Truth**&quot;">​</a></h4><ul><li><strong>Contains</strong>: Task lists per phase, key decisions, project context</li><li><strong>Structure</strong>: Simple, LLM-maintainable (no complex dynamic elements)</li><li><strong>Purpose</strong>: Task tracker and decision log, not workflow guide</li></ul><h4 id="_4-clear-separation-of-concerns" tabindex="-1"><strong>4. Clear Separation of Concerns</strong> <a class="header-anchor" href="#_4-clear-separation-of-concerns" aria-label="Permalink to &quot;**4. Clear Separation of Concerns**&quot;">​</a></h4><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>System Prompt: &quot;How to use tools&quot;</span></span>
23
23
  <span class="line"><span>Tool Descriptions: &quot;What tools do&quot; (generic)</span></span>
24
24
  <span class="line"><span>Tool Responses: &quot;Check plan file section X, work on tasks Y, Z&quot; (specific)</span></span>
25
25
  <span class="line"><span>Plan File: &quot;[ ] Task 1 [x] Task 2 Decision: chose approach A&quot; (tracking)</span></span></code></pre></div><h3 id="benefits-of-this-architecture" tabindex="-1">Benefits of This Architecture <a class="header-anchor" href="#benefits-of-this-architecture" aria-label="Permalink to &quot;Benefits of This Architecture&quot;">​</a></h3><ul><li><strong>✅ Workflow Flexibility</strong>: Static components work with any workflow type</li><li><strong>✅ Maintainable</strong>: No hardcoded workflow information in static descriptions</li><li><strong>✅ User Transparency</strong>: Users see the same plan file the LLM follows</li><li><strong>✅ Consistent Guidance</strong>: All dynamic instructions come from tool responses</li><li><strong>✅ Simple Maintenance</strong>: LLM only updates simple task lists and decisions</li></ul><h2 id="monorepo-architecture" tabindex="-1">Monorepo Architecture <a class="header-anchor" href="#monorepo-architecture" aria-label="Permalink to &quot;Monorepo Architecture&quot;">​</a></h2><p>Responsible-Vibe-MCP is organized as a monorepo with clear package separation and dependency management:</p><h3 id="package-structure" tabindex="-1">Package Structure <a class="header-anchor" href="#package-structure" aria-label="Permalink to &quot;Package Structure&quot;">​</a></h3><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>responsible-vibe-mcp/</span></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></div></div></main><footer class="VPDocFooter" data-v-e54aa9f7 data-v-5ee41a35><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-5ee41a35><span class="visually-hidden" id="doc-footer-aria-label" data-v-5ee41a35>Pager</span><div class="pager" data-v-5ee41a35><!----></div><div class="pager" data-v-5ee41a35><a class="VPLink link pager-link next" href="/responsible-vibe-mcp/" data-v-5ee41a35><!--[--><span class="desc" data-v-5ee41a35>Next page</span><span class="title" data-v-5ee41a35>Overview</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
152
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"v94YJS-p\",\"dev_development.md\":\"DUJdRHQV\",\"dev_logging.md\":\"DZNw81ne\",\"dev_publishing.md\":\"NaXiVuSC\",\"index.md\":\"CexYDH8O\",\"user_advanced-engineering.md\":\"CVjCpqmE\",\"user_agent-setup.md\":\"CfyzSeoq\",\"user_crowd-mcp-integration.md\":\"L2F3yTPt\",\"user_custom-workflows.md\":\"DyDxr2X_\",\"user_git-commit-feature.md\":\"BKn5HSBm\",\"user_how-it-works.md\":\"Cz8-c1YR\",\"user_long-term-memory.md\":\"BHVmeqSD\",\"user_tutorial.md\":\"3q3JM54h\",\"user_workflow-selection.md\":\"CDpPPRiE\",\"workflows.md\":\"DKfUCqv5\",\"workflows_adr.md\":\"WqKoCOsT\",\"workflows_big-bang-conversion.md\":\"B2uRBL_k\",\"workflows_boundary-testing.md\":\"BbV9tRHk\",\"workflows_bugfix.md\":\"B2sXKKGx\",\"workflows_business-analysis.md\":\"CcOMIlu-\",\"workflows_c4-analysis.md\":\"BvkdYdaJ\",\"workflows_epcc.md\":\"BvfhyoHC\",\"workflows_game-beginner.md\":\"Dmw0yenX\",\"workflows_greenfield.md\":\"gdHw7n8T\",\"workflows_minor.md\":\"CCpon9D_\",\"workflows_posts.md\":\"BB0Bx0Eh\",\"workflows_sdd-bugfix-crowd.md\":\"CXslslqL\",\"workflows_sdd-bugfix.md\":\"Ik57ZyHx\",\"workflows_sdd-feature-crowd.md\":\"B-Tg93H_\",\"workflows_sdd-feature.md\":\"Bc_1r0_Q\",\"workflows_sdd-greenfield-crowd.md\":\"CKxmKSuU\",\"workflows_sdd-greenfield.md\":\"BRyXknCo\",\"workflows_slides.md\":\"oNvoNIvP\",\"workflows_tdd.md\":\"tQIBQZGo\",\"workflows_waterfall.md\":\"DyNeDPq_\"}");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\":\"Tutorial\",\"link\":\"/user/tutorial\"}]},{\"text\":\"Workflows\",\"items\":[{\"text\":\"Workflow-Selection\",\"link\":\"/user/workflow-selection\"},{\"text\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
152
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"v94YJS-p\",\"dev_development.md\":\"DUJdRHQV\",\"dev_logging.md\":\"DZNw81ne\",\"dev_publishing.md\":\"NaXiVuSC\",\"index.md\":\"CexYDH8O\",\"user_advanced-engineering.md\":\"CVjCpqmE\",\"user_agent-setup.md\":\"CfyzSeoq\",\"user_beads-integration.md\":\"BR4yrDRa\",\"user_crowd-mcp-integration.md\":\"L2F3yTPt\",\"user_custom-workflows.md\":\"DyDxr2X_\",\"user_git-commit-feature.md\":\"BKn5HSBm\",\"user_how-it-works.md\":\"Cz8-c1YR\",\"user_long-term-memory.md\":\"BHVmeqSD\",\"user_tutorial.md\":\"3q3JM54h\",\"user_workflow-selection.md\":\"CDpPPRiE\",\"workflows.md\":\"DKfUCqv5\",\"workflows_adr.md\":\"WqKoCOsT\",\"workflows_big-bang-conversion.md\":\"B2uRBL_k\",\"workflows_boundary-testing.md\":\"BbV9tRHk\",\"workflows_bugfix.md\":\"B2sXKKGx\",\"workflows_business-analysis.md\":\"CcOMIlu-\",\"workflows_c4-analysis.md\":\"BvkdYdaJ\",\"workflows_epcc.md\":\"BvfhyoHC\",\"workflows_game-beginner.md\":\"Dmw0yenX\",\"workflows_greenfield.md\":\"gdHw7n8T\",\"workflows_minor.md\":\"CCpon9D_\",\"workflows_posts.md\":\"BB0Bx0Eh\",\"workflows_sdd-bugfix-crowd.md\":\"CXslslqL\",\"workflows_sdd-bugfix.md\":\"Ik57ZyHx\",\"workflows_sdd-feature-crowd.md\":\"B-Tg93H_\",\"workflows_sdd-feature.md\":\"Bc_1r0_Q\",\"workflows_sdd-greenfield-crowd.md\":\"CKxmKSuU\",\"workflows_sdd-greenfield.md\":\"BRyXknCo\",\"workflows_slides.md\":\"oNvoNIvP\",\"workflows_tdd.md\":\"tQIBQZGo\",\"workflows_waterfall.md\":\"DyNeDPq_\"}");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\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
153
153
 
154
154
  </body>
155
155
  </html>
package/packages/docs/.vitepress/dist/dev/DEVELOPMENT.html CHANGED
@@ -19,7 +19,7 @@
19
19
  <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
20
20
  </head>
21
21
  <body>
22
- <div id="app"><div class="Layout" data-v-793259ae><!--[--><!--]--><!--[--><span tabindex="-1" data-v-e4511067></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-e4511067>Skip to content</a><!--]--><!----><header class="VPNav" data-v-793259ae data-v-59bc048e><div class="VPNavBar" data-v-59bc048e data-v-969880ef><div class="wrapper" data-v-969880ef><div class="container" data-v-969880ef><div class="title" data-v-969880ef><div class="VPNavBarTitle has-sidebar" data-v-969880ef data-v-2c21f750><a class="title" href="/responsible-vibe-mcp/" data-v-2c21f750><!--[--><!--]--><!----><span data-v-2c21f750>Responsible Vibe MCP</span><!--[--><!--]--></a></div></div><div class="content" data-v-969880ef><div class="content-body" data-v-969880ef><!--[--><!--]--><div class="VPNavBarSearch search" data-v-969880ef><!----></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-969880ef data-v-afa464cc><span id="main-nav-aria-label" class="visually-hidden" data-v-afa464cc> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/responsible-vibe-mcp/" tabindex="0" data-v-afa464cc data-v-ffd80936><!--[--><span data-v-ffd80936>Documentation</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/responsible-vibe-mcp/workflows.html" tabindex="0" data-v-afa464cc data-v-ffd80936><!--[--><span data-v-ffd80936>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-afa464cc data-v-ffd80936><!--[--><span data-v-ffd80936>Github</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-969880ef data-v-6f54757f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6f54757f data-v-ec2a0fe5 data-v-12f28f6f><span class="check" data-v-12f28f6f><span class="icon" data-v-12f28f6f><!--[--><span class="vpi-sun sun" data-v-ec2a0fe5></span><span class="vpi-moon moon" data-v-ec2a0fe5></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-969880ef data-v-75fc7e88 data-v-e002db9a><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-e002db9a><span class="vpi-more-horizontal icon" data-v-e002db9a></span></button><div class="menu" data-v-e002db9a><div class="VPMenu" data-v-e002db9a data-v-d4309bd1><!----><!--[--><!--[--><!----><div class="group" data-v-75fc7e88><div class="item appearance" data-v-75fc7e88><p class="label" data-v-75fc7e88>Appearance</p><div class="appearance-action" data-v-75fc7e88><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-75fc7e88 data-v-ec2a0fe5 data-v-12f28f6f><span class="check" data-v-12f28f6f><span class="icon" data-v-12f28f6f><!--[--><span class="vpi-sun sun" data-v-ec2a0fe5></span><span class="vpi-moon moon" data-v-ec2a0fe5></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-969880ef data-v-7adb053c><span class="container" data-v-7adb053c><span class="top" data-v-7adb053c></span><span class="middle" data-v-7adb053c></span><span class="bottom" data-v-7adb053c></span></span></button></div></div></div></div><div class="divider" data-v-969880ef><div class="divider-line" data-v-969880ef></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-793259ae data-v-b7f341b3><div class="container" data-v-b7f341b3><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-b7f341b3><span class="vpi-align-left menu-icon" data-v-b7f341b3></span><span class="menu-text" data-v-b7f341b3>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-b7f341b3 data-v-454e3eda><button data-v-454e3eda>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-793259ae data-v-eb9664d6><div class="curtain" data-v-eb9664d6></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-eb9664d6><span class="visually-hidden" id="sidebar-aria-label" data-v-eb9664d6> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-75f10f97><section class="VPSidebarItem level-0" data-v-75f10f97 data-v-14b77bdf><div class="item" role="button" tabindex="0" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><h2 class="text" data-v-14b77bdf>User Guide</h2><!----></div><div class="items" data-v-14b77bdf><!--[--><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/how-it-works.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>How It Works</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/agent-setup.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Agent Setup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/advanced-engineering.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Vibe Engineering</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/long-term-memory.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Long-Term Memory</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/tutorial.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Tutorial</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-75f10f97><section class="VPSidebarItem level-0" data-v-75f10f97 data-v-14b77bdf><div class="item" role="button" tabindex="0" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><h2 class="text" data-v-14b77bdf>Workflows</h2><!----></div><div class="items" data-v-14b77bdf><!--[--><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/workflow-selection.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Workflow-Selection</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/workflows.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Explore All Workflows</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/custom-workflows.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Custom Workflows</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/crowd-mcp-integration.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Crowd MCP Integration</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-793259ae data-v-987f9636><div class="VPDoc has-sidebar has-aside" data-v-987f9636 data-v-e54aa9f7><!--[--><!--]--><div class="container" data-v-e54aa9f7><div class="aside" data-v-e54aa9f7><div class="aside-curtain" data-v-e54aa9f7></div><div class="aside-container" data-v-e54aa9f7><div class="aside-content" data-v-e54aa9f7><div class="VPDocAside" data-v-e54aa9f7 data-v-76d5b5ee><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-76d5b5ee data-v-9b7425cb><div class="content" data-v-9b7425cb><div class="outline-marker" data-v-9b7425cb></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-9b7425cb>On this page</div><ul class="VPDocOutlineItem root" data-v-9b7425cb data-v-ffee3cb7><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-76d5b5ee></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-e54aa9f7><div class="content-container" data-v-e54aa9f7><!--[--><!--]--><main class="main" data-v-e54aa9f7><div style="position:relative;" class="vp-doc _responsible-vibe-mcp_dev_DEVELOPMENT" data-v-e54aa9f7><div><h1 id="development" tabindex="-1">Development <a class="header-anchor" href="#development" aria-label="Permalink to &quot;Development&quot;">​</a></h1><p>This document provides information for developers working on the Responsible Vibe MCP Server, including testing, logging, debugging, and architectural decisions.</p><h2 id="optional-documentation-feature" tabindex="-1">Optional Documentation Feature <a class="header-anchor" href="#optional-documentation-feature" aria-label="Permalink to &quot;Optional Documentation Feature&quot;">​</a></h2><p>The system includes a flexible documentation architecture that allows workflows to specify their documentation requirements:</p><h3 id="key-implementation-components" tabindex="-1">Key Implementation Components <a class="header-anchor" href="#key-implementation-components" aria-label="Permalink to &quot;Key Implementation Components&quot;">​</a></h3><h4 id="_1-workflow-metadata-schema" tabindex="-1">1. Workflow Metadata Schema <a class="header-anchor" href="#_1-workflow-metadata-schema" aria-label="Permalink to &quot;1. Workflow Metadata Schema&quot;">​</a></h4><div class="language-typescript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">typescript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">interface</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> YamlStateMachine</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
22
+ <div id="app"><div class="Layout" data-v-793259ae><!--[--><!--]--><!--[--><span tabindex="-1" data-v-e4511067></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-e4511067>Skip to content</a><!--]--><!----><header class="VPNav" data-v-793259ae data-v-59bc048e><div class="VPNavBar" data-v-59bc048e data-v-969880ef><div class="wrapper" data-v-969880ef><div class="container" data-v-969880ef><div class="title" data-v-969880ef><div class="VPNavBarTitle has-sidebar" data-v-969880ef data-v-2c21f750><a class="title" href="/responsible-vibe-mcp/" data-v-2c21f750><!--[--><!--]--><!----><span data-v-2c21f750>Responsible Vibe MCP</span><!--[--><!--]--></a></div></div><div class="content" data-v-969880ef><div class="content-body" data-v-969880ef><!--[--><!--]--><div class="VPNavBarSearch search" data-v-969880ef><!----></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-969880ef data-v-afa464cc><span id="main-nav-aria-label" class="visually-hidden" data-v-afa464cc> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/responsible-vibe-mcp/" tabindex="0" data-v-afa464cc data-v-ffd80936><!--[--><span data-v-ffd80936>Documentation</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/responsible-vibe-mcp/workflows.html" tabindex="0" data-v-afa464cc data-v-ffd80936><!--[--><span data-v-ffd80936>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-afa464cc data-v-ffd80936><!--[--><span data-v-ffd80936>Github</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-969880ef data-v-6f54757f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6f54757f data-v-ec2a0fe5 data-v-12f28f6f><span class="check" data-v-12f28f6f><span class="icon" data-v-12f28f6f><!--[--><span class="vpi-sun sun" data-v-ec2a0fe5></span><span class="vpi-moon moon" data-v-ec2a0fe5></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-969880ef data-v-75fc7e88 data-v-e002db9a><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-e002db9a><span class="vpi-more-horizontal icon" data-v-e002db9a></span></button><div class="menu" data-v-e002db9a><div class="VPMenu" data-v-e002db9a data-v-d4309bd1><!----><!--[--><!--[--><!----><div class="group" data-v-75fc7e88><div class="item appearance" data-v-75fc7e88><p class="label" data-v-75fc7e88>Appearance</p><div class="appearance-action" data-v-75fc7e88><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-75fc7e88 data-v-ec2a0fe5 data-v-12f28f6f><span class="check" data-v-12f28f6f><span class="icon" data-v-12f28f6f><!--[--><span class="vpi-sun sun" data-v-ec2a0fe5></span><span class="vpi-moon moon" data-v-ec2a0fe5></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-969880ef data-v-7adb053c><span class="container" data-v-7adb053c><span class="top" data-v-7adb053c></span><span class="middle" data-v-7adb053c></span><span class="bottom" data-v-7adb053c></span></span></button></div></div></div></div><div class="divider" data-v-969880ef><div class="divider-line" data-v-969880ef></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-793259ae data-v-b7f341b3><div class="container" data-v-b7f341b3><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-b7f341b3><span class="vpi-align-left menu-icon" data-v-b7f341b3></span><span class="menu-text" data-v-b7f341b3>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-b7f341b3 data-v-454e3eda><button data-v-454e3eda>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-793259ae data-v-eb9664d6><div class="curtain" data-v-eb9664d6></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-eb9664d6><span class="visually-hidden" id="sidebar-aria-label" data-v-eb9664d6> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-75f10f97><section class="VPSidebarItem level-0" data-v-75f10f97 data-v-14b77bdf><div class="item" role="button" tabindex="0" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><h2 class="text" data-v-14b77bdf>User Guide</h2><!----></div><div class="items" data-v-14b77bdf><!--[--><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/how-it-works.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>How It Works</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/agent-setup.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Agent Setup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/advanced-engineering.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Vibe Engineering</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/long-term-memory.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Long-Term Memory</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/beads-integration.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Beads-Integration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/tutorial.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Tutorial</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-75f10f97><section class="VPSidebarItem level-0" data-v-75f10f97 data-v-14b77bdf><div class="item" role="button" tabindex="0" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><h2 class="text" data-v-14b77bdf>Workflows</h2><!----></div><div class="items" data-v-14b77bdf><!--[--><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/workflow-selection.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Workflow-Selection</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/workflows.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Explore All Workflows</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/custom-workflows.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Custom Workflows</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-14b77bdf data-v-14b77bdf><div class="item" data-v-14b77bdf><div class="indicator" data-v-14b77bdf></div><a class="VPLink link link" href="/responsible-vibe-mcp/user/crowd-mcp-integration.html" data-v-14b77bdf><!--[--><p class="text" data-v-14b77bdf>Crowd MCP Integration</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-793259ae data-v-987f9636><div class="VPDoc has-sidebar has-aside" data-v-987f9636 data-v-e54aa9f7><!--[--><!--]--><div class="container" data-v-e54aa9f7><div class="aside" data-v-e54aa9f7><div class="aside-curtain" data-v-e54aa9f7></div><div class="aside-container" data-v-e54aa9f7><div class="aside-content" data-v-e54aa9f7><div class="VPDocAside" data-v-e54aa9f7 data-v-76d5b5ee><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-76d5b5ee data-v-9b7425cb><div class="content" data-v-9b7425cb><div class="outline-marker" data-v-9b7425cb></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-9b7425cb>On this page</div><ul class="VPDocOutlineItem root" data-v-9b7425cb data-v-ffee3cb7><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-76d5b5ee></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-e54aa9f7><div class="content-container" data-v-e54aa9f7><!--[--><!--]--><main class="main" data-v-e54aa9f7><div style="position:relative;" class="vp-doc _responsible-vibe-mcp_dev_DEVELOPMENT" data-v-e54aa9f7><div><h1 id="development" tabindex="-1">Development <a class="header-anchor" href="#development" aria-label="Permalink to &quot;Development&quot;">​</a></h1><p>This document provides information for developers working on the Responsible Vibe MCP Server, including testing, logging, debugging, and architectural decisions.</p><h2 id="optional-documentation-feature" tabindex="-1">Optional Documentation Feature <a class="header-anchor" href="#optional-documentation-feature" aria-label="Permalink to &quot;Optional Documentation Feature&quot;">​</a></h2><p>The system includes a flexible documentation architecture that allows workflows to specify their documentation requirements:</p><h3 id="key-implementation-components" tabindex="-1">Key Implementation Components <a class="header-anchor" href="#key-implementation-components" aria-label="Permalink to &quot;Key Implementation Components&quot;">​</a></h3><h4 id="_1-workflow-metadata-schema" tabindex="-1">1. Workflow Metadata Schema <a class="header-anchor" href="#_1-workflow-metadata-schema" aria-label="Permalink to &quot;1. Workflow Metadata Schema&quot;">​</a></h4><div class="language-typescript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">typescript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">interface</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> YamlStateMachine</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
23
23
  <span class="line"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> metadata</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">?:</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
24
24
  <span class="line"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> requiresDocumentation</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">?:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> boolean</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">; </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// defaults to false</span></span>
25
25
  <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // ... other metadata</span></span>
@@ -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 &quot;Pull Request Process&quot;">​</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 &quot;Automated Checks&quot;">​</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 &quot;Dependency Management&quot;">​</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 &quot;Release Process&quot;">​</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-e54aa9f7 data-v-5ee41a35><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-5ee41a35><span class="visually-hidden" id="doc-footer-aria-label" data-v-5ee41a35>Pager</span><div class="pager" data-v-5ee41a35><!----></div><div class="pager" data-v-5ee41a35><a class="VPLink link pager-link next" href="/responsible-vibe-mcp/" data-v-5ee41a35><!--[--><span class="desc" data-v-5ee41a35>Next page</span><span class="title" data-v-5ee41a35>Overview</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
94
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"v94YJS-p\",\"dev_development.md\":\"DUJdRHQV\",\"dev_logging.md\":\"DZNw81ne\",\"dev_publishing.md\":\"NaXiVuSC\",\"index.md\":\"CexYDH8O\",\"user_advanced-engineering.md\":\"CVjCpqmE\",\"user_agent-setup.md\":\"CfyzSeoq\",\"user_crowd-mcp-integration.md\":\"L2F3yTPt\",\"user_custom-workflows.md\":\"DyDxr2X_\",\"user_git-commit-feature.md\":\"BKn5HSBm\",\"user_how-it-works.md\":\"Cz8-c1YR\",\"user_long-term-memory.md\":\"BHVmeqSD\",\"user_tutorial.md\":\"3q3JM54h\",\"user_workflow-selection.md\":\"CDpPPRiE\",\"workflows.md\":\"DKfUCqv5\",\"workflows_adr.md\":\"WqKoCOsT\",\"workflows_big-bang-conversion.md\":\"B2uRBL_k\",\"workflows_boundary-testing.md\":\"BbV9tRHk\",\"workflows_bugfix.md\":\"B2sXKKGx\",\"workflows_business-analysis.md\":\"CcOMIlu-\",\"workflows_c4-analysis.md\":\"BvkdYdaJ\",\"workflows_epcc.md\":\"BvfhyoHC\",\"workflows_game-beginner.md\":\"Dmw0yenX\",\"workflows_greenfield.md\":\"gdHw7n8T\",\"workflows_minor.md\":\"CCpon9D_\",\"workflows_posts.md\":\"BB0Bx0Eh\",\"workflows_sdd-bugfix-crowd.md\":\"CXslslqL\",\"workflows_sdd-bugfix.md\":\"Ik57ZyHx\",\"workflows_sdd-feature-crowd.md\":\"B-Tg93H_\",\"workflows_sdd-feature.md\":\"Bc_1r0_Q\",\"workflows_sdd-greenfield-crowd.md\":\"CKxmKSuU\",\"workflows_sdd-greenfield.md\":\"BRyXknCo\",\"workflows_slides.md\":\"oNvoNIvP\",\"workflows_tdd.md\":\"tQIBQZGo\",\"workflows_waterfall.md\":\"DyNeDPq_\"}");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\":\"Tutorial\",\"link\":\"/user/tutorial\"}]},{\"text\":\"Workflows\",\"items\":[{\"text\":\"Workflow-Selection\",\"link\":\"/user/workflow-selection\"},{\"text\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
94
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"v94YJS-p\",\"dev_development.md\":\"DUJdRHQV\",\"dev_logging.md\":\"DZNw81ne\",\"dev_publishing.md\":\"NaXiVuSC\",\"index.md\":\"CexYDH8O\",\"user_advanced-engineering.md\":\"CVjCpqmE\",\"user_agent-setup.md\":\"CfyzSeoq\",\"user_beads-integration.md\":\"BR4yrDRa\",\"user_crowd-mcp-integration.md\":\"L2F3yTPt\",\"user_custom-workflows.md\":\"DyDxr2X_\",\"user_git-commit-feature.md\":\"BKn5HSBm\",\"user_how-it-works.md\":\"Cz8-c1YR\",\"user_long-term-memory.md\":\"BHVmeqSD\",\"user_tutorial.md\":\"3q3JM54h\",\"user_workflow-selection.md\":\"CDpPPRiE\",\"workflows.md\":\"DKfUCqv5\",\"workflows_adr.md\":\"WqKoCOsT\",\"workflows_big-bang-conversion.md\":\"B2uRBL_k\",\"workflows_boundary-testing.md\":\"BbV9tRHk\",\"workflows_bugfix.md\":\"B2sXKKGx\",\"workflows_business-analysis.md\":\"CcOMIlu-\",\"workflows_c4-analysis.md\":\"BvkdYdaJ\",\"workflows_epcc.md\":\"BvfhyoHC\",\"workflows_game-beginner.md\":\"Dmw0yenX\",\"workflows_greenfield.md\":\"gdHw7n8T\",\"workflows_minor.md\":\"CCpon9D_\",\"workflows_posts.md\":\"BB0Bx0Eh\",\"workflows_sdd-bugfix-crowd.md\":\"CXslslqL\",\"workflows_sdd-bugfix.md\":\"Ik57ZyHx\",\"workflows_sdd-feature-crowd.md\":\"B-Tg93H_\",\"workflows_sdd-feature.md\":\"Bc_1r0_Q\",\"workflows_sdd-greenfield-crowd.md\":\"CKxmKSuU\",\"workflows_sdd-greenfield.md\":\"BRyXknCo\",\"workflows_slides.md\":\"oNvoNIvP\",\"workflows_tdd.md\":\"tQIBQZGo\",\"workflows_waterfall.md\":\"DyNeDPq_\"}");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\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
95
95
 
96
96
  </body>
97
97
  </html>