@codemcp/workflows 5.3.0 → 6.0.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.
- package/README.md +91 -0
- package/package.json +77 -17
- package/packages/cli/dist/chunk-R5U7XKVJ.js +16 -0
- package/packages/cli/dist/chunk-RTDQR2KY.js +6718 -0
- package/packages/cli/dist/cli-CZ4FMSWR.js +1421 -0
- package/packages/cli/dist/dist-KZOA4GL5.js +65 -0
- package/packages/cli/dist/dist-UGVUJIDN.js +14475 -0
- package/packages/cli/dist/index.js +21 -0
- package/packages/cli/package.json +28 -0
- package/packages/core/dist/beads-integration.d.ts +50 -0
- package/packages/core/dist/beads-integration.js +387 -0
- package/packages/core/dist/beads-integration.js.map +1 -0
- package/packages/core/dist/beads-state-manager.d.ts +58 -0
- package/packages/core/dist/beads-state-manager.js +212 -0
- package/packages/core/dist/beads-state-manager.js.map +1 -0
- package/packages/core/dist/config-manager.d.ts +24 -0
- package/packages/core/dist/config-manager.js +68 -0
- package/packages/core/dist/config-manager.js.map +1 -0
- package/packages/core/dist/conversation-manager.d.ts +98 -0
- package/packages/core/dist/conversation-manager.js +382 -0
- package/packages/core/dist/conversation-manager.js.map +1 -0
- package/packages/core/dist/file-detection-manager.d.ts +53 -0
- package/packages/core/dist/file-detection-manager.js +221 -0
- package/packages/core/dist/file-detection-manager.js.map +1 -0
- package/packages/core/dist/file-storage.d.ts +93 -0
- package/packages/core/dist/file-storage.js +301 -0
- package/packages/core/dist/file-storage.js.map +1 -0
- package/packages/core/dist/git-manager.d.ts +22 -0
- package/packages/core/dist/git-manager.js +123 -0
- package/packages/core/dist/git-manager.js.map +1 -0
- package/packages/core/dist/index.d.ts +24 -0
- package/packages/core/dist/index.js +31 -0
- package/packages/core/dist/index.js.map +1 -0
- package/packages/core/dist/instruction-generator.d.ts +40 -0
- package/packages/core/dist/instruction-generator.js +89 -0
- package/packages/core/dist/instruction-generator.js.map +1 -0
- package/packages/core/dist/interaction-logger.d.ts +37 -0
- package/packages/core/dist/interaction-logger.js +87 -0
- package/packages/core/dist/interaction-logger.js.map +1 -0
- package/packages/core/dist/interfaces/index.d.ts +9 -0
- package/packages/core/dist/interfaces/index.js +10 -0
- package/packages/core/dist/interfaces/index.js.map +1 -0
- package/packages/core/dist/interfaces/instruction-generator.interface.d.ts +41 -0
- package/packages/core/dist/interfaces/instruction-generator.interface.js +8 -0
- package/packages/core/dist/interfaces/instruction-generator.interface.js.map +1 -0
- package/packages/core/dist/interfaces/plan-manager.interface.d.ts +55 -0
- package/packages/core/dist/interfaces/plan-manager.interface.js +8 -0
- package/packages/core/dist/interfaces/plan-manager.interface.js.map +1 -0
- package/packages/core/dist/interfaces/task-backend-client.interface.d.ts +52 -0
- package/packages/core/dist/interfaces/task-backend-client.interface.js +8 -0
- package/packages/core/dist/interfaces/task-backend-client.interface.js.map +1 -0
- package/packages/core/dist/logger.d.ts +64 -0
- package/packages/core/dist/logger.js +283 -0
- package/packages/core/dist/logger.js.map +1 -0
- package/packages/core/dist/path-validation-utils.d.ts +75 -0
- package/packages/core/dist/path-validation-utils.js +238 -0
- package/packages/core/dist/path-validation-utils.js.map +1 -0
- package/packages/core/dist/persistence-interface.d.ts +91 -0
- package/packages/core/dist/persistence-interface.js +9 -0
- package/packages/core/dist/persistence-interface.js.map +1 -0
- package/{dist/components/beads/beads-plan-manager.d.ts → packages/core/dist/plan-manager.d.ts} +15 -15
- package/{dist/components/beads/beads-plan-manager.js → packages/core/dist/plan-manager.js} +66 -50
- package/packages/core/dist/plan-manager.js.map +1 -0
- package/packages/core/dist/project-docs-manager.d.ts +119 -0
- package/packages/core/dist/project-docs-manager.js +366 -0
- package/packages/core/dist/project-docs-manager.js.map +1 -0
- package/packages/core/dist/state-machine-loader.d.ts +61 -0
- package/packages/core/dist/state-machine-loader.js +273 -0
- package/packages/core/dist/state-machine-loader.js.map +1 -0
- package/packages/core/dist/state-machine-types.d.ts +64 -0
- package/packages/core/dist/state-machine-types.js +7 -0
- package/packages/core/dist/state-machine-types.js.map +1 -0
- package/packages/core/dist/state-machine.d.ts +52 -0
- package/packages/core/dist/state-machine.js +256 -0
- package/packages/core/dist/state-machine.js.map +1 -0
- package/packages/core/dist/system-prompt-generator.d.ts +14 -0
- package/packages/core/dist/system-prompt-generator.js +42 -0
- package/packages/core/dist/system-prompt-generator.js.map +1 -0
- package/packages/core/dist/task-backend.d.ts +45 -0
- package/packages/core/dist/task-backend.js +176 -0
- package/packages/core/dist/task-backend.js.map +1 -0
- package/packages/core/dist/template-manager.d.ts +61 -0
- package/packages/core/dist/template-manager.js +231 -0
- package/packages/core/dist/template-manager.js.map +1 -0
- package/packages/core/dist/transition-engine.d.ts +77 -0
- package/packages/core/dist/transition-engine.js +244 -0
- package/packages/core/dist/transition-engine.js.map +1 -0
- package/packages/core/dist/types.d.ts +54 -0
- package/packages/core/dist/types.js +5 -0
- package/packages/core/dist/workflow-manager.d.ts +89 -0
- package/packages/core/dist/workflow-manager.js +468 -0
- package/packages/core/dist/workflow-manager.js.map +1 -0
- package/packages/core/package.json +33 -0
- package/packages/docs/.vitepress/dist/.gitignore +2 -0
- package/packages/docs/.vitepress/dist/404.html +23 -0
- package/packages/docs/.vitepress/dist/assets/app.Dz3lZH3M.js +1 -0
- package/packages/docs/.vitepress/dist/assets/chunks/framework.DZS7lpav.js +19 -0
- package/packages/docs/.vitepress/dist/assets/chunks/theme.q5Ewb3F1.js +206 -0
- package/packages/docs/.vitepress/dist/assets/dev_ARCHITECTURE.md.da_vFDwM.js +130 -0
- package/packages/docs/.vitepress/dist/assets/dev_ARCHITECTURE.md.da_vFDwM.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/dev_DEVELOPMENT.md.DWl9cccE.js +72 -0
- package/packages/docs/.vitepress/dist/assets/dev_DEVELOPMENT.md.DWl9cccE.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/dev_LOGGING.md.BebvbW7z.js +34 -0
- package/packages/docs/.vitepress/dist/assets/dev_LOGGING.md.BebvbW7z.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/dev_PUBLISHING.md.CQqbiIOF.js +1 -0
- package/packages/docs/.vitepress/dist/assets/dev_PUBLISHING.md.CQqbiIOF.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/index.md.D6ROLohf.js +2 -0
- package/packages/docs/.vitepress/dist/assets/index.md.D6ROLohf.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-italic-cyrillic.By2_1cv3.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-italic-greek-ext.1u6EdAuj.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-italic-greek.DJ8dCoTZ.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-italic-latin-ext.CN1xVJS-.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-italic-latin.C2AdPX0b.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-italic-vietnamese.BSbpV94h.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-roman-cyrillic.C5lxZ8CY.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-roman-greek.BBVDIX6e.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-roman-latin.Di8DUHzh.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/inter-roman-vietnamese.BjW4sHH5.woff2 +0 -0
- package/packages/docs/.vitepress/dist/assets/mcp-interaction-pattern.VdvOPuTt.png +0 -0
- package/packages/docs/.vitepress/dist/assets/placeholder-demo-greenfield.B8lG_tBI.png +0 -0
- package/packages/docs/.vitepress/dist/assets/style.CAgdBzOq.css +1 -0
- package/packages/docs/.vitepress/dist/assets/user_advanced-engineering.md.MkETYNtq.js +50 -0
- package/packages/docs/.vitepress/dist/assets/user_advanced-engineering.md.MkETYNtq.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/user_agent-setup.md.B54OLL2H.js +24 -0
- package/packages/docs/.vitepress/dist/assets/user_agent-setup.md.B54OLL2H.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/user_beads-integration.md.BzdR5Fif.js +15 -0
- package/packages/docs/.vitepress/dist/assets/user_beads-integration.md.BzdR5Fif.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/user_crowd-mcp-integration.md.C15kSdIJ.js +157 -0
- package/packages/docs/.vitepress/dist/assets/user_crowd-mcp-integration.md.C15kSdIJ.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/user_custom-workflows.md.Cz4IYCXa.js +143 -0
- package/packages/docs/.vitepress/dist/assets/user_custom-workflows.md.Cz4IYCXa.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/user_git-commit-feature.md.UcTvDR-O.js +1 -0
- package/packages/docs/.vitepress/dist/assets/user_git-commit-feature.md.UcTvDR-O.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/user_how-it-works.md.DiOXNgaL.js +23 -0
- package/packages/docs/.vitepress/dist/assets/user_how-it-works.md.DiOXNgaL.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/user_long-term-memory.md.DZh0tjNa.js +43 -0
- package/packages/docs/.vitepress/dist/assets/user_long-term-memory.md.DZh0tjNa.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/user_packaged-workflows.md.s1HT89ZU.js +2 -0
- package/packages/docs/.vitepress/dist/assets/user_packaged-workflows.md.s1HT89ZU.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/user_tutorial.md.Dmj8zLB2.js +3 -0
- package/packages/docs/.vitepress/dist/assets/user_tutorial.md.Dmj8zLB2.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/user_workflow-selection.md.CrPGw9Hr.js +7 -0
- package/packages/docs/.vitepress/dist/assets/user_workflow-selection.md.CrPGw9Hr.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows.md.Bm5sGt3u.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows.md.Bm5sGt3u.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_adr.md.DEaXkbRp.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_adr.md.DEaXkbRp.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_big-bang-conversion.md.BA5R1LxZ.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_big-bang-conversion.md.BA5R1LxZ.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_boundary-testing.md.DBcYnMhx.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_boundary-testing.md.DBcYnMhx.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_bugfix.md.CZRCL0Hp.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_bugfix.md.CZRCL0Hp.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_business-analysis.md.fGLml8Hw.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_business-analysis.md.fGLml8Hw.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_c4-analysis.md.Dnssqzuf.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_c4-analysis.md.Dnssqzuf.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_epcc.md.M6DnIhpp.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_epcc.md.M6DnIhpp.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_game-beginner.md.CNxzWLtd.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_game-beginner.md.CNxzWLtd.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_greenfield.md.vx_g-WOe.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_greenfield.md.vx_g-WOe.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_minor.md.DdnfwMf4.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_minor.md.DdnfwMf4.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_posts.md.SOldXvq7.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_posts.md.SOldXvq7.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_sdd-bugfix-crowd.md.-lSf42gJ.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_sdd-bugfix-crowd.md.-lSf42gJ.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_sdd-bugfix.md.oRAsEVbc.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_sdd-bugfix.md.oRAsEVbc.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_sdd-feature-crowd.md.DAtnfCAd.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_sdd-feature-crowd.md.DAtnfCAd.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_sdd-feature.md.Ce3-H_g3.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_sdd-feature.md.Ce3-H_g3.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_sdd-greenfield-crowd.md.8DUvcmLe.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_sdd-greenfield-crowd.md.8DUvcmLe.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_sdd-greenfield.md.eEN6U0J4.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_sdd-greenfield.md.eEN6U0J4.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_slides.md.Cqt-19_1.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_slides.md.Cqt-19_1.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_tdd.md.BjVC69tu.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_tdd.md.BjVC69tu.lean.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_waterfall.md.CL6jTZP9.js +1 -0
- package/packages/docs/.vitepress/dist/assets/workflows_waterfall.md.CL6jTZP9.lean.js +1 -0
- package/packages/docs/.vitepress/dist/dev/ARCHITECTURE.html +155 -0
- package/packages/docs/.vitepress/dist/dev/DEVELOPMENT.html +97 -0
- package/packages/docs/.vitepress/dist/dev/LOGGING.html +59 -0
- package/packages/docs/.vitepress/dist/dev/PUBLISHING.html +30 -0
- package/packages/docs/.vitepress/dist/hashmap.json +1 -0
- package/packages/docs/.vitepress/dist/index.html +27 -0
- package/packages/docs/.vitepress/dist/user/advanced-engineering.html +75 -0
- package/packages/docs/.vitepress/dist/user/agent-setup.html +49 -0
- package/packages/docs/.vitepress/dist/user/beads-integration.html +40 -0
- package/packages/docs/.vitepress/dist/user/crowd-mcp-integration.html +182 -0
- package/packages/docs/.vitepress/dist/user/custom-workflows.html +168 -0
- package/packages/docs/.vitepress/dist/user/git-commit-feature.html +30 -0
- package/packages/docs/.vitepress/dist/user/how-it-works.html +48 -0
- package/packages/docs/.vitepress/dist/user/long-term-memory.html +68 -0
- package/packages/docs/.vitepress/dist/user/packaged-workflows.html +27 -0
- package/packages/docs/.vitepress/dist/user/tutorial.html +28 -0
- package/packages/docs/.vitepress/dist/user/workflow-selection.html +32 -0
- package/packages/docs/.vitepress/dist/vp-icons.css +0 -0
- package/packages/docs/.vitepress/dist/workflows/adr.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/adr.yaml +157 -0
- package/packages/docs/.vitepress/dist/workflows/big-bang-conversion.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/big-bang-conversion.yaml +592 -0
- package/packages/docs/.vitepress/dist/workflows/boundary-testing.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/boundary-testing.yaml +376 -0
- package/packages/docs/.vitepress/dist/workflows/bugfix.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/bugfix.yaml +177 -0
- package/packages/docs/.vitepress/dist/workflows/business-analysis.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/business-analysis.yaml +597 -0
- package/packages/docs/.vitepress/dist/workflows/c4-analysis.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/c4-analysis.yaml +471 -0
- package/packages/docs/.vitepress/dist/workflows/epcc.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/epcc.yaml +183 -0
- package/packages/docs/.vitepress/dist/workflows/game-beginner.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/game-beginner.yaml +434 -0
- package/packages/docs/.vitepress/dist/workflows/greenfield.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/greenfield.yaml +201 -0
- package/packages/docs/.vitepress/dist/workflows/minor.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/minor.yaml +138 -0
- package/packages/docs/.vitepress/dist/workflows/posts.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/posts.yaml +193 -0
- package/packages/docs/.vitepress/dist/workflows/sdd-bugfix-crowd.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/sdd-bugfix-crowd.yaml +608 -0
- package/packages/docs/.vitepress/dist/workflows/sdd-bugfix.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/sdd-bugfix.yaml +381 -0
- package/packages/docs/.vitepress/dist/workflows/sdd-feature-crowd.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/sdd-feature-crowd.yaml +713 -0
- package/packages/docs/.vitepress/dist/workflows/sdd-feature.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/sdd-feature.yaml +471 -0
- package/packages/docs/.vitepress/dist/workflows/sdd-greenfield-crowd.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/sdd-greenfield-crowd.yaml +336 -0
- package/packages/docs/.vitepress/dist/workflows/sdd-greenfield.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/sdd-greenfield.yaml +463 -0
- package/packages/docs/.vitepress/dist/workflows/slides.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/slides.yaml +237 -0
- package/packages/docs/.vitepress/dist/workflows/tdd.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/tdd.yaml +160 -0
- package/packages/docs/.vitepress/dist/workflows/waterfall.html +26 -0
- package/packages/docs/.vitepress/dist/workflows/waterfall.yaml +209 -0
- package/packages/docs/.vitepress/dist/workflows.html +26 -0
- package/packages/docs/package.json +32 -0
- package/packages/mcp-server/dist/index.js +10546 -0
- package/packages/mcp-server/package.json +41 -0
- package/packages/visualizer/dist/WorkflowVisualizer.vue +1147 -0
- package/packages/visualizer/dist/index.ts +17 -0
- package/packages/visualizer/dist/main.ts +673 -0
- package/packages/visualizer/dist/services/BundledWorkflows.ts +35 -0
- package/packages/visualizer/dist/services/FileUploadHandler.ts +166 -0
- package/packages/visualizer/dist/services/WorkflowLoader.ts +198 -0
- package/packages/visualizer/dist/services/YamlParser.ts +248 -0
- package/packages/visualizer/dist/services/workflow-list.ts +23 -0
- package/packages/visualizer/dist/types/ui-types.ts +84 -0
- package/packages/visualizer/dist/types/visualization-types.ts +95 -0
- package/packages/visualizer/dist/types/vite-env.d.ts +12 -0
- package/packages/visualizer/dist/utils/DomHelpers.ts +206 -0
- package/packages/visualizer/dist/utils/ErrorHandler.ts +170 -0
- package/packages/visualizer/dist/utils/PlantUMLEncoder.ts +121 -0
- package/packages/visualizer/dist/visualization/DiagramRenderer.ts +430 -0
- package/packages/visualizer/dist/visualization/LayoutEngine.ts +339 -0
- package/packages/visualizer/dist/visualization/PlantUMLRenderer.ts +507 -0
- package/packages/visualizer/dist/visualization/StateRenderer.ts +339 -0
- package/packages/visualizer/dist/visualization/TransitionRenderer.ts +432 -0
- package/packages/visualizer/package.json +39 -0
- package/resources/.DS_Store +0 -0
- package/resources/agents/architect.yaml +61 -0
- package/resources/agents/business-analyst.yaml +60 -0
- package/resources/agents/developer.yaml +61 -0
- package/resources/state-machine-schema.json +114 -0
- package/resources/templates/architecture/arc42/arc42-template-EN.md +1077 -0
- package/resources/templates/architecture/arc42/images/01_2_iso-25010-topics-EN.drawio-2023.png +0 -0
- package/resources/templates/architecture/arc42/images/01_2_iso-25010-topics-EN.drawio.png +0 -0
- package/resources/templates/architecture/arc42/images/05_building_blocks-EN.png +0 -0
- package/resources/templates/architecture/arc42/images/08-concepts-EN.drawio.png +0 -0
- package/resources/templates/architecture/arc42/images/arc42-logo.png +0 -0
- package/resources/templates/architecture/c4.md +224 -0
- package/resources/templates/architecture/freestyle.md +53 -0
- package/resources/templates/architecture/game.md +250 -0
- package/resources/templates/architecture/none.md +17 -0
- package/resources/templates/design/comprehensive.md +207 -0
- package/resources/templates/design/freestyle.md +37 -0
- package/resources/templates/design/game.md +66 -0
- package/resources/templates/design/none.md +17 -0
- package/resources/templates/requirements/ears.md +90 -0
- package/resources/templates/requirements/freestyle.md +42 -0
- package/resources/templates/requirements/game.md +162 -0
- package/resources/templates/requirements/none.md +17 -0
- package/resources/templates/skills/POWER.md +23 -0
- package/resources/templates/skills/SKILL.md +19 -0
- package/resources/workflows/adr.yaml +157 -0
- package/resources/workflows/big-bang-conversion.yaml +592 -0
- package/resources/workflows/boundary-testing.yaml +376 -0
- package/resources/workflows/bugfix.yaml +177 -0
- package/resources/workflows/business-analysis.yaml +597 -0
- package/resources/workflows/c4-analysis.yaml +471 -0
- package/resources/workflows/epcc.yaml +183 -0
- package/resources/workflows/game-beginner.yaml +434 -0
- package/resources/workflows/greenfield.yaml +201 -0
- package/resources/workflows/minor.yaml +138 -0
- package/resources/workflows/posts.yaml +193 -0
- package/resources/workflows/sdd-bugfix-crowd.yaml +608 -0
- package/resources/workflows/sdd-bugfix.yaml +381 -0
- package/resources/workflows/sdd-feature-crowd.yaml +713 -0
- package/resources/workflows/sdd-feature.yaml +471 -0
- package/resources/workflows/sdd-greenfield-crowd.yaml +336 -0
- package/resources/workflows/sdd-greenfield.yaml +463 -0
- package/resources/workflows/slides.yaml +237 -0
- package/resources/workflows/tdd.yaml +160 -0
- package/resources/workflows/waterfall.yaml +209 -0
- package/dist/components/beads/beads-instruction-generator.d.ts +0 -44
- package/dist/components/beads/beads-instruction-generator.d.ts.map +0 -1
- package/dist/components/beads/beads-instruction-generator.js +0 -160
- package/dist/components/beads/beads-instruction-generator.js.map +0 -1
- package/dist/components/beads/beads-plan-manager.d.ts.map +0 -1
- package/dist/components/beads/beads-plan-manager.js.map +0 -1
- package/dist/components/beads/beads-task-backend-client.d.ts +0 -43
- package/dist/components/beads/beads-task-backend-client.d.ts.map +0 -1
- package/dist/components/beads/beads-task-backend-client.js +0 -175
- package/dist/components/beads/beads-task-backend-client.js.map +0 -1
- package/dist/index.d.ts +0 -9
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js +0 -74
- package/dist/index.js.map +0 -1
- package/dist/notification-service.d.ts +0 -14
- package/dist/notification-service.d.ts.map +0 -1
- package/dist/notification-service.js +0 -18
- package/dist/notification-service.js.map +0 -1
- package/dist/plugin-system/beads-plugin.d.ts +0 -71
- package/dist/plugin-system/beads-plugin.d.ts.map +0 -1
- package/dist/plugin-system/beads-plugin.js +0 -465
- package/dist/plugin-system/beads-plugin.js.map +0 -1
- package/dist/plugin-system/commit-plugin.d.ts +0 -40
- package/dist/plugin-system/commit-plugin.d.ts.map +0 -1
- package/dist/plugin-system/commit-plugin.js +0 -204
- package/dist/plugin-system/commit-plugin.js.map +0 -1
- package/dist/plugin-system/index.d.ts +0 -9
- package/dist/plugin-system/index.d.ts.map +0 -1
- package/dist/plugin-system/index.js +0 -9
- package/dist/plugin-system/index.js.map +0 -1
- package/dist/plugin-system/plugin-interfaces.d.ts +0 -98
- package/dist/plugin-system/plugin-interfaces.d.ts.map +0 -1
- package/dist/plugin-system/plugin-interfaces.js +0 -9
- package/dist/plugin-system/plugin-interfaces.js.map +0 -1
- package/dist/plugin-system/plugin-registry.d.ts +0 -44
- package/dist/plugin-system/plugin-registry.d.ts.map +0 -1
- package/dist/plugin-system/plugin-registry.js +0 -132
- package/dist/plugin-system/plugin-registry.js.map +0 -1
- package/dist/resource-handlers/conversation-state.d.ts +0 -15
- package/dist/resource-handlers/conversation-state.d.ts.map +0 -1
- package/dist/resource-handlers/conversation-state.js +0 -40
- package/dist/resource-handlers/conversation-state.js.map +0 -1
- package/dist/resource-handlers/development-plan.d.ts +0 -14
- package/dist/resource-handlers/development-plan.d.ts.map +0 -1
- package/dist/resource-handlers/development-plan.js +0 -31
- package/dist/resource-handlers/development-plan.js.map +0 -1
- package/dist/resource-handlers/index.d.ts +0 -24
- package/dist/resource-handlers/index.d.ts.map +0 -1
- package/dist/resource-handlers/index.js +0 -62
- package/dist/resource-handlers/index.js.map +0 -1
- package/dist/resource-handlers/system-prompt.d.ts +0 -15
- package/dist/resource-handlers/system-prompt.d.ts.map +0 -1
- package/dist/resource-handlers/system-prompt.js +0 -40
- package/dist/resource-handlers/system-prompt.js.map +0 -1
- package/dist/resource-handlers/workflow-resource.d.ts +0 -15
- package/dist/resource-handlers/workflow-resource.d.ts.map +0 -1
- package/dist/resource-handlers/workflow-resource.js +0 -85
- package/dist/resource-handlers/workflow-resource.js.map +0 -1
- package/dist/response-renderer.d.ts +0 -30
- package/dist/response-renderer.d.ts.map +0 -1
- package/dist/response-renderer.js +0 -94
- package/dist/response-renderer.js.map +0 -1
- package/dist/server-config.d.ts +0 -34
- package/dist/server-config.d.ts.map +0 -1
- package/dist/server-config.js +0 -503
- package/dist/server-config.js.map +0 -1
- package/dist/server-helpers.d.ts +0 -70
- package/dist/server-helpers.d.ts.map +0 -1
- package/dist/server-helpers.js +0 -171
- package/dist/server-helpers.js.map +0 -1
- package/dist/server-implementation.d.ts +0 -74
- package/dist/server-implementation.d.ts.map +0 -1
- package/dist/server-implementation.js +0 -201
- package/dist/server-implementation.js.map +0 -1
- package/dist/server.d.ts +0 -6
- package/dist/server.d.ts.map +0 -1
- package/dist/server.js +0 -5
- package/dist/server.js.map +0 -1
- package/dist/tool-handlers/base-tool-handler.d.ts +0 -50
- package/dist/tool-handlers/base-tool-handler.d.ts.map +0 -1
- package/dist/tool-handlers/base-tool-handler.js +0 -81
- package/dist/tool-handlers/base-tool-handler.js.map +0 -1
- package/dist/tool-handlers/conduct-review.d.ts +0 -49
- package/dist/tool-handlers/conduct-review.d.ts.map +0 -1
- package/dist/tool-handlers/conduct-review.js +0 -104
- package/dist/tool-handlers/conduct-review.js.map +0 -1
- package/dist/tool-handlers/get-tool-info.d.ts +0 -75
- package/dist/tool-handlers/get-tool-info.d.ts.map +0 -1
- package/dist/tool-handlers/get-tool-info.js +0 -168
- package/dist/tool-handlers/get-tool-info.js.map +0 -1
- package/dist/tool-handlers/index.d.ts +0 -41
- package/dist/tool-handlers/index.d.ts.map +0 -1
- package/dist/tool-handlers/index.js +0 -71
- package/dist/tool-handlers/index.js.map +0 -1
- package/dist/tool-handlers/list-workflows.d.ts +0 -35
- package/dist/tool-handlers/list-workflows.d.ts.map +0 -1
- package/dist/tool-handlers/list-workflows.js +0 -43
- package/dist/tool-handlers/list-workflows.js.map +0 -1
- package/dist/tool-handlers/no-idea.d.ts +0 -41
- package/dist/tool-handlers/no-idea.d.ts.map +0 -1
- package/dist/tool-handlers/no-idea.js +0 -29
- package/dist/tool-handlers/no-idea.js.map +0 -1
- package/dist/tool-handlers/proceed-to-phase.d.ts +0 -41
- package/dist/tool-handlers/proceed-to-phase.d.ts.map +0 -1
- package/dist/tool-handlers/proceed-to-phase.js +0 -165
- package/dist/tool-handlers/proceed-to-phase.js.map +0 -1
- package/dist/tool-handlers/reset-development.d.ts +0 -31
- package/dist/tool-handlers/reset-development.d.ts.map +0 -1
- package/dist/tool-handlers/reset-development.js +0 -48
- package/dist/tool-handlers/reset-development.js.map +0 -1
- package/dist/tool-handlers/resume-workflow.d.ts +0 -87
- package/dist/tool-handlers/resume-workflow.d.ts.map +0 -1
- package/dist/tool-handlers/resume-workflow.js +0 -212
- package/dist/tool-handlers/resume-workflow.js.map +0 -1
- package/dist/tool-handlers/setup-project-docs.d.ts +0 -37
- package/dist/tool-handlers/setup-project-docs.d.ts.map +0 -1
- package/dist/tool-handlers/setup-project-docs.js +0 -138
- package/dist/tool-handlers/setup-project-docs.js.map +0 -1
- package/dist/tool-handlers/start-development.d.ts +0 -79
- package/dist/tool-handlers/start-development.d.ts.map +0 -1
- package/dist/tool-handlers/start-development.js +0 -484
- package/dist/tool-handlers/start-development.js.map +0 -1
- package/dist/tool-handlers/whats-next.d.ts +0 -41
- package/dist/tool-handlers/whats-next.d.ts.map +0 -1
- package/dist/tool-handlers/whats-next.js +0 -123
- package/dist/tool-handlers/whats-next.js.map +0 -1
- package/dist/types.d.ts +0 -119
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js +0 -5
- package/dist/version-info.d.ts +0 -30
- package/dist/version-info.d.ts.map +0 -1
- package/dist/version-info.js +0 -178
- package/dist/version-info.js.map +0 -1
- package/skill/SKILL.md +0 -28
- /package/{dist → packages/core/dist}/types.js.map +0 -0
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import{_ as a,c as i,o as e,a0 as t}from"./chunks/framework.DZS7lpav.js";const c=JSON.parse('{"title":"Beads Integration for Workflows Server","description":"","frontmatter":{},"headers":[],"relativePath":"user/beads-integration.md","filePath":"user/beads-integration.md"}'),n={name:"user/beads-integration.md"};function l(r,s,o,h,p,d){return e(),i("div",null,[...s[0]||(s[0]=[t(`<h1 id="beads-integration-for-workflows-server" tabindex="-1">Beads Integration for Workflows Server <a class="header-anchor" href="#beads-integration-for-workflows-server" aria-label="Permalink to "Beads Integration for Workflows Server""></a></h1><p>Integration between the workflows server and <a href="https://github.com/steveyegge/beads" target="_blank" rel="noreferrer">beads distributed issue tracker</a> for enhanced AI agent task management.</p><h2 id="overview" tabindex="-1">Overview <a class="header-anchor" href="#overview" aria-label="Permalink to "Overview""></a></h2><p><strong>Prerequisites</strong>: <code>bd</code> CLI must be installed and available in PATH.</p><p><strong>Backends</strong>:</p><ul><li><strong>Markdown</strong>: Checkbox tasks in plan files</li><li><strong>Beads</strong>: Rich task management with dependencies, priorities, and git integration</li></ul><h2 id="configuration" tabindex="-1">Configuration <a class="header-anchor" href="#configuration" aria-label="Permalink to "Configuration""></a></h2><p>Beads is <strong>auto-detected</strong>: if the <code>bd</code> command is available, it is used automatically. No configuration needed.</p><p>To explicitly override auto-detection:</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;">markdown </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Force markdown even if bd is available</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;">beads </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Force beads (errors if bd unavailable)</span></span></code></pre></div><h2 id="quick-setup" tabindex="-1">Quick Setup <a class="header-anchor" href="#quick-setup" aria-label="Permalink to "Quick Setup""></a></h2><ol><li>Install beads CLI (<code>bd</code> command must be in PATH)</li><li>Use <code>start_development()</code> as normal — beads is detected automatically</li></ol><h2 id="usage" tabindex="-1">Usage <a class="header-anchor" href="#usage" aria-label="Permalink to "Usage""></a></h2><h3 id="development-workflow" tabindex="-1">Development Workflow <a class="header-anchor" href="#development-workflow" aria-label="Permalink to "Development Workflow""></a></h3><p>When beads is active:</p><ol><li><strong>Project epic</strong>: Created automatically for all development tasks</li><li><strong>Phase tasks</strong>: One task per workflow phase with sequential dependencies</li><li><strong>Plan file</strong>: Modified to include beads task IDs in comments</li></ol><p><strong>Task Hierarchy</strong> (automatic):</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: "responsible-vibe Development: My Project" (bd-a1b2)</span></span>
|
|
3
|
+
<span class="line"><span>├── Explore Phase (bd-a1b2.1) → Plan Phase (bd-a1b2.2) →</span></span>
|
|
4
|
+
<span class="line"><span>├── Code Phase (bd-a1b2.3) → Commit Phase (bd-a1b2.4)</span></span></code></pre></div><p><strong>Sequential dependencies</strong>: Each phase blocks the next, ensuring proper workflow order.</p><h3 id="essential-commands" tabindex="-1">Essential Commands <a class="header-anchor" href="#essential-commands" aria-label="Permalink to "Essential Commands""></a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Task creation with context</span></span>
|
|
5
|
+
<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;"> "Task title"</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --parent</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2.1</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --description</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> "what, why, how"</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --priority</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 2</span></span>
|
|
6
|
+
<span class="line"></span>
|
|
7
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Task management</span></span>
|
|
8
|
+
<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.1</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --status</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> open</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # List phase tasks</span></span>
|
|
9
|
+
<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:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">task-i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # Show details</span></span>
|
|
10
|
+
<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:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">task-i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --status</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> in_progress</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # Update status</span></span>
|
|
11
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> close</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">task-i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # Mark complete</span></span>
|
|
12
|
+
<span class="line"></span>
|
|
13
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Project overview</span></span>
|
|
14
|
+
<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 style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # Show epic</span></span>
|
|
15
|
+
<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 style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # All project tasks</span></span></code></pre></div><h2 id="troubleshooting" tabindex="-1">Troubleshooting <a class="header-anchor" href="#troubleshooting" aria-label="Permalink to "Troubleshooting""></a></h2><p><strong><code>bd</code> command not found</strong>: Install beads CLI and ensure it's in PATH<br><strong>Beads setup failed</strong>: Ensure git repo, run <code>bd init</code> if needed<br><strong>Phase task IDs missing</strong>: Re-run <code>start_development()</code> to regenerate beads integration</p><p><strong>Switch backends</strong>: Set <code>TASK_BACKEND=markdown</code> to disable beads, or unset it to re-enable auto-detection.</p><h2 id="technical-notes" tabindex="-1">Technical Notes <a class="header-anchor" href="#technical-notes" aria-label="Permalink to "Technical Notes""></a></h2><ul><li><strong>Backwards compatible</strong>: Existing markdown projects unaffected</li><li><strong>Per-project choice</strong>: Each project chooses its backend independently</li><li><strong>Graceful fallback</strong>: Falls back to markdown if beads unavailable</li><li><strong>Plan file modifications</strong>: Phase task IDs stored in comments for reference</li></ul><p><strong>Limitations</strong>: No real-time sync between beads and plan files; manual task creation required.</p><h2 id="resources" tabindex="-1">Resources <a class="header-anchor" href="#resources" aria-label="Permalink to "Resources""></a></h2><ul><li><a href="https://github.com/steveyegge/beads" target="_blank" rel="noreferrer">Beads 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></ul>`,29)])])}const g=a(n,[["render",l]]);export{c as __pageData,g as default};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{_ as a,c as i,o as e,a0 as t}from"./chunks/framework.DZS7lpav.js";const c=JSON.parse('{"title":"Beads Integration for Workflows Server","description":"","frontmatter":{},"headers":[],"relativePath":"user/beads-integration.md","filePath":"user/beads-integration.md"}'),n={name:"user/beads-integration.md"};function l(r,s,o,h,p,d){return e(),i("div",null,[...s[0]||(s[0]=[t("",29)])])}const g=a(n,[["render",l]]);export{c as __pageData,g as default};
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
import{_ as a,c as n,o as i,a0 as e}from"./chunks/framework.DZS7lpav.js";const k=JSON.parse('{"title":"Crowd Workflows - Multi-Agent Collaboration Guide","description":"","frontmatter":{},"headers":[],"relativePath":"user/crowd-mcp-integration.md","filePath":"user/crowd-mcp-integration.md"}'),t={name:"user/crowd-mcp-integration.md"};function l(p,s,o,r,h,c){return i(),n("div",null,[...s[0]||(s[0]=[e(`<h1 id="crowd-workflows-multi-agent-collaboration-guide" tabindex="-1">Crowd Workflows - Multi-Agent Collaboration Guide <a class="header-anchor" href="#crowd-workflows-multi-agent-collaboration-guide" aria-label="Permalink to "Crowd Workflows - Multi-Agent Collaboration Guide""></a></h1><h2 id="overview" tabindex="-1">Overview <a class="header-anchor" href="#overview" aria-label="Permalink to "Overview""></a></h2><p>Responsible-Vibe-MCP supports <strong>collaborative workflows</strong> that enable teams of specialized AI agents to work together on software development tasks. Each agent has a specific role (business-analyst, architect, developer) and follows the same workflow with role-appropriate instructions.</p><h2 id="quick-setup" tabindex="-1">Quick Setup <a class="header-anchor" href="#quick-setup" aria-label="Permalink to "Quick Setup""></a></h2><h3 id="_1-copy-agent-configurations" tabindex="-1">1. Copy Agent Configurations <a class="header-anchor" href="#_1-copy-agent-configurations" aria-label="Permalink to "1. Copy Agent Configurations""></a></h3><p>Use the CLI to copy pre-configured agent definitions to your project:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @codemcp/workflows@latest</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> agents</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> copy</span></span></code></pre></div><p>This creates three agent configurations in <code>.crowd/agents/</code>:</p><ul><li><code>business-analyst.yaml</code> - Requirements and specification expert</li><li><code>architect.yaml</code> - System design and planning expert</li><li><code>developer.yaml</code> - Implementation expert</li></ul><p>Each agent is pre-configured with:</p><ul><li><code>VIBE_ROLE</code> environment variable (business-analyst, architect, or developer)</li><li><code>VIBE_WORKFLOW_DOMAINS=sdd-crowd</code> to access collaborative workflows</li><li>System prompts explaining team collaboration</li><li>MCP server connection to workflows server</li></ul><h3 id="_2-give-this-prompt-to-your-orchestrator" tabindex="-1">2. Give This Prompt to Your Orchestrator <a class="header-anchor" href="#_2-give-this-prompt-to-your-orchestrator" aria-label="Permalink to "2. Give This Prompt to Your Orchestrator""></a></h3><p>Copy this prompt and give it to your orchestrating agent (the one with access to crowd-mcp tools):</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>You are orchestrating a team of AI agents using crowd-mcp and the workflows server.</span></span>
|
|
2
|
+
<span class="line"><span></span></span>
|
|
3
|
+
<span class="line"><span>## Agent Discovery</span></span>
|
|
4
|
+
<span class="line"><span></span></span>
|
|
5
|
+
<span class="line"><span>The project has three pre-configured agents:</span></span>
|
|
6
|
+
<span class="line"><span>- business-analyst</span></span>
|
|
7
|
+
<span class="line"><span>- architect</span></span>
|
|
8
|
+
<span class="line"><span>- developer</span></span>
|
|
9
|
+
<span class="line"><span></span></span>
|
|
10
|
+
<span class="line"><span>## Your Orchestration Process</span></span>
|
|
11
|
+
<span class="line"><span></span></span>
|
|
12
|
+
<span class="line"><span>When I ask you to start a collaborative development task:</span></span>
|
|
13
|
+
<span class="line"><span></span></span>
|
|
14
|
+
<span class="line"><span>1. **Spawn the team** using spawn_agent() with the agent type matching the filename</span></span>
|
|
15
|
+
<span class="line"><span> - spawn_agent(task="[task] - analysis", agentType="business-analyst")</span></span>
|
|
16
|
+
<span class="line"><span> - spawn_agent(task="[task] - architecture", agentType="architect")</span></span>
|
|
17
|
+
<span class="line"><span> - spawn_agent(task="[task] - implementation", agentType="developer")</span></span>
|
|
18
|
+
<span class="line"><span></span></span>
|
|
19
|
+
<span class="line"><span>2. **Choose workflow** based on task type:</span></span>
|
|
20
|
+
<span class="line"><span> - Feature development → sdd-feature-crowd (starts with business-analyst)</span></span>
|
|
21
|
+
<span class="line"><span> - Bug fixing → sdd-bugfix-crowd (starts with developer)</span></span>
|
|
22
|
+
<span class="line"><span> - New project → sdd-greenfield-crowd (starts with architect)</span></span>
|
|
23
|
+
<span class="line"><span></span></span>
|
|
24
|
+
<span class="line"><span>3. **Kick off** by sending message to the starting agent:</span></span>
|
|
25
|
+
<span class="line"><span> - send_message(to: [agent-id], content: "Start [workflow-name] for [task description]")</span></span>
|
|
26
|
+
<span class="line"><span></span></span>
|
|
27
|
+
<span class="line"><span>4. **Monitor** using get_messages() to see progress updates from agents.</span></span>
|
|
28
|
+
<span class="line"><span>IMPORTANT: The agents will work for long intervals. You may check as often as you like, but don't bother them with repeated questions or status updates</span></span>
|
|
29
|
+
<span class="line"><span></span></span>
|
|
30
|
+
<span class="line"><span>5. **Relay** when agents send_message_to_operator() with questions you cannot answer as they need more information on the context of the development.</span></span>
|
|
31
|
+
<span class="line"><span></span></span>
|
|
32
|
+
<span class="line"><span>## Rules</span></span>
|
|
33
|
+
<span class="line"><span></span></span>
|
|
34
|
+
<span class="line"><span>- Spawn all three agents at start (they work as a persistent team)</span></span>
|
|
35
|
+
<span class="line"><span>- Agents will message each other directly - you monitor and intervene when needed</span></span>
|
|
36
|
+
<span class="line"><span>- When agents ask you questions, ask me and relay my answer</span></span>
|
|
37
|
+
<span class="line"><span></span></span>
|
|
38
|
+
<span class="line"><span>## Example</span></span>
|
|
39
|
+
<span class="line"><span></span></span>
|
|
40
|
+
<span class="line"><span>When I say: "Build user authentication"</span></span>
|
|
41
|
+
<span class="line"><span></span></span>
|
|
42
|
+
<span class="line"><span>You should:</span></span>
|
|
43
|
+
<span class="line"><span>1. spawn_agent(task="Build user authentication - analysis", agentType="business-analyst")</span></span>
|
|
44
|
+
<span class="line"><span>2. spawn_agent(task="Build user authentication - architecture", agentType="architect")</span></span>
|
|
45
|
+
<span class="line"><span>3. spawn_agent(task="Build user authentication - implementation", agentType="developer")</span></span>
|
|
46
|
+
<span class="line"><span>4. send_message(to: business-analyst, content: "Start sdd-feature-crowd for user authentication system")</span></span>
|
|
47
|
+
<span class="line"><span>5. Monitor messages and keep me updated</span></span></code></pre></div><h3 id="_3-start-collaborating" tabindex="-1">3. Start Collaborating <a class="header-anchor" href="#_3-start-collaborating" aria-label="Permalink to "3. Start Collaborating""></a></h3><p>Tell your orchestrator to start a development task:</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>Build a search feature for the product catalog</span></span></code></pre></div><p>The orchestrator will:</p><ul><li>Spawn the three agents</li><li>Start the business-analyst with sdd-feature-crowd workflow</li><li>Monitor progress and report back to you</li></ul><h2 id="available-workflows" tabindex="-1">Available Workflows <a class="header-anchor" href="#available-workflows" aria-label="Permalink to "Available Workflows""></a></h2><p><strong>sdd-crowd Domain</strong> - Collaborative specification-driven development workflows:</p><h4 id="sdd-feature-crowd" tabindex="-1">sdd-feature-crowd <a class="header-anchor" href="#sdd-feature-crowd" aria-label="Permalink to "sdd-feature-crowd""></a></h4><p>Collaborative feature development with full team participation.</p><p><strong>Phases</strong>: analyze → specify → clarify → plan → tasks → implement</p><p><strong>Role Flow</strong>:</p><ul><li><strong>Business-analyst</strong> drives: analyze, specify, clarify</li><li><strong>Architect</strong> drives: plan, tasks</li><li><strong>Developer</strong> drives: implement</li></ul><p><strong>Use when</strong>: Building new features or enhancing existing ones with a team</p><h4 id="sdd-bugfix-crowd" tabindex="-1">sdd-bugfix-crowd <a class="header-anchor" href="#sdd-bugfix-crowd" aria-label="Permalink to "sdd-bugfix-crowd""></a></h4><p>Collaborative bug fixing with systematic approach.</p><p><strong>Phases</strong>: reproduce → specify → test → plan → fix → verify</p><p><strong>Role Flow</strong>:</p><ul><li><strong>Developer</strong> drives: reproduce, test, fix, verify</li><li><strong>Business-analyst</strong> drives: specify</li><li><strong>Architect</strong> drives: plan</li></ul><p><strong>Use when</strong>: Fixing complex bugs that benefit from team expertise</p><h4 id="sdd-greenfield-crowd" tabindex="-1">sdd-greenfield-crowd <a class="header-anchor" href="#sdd-greenfield-crowd" aria-label="Permalink to "sdd-greenfield-crowd""></a></h4><p>Collaborative new project development from scratch.</p><p><strong>Phases</strong>: constitution → specify → plan → tasks → implement → document</p><p><strong>Role Flow</strong>:</p><ul><li><strong>Architect</strong> drives: constitution, plan, tasks</li><li><strong>Business-analyst</strong> drives: specify</li><li><strong>Developer</strong> drives: implement</li><li><strong>All contribute</strong> to: document</li></ul><p><strong>Use when</strong>: Starting new projects with comprehensive team planning</p><h2 id="how-collaboration-works" tabindex="-1">How Collaboration Works <a class="header-anchor" href="#how-collaboration-works" aria-label="Permalink to "How Collaboration Works""></a></h2><h3 id="the-rci-model" tabindex="-1">The RCI Model <a class="header-anchor" href="#the-rci-model" aria-label="Permalink to "The RCI Model""></a></h3><p>Each phase assigns agents one of three roles:</p><ul><li><strong>Responsible (R)</strong>: Primary driver <ul><li>Edits the plan file</li><li>Calls <code>proceed_to_phase()</code> to advance</li><li>Drives the work forward</li></ul></li><li><strong>Consulted (C)</strong>: Available for questions <ul><li>Monitors messages</li><li>Provides expert input when asked</li><li>Cannot edit plan or proceed</li></ul></li><li><strong>Informed (I)</strong>: Passive monitoring <ul><li>Stays aware of progress</li><li>No active participation required</li></ul></li></ul><p><strong>Note</strong>: The human operator is always implicitly informed.</p><h3 id="role-assignment-examples" tabindex="-1">Role Assignment Examples <a class="header-anchor" href="#role-assignment-examples" aria-label="Permalink to "Role Assignment Examples""></a></h3><p><strong>sdd-feature-crowd specify phase</strong>:</p><ul><li>Business-analyst: <strong>RESPONSIBLE</strong> (drives specification)</li><li>Architect: <strong>CONSULTED</strong> (answers technical feasibility questions)</li><li>Developer: <strong>CONSULTED</strong> (provides complexity estimates)</li></ul><p><strong>sdd-feature-crowd implement phase</strong>:</p><ul><li>Developer: <strong>RESPONSIBLE</strong> (drives implementation)</li><li>Architect: <strong>CONSULTED</strong> (answers design questions)</li><li>Business-analyst: <strong>CONSULTED</strong> (clarifies requirements)</li></ul><h3 id="collaboration-protocol" tabindex="-1">Collaboration Protocol <a class="header-anchor" href="#collaboration-protocol" aria-label="Permalink to "Collaboration Protocol""></a></h3><p><strong>1. Handoff Pattern</strong>:</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>Business-analyst (RESPONSIBLE in specify phase):</span></span>
|
|
48
|
+
<span class="line"><span> 1. Completes specification work</span></span>
|
|
49
|
+
<span class="line"><span> 2. Sends: send_message(architect-id, "Please take lead for plan phase")</span></span>
|
|
50
|
+
<span class="line"><span> 3. Reports: send_message_to_operator("Spec complete, handing to architect")</span></span>
|
|
51
|
+
<span class="line"><span> 4. Calls: proceed_to_phase(target_phase: "plan")</span></span>
|
|
52
|
+
<span class="line"><span> 5. Becomes: CONSULTED in plan phase</span></span>
|
|
53
|
+
<span class="line"><span></span></span>
|
|
54
|
+
<span class="line"><span>Architect (CONSULTED → RESPONSIBLE):</span></span>
|
|
55
|
+
<span class="line"><span> 1. Receives handoff message</span></span>
|
|
56
|
+
<span class="line"><span> 2. Becomes RESPONSIBLE in plan phase</span></span>
|
|
57
|
+
<span class="line"><span> 3. Drives planning work</span></span></code></pre></div><p><strong>2. Consultation Pattern</strong>:</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>Architect (RESPONSIBLE in plan phase):</span></span>
|
|
58
|
+
<span class="line"><span> 1. Has question about requirements</span></span>
|
|
59
|
+
<span class="line"><span> 2. Sends: send_message(business-analyst-id, "What does requirement X mean?")</span></span>
|
|
60
|
+
<span class="line"><span></span></span>
|
|
61
|
+
<span class="line"><span>Business-analyst (CONSULTED in plan phase):</span></span>
|
|
62
|
+
<span class="line"><span> 1. Receives: get_my_messages()</span></span>
|
|
63
|
+
<span class="line"><span> 2. Responds: send_message(architect-id, "Requirement X means...")</span></span>
|
|
64
|
+
<span class="line"><span></span></span>
|
|
65
|
+
<span class="line"><span>Architect:</span></span>
|
|
66
|
+
<span class="line"><span> 3. Continues planning with clarified information</span></span></code></pre></div><h2 id="agent-configuration" tabindex="-1">Agent Configuration <a class="header-anchor" href="#agent-configuration" aria-label="Permalink to "Agent Configuration""></a></h2><h3 id="system-prompts" tabindex="-1">System Prompts <a class="header-anchor" href="#system-prompts" aria-label="Permalink to "System Prompts""></a></h3><p>All agent system prompts follow the same pattern:</p><ul><li>Explain team structure and roles</li><li>Describe available tools (whats_next, send_message, etc.)</li><li>Emphasize important rules (only responsible edits plan, always call whats_next)</li><li>Keep role responsibilities generic (workflow provides specific tasks)</li></ul><h3 id="example-configuration" tabindex="-1">Example Configuration <a class="header-anchor" href="#example-configuration" aria-label="Permalink to "Example Configuration""></a></h3><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">business-analyst</span></span>
|
|
67
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">displayName</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">Business Analyst</span></span>
|
|
68
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">systemPrompt</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span></span>
|
|
69
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> You are working as a business-analyst in a collaborative team.</span></span>
|
|
70
|
+
<span class="line"></span>
|
|
71
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Your team: business-analyst (you), architect, developer</span></span>
|
|
72
|
+
<span class="line"></span>
|
|
73
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ## How Collaboration Works</span></span>
|
|
74
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> You follow structured workflows. In each phase, you may be:</span></span>
|
|
75
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - RESPONSIBLE (driving), CONSULTED (answering questions), or INFORMED (monitoring)</span></span>
|
|
76
|
+
<span class="line"></span>
|
|
77
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ## Available Tools</span></span>
|
|
78
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - whats_next(): Get phase guidance (call after every message)</span></span>
|
|
79
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - proceed_to_phase(): Move forward (only when responsible)</span></span>
|
|
80
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - send_message(to, content): Collaborate with team</span></span>
|
|
81
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - send_message_to_operator(content): Report to human</span></span>
|
|
82
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - get_my_messages(): Check for questions</span></span>
|
|
83
|
+
<span class="line"></span>
|
|
84
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">mcpServers</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
85
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> responsible-vibe</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
86
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> type</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">stdio</span></span>
|
|
87
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> command</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">npx</span></span>
|
|
88
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> args</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [@</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">codemcp/workflows-server@latest</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]</span></span>
|
|
89
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> env</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
90
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> VIBE_ROLE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">business-analyst</span></span>
|
|
91
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> VIBE_WORKFLOW_DOMAINS</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">sdd-crowd</span></span></code></pre></div><h2 id="workflow-features" tabindex="-1">Workflow Features <a class="header-anchor" href="#workflow-features" aria-label="Permalink to "Workflow Features""></a></h2><h3 id="vibe-role-variable" tabindex="-1">$VIBE_ROLE Variable <a class="header-anchor" href="#vibe-role-variable" aria-label="Permalink to "$VIBE_ROLE Variable""></a></h3><p>Workflows use <code>$VIBE_ROLE</code> for dynamic agent identification:</p><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">default_instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span></span>
|
|
92
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> You are $VIBE_ROLE working in a collaborative team.</span></span>
|
|
93
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Current phase: SPECIFY</span></span></code></pre></div><p>Substituted at runtime:</p><ul><li>Business-analyst sees: "You are business-analyst working..."</li><li>Architect sees: "You are architect working..."</li></ul><h3 id="role-specific-instructions" tabindex="-1">Role-Specific Instructions <a class="header-anchor" href="#role-specific-instructions" aria-label="Permalink to "Role-Specific Instructions""></a></h3><p>Each transition provides role-appropriate guidance:</p><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">transitions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
94
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">trigger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">spec_complete</span></span>
|
|
95
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> to</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">plan</span></span>
|
|
96
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> role</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">business-analyst</span></span>
|
|
97
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> additional_instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span></span>
|
|
98
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> You are RESPONSIBLE. Create spec, then hand off.</span></span>
|
|
99
|
+
<span class="line"></span>
|
|
100
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">trigger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">spec_complete</span></span>
|
|
101
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> to</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">plan</span></span>
|
|
102
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> role</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">architect</span></span>
|
|
103
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> additional_instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span></span>
|
|
104
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> You are CONSULTED. Answer questions when asked.</span></span></code></pre></div><h3 id="transition-filtering" tabindex="-1">Transition Filtering <a class="header-anchor" href="#transition-filtering" aria-label="Permalink to "Transition Filtering""></a></h3><p>Each agent only sees transitions for their role:</p><ul><li>Business-analyst sees only <code>role: business-analyst</code> transitions</li><li>Architect sees only <code>role: architect</code> transitions</li><li>Developer sees only <code>role: developer</code> transitions</li><li>Transitions with no <code>role</code> shown to everyone</li></ul><h3 id="validation" tabindex="-1">Validation <a class="header-anchor" href="#validation" aria-label="Permalink to "Validation""></a></h3><p><strong>Tool Validation</strong> (<code>proceed_to_phase</code>):</p><ul><li>Verifies agent has valid transition to target phase</li><li>Prevents agents from proceeding when not responsible</li><li>Clear error messages when validation fails</li></ul><p><strong>Plan File Editing</strong>:</p><ul><li>Enforced via instructions (cannot validate at tool level)</li><li>RESPONSIBLE: "Only you can edit the plan file"</li><li>CONSULTED: "Do NOT edit the plan file"</li></ul><h2 id="usage-examples" tabindex="-1">Usage Examples <a class="header-anchor" href="#usage-examples" aria-label="Permalink to "Usage Examples""></a></h2><h3 id="starting-a-feature-with-team" tabindex="-1">Starting a Feature with Team <a class="header-anchor" href="#starting-a-feature-with-team" aria-label="Permalink to "Starting a Feature with Team""></a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Human operator (via Claude Desktop + crowd-mcp):</span></span>
|
|
105
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">"Spawn business-analyst, architect, and developer agents to build user authentication"</span></span>
|
|
106
|
+
<span class="line"></span>
|
|
107
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Agents spawn and start sdd-feature-crowd workflow</span></span>
|
|
108
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Each agent calls whats_next() and gets role-specific instructions</span></span>
|
|
109
|
+
<span class="line"></span>
|
|
110
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Business-analyst (RESPONSIBLE in analyze):</span></span>
|
|
111
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Analyzes</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> requirements</span></span>
|
|
112
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Messages</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> architect:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> "What authentication patterns do we use?"</span></span>
|
|
113
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Messages</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> developer:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> "How complex is OAuth integration?"</span></span>
|
|
114
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Completes</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> analysis</span></span>
|
|
115
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Hands</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> off</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> to</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> specify</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> phase</span></span>
|
|
116
|
+
<span class="line"></span>
|
|
117
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Business-analyst (RESPONSIBLE in specify):</span></span>
|
|
118
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Creates</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> specification</span></span>
|
|
119
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Messages</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> team</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> for</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> review</span></span>
|
|
120
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Hands</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> off</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> to</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> architect</span></span>
|
|
121
|
+
<span class="line"></span>
|
|
122
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Architect (RESPONSIBLE in plan):</span></span>
|
|
123
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Creates</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> technical</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plan</span></span>
|
|
124
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Messages</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> developer</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> for</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> feedback</span></span>
|
|
125
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Creates</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> task</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> breakdown</span></span>
|
|
126
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Hands</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> off</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> to</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> developer</span></span>
|
|
127
|
+
<span class="line"></span>
|
|
128
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Developer (RESPONSIBLE in implement):</span></span>
|
|
129
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Implements</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> features</span></span>
|
|
130
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Messages</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> architect</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> with</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> design</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> questions</span></span>
|
|
131
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Messages</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> business-analyst</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> for</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> requirement</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clarifications</span></span>
|
|
132
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">-</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Completes</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> implementation</span></span></code></pre></div><h3 id="agent-perspectives" tabindex="-1">Agent Perspectives <a class="header-anchor" href="#agent-perspectives" aria-label="Permalink to "Agent Perspectives""></a></h3><p><strong>What business-analyst sees in specify phase</strong>:</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>You are RESPONSIBLE for the specify phase.</span></span>
|
|
133
|
+
<span class="line"><span></span></span>
|
|
134
|
+
<span class="line"><span>You have exclusive control:</span></span>
|
|
135
|
+
<span class="line"><span>- Only you can edit the plan file</span></span>
|
|
136
|
+
<span class="line"><span>- Only you can proceed to next phase</span></span>
|
|
137
|
+
<span class="line"><span></span></span>
|
|
138
|
+
<span class="line"><span>Tasks:</span></span>
|
|
139
|
+
<span class="line"><span>- Create specification...</span></span>
|
|
140
|
+
<span class="line"><span>- Use send_message to ask architect about technical feasibility</span></span>
|
|
141
|
+
<span class="line"><span>- Use send_message to ask developer about implementation complexity</span></span>
|
|
142
|
+
<span class="line"><span></span></span>
|
|
143
|
+
<span class="line"><span>Before proceeding:</span></span>
|
|
144
|
+
<span class="line"><span>- Send handoff message to architect</span></span>
|
|
145
|
+
<span class="line"><span>- Report to operator</span></span>
|
|
146
|
+
<span class="line"><span>- Call proceed_to_phase</span></span></code></pre></div><p><strong>What architect sees in specify phase</strong>:</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>You are CONSULTED during the specify phase.</span></span>
|
|
147
|
+
<span class="line"><span></span></span>
|
|
148
|
+
<span class="line"><span>Business-analyst is driving this work.</span></span>
|
|
149
|
+
<span class="line"><span></span></span>
|
|
150
|
+
<span class="line"><span>Your responsibilities:</span></span>
|
|
151
|
+
<span class="line"><span>- Monitor messages for questions</span></span>
|
|
152
|
+
<span class="line"><span>- Provide technical feasibility input</span></span>
|
|
153
|
+
<span class="line"><span>- Review specification when asked</span></span>
|
|
154
|
+
<span class="line"><span></span></span>
|
|
155
|
+
<span class="line"><span>Constraints:</span></span>
|
|
156
|
+
<span class="line"><span>- Do NOT edit plan file</span></span>
|
|
157
|
+
<span class="line"><span>- Do NOT proceed to next phase</span></span></code></pre></div><h2 id="best-practices" tabindex="-1">Best Practices <a class="header-anchor" href="#best-practices" aria-label="Permalink to "Best Practices""></a></h2><h3 id="_1-always-call-whats-next" tabindex="-1">1. Always Call whats_next() <a class="header-anchor" href="#_1-always-call-whats-next" aria-label="Permalink to "1. Always Call whats_next()""></a></h3><p>Every agent should call <code>whats_next()</code> after each user message to get current phase guidance.</p><h3 id="_2-use-messaging-proactively" tabindex="-1">2. Use Messaging Proactively <a class="header-anchor" href="#_2-use-messaging-proactively" aria-label="Permalink to "2. Use Messaging Proactively""></a></h3><p>Agents should actively collaborate:</p><ul><li>Ask questions when uncertain</li><li>Request reviews before proceeding</li><li>Share information proactively</li><li>Keep operator informed of progress</li></ul><h3 id="_3-respect-role-boundaries" tabindex="-1">3. Respect Role Boundaries <a class="header-anchor" href="#_3-respect-role-boundaries" aria-label="Permalink to "3. Respect Role Boundaries""></a></h3><ul><li>Only RESPONSIBLE agent edits plan file</li><li>Only RESPONSIBLE agent calls proceed_to_phase</li><li>CONSULTED agents wait for questions</li><li>Clear communication about role transitions</li></ul><h3 id="_4-explicit-handoffs" tabindex="-1">4. Explicit Handoffs <a class="header-anchor" href="#_4-explicit-handoffs" aria-label="Permalink to "4. Explicit Handoffs""></a></h3><p>When transitioning phases:</p><ol><li>Complete your work</li><li>Send handoff message to next responsible agent</li><li>Notify other team members</li><li>Report to operator</li><li>Call proceed_to_phase</li></ol><h2 id="troubleshooting" tabindex="-1">Troubleshooting <a class="header-anchor" href="#troubleshooting" aria-label="Permalink to "Troubleshooting""></a></h2><h3 id="agent-with-role-x-cannot-proceed" tabindex="-1">"Agent with role 'X' cannot proceed" <a class="header-anchor" href="#agent-with-role-x-cannot-proceed" aria-label="Permalink to ""Agent with role 'X' cannot proceed"""></a></h3><p><strong>Cause</strong>: Agent trying to proceed when not responsible for target phase</p><p><strong>Solution</strong>: Only the responsible agent can call <code>proceed_to_phase</code>. Check workflow to see who should be driving the target phase.</p><h3 id="agent-not-seeing-transitions" tabindex="-1">Agent Not Seeing Transitions <a class="header-anchor" href="#agent-not-seeing-transitions" aria-label="Permalink to "Agent Not Seeing Transitions""></a></h3><p><strong>Cause</strong>: <code>VIBE_ROLE</code> not set or doesn't match workflow roles</p><p><strong>Solution</strong>: Verify agent configuration has <code>VIBE_ROLE</code> environment variable set correctly.</p><h3 id="multiple-agents-editing-plan-file" tabindex="-1">Multiple Agents Editing Plan File <a class="header-anchor" href="#multiple-agents-editing-plan-file" aria-label="Permalink to "Multiple Agents Editing Plan File""></a></h3><p><strong>Cause</strong>: Agents not following role instructions</p><p><strong>Solution</strong>: Ensure agents read and follow their role-specific instructions. Only RESPONSIBLE agent should edit plan file.</p><h2 id="technical-details" tabindex="-1">Technical Details <a class="header-anchor" href="#technical-details" aria-label="Permalink to "Technical Details""></a></h2><h3 id="environment-variables" tabindex="-1">Environment Variables <a class="header-anchor" href="#environment-variables" aria-label="Permalink to "Environment Variables""></a></h3><ul><li><strong>VIBE_ROLE</strong>: Agent's role (business-analyst, architect, developer) <ul><li>Required for collaborative workflows</li><li>Optional for single-agent workflows</li></ul></li><li><strong>VIBE_WORKFLOW_DOMAINS</strong>: Filter workflows by domain <ul><li>Set to <code>sdd-crowd</code> for collaborative workflows</li><li>Can combine: <code>sdd-crowd,sdd</code> for both</li></ul></li></ul><h3 id="workflow-schema" tabindex="-1">Workflow Schema <a class="header-anchor" href="#workflow-schema" aria-label="Permalink to "Workflow Schema""></a></h3><p>Collaborative workflows extend the standard workflow schema:</p><ul><li><code>role?: string</code> on transitions</li><li><code>collaboration?: boolean</code> in metadata</li><li><code>requiredRoles?: string[]</code> in metadata</li></ul><p>All fields optional - backward compatible with existing workflows.</p><h2 id="resources" tabindex="-1">Resources <a class="header-anchor" href="#resources" aria-label="Permalink to "Resources""></a></h2><ul><li><p><strong>Agent Templates</strong>: <code>.crowd/agents/</code></p><ul><li>business-analyst.yaml</li><li>architect.yaml</li><li>developer.yaml</li></ul></li><li><p><strong>Workflows</strong>: <code>resources/workflows/sdd-crowd/</code></p><ul><li>sdd-feature-crowd.yaml</li><li>sdd-bugfix-crowd.yaml</li><li>sdd-greenfield-crowd.yaml</li></ul></li><li><p><strong>Tests</strong>: <code>test/integration/crowd-workflows.test.ts</code></p><ul><li>11 tests covering all collaboration features</li></ul></li><li><p><strong>Integration</strong>: Designed for <a href="https://github.com/mrsimpson/crowd-mcp" target="_blank" rel="noreferrer">crowd-mcp</a></p></li></ul>`,115)])])}const g=a(t,[["render",l]]);export{k as __pageData,g as default};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{_ as a,c as n,o as i,a0 as e}from"./chunks/framework.DZS7lpav.js";const k=JSON.parse('{"title":"Crowd Workflows - Multi-Agent Collaboration Guide","description":"","frontmatter":{},"headers":[],"relativePath":"user/crowd-mcp-integration.md","filePath":"user/crowd-mcp-integration.md"}'),t={name:"user/crowd-mcp-integration.md"};function l(p,s,o,r,h,c){return i(),n("div",null,[...s[0]||(s[0]=[e("",115)])])}const g=a(t,[["render",l]]);export{k as __pageData,g as default};
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
import{_ as i,c as a,o as n,a0 as l}from"./chunks/framework.DZS7lpav.js";const E=JSON.parse('{"title":"Custom Workflows","description":"","frontmatter":{},"headers":[],"relativePath":"user/custom-workflows.md","filePath":"user/custom-workflows.md"}'),t={name:"user/custom-workflows.md"};function e(p,s,h,k,r,o){return n(),a("div",null,[...s[0]||(s[0]=[l(`<h1 id="custom-workflows" tabindex="-1">Custom Workflows <a class="header-anchor" href="#custom-workflows" aria-label="Permalink to "Custom Workflows""></a></h1><p>Responsible Vibe supports custom workflow definitions that you can create, install, and share. The system uses a directory-based approach with domain filtering for better organization.</p><h2 id="how-custom-workflows-work" tabindex="-1">How Custom Workflows Work <a class="header-anchor" href="#how-custom-workflows-work" aria-label="Permalink to "How Custom Workflows Work""></a></h2><h3 id="the-vibe-workflows-directory" tabindex="-1">The <code>.vibe/workflows/</code> Directory <a class="header-anchor" href="#the-vibe-workflows-directory" aria-label="Permalink to "The \`.vibe/workflows/\` Directory""></a></h3><p>Custom workflows are stored in your project's <code>.vibe/workflows/</code> directory:</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>.vibe/</span></span>
|
|
2
|
+
<span class="line"><span>├── workflows/</span></span>
|
|
3
|
+
<span class="line"><span>│ ├── my-custom-workflow.yaml</span></span>
|
|
4
|
+
<span class="line"><span>│ ├── team-review-process.yaml</span></span>
|
|
5
|
+
<span class="line"><span>│ └── client-specific-flow.yaml</span></span>
|
|
6
|
+
<span class="line"><span>└── development-plan-main.md</span></span></code></pre></div><h3 id="workflow-domains" tabindex="-1">Workflow Domains <a class="header-anchor" href="#workflow-domains" aria-label="Permalink to "Workflow Domains""></a></h3><p>Workflows are organized by domains to keep things manageable:</p><ul><li><strong><code>code</code></strong>: Software development workflows (default)</li><li><strong><code>architecture</code></strong>: System design and architecture workflows</li><li><strong><code>office</code></strong>: Business process and documentation workflows</li></ul><p><strong>Control which domains are loaded:</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;"> VIBE_WORKFLOW_DOMAINS</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"code,architecture"</span></span>
|
|
7
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Only loads workflows from code and architecture domains</span></span></code></pre></div><h2 id="creating-custom-workflows" tabindex="-1">Creating Custom Workflows <a class="header-anchor" href="#creating-custom-workflows" aria-label="Permalink to "Creating Custom Workflows""></a></h2><h3 id="_1-basic-workflow-structure" tabindex="-1">1. Basic Workflow Structure <a class="header-anchor" href="#_1-basic-workflow-structure" aria-label="Permalink to "1. Basic Workflow Structure""></a></h3><p>Create a YAML file in <code>.vibe/workflows/</code>:</p><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'my-custom-workflow'</span></span>
|
|
8
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">description</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Custom workflow for my specific needs'</span></span>
|
|
9
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">initial_state</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'start'</span></span>
|
|
10
|
+
<span class="line"></span>
|
|
11
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">metadata</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
12
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> domain</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'code'</span></span>
|
|
13
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> complexity</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'medium'</span></span>
|
|
14
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> bestFor</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Custom processes'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Team workflows'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]</span></span>
|
|
15
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> useCases</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Specific project needs'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]</span></span>
|
|
16
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> examples</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Custom review process'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]</span></span>
|
|
17
|
+
<span class="line"></span>
|
|
18
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">states</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
19
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> start</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
20
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> description</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Initial phase'</span></span>
|
|
21
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span></span>
|
|
22
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Start your custom process here.</span></span>
|
|
23
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Define what the AI should focus on in this phase.</span></span>
|
|
24
|
+
<span class="line"></span>
|
|
25
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> transitions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
26
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">trigger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'ready_for_next'</span></span>
|
|
27
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> to</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'next_phase'</span></span>
|
|
28
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> transition_reason</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Ready to move forward'</span></span>
|
|
29
|
+
<span class="line"></span>
|
|
30
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> next_phase</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
31
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> description</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Next phase'</span></span>
|
|
32
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span></span>
|
|
33
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Continue with the next step of your process.</span></span>
|
|
34
|
+
<span class="line"></span>
|
|
35
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> transitions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
36
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">trigger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'workflow_complete'</span></span>
|
|
37
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> to</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'start'</span></span>
|
|
38
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> transition_reason</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Workflow complete, ready for new task'</span></span></code></pre></div><h3 id="_2-advanced-features" tabindex="-1">2. Advanced Features <a class="header-anchor" href="#_2-advanced-features" aria-label="Permalink to "2. Advanced Features""></a></h3><p><strong>Phase-specific instructions:</strong></p><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">states</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
39
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> design</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
40
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span></span>
|
|
41
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> You are in the design phase. Focus on:</span></span>
|
|
42
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - System architecture decisions</span></span>
|
|
43
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Component interfaces</span></span>
|
|
44
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Data flow design</span></span>
|
|
45
|
+
<span class="line"></span>
|
|
46
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Reference existing architecture: $ARCHITECTURE_DOC</span></span>
|
|
47
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Document your design in: $DESIGN_DOC</span></span></code></pre></div><p><strong>Conditional transitions:</strong></p><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">transitions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
48
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">trigger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'design_approved'</span></span>
|
|
49
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> to</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'implementation'</span></span>
|
|
50
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> additional_instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Call setup_project_docs to create implementation templates before starting'</span></span>
|
|
51
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">trigger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'need_more_design'</span></span>
|
|
52
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> to</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'requirements'</span></span>
|
|
53
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> additional_instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Review and update requirements.md based on design feedback'</span></span></code></pre></div><h2 id="installing-workflows" tabindex="-1">Installing Workflows <a class="header-anchor" href="#installing-workflows" aria-label="Permalink to "Installing Workflows""></a></h2><h3 id="using-cli" tabindex="-1">Using CLI <a class="header-anchor" href="#using-cli" aria-label="Permalink to "Using CLI""></a></h3><p>The CLI provides convenient commands to list and copy workflows:</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;"># List all available workflows</span></span>
|
|
54
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @codemcp/workflows</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> workflow</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span></span>
|
|
55
|
+
<span class="line"></span>
|
|
56
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Copy a built-in workflow to customize it</span></span>
|
|
57
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @codemcp/workflows</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> workflow</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> copy</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> waterfall</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> my-custom-waterfall</span></span>
|
|
58
|
+
<span class="line"></span>
|
|
59
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Copy any available workflow</span></span>
|
|
60
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @codemcp/workflows</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> workflow</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> copy</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> epcc</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> my-team-process</span></span></code></pre></div><p>This copies the workflow to <code>.vibe/workflows/my-custom-waterfall.yaml</code> where you can customize it for your needs.</p><p>The copied workflow will have:</p><ul><li>Updated <code>name</code> field to match your custom name</li><li>All original states and transitions</li><li>Metadata you can modify (description, complexity, etc.)</li></ul><h3 id="from-urls-or-files" tabindex="-1">From URLs or Files <a class="header-anchor" href="#from-urls-or-files" aria-label="Permalink to "From URLs or Files""></a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Install from URL</span></span>
|
|
61
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">"Install workflow from https://example.com/my-workflow.yaml"</span></span>
|
|
62
|
+
<span class="line"></span>
|
|
63
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Install with custom name</span></span>
|
|
64
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">"Install the waterfall workflow as 'detailed-waterfall'"</span></span></code></pre></div><h2 id="workflow-discovery" tabindex="-1">Workflow Discovery <a class="header-anchor" href="#workflow-discovery" aria-label="Permalink to "Workflow Discovery""></a></h2><h3 id="list-available-workflows" tabindex="-1">List Available Workflows <a class="header-anchor" href="#list-available-workflows" aria-label="Permalink to "List Available Workflows""></a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># See all workflows available to your project</span></span>
|
|
65
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">"List available workflows"</span></span>
|
|
66
|
+
<span class="line"></span>
|
|
67
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># See all workflows regardless of domain filtering</span></span>
|
|
68
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">"List all workflows including unloaded ones"</span></span></code></pre></div><h3 id="domain-filtering-in-action" tabindex="-1">Domain Filtering in Action <a class="header-anchor" href="#domain-filtering-in-action" aria-label="Permalink to "Domain Filtering in Action""></a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Default: only 'code' domain workflows</span></span>
|
|
69
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">VIBE_WORKFLOW_DOMAINS</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"code"</span></span>
|
|
70
|
+
<span class="line"></span>
|
|
71
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Multiple domains</span></span>
|
|
72
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">VIBE_WORKFLOW_DOMAINS</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"code,architecture,office"</span></span>
|
|
73
|
+
<span class="line"></span>
|
|
74
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># All domains</span></span>
|
|
75
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">VIBE_WORKFLOW_DOMAINS</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"code,architecture,office"</span></span></code></pre></div><h2 id="project-specific-configuration" tabindex="-1">Project-Specific Configuration <a class="header-anchor" href="#project-specific-configuration" aria-label="Permalink to "Project-Specific Configuration""></a></h2><h3 id="vibe-config-yaml" tabindex="-1"><code>.vibe/config.yaml</code> <a class="header-anchor" href="#vibe-config-yaml" aria-label="Permalink to "\`.vibe/config.yaml\`""></a></h3><p>Control which workflows are available for your project:</p><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">enabled_workflows</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
76
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'waterfall'</span></span>
|
|
77
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'my-custom-workflow'</span></span>
|
|
78
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'team-review-process'</span></span></code></pre></div><p>This filters the available workflows to only those specified, regardless of domain settings.</p><h2 id="workflow-metadata" tabindex="-1">Workflow Metadata <a class="header-anchor" href="#workflow-metadata" aria-label="Permalink to "Workflow Metadata""></a></h2><h3 id="enhanced-discoverability" tabindex="-1">Enhanced Discoverability <a class="header-anchor" href="#enhanced-discoverability" aria-label="Permalink to "Enhanced Discoverability""></a></h3><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">metadata</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
79
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> domain</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'code'</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # Which domain this belongs to</span></span>
|
|
80
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> complexity</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'high'</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # low, medium, high</span></span>
|
|
81
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> bestFor</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># What this workflow is good for</span></span>
|
|
82
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Large features'</span></span>
|
|
83
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Design-heavy projects'</span></span>
|
|
84
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> useCases</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Specific use cases</span></span>
|
|
85
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Building new systems'</span></span>
|
|
86
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Complex integrations'</span></span>
|
|
87
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> examples</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Example scenarios</span></span>
|
|
88
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Create authentication system'</span></span>
|
|
89
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Build reporting dashboard'</span></span></code></pre></div><p>This metadata helps your AI automatically select the right workflow for different scenarios.</p><h2 id="real-world-example" tabindex="-1">Real-World Example <a class="header-anchor" href="#real-world-example" aria-label="Permalink to "Real-World Example""></a></h2><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'api-development'</span></span>
|
|
90
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">description</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Workflow for developing REST APIs with proper testing'</span></span>
|
|
91
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">initial_state</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'api_design'</span></span>
|
|
92
|
+
<span class="line"></span>
|
|
93
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">metadata</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
94
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> domain</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'code'</span></span>
|
|
95
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> complexity</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'medium'</span></span>
|
|
96
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> bestFor</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'API development'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Backend services'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]</span></span>
|
|
97
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> useCases</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'REST API creation'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Microservice development'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]</span></span>
|
|
98
|
+
<span class="line"></span>
|
|
99
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">states</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
100
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> api_design</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
101
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> description</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Design API endpoints and contracts'</span></span>
|
|
102
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span></span>
|
|
103
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Design your API:</span></span>
|
|
104
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Define endpoints and HTTP methods</span></span>
|
|
105
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Specify request/response schemas</span></span>
|
|
106
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Document authentication requirements</span></span>
|
|
107
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Plan error handling approach</span></span>
|
|
108
|
+
<span class="line"></span>
|
|
109
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Document in $DESIGN_DOC</span></span>
|
|
110
|
+
<span class="line"></span>
|
|
111
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> transitions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
112
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">trigger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'api_design_complete'</span></span>
|
|
113
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> to</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'implementation'</span></span>
|
|
114
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> additional_instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Create API implementation templates and set up testing framework'</span></span>
|
|
115
|
+
<span class="line"></span>
|
|
116
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> implementation</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
117
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> description</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Implement API endpoints'</span></span>
|
|
118
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span></span>
|
|
119
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Implement the API following your design:</span></span>
|
|
120
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Create route handlers</span></span>
|
|
121
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Implement business logic</span></span>
|
|
122
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Add input validation</span></span>
|
|
123
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Include proper error handling</span></span>
|
|
124
|
+
<span class="line"></span>
|
|
125
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> transitions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
126
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">trigger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'implementation_complete'</span></span>
|
|
127
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> to</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'testing'</span></span>
|
|
128
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> additional_instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Set up test environment and create test data fixtures'</span></span>
|
|
129
|
+
<span class="line"></span>
|
|
130
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> testing</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
131
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> description</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Test API endpoints'</span></span>
|
|
132
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">|</span></span>
|
|
133
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Test your API thoroughly:</span></span>
|
|
134
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Unit tests for business logic</span></span>
|
|
135
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Integration tests for endpoints</span></span>
|
|
136
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Test error scenarios</span></span>
|
|
137
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> - Validate against API design</span></span>
|
|
138
|
+
<span class="line"></span>
|
|
139
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> transitions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
|
|
140
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">trigger</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'testing_complete'</span></span>
|
|
141
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> to</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'api_design'</span></span>
|
|
142
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> additional_instructions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Document API completion and prepare for next API development cycle'</span></span>
|
|
143
|
+
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> transition_reason</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'API complete, ready for next API'</span></span></code></pre></div><h2 id="why-this-system-works" tabindex="-1">Why This System Works <a class="header-anchor" href="#why-this-system-works" aria-label="Permalink to "Why This System Works""></a></h2><p><strong>Directory-based</strong>: Easy to see and manage all your custom workflows<br><strong>Domain filtering</strong>: Only load workflows relevant to your work<br><strong>Project-specific</strong>: Each project can have its own custom workflows<br><strong>Shareable</strong>: Workflows can be installed from URLs or shared between projects<br><strong>Discoverable</strong>: Rich metadata helps AI select appropriate workflows</p><p>Your custom workflows integrate seamlessly with the built-in ones, giving you complete control over your development process.</p>`,48)])])}const c=i(t,[["render",e]]);export{E as __pageData,c as default};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{_ as i,c as a,o as n,a0 as l}from"./chunks/framework.DZS7lpav.js";const E=JSON.parse('{"title":"Custom Workflows","description":"","frontmatter":{},"headers":[],"relativePath":"user/custom-workflows.md","filePath":"user/custom-workflows.md"}'),t={name:"user/custom-workflows.md"};function e(p,s,h,k,r,o){return n(),a("div",null,[...s[0]||(s[0]=[l("",48)])])}const c=i(t,[["render",e]]);export{E as __pageData,c as default};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{_ as i,c as t,o as a,a0 as o}from"./chunks/framework.DZS7lpav.js";const u=JSON.parse('{"title":"Git Commits","description":"","frontmatter":{},"headers":[],"relativePath":"user/git-commit-feature.md","filePath":"user/git-commit-feature.md"}'),s={name:"user/git-commit-feature.md"};function n(r,e,l,c,d,m){return a(),t("div",null,[...e[0]||(e[0]=[o('<h1 id="git-commits" tabindex="-1">Git Commits <a class="header-anchor" href="#git-commits" aria-label="Permalink to "Git Commits""></a></h1><p>The workflows server supports configurable automatic git commits during development. This allows for simpler rollbacks – independent of whether the agent itself supports rollbacks (which usually only roll-back conversation history).</p><h2 id="configuration" tabindex="-1">Configuration <a class="header-anchor" href="#configuration" aria-label="Permalink to "Configuration""></a></h2><p>Git commit behavior is configured via <strong>environment variables</strong> before starting the server:</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;"># Set commit behavior</span></span>\n<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> COMMIT_BEHAVIOR</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">end </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Options: "step", "phase", "end", "none"</span></span>\n<span class="line"></span>\n<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Optional: Custom commit message template.</span></span>\n<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> COMMIT_MESSAGE_TEMPLATE</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"feat: custom commit message format"</span></span></code></pre></div><h3 id="environment-variables" tabindex="-1">Environment Variables <a class="header-anchor" href="#environment-variables" aria-label="Permalink to "Environment Variables""></a></h3><h4 id="commit-behavior-required" tabindex="-1"><code>COMMIT_BEHAVIOR</code> (Required) <a class="header-anchor" href="#commit-behavior-required" aria-label="Permalink to "`COMMIT_BEHAVIOR` (Required)""></a></h4><ul><li><strong><code>step</code></strong>: Creates commits after each development step, providing detailed progress tracking</li><li><strong><code>phase</code></strong>: Creates commits before phase transitions, marking major milestones</li><li><strong><code>end</code></strong>: Creates a single commit when development is complete (recommended default)</li><li><strong><code>none</code></strong>: Disables automatic commits, giving you full manual control</li></ul><p>All intermediate commits will simply add all artifacts and create a WIP commit with a generic message.</p><p>The commit at the end of the development will be instructed with an optional custom template via a task in the development plan.</p><h4 id="commit-message-template-optional" tabindex="-1"><code>COMMIT_MESSAGE_TEMPLATE</code> (Optional) <a class="header-anchor" href="#commit-message-template-optional" aria-label="Permalink to "`COMMIT_MESSAGE_TEMPLATE` (Optional)""></a></h4><p>Customize the commit message format. Default: "Create a conventional commit. In the message, first summarize the intentions and key decisions from the development plan. Then, add a brief summary of the key changes and their side effects and dependencies"</p><h2 id="troubleshooting" tabindex="-1">Troubleshooting <a class="header-anchor" href="#troubleshooting" aria-label="Permalink to "Troubleshooting""></a></h2><h3 id="plugin-not-active" tabindex="-1">Plugin Not Active <a class="header-anchor" href="#plugin-not-active" aria-label="Permalink to "Plugin Not Active""></a></h3><ul><li>Verify <code>COMMIT_BEHAVIOR</code> environment variable is set before starting the server</li><li>Check server logs for "CommitPlugin registered successfully" message</li><li>Ensure the value is one of: <code>step</code>, <code>phase</code>, <code>end</code>, <code>none</code></li></ul><h3 id="no-commits-created" tabindex="-1">No Commits Created <a class="header-anchor" href="#no-commits-created" aria-label="Permalink to "No Commits Created""></a></h3><ul><li>Verify the directory is a git repository (<code>git status</code>)</li><li>Check that there are actual file changes to commit</li><li>Ensure git configuration is correct (<code>git config user.name</code> and <code>git config user.email</code>)</li><li>For step/phase modes: commits are created automatically during phase transitions</li></ul><h3 id="no-final-commit-task-in-plan-file" tabindex="-1">No Final Commit Task in Plan File <a class="header-anchor" href="#no-final-commit-task-in-plan-file" aria-label="Permalink to "No Final Commit Task in Plan File""></a></h3><ul><li>Ensure <code>COMMIT_BEHAVIOR</code> was set when <code>start_development</code> was called</li><li>The task is added to the final phase (usually "Commit") of the plan file</li><li>Check that the <code>afterPlanFileCreated</code> hook was executed during plan creation</li></ul><h3 id="git-errors" tabindex="-1">Git Errors <a class="header-anchor" href="#git-errors" aria-label="Permalink to "Git Errors""></a></h3><ul><li>Git errors are logged but don't interrupt development flow</li><li>Check git repository status and permissions</li><li>Verify git configuration is correct</li><li>Ensure no merge conflicts or other git issues</li></ul>',21)])])}const p=i(s,[["render",n]]);export{u as __pageData,p as default};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{_ as i,c as t,o as a,a0 as o}from"./chunks/framework.DZS7lpav.js";const u=JSON.parse('{"title":"Git Commits","description":"","frontmatter":{},"headers":[],"relativePath":"user/git-commit-feature.md","filePath":"user/git-commit-feature.md"}'),s={name:"user/git-commit-feature.md"};function n(r,e,l,c,d,m){return a(),t("div",null,[...e[0]||(e[0]=[o("",21)])])}const p=i(s,[["render",n]]);export{u as __pageData,p as default};
|