mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-04 01:40:45 +08:00
- 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.
116 lines
63 KiB
HTML
116 lines
63 KiB
HTML
<!doctype html>
|
||
<html lang="en" dir="ltr" class="docs-wrapper plugin-docs plugin-id-default docs-version-current docs-doc-page docs-doc-id-commands/general/ccw-debug" data-has-hydrated="false">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="generator" content="Docusaurus v3.9.2">
|
||
<title data-rh="true">/ccw-debug | 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/commands/general/ccw-debug"><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="/ccw-debug | CCW Help Documentation"><meta data-rh="true" name="description" content="Debug coordinator for intelligent debugging workflows"><meta data-rh="true" property="og:description" content="Debug coordinator for intelligent debugging workflows"><link data-rh="true" rel="icon" href="/docs/img/favicon.ico"><link data-rh="true" rel="canonical" href="http://localhost:3001/docs/docs/commands/general/ccw-debug"><link data-rh="true" rel="alternate" href="http://localhost:3001/docs/docs/commands/general/ccw-debug" hreflang="en"><link data-rh="true" rel="alternate" href="http://localhost:3001/docs/zh/docs/commands/general/ccw-debug" hreflang="zh"><link data-rh="true" rel="alternate" href="http://localhost:3001/docs/docs/commands/general/ccw-debug" hreflang="x-default"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"/ccw-debug","item":"http://localhost:3001/docs/docs/commands/general/ccw-debug"}]}</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/commands/general/ccw-debug" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en">English</a></li><li><a href="/docs/zh/docs/commands/general/ccw-debug" 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 menu__link--active" 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 menu__link--active" 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 menu__link--active" aria-current="page" 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" href="/docs/docs/faq"><span title="FAQ" class="linkLabel_PuAu">FAQ</span></a></li></ul></nav></div></div></aside><main class="docMainContainer_namt"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_YAwJ"><div class="docItemContainer_Rv5Z"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_zCmv" aria-label="Breadcrumbs"><ul class="breadcrumbs"><li class="breadcrumbs__item"><span class="breadcrumbs__link">Commands</span></li><li class="breadcrumbs__item"><span class="breadcrumbs__link">General Commands</span></li><li class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link">/ccw-debug</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>/ccw-debug</h1></header>
|
||
<p>Debug coordinator - analyzes issues, selects debug strategy, and executes debug workflow in the main process.</p>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="overview">Overview<a href="#overview" class="hash-link" aria-label="Direct link to Overview" title="Direct link to Overview" translate="no"></a></h2>
|
||
<p>The <code>/ccw-debug</code> command orchestrates debugging workflows by analyzing issue descriptions, selecting appropriate debug strategies, and executing targeted command chains.</p>
|
||
<p><strong>Parameters</strong>:</p>
|
||
<ul>
|
||
<li class=""><code>--mode &lt;mode&gt;</code>: Debug mode (cli, debug, test, bidirectional)</li>
|
||
<li class=""><code>--yes|-y</code>: Skip confirmation prompts</li>
|
||
<li class=""><code>"bug description"</code>: Issue to debug (required)</li>
|
||
</ul>
|
||
<p><strong>Core Concept</strong>: Debug Units - commands grouped into logical units for different root cause strategies.</p>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="features">Features<a href="#features" class="hash-link" aria-label="Direct link to Features" title="Direct link to Features" translate="no"></a></h2>
|
||
<ul>
|
||
<li class=""><strong>Issue Analysis</strong> - Extracts symptoms, occurrence patterns, affected components</li>
|
||
<li class=""><strong>Strategy Selection</strong> - Auto-selects based on keywords and complexity</li>
|
||
<li class=""><strong>Debug Units</strong> - 4 debug modes for different scenarios</li>
|
||
<li class=""><strong>Parallel Execution</strong> - Bidirectional mode for complex issues</li>
|
||
<li class=""><strong>State Tracking</strong> - TODO and status file tracking</li>
|
||
</ul>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="usage">Usage<a href="#usage" class="hash-link" aria-label="Direct link to Usage" title="Direct link to Usage" translate="no"></a></h2>
|
||
<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"># Auto-select mode (keyword-based detection)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/ccw-debug </span><span class="token string" style="color:rgb(195, 232, 141)">"Login timeout error"</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"># Explicit mode selection</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/ccw-debug </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--mode</span><span class="token plain"> cli </span><span class="token string" style="color:rgb(195, 232, 141)">"Quick API question"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/ccw-debug </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--mode</span><span class="token plain"> debug </span><span class="token string" style="color:rgb(195, 232, 141)">"User authentication fails"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/ccw-debug </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--mode</span><span class="token plain"> </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">test</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"Unit tests failing"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/ccw-debug </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--mode</span><span class="token plain"> bidirectional </span><span class="token string" style="color:rgb(195, 232, 141)">"Complex multi-module issue"</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"># Skip confirmation</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/ccw-debug </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--yes</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"Fix typo in config"</span><br></span></code></pre></div></div>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="debug-modes">Debug Modes<a href="#debug-modes" class="hash-link" aria-label="Direct link to Debug Modes" title="Direct link to Debug Modes" translate="no"></a></h2>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="cli-mode">CLI Mode<a href="#cli-mode" class="hash-link" aria-label="Direct link to CLI Mode" title="Direct link to CLI Mode" translate="no"></a></h3>
|
||
<p><strong>Use for</strong>: Quick analysis, simple questions, early diagnosis</p>
|
||
<p><strong>Command Chain</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">ccw cli --mode analysis --rule analysis-diagnose-bug-root-ause</span><br></span></code></pre></div></div>
|
||
<p><strong>Characteristics</strong>:</p>
|
||
<ul>
|
||
<li class="">Analysis only</li>
|
||
<li class="">No code changes</li>
|
||
<li class="">Returns findings and recommendations</li>
|
||
</ul>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="debug-mode">Debug Mode<a href="#debug-mode" class="hash-link" aria-label="Direct link to Debug Mode" title="Direct link to Debug Mode" translate="no"></a></h3>
|
||
<p><strong>Use for</strong>: Standard bug diagnosis and fix</p>
|
||
<p><strong>Command Chain</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">/workflow:debug-with-file</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/workflow:test-fix-gen</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/workflow:test-cycle-execute</span><br></span></code></pre></div></div>
|
||
<p><strong>Characteristics</strong>:</p>
|
||
<ul>
|
||
<li class="">Hypothesis-driven debugging</li>
|
||
<li class="">Test generation</li>
|
||
<li class="">Iterative fixing</li>
|
||
</ul>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="test-mode">Test Mode<a href="#test-mode" class="hash-link" aria-label="Direct link to Test Mode" title="Direct link to Test Mode" translate="no"></a></h3>
|
||
<p><strong>Use for</strong>: Test failures, test validation</p>
|
||
<p><strong>Command Chain</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">/workflow:test-fix-gen</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/workflow:test-cycle-execute</span><br></span></code></pre></div></div>
|
||
<p><strong>Characteristics</strong>:</p>
|
||
<ul>
|
||
<li class="">Test-focused</li>
|
||
<li class="">Fix in testing</li>
|
||
<li class="">Iterative until pass</li>
|
||
</ul>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="bidirectional-mode">Bidirectional Mode<a href="#bidirectional-mode" class="hash-link" aria-label="Direct link to Bidirectional Mode" title="Direct link to Bidirectional Mode" translate="no"></a></h3>
|
||
<p><strong>Use for</strong>: Complex issues requiring multiple perspectives</p>
|
||
<p><strong>Command Chain</strong> (Parallel):</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">/workflow:debug-with-file ∥ /workflow:test-fix-gen ∥ /workflow:test-cycle-execute</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ↓</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> Merge findings</span><br></span></code></pre></div></div>
|
||
<p><strong>Characteristics</strong>:</p>
|
||
<ul>
|
||
<li class="">Parallel execution</li>
|
||
<li class="">Multiple perspectives</li>
|
||
<li class="">Merged findings</li>
|
||
</ul>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="debug-units">Debug Units<a href="#debug-units" class="hash-link" aria-label="Direct link to Debug Units" title="Direct link to Debug Units" translate="no"></a></h2>
|
||
<table><thead><tr><th>Unit Name</th><th>Commands</th><th>Purpose</th></tr></thead><tbody><tr><td><strong>Quick Analysis</strong></td><td>ccw cli (analysis)</td><td>Quick diagnosis</td></tr><tr><td><strong>Standard Debug</strong></td><td>debug-with-file → test-fix-gen → test-cycle-execute</td><td>Full debug cycle</td></tr><tr><td><strong>Test Fix</strong></td><td>test-fix-gen → test-cycle-execute</td><td>Test-focused fix</td></tr><tr><td><strong>Comprehensive</strong></td><td>(debug ∥ test ∥ test-cycle) → merge</td><td>Multi-perspective</td></tr></tbody></table>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="execution-flow">Execution Flow<a href="#execution-flow" class="hash-link" aria-label="Direct link to Execution Flow" title="Direct link to Execution Flow" translate="no"></a></h2>
|
||
<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">User Input: "bug description"</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ↓</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Phase 1: Analyze Issue</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ├─ Extract: description, error_type, clarity, complexity, scope</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> └─ If clarity < 2 → Phase 1.5: Clarify Issue</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ↓</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Phase 2: Select Debug Strategy & Build Chain</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ├─ Detect mode: cli | debug | test | bidirectional</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ├─ Build command chain based on mode</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> └─ Parallel execution for bidirectional</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ↓</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Phase 3: User Confirmation (optional)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ├─ Show debug strategy</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> └─ Allow mode change</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ↓</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Phase 4: Setup TODO Tracking & Status File</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ├─ Create todos with CCWD prefix</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> └─ Initialize .workflow/.ccw-debug/{session_id}/status.json</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ↓</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Phase 5: Execute Debug Chain</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ├─ Sequential: execute commands in order</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ├─ Bidirectional: execute debug + test in parallel</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ├─ CLI: present findings, ask for escalation</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> └─ Merge findings (bidirectional)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ↓</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Update status and TODO</span><br></span></code></pre></div></div>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="mode-detection">Mode Detection<a href="#mode-detection" class="hash-link" aria-label="Direct link to Mode Detection" title="Direct link to Mode Detection" translate="no"></a></h2>
|
||
<table><thead><tr><th>Keywords</th><th>Detected Mode</th></tr></thead><tbody><tr><td>quick, simple, question, what, how</td><td>cli</td></tr><tr><td>bug, error, fail, crash, timeout</td><td>debug</td></tr><tr><td>test, unit test, coverage, assertion</td><td>test</td></tr><tr><td>complex, multiple, module, integration</td><td>bidirectional</td></tr></tbody></table>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="debug-pipeline-examples">Debug Pipeline Examples<a href="#debug-pipeline-examples" class="hash-link" aria-label="Direct link to Debug Pipeline Examples" title="Direct link to Debug Pipeline Examples" translate="no"></a></h2>
|
||
<table><thead><tr><th>Issue</th><th>Mode</th><th>Pipeline</th></tr></thead><tbody><tr><td>"Login timeout error (quick)"</td><td>cli</td><td>ccw cli → analysis → (escalate or done)</td></tr><tr><td>"User login fails intermittently"</td><td>debug</td><td>debug-with-file → test-gen → test-cycle</td></tr><tr><td>"Authentication tests failing"</td><td>test</td><td>test-fix-gen → test-cycle-execute</td></tr><tr><td>"Multi-module auth + db sync issue"</td><td>bidirectional</td><td>(debug ∥ test) → merge findings</td></tr></tbody></table>
|
||
<p><strong>Legend</strong>: <code>∥</code> = parallel execution</p>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="state-management">State Management<a href="#state-management" class="hash-link" aria-label="Direct link to State Management" title="Direct link to State Management" translate="no"></a></h2>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="dual-tracking-system">Dual Tracking System<a href="#dual-tracking-system" class="hash-link" aria-label="Direct link to Dual Tracking System" title="Direct link to Dual Tracking System" translate="no"></a></h3>
|
||
<p><strong>1. TodoWrite-Based Tracking</strong> (UI Display):</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">CCWD:debug: </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token plain">/3</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"> /workflow:debug-with-file </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">in_progress</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">CCWD:debug: </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token number" style="color:rgb(247, 140, 108)">2</span><span class="token plain">/3</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"> /workflow:test-fix-gen </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">pending</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">CCWD:debug: </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token number" style="color:rgb(247, 140, 108)">3</span><span class="token plain">/3</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"> /workflow:test-cycle-execute </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">pending</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><br></span></code></pre></div></div>
|
||
<p><strong>2. Status File</strong> (Internal State):</p>
|
||
<div class="language-json codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-json 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><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> </span><span class="token property">"session_id"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"CCWD-..."</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 property">"mode"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"debug|cli|test|bidirectional"</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 property">"status"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"running"</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 property">"parallel_execution"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain">|</span><span class="token boolean" style="color:rgb(255, 88, 116)">true</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 property">"issue"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</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 property">"description"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"..."</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 property">"error_type"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"..."</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 property">"clarity"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token number" style="color:rgb(247, 140, 108)">-5</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 property">"complexity"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"low|medium|high"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><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"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> </span><span class="token property">"command_chain"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</span><span class="token plain"> </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"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> </span><span class="token property">"findings"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</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 property">"debug"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</span><span class="token plain"> </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"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> </span><span class="token property">"test"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</span><span class="token plain"> </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"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> </span><span class="token property">"merged"</span><span class="token operator" style="color:rgb(137, 221, 255)">:</span><span class="token plain"> </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 plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><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 punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="examples">Examples<a href="#examples" class="hash-link" aria-label="Direct link to Examples" title="Direct link to Examples" translate="no"></a></h2>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="cli-mode-1">CLI Mode<a href="#cli-mode-1" class="hash-link" aria-label="Direct link to CLI Mode" title="Direct link to CLI Mode" 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"># Quick analysis</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/ccw-debug </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--mode</span><span class="token plain"> cli </span><span class="token string" style="color:rgb(195, 232, 141)">"Why is the API returning 500?"</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"># Output:</span><span class="token plain"></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"># Executing CLI analysis...</span><span class="token plain"></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"># Analysis complete:</span><span class="token plain"></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"># - Root cause: Database connection timeout</span><span class="token plain"></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"># - Recommendation: Increase connection pool size</span><span class="token plain"></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"># Escalate to debug mode? (y/n): y</span><br></span></code></pre></div></div>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="debug-mode-1">Debug Mode<a href="#debug-mode-1" class="hash-link" aria-label="Direct link to Debug Mode" title="Direct link to Debug Mode" 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"># Standard debugging</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/ccw-debug </span><span class="token string" style="color:rgb(195, 232, 141)">"User login fails intermittently"</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"># Output:</span><span class="token plain"></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"># Analyzing issue...</span><span class="token plain"></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"># Mode detected: debug</span><span class="token plain"></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"># Command chain:</span><span class="token plain"></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"># 1. /workflow:debug-with-file</span><span class="token plain"></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"># 2. /workflow:test-fix-gen</span><span class="token plain"></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"># 3. /workflow:test-cycle-execute</span><span class="token plain"></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"># Confirm? (y/n): y</span><span class="token plain"></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">#</span><span class="token plain"></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"># CCWD:debug: [1/3] /workflow:debug-with-file [in_progress]</span><span class="token plain"></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"># ...</span><br></span></code></pre></div></div>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="bidirectional-mode-1">Bidirectional Mode<a href="#bidirectional-mode-1" class="hash-link" aria-label="Direct link to Bidirectional Mode" title="Direct link to Bidirectional Mode" 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"># Complex issue</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/ccw-debug </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--mode</span><span class="token plain"> bidirectional </span><span class="token string" style="color:rgb(195, 232, 141)">"Multi-module auth + database sync issue"</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"># Output:</span><span class="token plain"></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"># Analyzing issue...</span><span class="token plain"></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"># Mode: bidirectional (parallel execution)</span><span class="token plain"></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"># Command chain:</span><span class="token plain"></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"># Branch A: /workflow:debug-with-file</span><span class="token plain"></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"># Branch B: /workflow:test-fix-gen</span><span class="token plain"></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"># Branch C: /workflow:test-cycle-execute</span><span class="token plain"></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"># → Merge findings</span><span class="token plain"></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"># Confirm? (y/n): y</span><span class="token plain"></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">#</span><span class="token plain"></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"># Executing branches in parallel...</span><span class="token plain"></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"># Merging findings...</span><span class="token plain"></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"># Final recommendations: ...</span><br></span></code></pre></div></div>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="related-commands">Related Commands<a href="#related-commands" class="hash-link" aria-label="Direct link to Related Commands" title="Direct link to Related Commands" translate="no"></a></h2>
|
||
<ul>
|
||
<li class=""><strong>/workflow<!-- -->:debug-with-file</strong> - Hypothesis-driven debugging</li>
|
||
<li class=""><strong>/workflow<!-- -->:test-fix-gen</strong> - Test fix generation</li>
|
||
<li class=""><strong>/workflow<!-- -->:test-cycle-execute</strong> - Test cycle execution</li>
|
||
<li class=""><strong>/ccw</strong> - Main workflow coordinator</li>
|
||
</ul>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="notes">Notes<a href="#notes" class="hash-link" aria-label="Direct link to Notes" title="Direct link to Notes" translate="no"></a></h2>
|
||
<ul>
|
||
<li class=""><strong>Auto mode detection</strong> based on keywords</li>
|
||
<li class=""><strong>Debug units</strong> ensure complete debugging milestones</li>
|
||
<li class=""><strong>TODO tracking</strong> with CCWD prefix</li>
|
||
<li class=""><strong>Status file</strong> in <code>.workflow/.ccw-debug/{session}/</code></li>
|
||
<li class=""><strong>Parallel execution</strong> for bidirectional mode</li>
|
||
<li class=""><strong>Merge findings</strong> combines multiple perspectives</li>
|
||
<li class=""><strong>Escalation support</strong> from CLI to other modes</li>
|
||
</ul></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="row margin-top--sm theme-doc-footer-edit-meta-row"><div class="col noPrint_HJkF"><a href="https://github.com/ccw/docs/tree/main/docs/commands/general/ccw-debug.mdx" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_UohW" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_g62E"></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/docs/commands/general/ccw-coordinator"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">/ccw-coordinator</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/docs/commands/general/flow-create"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">/flow-create</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="#overview" class="table-of-contents__link toc-highlight">Overview</a></li><li><a href="#features" class="table-of-contents__link toc-highlight">Features</a></li><li><a href="#usage" class="table-of-contents__link toc-highlight">Usage</a></li><li><a href="#debug-modes" class="table-of-contents__link toc-highlight">Debug Modes</a><ul><li><a href="#cli-mode" class="table-of-contents__link toc-highlight">CLI Mode</a></li><li><a href="#debug-mode" class="table-of-contents__link toc-highlight">Debug Mode</a></li><li><a href="#test-mode" class="table-of-contents__link toc-highlight">Test Mode</a></li><li><a href="#bidirectional-mode" class="table-of-contents__link toc-highlight">Bidirectional Mode</a></li></ul></li><li><a href="#debug-units" class="table-of-contents__link toc-highlight">Debug Units</a></li><li><a href="#execution-flow" class="table-of-contents__link toc-highlight">Execution Flow</a></li><li><a href="#mode-detection" class="table-of-contents__link toc-highlight">Mode Detection</a></li><li><a href="#debug-pipeline-examples" class="table-of-contents__link toc-highlight">Debug Pipeline Examples</a></li><li><a href="#state-management" class="table-of-contents__link toc-highlight">State Management</a><ul><li><a href="#dual-tracking-system" class="table-of-contents__link toc-highlight">Dual Tracking System</a></li></ul></li><li><a href="#examples" class="table-of-contents__link toc-highlight">Examples</a><ul><li><a href="#cli-mode-1" class="table-of-contents__link toc-highlight">CLI Mode</a></li><li><a href="#debug-mode-1" class="table-of-contents__link toc-highlight">Debug Mode</a></li><li><a href="#bidirectional-mode-1" class="table-of-contents__link toc-highlight">Bidirectional Mode</a></li></ul></li><li><a href="#related-commands" class="table-of-contents__link toc-highlight">Related Commands</a></li><li><a href="#notes" class="table-of-contents__link toc-highlight">Notes</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> |