catlog22/Claude-Code-Workflow
1
0
Fork 0
mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-05 01:50:27 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
Claude-Code-Workflow/ccw/docs-site/build/docs/faq.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

311 lines
96 KiB
HTML
Raw Permalink 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-faq" data-has-hydrated="false">
<head>
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">Frequently Asked Questions | 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/faq"><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="Frequently Asked Questions | CCW Help Documentation"><meta data-rh="true" name="description" content="Common questions about CCW, workflows, commands, and troubleshooting."><meta data-rh="true" property="og:description" content="Common questions about CCW, workflows, commands, and troubleshooting."><link data-rh="true" rel="icon" href="/docs/img/favicon.ico"><link data-rh="true" rel="canonical" href="http://localhost:3001/docs/docs/faq"><link data-rh="true" rel="alternate" href="http://localhost:3001/docs/docs/faq" hreflang="en"><link data-rh="true" rel="alternate" href="http://localhost:3001/docs/zh/docs/faq" hreflang="zh"><link data-rh="true" rel="alternate" href="http://localhost:3001/docs/docs/faq" hreflang="x-default"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"FAQ","item":"http://localhost:3001/docs/docs/faq"}]}</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/faq" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en">English</a></li><li><a href="/docs/zh/docs/faq" 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" 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" 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 menu__link--active" aria-current="page" 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 breadcrumbs__item--active"><span class="breadcrumbs__link">FAQ</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>Frequently Asked Questions</h1></header>
<p>Common questions about CCW, workflows, commands, and troubleshooting.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="general-questions">General Questions<a href="#general-questions" class="hash-link" aria-label="Direct link to General Questions" title="Direct link to General Questions" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-is-ccw">What is CCW?<a href="#what-is-ccw" class="hash-link" aria-label="Direct link to What is CCW?" title="Direct link to What is CCW?" translate="no">​</a></h3>
<p>CCW (Claude Code Workflows) is a professional workflow automation platform that combines AI-powered intelligence with structured development workflows. It provides 40+ commands and 15 integrated workflows to accelerate software development while maintaining quality standards.</p>
<p><strong>Key Features:</strong></p>
<ul>
<li class="">AI-powered code analysis, generation, and review</li>
<li class="">15 workflow levels from rapid execution to intelligent orchestration</li>
<li class="">Session management with full state persistence</li>
<li class="">Multi-agent coordination with parallel execution</li>
<li class="">Built-in testing, verification, and code review</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-are-the-system-requirements">What are the system requirements?<a href="#what-are-the-system-requirements" class="hash-link" aria-label="Direct link to What are the system requirements?" title="Direct link to What are the system requirements?" translate="no">​</a></h3>
<p><strong>Minimum Requirements:</strong></p>
<ul>
<li class="">Node.js 16.x or higher</li>
<li class="">Git 2.x or higher</li>
<li class="">4GB RAM available</li>
<li class="">500MB disk space</li>
</ul>
<p><strong>Recommended:</strong></p>
<ul>
<li class="">Node.js 18.x LTS</li>
<li class="">8GB RAM available</li>
<li class="">2GB disk space for artifacts and sessions</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-install-ccw">How do I install CCW?<a href="#how-do-i-install-ccw" class="hash-link" aria-label="Direct link to How do I install CCW?" title="Direct link to How do I install CCW?" translate="no">​</a></h3>
<div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Install globally via npm</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token function" style="color:rgb(130, 170, 255)">npm</span><span class="token plain"> </span><span class="token function" style="color:rgb(130, 170, 255)">install</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-g</span><span class="token plain"> @ccw/cli</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Or use npx (no installation required)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">npx @ccw/cli init</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Initialize in your project</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw init</span><br></span></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="is-ccw-free-to-use">Is CCW free to use?<a href="#is-ccw-free-to-use" class="hash-link" aria-label="Direct link to Is CCW free to use?" title="Direct link to Is CCW free to use?" translate="no">​</a></h3>
<p>Yes, CCW is open-source and free to use. However, CCW integrates with third-party AI services (Gemini, Codex, Claude, Qwen) that may have their own pricing. You&#x27;ll need API keys for any AI services you want to use.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-programming-languages-are-supported">What programming languages are supported?<a href="#what-programming-languages-are-supported" class="hash-link" aria-label="Direct link to What programming languages are supported?" title="Direct link to What programming languages are supported?" translate="no">​</a></h3>
<p>CCW supports all programming languages. The AI models can analyze and generate code in any language, including:</p>
<ul>
<li class=""><strong>Web</strong>: JavaScript, TypeScript, Python, PHP, Ruby</li>
<li class=""><strong>Mobile</strong>: Swift, Kotlin, React Native, Flutter</li>
<li class=""><strong>Systems</strong>: Rust, Go, C, C++</li>
<li class=""><strong>Data</strong>: Python, R, SQL</li>
<li class=""><strong>Enterprise</strong>: Java, C#, .NET</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="workflow-selection">Workflow Selection<a href="#workflow-selection" class="hash-link" aria-label="Direct link to Workflow Selection" title="Direct link to Workflow Selection" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-choose-the-right-workflow">How do I choose the right workflow?<a href="#how-do-i-choose-the-right-workflow" class="hash-link" aria-label="Direct link to How do I choose the right workflow?" title="Direct link to How do I choose the right workflow?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Decision Framework</summary><p>Use this quick decision tree:</p><ol>
<li class=""><strong>Post-development maintenance?</strong> → Use <a class="" href="/docs/docs/workflows/faq#what-is-the-difference-between-main-workflow-and-issue-workflow">Issue Workflow</a></li>
<li class=""><strong>Uncertain which commands to use?</strong> → Use <code>ccw-coordinator</code> (Level 5)</li>
<li class=""><strong>Requirements unclear?</strong> → Use <code>brainstorm:auto-parallel</code> (Level 4)</li>
<li class=""><strong>Need persistent session?</strong>
<ul>
<li class="">Standard development → <code>plan</code> → <code>execute</code> (Level 3)</li>
<li class="">Test-driven → <code>tdd-plan</code> → <code>execute</code> (Level 3)</li>
<li class="">Test fixes → <code>test-fix-gen</code> → <code>test-cycle-execute</code> (Level 3)</li>
</ul>
</li>
<li class=""><strong>Need multi-perspective analysis?</strong> → Use <code>multi-cli-plan</code> (Level 2)</li>
<li class=""><strong>Bug fix?</strong> → Use <code>lite-fix</code> (Level 2)</li>
<li class=""><strong>Need planning?</strong> → Use <code>lite-plan</code> → <code>lite-execute</code> (Level 2)</li>
<li class=""><strong>Quick task?</strong> → Use <code>lite-lite-lite</code> (Level 1)</li>
</ol></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="whats-the-difference-between-main-workflow-and-issue-workflow">What&#x27;s the difference between Main Workflow and Issue Workflow?<a href="#whats-the-difference-between-main-workflow-and-issue-workflow" class="hash-link" aria-label="Direct link to What&#x27;s the difference between Main Workflow and Issue Workflow?" title="Direct link to What&#x27;s the difference between Main Workflow and Issue Workflow?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Comparison</summary><p><strong>Main Workflow</strong> is for primary development:</p><ul>
<li class="">Feature development (Levels 1-5)</li>
<li class="">Active development phase</li>
<li class="">Dependency-based parallelism</li>
<li class="">Works on current branch</li>
</ul><p><strong>Issue Workflow</strong> is for post-development maintenance:</p><ul>
<li class="">Bug fixes and enhancements after merge</li>
<li class="">After main workflow completes</li>
<li class="">Optional worktree isolation</li>
<li class="">Keeps main branch stable</li>
</ul><table><thead><tr><th>Aspect</th><th>Main Workflow</th><th>Issue Workflow</th></tr></thead><tbody><tr><td><strong>Purpose</strong></td><td>Feature development</td><td>Post-development fixes</td></tr><tr><td><strong>Timing</strong></td><td>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</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></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-are-minimum-execution-units">What are Minimum Execution Units?<a href="#what-are-minimum-execution-units" class="hash-link" aria-label="Direct link to What are Minimum Execution Units?" title="Direct link to What are Minimum Execution Units?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Explanation</summary><p><strong>Minimum Execution Units</strong> are sets of commands that must execute together as atomic groups to achieve meaningful workflow milestones. Splitting these commands breaks logical flow and creates incomplete states.</p><p><strong>Common Minimum Execution Units:</strong></p><table><thead><tr><th>Unit</th><th>Commands</th><th>Purpose</th></tr></thead><tbody><tr><td>Quick Implementation</td><td><code>lite-plan</code> → <code>lite-execute</code></td><td>Lightweight plan and execution</td></tr><tr><td>Multi-CLI Planning</td><td><code>multi-cli-plan</code> → <code>lite-execute</code></td><td>Multi-perspective analysis and execution</td></tr><tr><td>Bug Fix</td><td><code>lite-fix</code> → <code>lite-execute</code></td><td>Bug diagnosis and fix execution</td></tr><tr><td>Verified Planning</td><td><code>plan</code> → <code>plan-verify</code> → <code>execute</code></td><td>Planning with verification and execution</td></tr><tr><td>TDD Planning</td><td><code>tdd-plan</code> → <code>execute</code></td><td>Test-driven development planning and execution</td></tr><tr><td>Test Validation</td><td><code>test-fix-gen</code> → <code>test-cycle-execute</code></td><td>Generate test tasks and execute test-fix cycle</td></tr></tbody></table><p><strong>Example</strong>: The unit <code>lite-plan → lite-execute</code> must complete together. Stopping after <code>lite-plan</code> leaves you with a plan but no implementation.</p></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="when-should-i-use-each-workflow-level">When should I use each workflow level?<a href="#when-should-i-use-each-workflow-level" class="hash-link" aria-label="Direct link to When should I use each workflow level?" title="Direct link to When should I use each workflow level?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Level Selection Guide</summary><p><strong>Level 1 (lite-lite-lite):</strong></p><ul>
<li class="">Quick fixes (typos, minor adjustments)</li>
<li class="">Simple features (single function, small utility)</li>
<li class="">Config changes (environment variables, timeouts)</li>
<li class="">Documentation updates</li>
</ul><p><strong>Level 2 (lite-plan, lite-fix, multi-cli-plan):</strong></p><ul>
<li class="">Single-module features</li>
<li class="">Bug diagnosis and fixes</li>
<li class="">Technology selection decisions</li>
<li class="">Solution comparison</li>
</ul><p><strong>Level 3 (plan, tdd-plan, test-fix-gen):</strong></p><ul>
<li class="">Multi-module changes</li>
<li class="">Refactoring</li>
<li class="">Test-driven development</li>
<li class="">Test failure fixes</li>
</ul><p><strong>Level 4 (brainstorm<!-- -->:auto-parallel<!-- -->):</strong></p><ul>
<li class="">New feature design</li>
<li class="">System architecture refactoring</li>
<li class="">Exploratory requirements</li>
<li class="">Multi-dimensional trade-offs</li>
</ul><p><strong>Level 5 (ccw-coordinator):</strong></p><ul>
<li class="">Complex multi-step workflows</li>
<li class="">Uncertain which commands to use</li>
<li class="">End-to-end automation</li>
<li class="">Team collaboration</li>
</ul><p><strong>Issue Workflow:</strong></p><ul>
<li class="">Post-development issue fixes</li>
<li class="">Maintaining main branch stability</li>
</ul></div></div></details>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="command-usage">Command Usage<a href="#command-usage" class="hash-link" aria-label="Direct link to Command Usage" title="Direct link to Command Usage" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-use-workflow-commands">How do I use workflow commands?<a href="#how-do-i-use-workflow-commands" class="hash-link" aria-label="Direct link to How do I use workflow commands?" title="Direct link to How do I use workflow commands?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Command Patterns</summary><p><strong>Basic Pattern:</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw </span><span class="token operator" style="color:rgb(137, 221, 255)">&amp;</span><span class="token plain">lt</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">command</span><span class="token operator" style="color:rgb(137, 221, 255)">&amp;</span><span class="token plain">gt</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">&amp;</span><span class="token plain">lt</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain">arguments</span><span class="token operator" style="color:rgb(137, 221, 255)">&amp;</span><span class="token plain">gt</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div><p><strong>Examples:</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Level 1 - Direct execution</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw lite-lite-lite </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Fix login button&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Level 2 - Lightweight planning</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw lite-plan </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Add user profile page&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw lite-execute --in-memory</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Level 3 - Full workflow</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw workflow:plan </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Implement OAuth2&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw workflow:execute </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--session</span><span class="token plain"> WFS-oauth-auth</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Level 4 - Brainstorming</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw brainstorm:auto-parallel </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Design notification system&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Level 5 - Intelligent coordination</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw ccw-coordinator </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Refactor API layer&quot;</span><br></span></code></pre></div></div></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-is-the-difference-between-lite-execute-and-execute">What is the difference between lite-execute and execute?<a href="#what-is-the-difference-between-lite-execute-and-execute" class="hash-link" aria-label="Direct link to What is the difference between lite-execute and execute?" title="Direct link to What is the difference between lite-execute and execute?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Comparison</summary><p><strong>lite-execute</strong> (Level 2):</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw lite-execute --in-memory</span><br></span></code></pre></div></div><ul>
<li class="">For Level 2 workflows</li>
<li class="">In-memory planning (no session files)</li>
<li class="">Parallel execution for independent tasks</li>
<li class="">Optional code review</li>
</ul><p><strong>execute</strong> (Level 3):</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw workflow:execute </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--session</span><span class="token plain"> WFS-</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain">session-id</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><ul>
<li class="">For Level 3 workflows</li>
<li class="">Session-based execution</li>
<li class="">Dependency analysis</li>
<li class="">Full state tracking and resumability</li>
<li class="">Task completion summaries</li>
</ul></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-use-hotfix-mode">How do I use hotfix mode?<a href="#how-do-i-use-hotfix-mode" class="hash-link" aria-label="Direct link to How do I use hotfix mode?" title="Direct link to How do I use hotfix mode?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Hotfix Usage</summary><p><strong>Hotfix mode</strong> is for production emergencies:</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw lite-fix </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--hotfix</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Production database connection failing&quot;</span><br></span></code></pre></div></div><p><strong>What it does:</strong></p><ul>
<li class="">Skips most diagnosis phases</li>
<li class="">Minimal planning (direct execution)</li>
<li class="">Auto-generates follow-up tasks for complete fix + post-mortem</li>
</ul><p><strong>When to use:</strong></p><ul>
<li class="">Production incidents</li>
<li class="">Critical bugs requiring immediate fix</li>
<li class="">Outages and service disruptions</li>
</ul><p><strong>What happens after:</strong>
CCW automatically generates follow-up tasks for:</p><ul>
<li class="">Complete root cause analysis</li>
<li class="">Comprehensive fix</li>
<li class="">Post-mortem documentation</li>
</ul></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-resume-a-paused-session">How do I resume a paused session?<a href="#how-do-i-resume-a-paused-session" class="hash-link" aria-label="Direct link to How do I resume a paused session?" title="Direct link to How do I resume a paused session?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Session Resume</summary><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Resume most recent session</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw workflow:session:resume</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Resume specific session</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw workflow:session:resume WFS-user-auth-v2</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># List all sessions</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw workflow:session:list</span><br></span></code></pre></div></div><p><strong>Session states:</strong></p><ul>
<li class=""><strong>active</strong>: Currently running</li>
<li class=""><strong>paused</strong>: Stopped, can be resumed</li>
<li class=""><strong>completed</strong>: Finished and archived</li>
</ul></div></div></details>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="ai-models">AI Models<a href="#ai-models" class="hash-link" aria-label="Direct link to AI Models" title="Direct link to AI Models" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="which-ai-models-does-ccw-support">Which AI models does CCW support?<a href="#which-ai-models-does-ccw-support" class="hash-link" aria-label="Direct link to Which AI models does CCW support?" title="Direct link to Which AI models does CCW support?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Supported Models</summary><p>CCW supports multiple AI models via CLI endpoints:</p><table><thead><tr><th>Model</th><th>Capabilities</th><th>Best For</th></tr></thead><tbody><tr><td><strong>Gemini</strong></td><td>Analysis + Write</td><td>Code review, debugging, refactoring</td></tr><tr><td><strong>Codex</strong></td><td>Analysis + Write + Review</td><td>Git-aware code review, implementation</td></tr><tr><td><strong>Claude</strong></td><td>Analysis + Write</td><td>Complex reasoning, documentation</td></tr><tr><td><strong>Qwen</strong></td><td>Analysis + Write</td><td>Code generation, pattern matching</td></tr></tbody></table><p>Configure models in <code>~/.claude/cli-tools.json</code>.</p></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-configure-api-keys">How do I configure API keys?<a href="#how-do-i-configure-api-keys" class="hash-link" aria-label="Direct link to How do I configure API keys?" title="Direct link to How do I configure API keys?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>API Key Configuration</summary><p><strong>Set environment variables:</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Gemini</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(191, 199, 213)">GEMINI_API_KEY</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token string" style="color:rgb(195, 232, 141)">&quot;your-key-here&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># OpenAI (Codex)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(191, 199, 213)">OPENAI_API_KEY</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token string" style="color:rgb(195, 232, 141)">&quot;your-key-here&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Anthropic (Claude)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(191, 199, 213)">ANTHROPIC_API_KEY</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token string" style="color:rgb(195, 232, 141)">&quot;your-key-here&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Qwen</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(191, 199, 213)">DASHSCOPE_API_KEY</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token string" style="color:rgb(195, 232, 141)">&quot;your-key-here&quot;</span><br></span></code></pre></div></div><p><strong>Or configure in <code>.env</code> file:</strong></p><div class="language-env codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-env codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">GEMINI_API_KEY=your-key-here</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">OPENAI_API_KEY=your-key-here</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ANTHROPIC_API_KEY=your-key-here</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">DASHSCOPE_API_KEY=your-key-here</span><br></span></code></pre></div></div></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-is-multi-cli-collaboration">What is multi-CLI collaboration?<a href="#what-is-multi-cli-collaboration" class="hash-link" aria-label="Direct link to What is multi-CLI collaboration?" title="Direct link to What is multi-CLI collaboration?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Multi-CLI Explanation</summary><p><strong>Multi-CLI collaboration</strong> uses multiple AI models to analyze the same problem from different perspectives:</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw multi-cli-plan </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Compare Redis vs RabbitMQ for message queuing&quot;</span><br></span></code></pre></div></div><p><strong>How it works:</strong></p><ol>
<li class="">Multiple AI models analyze independently</li>
<li class="">Each provides unique insights and recommendations</li>
<li class="">Results are synthesized into a comprehensive analysis</li>
<li class="">You get multiple perspectives before making decisions</li>
</ol><p><strong>Best for:</strong></p><ul>
<li class="">Technology selection</li>
<li class="">Architecture decisions</li>
<li class="">Solution comparison</li>
<li class="">Trade-off analysis</li>
</ul></div></div></details>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="testing">Testing<a href="#testing" class="hash-link" aria-label="Direct link to Testing" title="Direct link to Testing" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-add-tests-to-existing-code">How do I add tests to existing code?<a href="#how-do-i-add-tests-to-existing-code" class="hash-link" aria-label="Direct link to How do I add tests to existing code?" title="Direct link to How do I add tests to existing code?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Test Generation</summary><p><strong>Session Mode (from existing session):</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw test-fix-gen WFS-user-auth-v2</span><br></span></code></pre></div></div><p><strong>Prompt Mode (direct description):</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw test-fix-gen </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Add unit tests for the auth API&quot;</span><br></span></code></pre></div></div><p><strong>CCW will:</strong></p><ol>
<li class="">Analyze the code structure</li>
<li class="">Generate appropriate test cases</li>
<li class="">Create test files following project patterns</li>
<li class="">Implement tests with proper assertions</li>
</ol></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-fix-failing-tests">How do I fix failing tests?<a href="#how-do-i-fix-failing-tests" class="hash-link" aria-label="Direct link to How do I fix failing tests?" title="Direct link to How do I fix failing tests?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Test Fix Workflow</summary><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Generate test fix tasks</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw test-fix-gen </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Tests failing for user registration&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Execute test-fix cycle</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw test-cycle-execute</span><br></span></code></pre></div></div><p><strong>Workflow:</strong></p><ol>
<li class="">Analyze test failures</li>
<li class="">Identify root causes</li>
<li class="">Fix issues iteratively</li>
<li class="">Verify &gt;= 95% pass rate</li>
<li class="">Stop when tests pass or max iterations reached</li>
</ol></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-is-tdd-test-driven-development">What is TDD (Test-Driven Development)?<a href="#what-is-tdd-test-driven-development" class="hash-link" aria-label="Direct link to What is TDD (Test-Driven Development)?" title="Direct link to What is TDD (Test-Driven Development)?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>TDD Explanation</summary><p><strong>TDD</strong> follows the Red-Green-Refactor cycle:</p><ol>
<li class=""><strong>Red</strong>: Write a failing test</li>
<li class=""><strong>Green</strong>: Write minimal code to pass the test</li>
<li class=""><strong>Refactor</strong>: Improve code while keeping tests green</li>
</ol><p><strong>The Iron Law:</strong></p><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST</span><br></span></code></pre></div></div><p><strong>Why write tests first?</strong></p><table><thead><tr><th>Aspect</th><th>Test-First</th><th>Test-After</th></tr></thead><tbody><tr><td><strong>Proof</strong></td><td>Tests fail before implementation</td><td>Tests pass immediately (proves nothing)</td></tr><tr><td><strong>Discovery</strong></td><td>Edge cases found before coding</td><td>Edge cases found after coding</td></tr><tr><td><strong>Verification</strong></td><td>Verifies requirements</td><td>Verifies implementation</td></tr></tbody></table></div></div></details>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="troubleshooting">Troubleshooting<a href="#troubleshooting" class="hash-link" aria-label="Direct link to Troubleshooting" title="Direct link to Troubleshooting" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="my-workflow-failed-what-should-i-do">My workflow failed. What should I do?<a href="#my-workflow-failed-what-should-i-do" class="hash-link" aria-label="Direct link to My workflow failed. What should I do?" title="Direct link to My workflow failed. What should I do?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Troubleshooting Steps</summary><ol>
<li class=""><strong>Check the error message</strong> - Identify the root cause</li>
<li class=""><strong>Review session state</strong> - Check <code>.workflow/.ccw-coordinator/{session}/state.json</code></li>
<li class=""><strong>Resume the session</strong> - Use <code>ccw workflow:session:resume</code> to continue</li>
<li class=""><strong>Adjust and retry</strong> - Modify approach based on error</li>
</ol><p><strong>Common fixes:</strong></p><ul>
<li class=""><strong>API key errors</strong>: Verify environment variables are set</li>
<li class=""><strong>Module not found</strong>: Run <code>npm install</code> or <code>pip install</code></li>
<li class=""><strong>Git errors</strong>: Ensure clean git state (<code>git status</code>)</li>
<li class=""><strong>Timeout errors</strong>: Increase timeout in task JSON</li>
</ul></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-skip-a-failing-task">How do I skip a failing task?<a href="#how-do-i-skip-a-failing-task" class="hash-link" aria-label="Direct link to How do I skip a failing task?" title="Direct link to How do I skip a failing task?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Skip Task</summary><p>Edit the task JSON to set status to &quot;completed&quot;:</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">jq </span><span class="token string" style="color:rgb(195, 232, 141)">&#x27;.status = &quot;completed&quot;&#x27;</span><span class="token plain"> .workflow/active/WFS-</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain">session</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain">/.task/IMPL-001.json</span><br></span></code></pre></div></div><p><strong>Use with caution:</strong> Skipping tasks may leave the workflow in an incomplete state.</p></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-clean-up-old-sessions">How do I clean up old sessions?<a href="#how-do-i-clean-up-old-sessions" class="hash-link" aria-label="Direct link to How do I clean up old sessions?" title="Direct link to How do I clean up old sessions?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Cleanup Commands</summary><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># List sessions</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw workflow:session:list</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Remove specific session</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token function" style="color:rgb(130, 170, 255)">rm</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-rf</span><span class="token plain"> .workflow/active/WFS-</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain">session-id</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Clean all completed sessions</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw workflow:clean</span><br></span></code></pre></div></div><p><strong>Automatic cleanup:</strong></p><ul>
<li class="">Completed sessions are archived to <code>.workflow/completed/</code></li>
<li class="">Old sessions (&gt; 30 days) can be safely removed</li>
</ul></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="why-is-my-workflow-running-slowly">Why is my workflow running slowly?<a href="#why-is-my-workflow-running-slowly" class="hash-link" aria-label="Direct link to Why is my workflow running slowly?" title="Direct link to Why is my workflow running slowly?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Performance Tips</summary><p><strong>Possible causes:</strong></p><ol>
<li class="">
<p><strong>Large codebase</strong>: CCW analyzes the entire project</p>
<ul>
<li class=""><strong>Fix</strong>: Use <code>--focus-paths</code> to limit analysis scope</li>
</ul>
</li>
<li class="">
<p><strong>Many dependencies</strong>: Slow AI response times</p>
<ul>
<li class=""><strong>Fix</strong>: Use faster models (Gemini Flash) for initial analysis</li>
</ul>
</li>
<li class="">
<p><strong>Sequential tasks</strong>: Waiting on dependent tasks</p>
<ul>
<li class=""><strong>Fix</strong>: Review task dependencies in <code>plan-verify</code></li>
</ul>
</li>
<li class="">
<p><strong>Network issues</strong>: Slow API calls to AI services</p>
<ul>
<li class=""><strong>Fix</strong>: Check network connectivity and API status</li>
</ul>
</li>
</ol><p><strong>Optimization tips:</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Limit analysis scope</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw plan </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Add login&quot;</span><span class="token plain"> --focus-paths src/auth</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Use faster model for initial analysis</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw cli </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-p</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Quick analysis&quot;</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--model</span><span class="token plain"> gemini-2.0-flash </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--mode</span><span class="token plain"> analysis</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Run in parallel when possible</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw workflow:execute </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--parallel</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">4</span><br></span></code></pre></div></div></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-debug-workflow-issues">How do I debug workflow issues?<a href="#how-do-i-debug-workflow-issues" class="hash-link" aria-label="Direct link to How do I debug workflow issues?" title="Direct link to How do I debug workflow issues?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Debugging Workflow</summary><p><strong>Enable debug logging:</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token assign-left variable" style="color:rgb(191, 199, 213)">DEBUG</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">ccw:* ccw workflow:plan </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;My feature&quot;</span><br></span></code></pre></div></div><p><strong>Check session logs:</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># View session state</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token function" style="color:rgb(130, 170, 255)">cat</span><span class="token plain"> .workflow/active/WFS-</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain">session</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain">/workflow-session.json</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># View task progress</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token function" style="color:rgb(130, 170, 255)">cat</span><span class="token plain"> .workflow/active/WFS-</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain">session</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain">/TODO_LIST.md</span><br></span></code></pre></div></div><p><strong>Use debug workflow:</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw workflow:debug-with-file </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Debug memory leak in connection handler&quot;</span><br></span></code></pre></div></div><p>This provides hypothesis-driven debugging with documented exploration.</p></div></div></details>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="integration">Integration<a href="#integration" class="hash-link" aria-label="Direct link to Integration" title="Direct link to Integration" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="can-i-use-ccw-with-my-existing-cicd">Can I use CCW with my existing CI/CD?<a href="#can-i-use-ccw-with-my-existing-cicd" class="hash-link" aria-label="Direct link to Can I use CCW with my existing CI/CD?" title="Direct link to Can I use CCW with my existing CI/CD?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>CI/CD Integration</summary><p>Yes, CCW can be integrated into CI/CD pipelines:</p><p><strong>GitHub Actions Example:</strong></p><div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> Run CCW Workflow</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> </span><span class="token key atrule">run</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">|</span><span class="token scalar string" style="color:rgb(195, 232, 141)"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token scalar string" style="color:rgb(195, 232, 141)"> ccw workflow:plan &quot;Implement feature&quot;</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token scalar string" style="color:rgb(195, 232, 141)"> ccw workflow:execute --session WFS-feature</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> </span><span class="token key atrule">env</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> </span><span class="token key atrule">GEMINI_API_KEY</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> secrets.GEMINI_API_KEY </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p><strong>Best practices:</strong></p><ul>
<li class="">Use <code>--mode analysis</code> for code review in CI</li>
<li class="">Store API keys in secret management</li>
<li class="">Run workflows in isolated environments</li>
<li class="">Archive sessions for audit trails</li>
</ul></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="can-ccw-work-with-monorepos">Can CCW work with monorepos?<a href="#can-ccw-work-with-monorepos" class="hash-link" aria-label="Direct link to Can CCW work with monorepos?" title="Direct link to Can CCW work with monorepos?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Monorepo Support</summary><p>Yes, CCW supports monorepos:</p><p><strong>Workspace-aware execution:</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Execute in specific package</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw plan </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Add auth to frontend&quot;</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--cd</span><span class="token plain"> packages/frontend</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Execute across packages</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw plan </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Update API contracts&quot;</span><span class="token plain"> --include-dir packages/api,packages/shared</span><br></span></code></pre></div></div><p><strong>Benefits:</strong></p><ul>
<li class="">Dependency-aware task distribution</li>
<li class="">Parallel execution across packages</li>
<li class="">Shared session state</li>
<li class="">Coordinated changes across workspaces</li>
</ul></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-migrate-from-another-tool">How do I migrate from another tool?<a href="#how-do-i-migrate-from-another-tool" class="hash-link" aria-label="Direct link to How do I migrate from another tool?" title="Direct link to How do I migrate from another tool?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Migration Guide</summary><p><strong>From basic Git workflows:</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Before: Manual planning</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token function" style="color:rgb(130, 170, 255)">git</span><span class="token plain"> checkout </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-b</span><span class="token plain"> feature</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># ... manual planning ...</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># After: CCW planning</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw plan </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Add feature&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw execute </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--session</span><span class="token plain"> WFS-feature</span><br></span></code></pre></div></div><p><strong>From other AI tools:</strong></p><ul>
<li class="">CCW provides structured workflows (vs. ad-hoc prompts)</li>
<li class="">Session management (vs. chat history)</li>
<li class="">Multi-agent coordination (vs. single AI)</li>
<li class="">Persistent artifacts (vs. transient responses)</li>
</ul><p><strong>Migration steps:</strong></p><ol>
<li class="">Install CCW: <code>npm install -g @ccw/cli</code></li>
<li class="">Initialize: <code>ccw init</code></li>
<li class="">Start with Level 2 workflows for familiar patterns</li>
<li class="">Gradually adopt higher levels as needed</li>
</ol></div></div></details>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="best-practices">Best Practices<a href="#best-practices" class="hash-link" aria-label="Direct link to Best Practices" title="Direct link to Best Practices" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-are-the-workflow-best-practices">What are the workflow best practices?<a href="#what-are-the-workflow-best-practices" class="hash-link" aria-label="Direct link to What are the workflow best practices?" title="Direct link to What are the workflow best practices?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>Best Practices</summary><p><strong>1. Start Simple</strong></p><ul>
<li class="">Use the lowest level that meets your needs</li>
<li class="">Don&#x27;t over-engineer simple tasks</li>
<li class="">Scale up complexity as needed</li>
</ul><p><strong>2. Plan Before Executing</strong></p><ul>
<li class="">Use verification steps when available</li>
<li class="">Review generated plans before execution</li>
<li class="">Adjust tasks based on project context</li>
</ul><p><strong>3. Test Continuously</strong></p><ul>
<li class="">Integrate testing into your workflow</li>
<li class="">Use TDD for critical features</li>
<li class="">Run tests after each iteration</li>
</ul><p><strong>4. Review Code</strong></p><ul>
<li class="">Use built-in review workflows</li>
<li class="">Leverage multi-CLI collaboration</li>
<li class="">Merge review feedback iteratively</li>
</ul><p><strong>5. Document Decisions</strong></p><ul>
<li class="">Use brainstorm workflows for complex decisions</li>
<li class="">Keep session artifacts for reference</li>
<li class="">Archive completed sessions</li>
</ul><p><strong>6. Maintain Session Hygiene</strong></p><ul>
<li class="">Complete sessions when done</li>
<li class="">Clean up old sessions regularly</li>
<li class="">Archive important sessions</li>
</ul></div></div></details>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-get-the-most-out-of-ai-assistance">How do I get the most out of AI assistance?<a href="#how-do-i-get-the-most-out-of-ai-assistance" class="hash-link" aria-label="Direct link to How do I get the most out of AI assistance?" title="Direct link to How do I get the most out of AI assistance?" translate="no">​</a></h3>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Details</summary><div><div class="collapsibleContent_VYua"><summary>AI Best Practices</summary><p><strong>1. Be Specific in Prompts</strong></p><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Bad: &quot;Fix the bug&quot;</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Good: &quot;Fix the 500 error when users update their profile picture&quot;</span><br></span></code></pre></div></div><p><strong>2. Provide Context</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw plan </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Add OAuth2&quot;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--context</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Using Express.js, MongoDB, Passport.js&quot;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--reference</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Similar to existing Google OAuth implementation&quot;</span><br></span></code></pre></div></div><p><strong>3. Use Multi-CLI Collaboration</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Get multiple perspectives</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw multi-cli-plan </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Architecture decision&quot;</span><br></span></code></pre></div></div><p><strong>4. Leverage Memory</strong></p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Build on previous work</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ccw plan </span><span class="token string" style="color:rgb(195, 232, 141)">&quot;Continue auth refactor&quot;</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--memory</span><span class="token plain"> WFS-auth-v1</span><br></span></code></pre></div></div><p><strong>5. Choose the Right Model</strong></p><ul>
<li class=""><strong>Gemini Flash</strong>: Fast, good for initial analysis</li>
<li class=""><strong>Gemini Pro</strong>: Deep reasoning, complex tasks</li>
<li class=""><strong>Codex</strong>: Code review, git-aware analysis</li>
<li class=""><strong>Claude</strong>: Documentation, complex reasoning</li>
</ul></div></div></details>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="related-documentation">Related Documentation<a href="#related-documentation" class="hash-link" aria-label="Direct link to Related Documentation" title="Direct link to Related Documentation" translate="no">​</a></h2>
<ul>
<li class=""><a class="" href="/docs/docs/workflows/introduction">Workflow Introduction</a> - Complete workflow guide</li>
<li class=""><a class="" href="/docs/docs/workflows/faq">Workflow FAQ</a> - Workflow-specific questions</li>
<li class=""><a class="" href="/docs/docs/commands/general/ccw">Command Reference</a> - All commands</li>
</ul>
<hr>
<p><strong>Still have questions?</strong> <a href="https://github.com/ccw/ccw/issues" target="_blank" rel="noopener noreferrer" class="">Open an issue</a> or check the <a href="https://github.com/ccw/ccw/discussions" target="_blank" rel="noopener noreferrer" class="">discussion forums</a>.</p></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/faq.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/workflows/level-5-intelligent"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Level 5: Intelligent</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="#general-questions" class="table-of-contents__link toc-highlight">General Questions</a><ul><li><a href="#what-is-ccw" class="table-of-contents__link toc-highlight">What is CCW?</a></li><li><a href="#what-are-the-system-requirements" class="table-of-contents__link toc-highlight">What are the system requirements?</a></li><li><a href="#how-do-i-install-ccw" class="table-of-contents__link toc-highlight">How do I install CCW?</a></li><li><a href="#is-ccw-free-to-use" class="table-of-contents__link toc-highlight">Is CCW free to use?</a></li><li><a href="#what-programming-languages-are-supported" class="table-of-contents__link toc-highlight">What programming languages are supported?</a></li></ul></li><li><a href="#workflow-selection" class="table-of-contents__link toc-highlight">Workflow Selection</a><ul><li><a href="#how-do-i-choose-the-right-workflow" class="table-of-contents__link toc-highlight">How do I choose the right workflow?</a></li><li><a href="#whats-the-difference-between-main-workflow-and-issue-workflow" class="table-of-contents__link toc-highlight">What&#39;s the difference between Main Workflow and Issue Workflow?</a></li><li><a href="#what-are-minimum-execution-units" class="table-of-contents__link toc-highlight">What are Minimum Execution Units?</a></li><li><a href="#when-should-i-use-each-workflow-level" class="table-of-contents__link toc-highlight">When should I use each workflow level?</a></li></ul></li><li><a href="#command-usage" class="table-of-contents__link toc-highlight">Command Usage</a><ul><li><a href="#how-do-i-use-workflow-commands" class="table-of-contents__link toc-highlight">How do I use workflow commands?</a></li><li><a href="#what-is-the-difference-between-lite-execute-and-execute" class="table-of-contents__link toc-highlight">What is the difference between lite-execute and execute?</a></li><li><a href="#how-do-i-use-hotfix-mode" class="table-of-contents__link toc-highlight">How do I use hotfix mode?</a></li><li><a href="#how-do-i-resume-a-paused-session" class="table-of-contents__link toc-highlight">How do I resume a paused session?</a></li></ul></li><li><a href="#ai-models" class="table-of-contents__link toc-highlight">AI Models</a><ul><li><a href="#which-ai-models-does-ccw-support" class="table-of-contents__link toc-highlight">Which AI models does CCW support?</a></li><li><a href="#how-do-i-configure-api-keys" class="table-of-contents__link toc-highlight">How do I configure API keys?</a></li><li><a href="#what-is-multi-cli-collaboration" class="table-of-contents__link toc-highlight">What is multi-CLI collaboration?</a></li></ul></li><li><a href="#testing" class="table-of-contents__link toc-highlight">Testing</a><ul><li><a href="#how-do-i-add-tests-to-existing-code" class="table-of-contents__link toc-highlight">How do I add tests to existing code?</a></li><li><a href="#how-do-i-fix-failing-tests" class="table-of-contents__link toc-highlight">How do I fix failing tests?</a></li><li><a href="#what-is-tdd-test-driven-development" class="table-of-contents__link toc-highlight">What is TDD (Test-Driven Development)?</a></li></ul></li><li><a href="#troubleshooting" class="table-of-contents__link toc-highlight">Troubleshooting</a><ul><li><a href="#my-workflow-failed-what-should-i-do" class="table-of-contents__link toc-highlight">My workflow failed. What should I do?</a></li><li><a href="#how-do-i-skip-a-failing-task" class="table-of-contents__link toc-highlight">How do I skip a failing task?</a></li><li><a href="#how-do-i-clean-up-old-sessions" class="table-of-contents__link toc-highlight">How do I clean up old sessions?</a></li><li><a href="#why-is-my-workflow-running-slowly" class="table-of-contents__link toc-highlight">Why is my workflow running slowly?</a></li><li><a href="#how-do-i-debug-workflow-issues" class="table-of-contents__link toc-highlight">How do I debug workflow issues?</a></li></ul></li><li><a href="#integration" class="table-of-contents__link toc-highlight">Integration</a><ul><li><a href="#can-i-use-ccw-with-my-existing-cicd" class="table-of-contents__link toc-highlight">Can I use CCW with my existing CI/CD?</a></li><li><a href="#can-ccw-work-with-monorepos" class="table-of-contents__link toc-highlight">Can CCW work with monorepos?</a></li><li><a href="#how-do-i-migrate-from-another-tool" class="table-of-contents__link toc-highlight">How do I migrate from another tool?</a></li></ul></li><li><a href="#best-practices" class="table-of-contents__link toc-highlight">Best Practices</a><ul><li><a href="#what-are-the-workflow-best-practices" class="table-of-contents__link toc-highlight">What are the workflow best practices?</a></li><li><a href="#how-do-i-get-the-most-out-of-ai-assistance" class="table-of-contents__link toc-highlight">How do I get the most out of AI assistance?</a></li></ul></li><li><a href="#related-documentation" class="table-of-contents__link toc-highlight">Related Documentation</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>
Reference in New Issue View Git Blame Copy Permalink