Files
Claude-Code-Workflow/ccw/docs-site/build/docs/workflows/introduction.html
catlog22 c6093ef741 feat: add CLI Command Node and Prompt Node components for orchestrator
- Implemented CliCommandNode component for executing CLI tools with AI models.
- Implemented PromptNode component for constructing AI prompts with context.
- Added styling for mode and tool badges in both components.
- Enhanced user experience with command and argument previews, execution status, and error handling.

test: add comprehensive tests for ask_question tool

- Created direct test for ask_question tool execution.
- Developed end-to-end tests to validate ask_question tool integration with WebSocket and A2UI surfaces.
- Implemented simple and integrated WebSocket tests to ensure proper message handling and surface reception.
- Added tool registration test to verify ask_question tool is correctly registered.

chore: add WebSocket listener and simulation tests

- Added WebSocket listener for A2UI surfaces to facilitate testing.
- Implemented frontend simulation test to validate complete flow from backend to frontend.
- Created various test scripts to ensure robust testing of ask_question tool functionality.
2026-02-03 23:10:36 +08:00

104 lines
40 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="en" dir="ltr" class="docs-wrapper plugin-docs plugin-id-default docs-version-current docs-doc-page docs-doc-id-workflows/introduction" data-has-hydrated="false">
<head>
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">Workflow Introduction | CCW Help Documentation</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="http://localhost:3001/docs/docs/workflows/introduction"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" property="og:locale:alternate" content="zh"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Workflow Introduction | CCW Help Documentation"><meta data-rh="true" name="description" content="Comprehensive overview of CCW workflows - from rapid execution to intelligent orchestration"><meta data-rh="true" property="og:description" content="Comprehensive overview of CCW workflows - from rapid execution to intelligent orchestration"><link data-rh="true" rel="icon" href="/docs/img/favicon.ico"><link data-rh="true" rel="canonical" href="http://localhost:3001/docs/docs/workflows/introduction"><link data-rh="true" rel="alternate" href="http://localhost:3001/docs/docs/workflows/introduction" hreflang="en"><link data-rh="true" rel="alternate" href="http://localhost:3001/docs/zh/docs/workflows/introduction" hreflang="zh"><link data-rh="true" rel="alternate" href="http://localhost:3001/docs/docs/workflows/introduction" hreflang="x-default"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Introduction","item":"http://localhost:3001/docs/docs/workflows/introduction"}]}</script><link rel="stylesheet" href="/docs/assets/css/styles.43777f0a.css">
<script src="/docs/assets/js/runtime~main.0220a52f.js" defer="defer"></script>
<script src="/docs/assets/js/main.d2194b90.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">
<svg style="display: none;"><defs>
<symbol id="theme-svg-external-link" viewBox="0 0 24 24"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol>
</defs></svg>
<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||"light"),document.documentElement.setAttribute("data-theme-choice",t||"light")}(),function(){try{const c=new URLSearchParams(window.location.search).entries();for(var[t,e]of c)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><div id="__docusaurus"><div role="region" aria-label="Skip to main content"><a class="skipToContent_G6ar" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="theme-layout-navbar navbar navbar--fixed-top"><div class="navbar__inner"><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/docs/"><div class="navbar__logo"><img src="/docs/img/logo.svg" alt="CCW Logo" class="themedComponent_DHUr themedComponent--light_DIHH"><img src="/docs/img/logo.svg" alt="CCW Logo" class="themedComponent_DHUr themedComponent--dark_Bv2M"></div><b class="navbar__title text--truncate">CCW Help</b></a></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link"><svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" class="iconLanguage_xrmG"><path fill="currentColor" d="M12.87 15.07l-2.54-2.51.03-.03c1.74-1.94 2.98-4.17 3.71-6.53H17V4h-7V2H8v2H1v1.99h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12zm-2.62 7l1.62-4.33L19.12 17h-3.24z"></path></svg>English</a><ul class="dropdown__menu"><li><a href="/docs/docs/workflows/introduction" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en">English</a></li><li><a href="/docs/zh/docs/workflows/introduction" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="zh">中文</a></li></ul></div><div class="toggle_OLSw colorModeToggle_Hg9V"><button class="clean-btn toggleButton_wYmb toggleButtonDisabled_vaDU" type="button" disabled="" title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_KEbZ lightToggleIcon_Sxwe"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_KEbZ darkToggleIcon_Yem1"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_KEbZ systemToggleIcon_txm5"><path fill="currentColor" d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"></path></svg></button></div><div class="navbarSearchContainer_bmvg"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="theme-layout-main main-wrapper mainWrapper_UyTV"><div class="docsWrapper_XLvK"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_z1FD" type="button"></button><div class="docRoot_HciC"><aside class="theme-doc-sidebar-container docSidebarContainer_e5ai"><div class="sidebarViewport_N8x0"><div class="sidebar_vJCc"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_qiME"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/docs/docs/overview"><span title="Overview" class="linkLabel_PuAu">Overview</span></a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="categoryLink_d9ci menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="true" href="/docs/docs/commands/general/ccw"><span title="Commands" class="categoryLinkLabel_Oe72">Commands</span></a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item"><div class="menu__list-item-collapsible"><a class="categoryLink_d9ci menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="true" tabindex="0" href="/docs/docs/commands/general/ccw"><span title="General Commands" class="categoryLinkLabel_Oe72">General Commands</span></a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/general/ccw"><span title="/ccw" class="linkLabel_PuAu">/ccw</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/general/ccw-plan"><span title="/ccw-plan" class="linkLabel_PuAu">/ccw-plan</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/general/ccw-test"><span title="/ccw-test" class="linkLabel_PuAu">/ccw-test</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/general/ccw-coordinator"><span title="/ccw-coordinator" class="linkLabel_PuAu">/ccw-coordinator</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/general/ccw-debug"><span title="/ccw-debug" class="linkLabel_PuAu">/ccw-debug</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/general/flow-create"><span title="/flow-create" class="linkLabel_PuAu">/flow-create</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/general/codex-coordinator"><span title="/codex-coordinator" class="linkLabel_PuAu">/codex-coordinator</span></a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item"><div class="menu__list-item-collapsible"><a class="categoryLink_d9ci menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="true" tabindex="0" href="/docs/docs/commands/issue/issue-new"><span title="Issue Commands" class="categoryLinkLabel_Oe72">Issue Commands</span></a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/issue/issue-new"><span title="issue:new" class="linkLabel_PuAu">issue:new</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/issue/issue-discover"><span title="issue:discover" class="linkLabel_PuAu">issue:discover</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/issue/issue-plan"><span title="issue:plan" class="linkLabel_PuAu">issue:plan</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/issue/issue-queue"><span title="issue:queue" class="linkLabel_PuAu">issue:queue</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/issue/issue-execute"><span title="issue:execute" class="linkLabel_PuAu">issue:execute</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/issue/issue-from-brainstorm"><span title="issue:from-brainstorm" class="linkLabel_PuAu">issue:from-brainstorm</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/issue/issue-convert-to-plan"><span title="issue:convert-to-plan" class="linkLabel_PuAu">issue:convert-to-plan</span></a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item"><div class="menu__list-item-collapsible"><a class="categoryLink_d9ci menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="true" tabindex="0" href="/docs/docs/commands/cli/cli-init"><span title="CLI Commands" class="categoryLinkLabel_Oe72">CLI Commands</span></a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/cli/cli-init"><span title="/cli:cli-init" class="linkLabel_PuAu">/cli:cli-init</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/cli/codex-review"><span title="/cli:codex-review" class="linkLabel_PuAu">/cli:codex-review</span></a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item"><div class="menu__list-item-collapsible"><a class="categoryLink_d9ci menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="true" tabindex="0" href="/docs/docs/commands/memory/memory-update-full"><span title="Memory Commands" class="categoryLinkLabel_Oe72">Memory Commands</span></a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/memory/memory-update-full"><span title="/memory:update-full" class="linkLabel_PuAu">/memory:update-full</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/memory/memory-update-related"><span title="/memory:update-related" class="linkLabel_PuAu">/memory:update-related</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/memory/memory-load"><span title="/memory:load" class="linkLabel_PuAu">/memory:load</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/memory/memory-docs-full-cli"><span title="/memory:docs-full-cli" class="linkLabel_PuAu">/memory:docs-full-cli</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/memory/memory-docs-related-cli"><span title="/memory:docs-related-cli" class="linkLabel_PuAu">/memory:docs-related-cli</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/memory/memory-compact"><span title="/memory:compact" class="linkLabel_PuAu">/memory:compact</span></a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item"><div class="menu__list-item-collapsible"><a class="categoryLink_d9ci menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="true" tabindex="0" href="/docs/docs/commands/memory/memory-update-full"><span title="Memory Commands" class="categoryLinkLabel_Oe72">Memory Commands</span></a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/memory/memory-update-full"><span title="/memory:update-full" class="linkLabel_PuAu">/memory:update-full</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/memory/memory-update-related"><span title="/memory:update-related" class="linkLabel_PuAu">/memory:update-related</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/memory/memory-load"><span title="/memory:load" class="linkLabel_PuAu">/memory:load</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/memory/memory-docs-full-cli"><span title="/memory:docs-full-cli" class="linkLabel_PuAu">/memory:docs-full-cli</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/memory/memory-docs-related-cli"><span title="/memory:docs-related-cli" class="linkLabel_PuAu">/memory:docs-related-cli</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/commands/memory/memory-compact"><span title="/memory:compact" class="linkLabel_PuAu">/memory:compact</span></a></li></ul></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="categoryLink_d9ci menu__link menu__link--sublist menu__link--sublist-caret menu__link--active" role="button" aria-expanded="true" href="/docs/docs/workflows/introduction"><span title="Workflows" class="categoryLinkLabel_Oe72">Workflows</span></a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/docs/docs/workflows/introduction"><span title="Introduction" class="linkLabel_PuAu">Introduction</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/workflows/level-1-ultra-lightweight"><span title="Level 1: Ultra Lightweight" class="linkLabel_PuAu">Level 1: Ultra Lightweight</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/workflows/level-2-rapid"><span title="Level 2: Rapid" class="linkLabel_PuAu">Level 2: Rapid</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/workflows/level-3-standard"><span title="Level 3: Standard" class="linkLabel_PuAu">Level 3: Standard</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/workflows/level-4-brainstorm"><span title="Level 4: Brainstorm" class="linkLabel_PuAu">Level 4: Brainstorm</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/docs/docs/workflows/level-5-intelligent"><span title="Level 5: Intelligent" class="linkLabel_PuAu">Level 5: Intelligent</span></a></li></ul></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/docs/docs/faq"><span title="FAQ" class="linkLabel_PuAu">FAQ</span></a></li></ul></nav></div></div></aside><main class="docMainContainer_namt"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_YAwJ"><div class="docItemContainer_Rv5Z"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_zCmv" aria-label="Breadcrumbs"><ul class="breadcrumbs"><li class="breadcrumbs__item"><span class="breadcrumbs__link">Workflows</span></li><li class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link">Introduction</span></li></ul></nav><div class="tocCollapsible_O_Qc theme-doc-toc-mobile tocMobile_tjDr"><button type="button" class="clean-btn tocCollapsibleButton_htYj">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Workflow Introduction</h1></header>
<p>CCW provides two workflow systems: <strong>Main Workflow</strong> and <strong>Issue Workflow</strong>, working together to cover the complete software development lifecycle.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="workflow-architecture-overview">Workflow Architecture Overview<a href="#workflow-architecture-overview" class="hash-link" aria-label="Direct link to Workflow Architecture Overview" title="Direct link to Workflow Architecture Overview" translate="no"></a></h2>
<!-- -->
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="main-workflow-vs-issue-workflow">Main Workflow vs Issue Workflow<a href="#main-workflow-vs-issue-workflow" class="hash-link" aria-label="Direct link to Main Workflow vs Issue Workflow" title="Direct link to Main Workflow vs Issue Workflow" translate="no"></a></h2>
<table><thead><tr><th>Aspect</th><th>Main Workflow</th><th>Issue Workflow</th></tr></thead><tbody><tr><td><strong>Purpose</strong></td><td>Primary development cycle</td><td>Post-development maintenance</td></tr><tr><td><strong>Timing</strong></td><td>Feature development phase</td><td>After main workflow completes</td></tr><tr><td><strong>Scope</strong></td><td>Complete feature implementation</td><td>Targeted fixes/enhancements</td></tr><tr><td><strong>Parallelism</strong></td><td>Dependency analysis + Agent parallel</td><td>Worktree isolation (optional)</td></tr><tr><td><strong>Branch Model</strong></td><td>Work on current branch</td><td>Can use isolated worktree</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="why-main-workflow-doesnt-use-worktree-automatically">Why Main Workflow Doesn&#x27;t Use Worktree Automatically?<a href="#why-main-workflow-doesnt-use-worktree-automatically" class="hash-link" aria-label="Direct link to Why Main Workflow Doesn&#x27;t Use Worktree Automatically?" title="Direct link to Why Main Workflow Doesn&#x27;t Use Worktree Automatically?" translate="no"></a></h3>
<p><strong>Dependency analysis already solves parallelism</strong>:</p>
<ol>
<li class="">Planning phase (<code>/workflow:plan</code>) performs dependency analysis</li>
<li class="">Automatically identifies task dependencies and critical paths</li>
<li class="">Partitions into <strong>parallel groups</strong> (independent tasks) and <strong>serial chains</strong> (dependent tasks)</li>
<li class="">Agents execute independent tasks in parallel without filesystem isolation</li>
</ol>
<!-- -->
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="why-issue-workflow-supports-worktree">Why Issue Workflow Supports Worktree?<a href="#why-issue-workflow-supports-worktree" class="hash-link" aria-label="Direct link to Why Issue Workflow Supports Worktree?" title="Direct link to Why Issue Workflow Supports Worktree?" translate="no"></a></h3>
<p>Issue Workflow serves as a <strong>supplementary mechanism</strong> with different scenarios:</p>
<ol>
<li class="">Main development complete, merged to <code>main</code></li>
<li class="">Issues discovered requiring fixes</li>
<li class="">Need to fix without affecting current development</li>
<li class="">Worktree isolation keeps main branch stable</li>
</ol>
<!-- -->
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="15-workflow-levels-explained">15 Workflow Levels Explained<a href="#15-workflow-levels-explained" class="hash-link" aria-label="Direct link to 15 Workflow Levels Explained" title="Direct link to 15 Workflow Levels Explained" translate="no"></a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="level-1-rapid-execution">Level 1: Rapid Execution<a href="#level-1-rapid-execution" class="hash-link" aria-label="Direct link to Level 1: Rapid Execution" title="Direct link to Level 1: Rapid Execution" translate="no"></a></h3>
<p><strong>Complexity</strong>: Low | <strong>Artifacts</strong>: None | <strong>State</strong>: Stateless</p>
<table><thead><tr><th>Workflow</th><th>Description</th></tr></thead><tbody><tr><td><code>lite-lite-lite</code></td><td>Ultra-lightweight direct execution with zero overhead</td></tr></tbody></table>
<p><strong>Best for</strong>: Quick fixes, simple features, config adjustments</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="level-2-lightweight-planning">Level 2: Lightweight Planning<a href="#level-2-lightweight-planning" class="hash-link" aria-label="Direct link to Level 2: Lightweight Planning" title="Direct link to Level 2: Lightweight Planning" translate="no"></a></h3>
<p><strong>Complexity</strong>: Low-Medium | <strong>Artifacts</strong>: Memory/Lightweight files | <strong>State</strong>: Session-scoped</p>
<table><thead><tr><th>Workflow</th><th>Description</th></tr></thead><tbody><tr><td><code>lite-plan</code></td><td>In-memory planning for clear requirements</td></tr><tr><td><code>lite-fix</code></td><td>Intelligent bug diagnosis and fix</td></tr><tr><td><code>multi-cli-plan</code></td><td>Multi-CLI collaborative analysis</td></tr></tbody></table>
<p><strong>Best for</strong>: Single-module features, bug fixes, technology selection</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="level-25-bridge-workflow">Level 2.5: Bridge Workflow<a href="#level-25-bridge-workflow" class="hash-link" aria-label="Direct link to Level 2.5: Bridge Workflow" title="Direct link to Level 2.5: Bridge Workflow" translate="no"></a></h3>
<p><strong>Complexity</strong>: Low-Medium | <strong>Purpose</strong>: Lightweight to Issue transition</p>
<table><thead><tr><th>Workflow</th><th>Description</th></tr></thead><tbody><tr><td><code>rapid-to-issue</code></td><td>Bridge from quick planning to issue workflow</td></tr></tbody></table>
<p><strong>Best for</strong>: Converting lightweight plans to issue tracking</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="level-3-standard-planning">Level 3: Standard Planning<a href="#level-3-standard-planning" class="hash-link" aria-label="Direct link to Level 3: Standard Planning" title="Direct link to Level 3: Standard Planning" translate="no"></a></h3>
<p><strong>Complexity</strong>: Medium-High | <strong>Artifacts</strong>: Persistent session files | <strong>State</strong>: Full session management</p>
<table><thead><tr><th>Workflow</th><th>Description</th></tr></thead><tbody><tr><td><code>plan</code></td><td>Complex feature development with 5 phases</td></tr><tr><td><code>tdd-plan</code></td><td>Test-driven development with Red-Green-Refactor</td></tr><tr><td><code>test-fix-gen</code></td><td>Test fix generation with progressive layers</td></tr></tbody></table>
<p><strong>Best for</strong>: Multi-module changes, refactoring, TDD development</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="with-file-workflows-level-3-4">With-File Workflows (Level 3-4)<a href="#with-file-workflows-level-3-4" class="hash-link" aria-label="Direct link to With-File Workflows (Level 3-4)" title="Direct link to With-File Workflows (Level 3-4)" translate="no"></a></h3>
<p><strong>Complexity</strong>: Medium-High | <strong>Artifacts</strong>: Documented exploration | <strong>Multi-CLI</strong>: Yes</p>
<table><thead><tr><th>Workflow</th><th>Description</th><th>Level</th></tr></thead><tbody><tr><td><code>brainstorm-with-file</code></td><td>Multi-perspective ideation</td><td>4</td></tr><tr><td><code>debug-with-file</code></td><td>Hypothesis-driven debugging</td><td>3</td></tr><tr><td><code>analyze-with-file</code></td><td>Collaborative analysis</td><td>3</td></tr></tbody></table>
<p><strong>Best for</strong>: Documented exploration with multi-CLI collaboration</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="level-4-brainstorming">Level 4: Brainstorming<a href="#level-4-brainstorming" class="hash-link" aria-label="Direct link to Level 4: Brainstorming" title="Direct link to Level 4: Brainstorming" translate="no"></a></h3>
<p><strong>Complexity</strong>: High | <strong>Artifacts</strong>: Multi-role analysis docs | <strong>Roles</strong>: 3-9</p>
<table><thead><tr><th>Workflow</th><th>Description</th></tr></thead><tbody><tr><td><code>brainstorm:auto-parallel</code></td><td>Multi-role brainstorming with synthesis</td></tr></tbody></table>
<p><strong>Best for</strong>: New feature design, architecture refactoring, exploratory requirements</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="level-5-intelligent-orchestration">Level 5: Intelligent Orchestration<a href="#level-5-intelligent-orchestration" class="hash-link" aria-label="Direct link to Level 5: Intelligent Orchestration" title="Direct link to Level 5: Intelligent Orchestration" translate="no"></a></h3>
<p><strong>Complexity</strong>: All levels | <strong>Artifacts</strong>: Full state persistence | <strong>Automation</strong>: Complete</p>
<table><thead><tr><th>Workflow</th><th>Description</th></tr></thead><tbody><tr><td><code>ccw-coordinator</code></td><td>Auto-analyze &amp; recommend command chains</td></tr></tbody></table>
<p><strong>Best for</strong>: Complex multi-step workflows, uncertain commands, end-to-end automation</p>
<hr>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="issue-workflow">Issue Workflow<a href="#issue-workflow" class="hash-link" aria-label="Direct link to Issue Workflow" title="Direct link to Issue Workflow" translate="no"></a></h3>
<p><strong>Complexity</strong>: Variable | <strong>Artifacts</strong>: Issue records | <strong>Isolation</strong>: Worktree optional</p>
<table><thead><tr><th>Phase</th><th>Commands</th></tr></thead><tbody><tr><td><strong>Accumulation</strong></td><td><code>discover</code>, <code>discover-by-prompt</code>, <code>new</code></td></tr><tr><td><strong>Resolution</strong></td><td><code>plan --all-pending</code>, <code>queue</code>, <code>execute</code></td></tr></tbody></table>
<p><strong>Best for</strong>: Post-development issue fixes, maintaining main branch stability</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="choosing-the-right-workflow">Choosing the Right Workflow<a href="#choosing-the-right-workflow" class="hash-link" aria-label="Direct link to Choosing the Right Workflow" title="Direct link to Choosing the Right Workflow" translate="no"></a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="quick-selection-table">Quick Selection Table<a href="#quick-selection-table" class="hash-link" aria-label="Direct link to Quick Selection Table" title="Direct link to Quick Selection Table" translate="no"></a></h3>
<table><thead><tr><th>Scenario</th><th>Recommended Workflow</th><th>Level</th></tr></thead><tbody><tr><td>Quick fixes, config adjustments</td><td><code>lite-lite-lite</code></td><td>1</td></tr><tr><td>Clear single-module features</td><td><code>lite-plan -&gt; lite-execute</code></td><td>2</td></tr><tr><td>Bug diagnosis and fix</td><td><code>lite-fix</code></td><td>2</td></tr><tr><td>Production emergencies</td><td><code>lite-fix --hotfix</code></td><td>2</td></tr><tr><td>Technology selection, solution comparison</td><td><code>multi-cli-plan -&gt; lite-execute</code></td><td>2</td></tr><tr><td>Multi-module changes, refactoring</td><td><code>plan -&gt; verify -&gt; execute</code></td><td>3</td></tr><tr><td>Test-driven development</td><td><code>tdd-plan -&gt; execute -&gt; tdd-verify</code></td><td>3</td></tr><tr><td>Test failure fixes</td><td><code>test-fix-gen -&gt; test-cycle-execute</code></td><td>3</td></tr><tr><td>New features, architecture design</td><td><code>brainstorm:auto-parallel -&gt; plan -&gt; execute</code></td><td>4</td></tr><tr><td>Complex multi-step workflows, uncertain commands</td><td><code>ccw-coordinator</code></td><td>5</td></tr><tr><td>Post-development issue fixes</td><td>Issue Workflow</td><td>-</td></tr></tbody></table>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="decision-flowchart">Decision Flowchart<a href="#decision-flowchart" class="hash-link" aria-label="Direct link to Decision Flowchart" title="Direct link to Decision Flowchart" translate="no"></a></h3>
<!-- -->
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="complexity-indicators">Complexity Indicators<a href="#complexity-indicators" class="hash-link" aria-label="Direct link to Complexity Indicators" title="Direct link to Complexity Indicators" translate="no"></a></h3>
<p>System auto-evaluates complexity based on keywords:</p>
<table><thead><tr><th>Weight</th><th>Keywords</th></tr></thead><tbody><tr><td>+2</td><td>refactor, migrate, architect, system</td></tr><tr><td>+2</td><td>multiple, across, all, entire</td></tr><tr><td>+1</td><td>integrate, api, database</td></tr><tr><td>+1</td><td>security, performance, scale</td></tr></tbody></table>
<ul>
<li class=""><strong>High complexity</strong> (&gt;=4): Auto-select Level 3-4</li>
<li class=""><strong>Medium complexity</strong> (2-3): Auto-select Level 2</li>
<li class=""><strong>Low complexity</strong> (&lt;2): Auto-select Level 1</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="minimum-execution-units">Minimum Execution Units<a href="#minimum-execution-units" class="hash-link" aria-label="Direct link to Minimum Execution Units" title="Direct link to Minimum Execution Units" translate="no"></a></h2>
<p><strong>Definition</strong>: A set of commands that must execute together as an atomic group to achieve a meaningful workflow milestone.</p>
<table><thead><tr><th>Unit Name</th><th>Commands</th><th>Purpose</th></tr></thead><tbody><tr><td><strong>Quick Implementation</strong></td><td>lite-plan -&gt; lite-execute</td><td>Lightweight plan and execution</td></tr><tr><td><strong>Multi-CLI Planning</strong></td><td>multi-cli-plan -&gt; lite-execute</td><td>Multi-perspective analysis and execution</td></tr><tr><td><strong>Bug Fix</strong></td><td>lite-fix -&gt; lite-execute</td><td>Bug diagnosis and fix execution</td></tr><tr><td><strong>Verified Planning</strong></td><td>plan -&gt; plan-verify -&gt; execute</td><td>Planning with verification and execution</td></tr><tr><td><strong>TDD Planning</strong></td><td>tdd-plan -&gt; execute</td><td>Test-driven development planning and execution</td></tr><tr><td><strong>Test Validation</strong></td><td>test-fix-gen -&gt; test-cycle-execute</td><td>Generate test tasks and execute test-fix cycle</td></tr><tr><td><strong>Code Review</strong></td><td>review-session-cycle -&gt; review-cycle-fix</td><td>Complete review cycle and apply fixes</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="next-steps">Next Steps<a href="#next-steps" class="hash-link" aria-label="Direct link to Next Steps" title="Direct link to Next Steps" translate="no"></a></h2>
<ul>
<li class=""><a class="" href="/docs/docs/workflows/level-1-ultra-lightweight">Level 1: Ultra-Lightweight Workflows</a> - Learn about rapid execution</li>
<li class=""><a class="" href="/docs/docs/workflows/level-2-rapid">Level 2: Rapid Workflows</a> - Lightweight planning and bug fixes</li>
<li class=""><a class="" href="/docs/docs/workflows/level-3-standard">Level 3: Standard Workflows</a> - Complete planning and TDD</li>
<li class=""><a class="" href="/docs/docs/workflows/level-4-brainstorm">Level 4: Brainstorm Workflows</a> - Multi-role exploration</li>
<li class=""><a class="" href="/docs/docs/workflows/level-5-intelligent">Level 5: Intelligent Workflows</a> - Automated orchestration</li>
<li class=""><a class="" href="/docs/docs/workflows/faq">FAQ</a> - Common questions and answers</li>
</ul></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="row margin-top--sm theme-doc-footer-edit-meta-row"><div class="col noPrint_HJkF"><a href="https://github.com/ccw/docs/tree/main/docs/workflows/introduction.mdx" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_UohW" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_g62E"></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/docs/commands/memory/memory-compact"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">/memory:compact</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/docs/workflows/level-1-ultra-lightweight"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Level 1: Ultra Lightweight</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_TN1Q thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#workflow-architecture-overview" class="table-of-contents__link toc-highlight">Workflow Architecture Overview</a></li><li><a href="#main-workflow-vs-issue-workflow" class="table-of-contents__link toc-highlight">Main Workflow vs Issue Workflow</a><ul><li><a href="#why-main-workflow-doesnt-use-worktree-automatically" class="table-of-contents__link toc-highlight">Why Main Workflow Doesn&#39;t Use Worktree Automatically?</a></li><li><a href="#why-issue-workflow-supports-worktree" class="table-of-contents__link toc-highlight">Why Issue Workflow Supports Worktree?</a></li></ul></li><li><a href="#15-workflow-levels-explained" class="table-of-contents__link toc-highlight">15 Workflow Levels Explained</a><ul><li><a href="#level-1-rapid-execution" class="table-of-contents__link toc-highlight">Level 1: Rapid Execution</a></li><li><a href="#level-2-lightweight-planning" class="table-of-contents__link toc-highlight">Level 2: Lightweight Planning</a></li><li><a href="#level-25-bridge-workflow" class="table-of-contents__link toc-highlight">Level 2.5: Bridge Workflow</a></li><li><a href="#level-3-standard-planning" class="table-of-contents__link toc-highlight">Level 3: Standard Planning</a></li><li><a href="#with-file-workflows-level-3-4" class="table-of-contents__link toc-highlight">With-File Workflows (Level 3-4)</a></li><li><a href="#level-4-brainstorming" class="table-of-contents__link toc-highlight">Level 4: Brainstorming</a></li><li><a href="#level-5-intelligent-orchestration" class="table-of-contents__link toc-highlight">Level 5: Intelligent Orchestration</a></li><li><a href="#issue-workflow" class="table-of-contents__link toc-highlight">Issue Workflow</a></li></ul></li><li><a href="#choosing-the-right-workflow" class="table-of-contents__link toc-highlight">Choosing the Right Workflow</a><ul><li><a href="#quick-selection-table" class="table-of-contents__link toc-highlight">Quick Selection Table</a></li><li><a href="#decision-flowchart" class="table-of-contents__link toc-highlight">Decision Flowchart</a></li><li><a href="#complexity-indicators" class="table-of-contents__link toc-highlight">Complexity Indicators</a></li></ul></li><li><a href="#minimum-execution-units" class="table-of-contents__link toc-highlight">Minimum Execution Units</a></li><li><a href="#next-steps" class="table-of-contents__link toc-highlight">Next Steps</a></li></ul></div></div></div></div></main></div></div></div><footer class="theme-layout-footer footer footer--dark"><div class="container container-fluid"><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2026 CCW. Built with Docusaurus.</div></div></div></footer></div>
</body>
</html>