mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-04 01:40:45 +08:00
c6093ef741
- 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.
203 lines
49 KiB
HTML
203 lines
49 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-workflows/faq" data-has-hydrated="false">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="generator" content="Docusaurus v3.9.2">
|
||
<title data-rh="true">Workflow FAQ | CCW Help Documentation</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="http://localhost:3001/docs/docs/workflows/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="Workflow FAQ | CCW Help Documentation"><meta data-rh="true" name="description" content="Frequently asked questions about CCW workflows"><meta data-rh="true" property="og:description" content="Frequently asked questions about CCW workflows"><link data-rh="true" rel="icon" href="/docs/img/favicon.ico"><link data-rh="true" rel="canonical" href="http://localhost:3001/docs/docs/workflows/faq"><link data-rh="true" rel="alternate" href="http://localhost:3001/docs/docs/workflows/faq" hreflang="en"><link data-rh="true" rel="alternate" href="http://localhost:3001/docs/zh/docs/workflows/faq" hreflang="zh"><link data-rh="true" rel="alternate" href="http://localhost:3001/docs/docs/workflows/faq" hreflang="x-default"><link rel="stylesheet" href="/docs/assets/css/styles.43777f0a.css">
|
||
<script src="/docs/assets/js/runtime~main.0220a52f.js" defer="defer"></script>
|
||
<script src="/docs/assets/js/main.d2194b90.js" defer="defer"></script>
|
||
</head>
|
||
<body class="navigation-with-keyboard">
|
||
<svg style="display: none;"><defs>
|
||
<symbol id="theme-svg-external-link" viewBox="0 0 24 24"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol>
|
||
</defs></svg>
|
||
<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||"light"),document.documentElement.setAttribute("data-theme-choice",t||"light")}(),function(){try{const c=new URLSearchParams(window.location.search).entries();for(var[t,e]of c)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><div id="__docusaurus"><div role="region" aria-label="Skip to main content"><a class="skipToContent_G6ar" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="theme-layout-navbar navbar navbar--fixed-top"><div class="navbar__inner"><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/docs/"><div class="navbar__logo"><img src="/docs/img/logo.svg" alt="CCW Logo" class="themedComponent_DHUr themedComponent--light_DIHH"><img src="/docs/img/logo.svg" alt="CCW Logo" class="themedComponent_DHUr themedComponent--dark_Bv2M"></div><b class="navbar__title text--truncate">CCW Help</b></a></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link"><svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" class="iconLanguage_xrmG"><path fill="currentColor" d="M12.87 15.07l-2.54-2.51.03-.03c1.74-1.94 2.98-4.17 3.71-6.53H17V4h-7V2H8v2H1v1.99h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12zm-2.62 7l1.62-4.33L19.12 17h-3.24z"></path></svg>English</a><ul class="dropdown__menu"><li><a href="/docs/docs/workflows/faq" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en">English</a></li><li><a href="/docs/zh/docs/workflows/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"><main class="docMainContainer_namt docMainContainerEnhanced_sRjM"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_YAwJ"><div class="docItemContainer_Rv5Z"><article><div class="tocCollapsible_O_Qc theme-doc-toc-mobile tocMobile_tjDr"><button type="button" class="clean-btn tocCollapsibleButton_htYj">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Workflow FAQ</h1></header>
|
||
<p>Common questions and answers about CCW workflows.</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-the-difference-between-main-workflow-and-issue-workflow">What is the difference between Main Workflow and Issue Workflow?<a href="#what-is-the-difference-between-main-workflow-and-issue-workflow" class="hash-link" aria-label="Direct link to What is the difference between Main Workflow and Issue Workflow?" title="Direct link to What is the difference between Main Workflow and Issue Workflow?" translate="no"></a></h3>
|
||
<p><strong>Main Workflow</strong> is for primary development (Levels 1-5), while <strong>Issue Workflow</strong> is for post-development maintenance.</p>
|
||
<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>Parallelism</strong></td><td>Dependency analysis</td><td>Worktree isolation (optional)</td></tr></tbody></table>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-choose-the-right-workflow-level">How do I choose the right workflow level?<a href="#how-do-i-choose-the-right-workflow-level" class="hash-link" aria-label="Direct link to How do I choose the right workflow level?" title="Direct link to How do I choose the right workflow level?" translate="no"></a></h3>
|
||
<!-- -->
|
||
<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>
|
||
<p><strong>Minimum Execution Units</strong> are sets of commands that must execute together as atomic groups. Splitting these commands breaks logical flow and creates incomplete states.</p>
|
||
<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>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="level-1-questions">Level 1 Questions<a href="#level-1-questions" class="hash-link" aria-label="Direct link to Level 1 Questions" title="Direct link to Level 1 Questions" translate="no"></a></h2>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="when-should-i-use-level-1">When should I use Level 1?<a href="#when-should-i-use-level-1" class="hash-link" aria-label="Direct link to When should I use Level 1?" title="Direct link to When should I use Level 1?" translate="no"></a></h3>
|
||
<p>Use Level 1 (<code>lite-lite-lite</code>) when:</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, timeout values)</li>
|
||
<li class="">Documentation updates (readme, comments)</li>
|
||
</ul>
|
||
<p><strong>Don't use</strong> when:</p>
|
||
<ul>
|
||
<li class="">Multi-module changes</li>
|
||
<li class="">Need persistent records</li>
|
||
<li class="">Complex refactoring</li>
|
||
<li class="">Test-driven development</li>
|
||
</ul>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="level-2-questions">Level 2 Questions<a href="#level-2-questions" class="hash-link" aria-label="Direct link to Level 2 Questions" title="Direct link to Level 2 Questions" translate="no"></a></h2>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="whats-the-difference-between-lite-plan-lite-fix-and-multi-cli-plan">What's the difference between lite-plan, lite-fix, and multi-cli-plan?<a href="#whats-the-difference-between-lite-plan-lite-fix-and-multi-cli-plan" class="hash-link" aria-label="Direct link to What's the difference between lite-plan, lite-fix, and multi-cli-plan?" title="Direct link to What's the difference between lite-plan, lite-fix, and multi-cli-plan?" translate="no"></a></h3>
|
||
<table><thead><tr><th>Workflow</th><th>Purpose</th><th>When to Use</th></tr></thead><tbody><tr><td><code>lite-plan</code></td><td>Clear requirements</td><td>Single-module features</td></tr><tr><td><code>lite-fix</code></td><td>Bug diagnosis</td><td>Bug fixes, production issues</td></tr><tr><td><code>multi-cli-plan</code></td><td>Multi-perspective analysis</td><td>Technology selection, solution comparison</td></tr></tbody></table>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-is-hotfix-mode">What is hotfix mode?<a href="#what-is-hotfix-mode" class="hash-link" aria-label="Direct link to What is hotfix mode?" title="Direct link to What is hotfix 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 plain">/workflow: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)">"Production database connection failing"</span><br></span></code></pre></div></div>
|
||
<p><strong>Hotfix mode</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>
|
||
<li class="">Use for <strong>production emergencies only</strong></li>
|
||
</ul>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="when-should-i-use-multi-cli-plan-vs-lite-plan">When should I use multi-cli-plan vs lite-plan?<a href="#when-should-i-use-multi-cli-plan-vs-lite-plan" class="hash-link" aria-label="Direct link to When should I use multi-cli-plan vs lite-plan?" title="Direct link to When should I use multi-cli-plan vs lite-plan?" translate="no"></a></h3>
|
||
<p>Use <code>multi-cli-plan</code> when:</p>
|
||
<ul>
|
||
<li class="">Need multiple perspectives (Gemini, Codex, Claude)</li>
|
||
<li class="">Technology selection decisions</li>
|
||
<li class="">Solution comparison</li>
|
||
<li class="">Architecture trade-offs</li>
|
||
</ul>
|
||
<p>Use <code>lite-plan</code> when:</p>
|
||
<ul>
|
||
<li class="">Requirements are clear</li>
|
||
<li class="">Single-perspective sufficient</li>
|
||
<li class="">Faster iteration needed</li>
|
||
</ul>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="level-3-questions">Level 3 Questions<a href="#level-3-questions" class="hash-link" aria-label="Direct link to Level 3 Questions" title="Direct link to Level 3 Questions" translate="no"></a></h2>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-is-the-difference-between-plan-tdd-plan-and-test-fix-gen">What is the difference between plan, tdd-plan, and test-fix-gen?<a href="#what-is-the-difference-between-plan-tdd-plan-and-test-fix-gen" class="hash-link" aria-label="Direct link to What is the difference between plan, tdd-plan, and test-fix-gen?" title="Direct link to What is the difference between plan, tdd-plan, and test-fix-gen?" translate="no"></a></h3>
|
||
<table><thead><tr><th>Workflow</th><th>Purpose</th><th>Key Feature</th></tr></thead><tbody><tr><td><code>plan</code></td><td>Standard development</td><td>5-phase planning with verification</td></tr><tr><td><code>tdd-plan</code></td><td>Test-driven development</td><td>Red-Green-Refactor cycles</td></tr><tr><td><code>test-fix-gen</code></td><td>Test fixes</td><td>Progressive test layers (L0-L3)</td></tr></tbody></table>
|
||
<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>
|
||
<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>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="why-does-tdd-require-tests-to-be-written-first">Why does TDD require tests to be written first?<a href="#why-does-tdd-require-tests-to-be-written-first" class="hash-link" aria-label="Direct link to Why does TDD require tests to be written first?" title="Direct link to Why does TDD require tests to be written first?" translate="no"></a></h3>
|
||
<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>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-are-the-test-layers-in-test-fix-gen">What are the test layers in test-fix-gen?<a href="#what-are-the-test-layers-in-test-fix-gen" class="hash-link" aria-label="Direct link to What are the test layers in test-fix-gen?" title="Direct link to What are the test layers in test-fix-gen?" translate="no"></a></h3>
|
||
<table><thead><tr><th>Layer</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>L0</strong></td><td>Static</td><td>Type checking, linting</td></tr><tr><td><strong>L1</strong></td><td>Unit</td><td>Function-level tests</td></tr><tr><td><strong>L2</strong></td><td>Integration</td><td>Component interaction</td></tr><tr><td><strong>L3</strong></td><td>E2E</td><td>Full system tests</td></tr></tbody></table>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="level-4-questions">Level 4 Questions<a href="#level-4-questions" class="hash-link" aria-label="Direct link to Level 4 Questions" title="Direct link to Level 4 Questions" translate="no"></a></h2>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="when-should-i-use-brainstorm">When should I use brainstorm<!-- -->:auto-parallel<!-- -->?<a href="#when-should-i-use-brainstorm" class="hash-link" aria-label="Direct link to when-should-i-use-brainstorm" title="Direct link to when-should-i-use-brainstorm" translate="no"></a></h3>
|
||
<p>Use Level 4 (<code>brainstorm:auto-parallel</code>) when:</p>
|
||
<ul>
|
||
<li class="">New feature design</li>
|
||
<li class="">System architecture refactoring</li>
|
||
<li class="">Exploratory requirements</li>
|
||
<li class="">Uncertain implementation approach</li>
|
||
<li class="">Multi-dimensional trade-offs needed</li>
|
||
</ul>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-roles-are-available-in-brainstorm">What roles are available in brainstorm?<a href="#what-roles-are-available-in-brainstorm" class="hash-link" aria-label="Direct link to What roles are available in brainstorm?" title="Direct link to What roles are available in brainstorm?" translate="no"></a></h3>
|
||
<table><thead><tr><th>Role</th><th>Description</th></tr></thead><tbody><tr><td><code>system-architect</code></td><td>System design</td></tr><tr><td><code>ui-designer</code></td><td>UI design</td></tr><tr><td><code>ux-expert</code></td><td>User experience</td></tr><tr><td><code>product-manager</code></td><td>Product requirements</td></tr><tr><td><code>product-owner</code></td><td>Business value</td></tr><tr><td><code>data-architect</code></td><td>Data structure</td></tr><tr><td><code>scrum-master</code></td><td>Process and team</td></tr><tr><td><code>subject-matter-expert</code></td><td>Domain expertise</td></tr><tr><td><code>test-strategist</code></td><td>Testing strategy</td></tr></tbody></table>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-are-with-file-workflows">What are With-File workflows?<a href="#what-are-with-file-workflows" class="hash-link" aria-label="Direct link to What are With-File workflows?" title="Direct link to What are With-File workflows?" translate="no"></a></h3>
|
||
<p><strong>With-File workflows</strong> provide documented exploration with multi-CLI collaboration:</p>
|
||
<table><thead><tr><th>Workflow</th><th>Purpose</th><th>Level</th></tr></thead><tbody><tr><td><code>brainstorm-with-file</code></td><td>Multi-perspective ideation</td><td>4</td></tr><tr><td><code>debug-with-file</code></td><td>Hypothesis-driven debugging</td><td>3</td></tr><tr><td><code>analyze-with-file</code></td><td>Collaborative analysis</td><td>3</td></tr></tbody></table>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="level-5-questions">Level 5 Questions<a href="#level-5-questions" class="hash-link" aria-label="Direct link to Level 5 Questions" title="Direct link to Level 5 Questions" translate="no"></a></h2>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="when-should-i-use-ccw-coordinator">When should I use ccw-coordinator?<a href="#when-should-i-use-ccw-coordinator" class="hash-link" aria-label="Direct link to When should I use ccw-coordinator?" title="Direct link to When should I use ccw-coordinator?" translate="no"></a></h3>
|
||
<p>Use Level 5 (<code>ccw-coordinator</code>) when:</p>
|
||
<ul>
|
||
<li class="">Complex multi-step workflows</li>
|
||
<li class="">Uncertain which commands to use</li>
|
||
<li class="">Desire end-to-end automation</li>
|
||
<li class="">Need full state tracking and resumability</li>
|
||
<li class="">Team collaboration with unified execution flow</li>
|
||
</ul>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-does-ccw-coordinator-differ-from-other-levels">How does ccw-coordinator differ from other levels?<a href="#how-does-ccw-coordinator-differ-from-other-levels" class="hash-link" aria-label="Direct link to How does ccw-coordinator differ from other levels?" title="Direct link to How does ccw-coordinator differ from other levels?" translate="no"></a></h3>
|
||
<table><thead><tr><th>Aspect</th><th>Level 1-4</th><th>Level 5</th></tr></thead><tbody><tr><td><strong>Command Selection</strong></td><td>Manual</td><td>Auto</td></tr><tr><td><strong>Orchestration</strong></td><td>Manual</td><td>Intelligent</td></tr><tr><td><strong>State Tracking</strong></td><td>Varies</td><td>Full persistence</td></tr></tbody></table>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="execution-questions">Execution Questions<a href="#execution-questions" class="hash-link" aria-label="Direct link to Execution Questions" title="Direct link to Execution Questions" translate="no"></a></h2>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-is-lite-execute">What is lite-execute?<a href="#what-is-lite-execute" class="hash-link" aria-label="Direct link to What is lite-execute?" title="Direct link to What is lite-execute?" translate="no"></a></h3>
|
||
<p><code>lite-execute</code> is the unified execution command for Level 2 workflows:</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">/workflow:lite-execute --in-memory</span><br></span></code></pre></div></div>
|
||
<p><strong>Features</strong>:</p>
|
||
<ul>
|
||
<li class="">Parallel execution for independent tasks</li>
|
||
<li class="">Sequential phases for dependent tasks</li>
|
||
<li class="">Progress tracking via TodoWrite</li>
|
||
<li class="">Optional code review</li>
|
||
</ul>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-is-execute">What is execute?<a href="#what-is-execute" class="hash-link" aria-label="Direct link to What is execute?" title="Direct link to What is execute?" translate="no"></a></h3>
|
||
<p><code>execute</code> is the unified execution command for Level 3 workflows:</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">/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>
|
||
<p><strong>Features</strong>:</p>
|
||
<ul>
|
||
<li class="">Dependency analysis</li>
|
||
<li class="">Parallel/sequential task execution</li>
|
||
<li class="">Session-based progress tracking</li>
|
||
<li class="">Task completion summaries</li>
|
||
</ul>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="session-questions">Session Questions<a href="#session-questions" class="hash-link" aria-label="Direct link to Session Questions" title="Direct link to Session Questions" translate="no"></a></h2>
|
||
<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>
|
||
<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">/workflow:session:resume </span><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">/workflow:session:resume 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><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Resume specific session</span><br></span></code></pre></div></div>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-complete-a-session">How do I complete a session?<a href="#how-do-i-complete-a-session" class="hash-link" aria-label="Direct link to How do I complete a session?" title="Direct link to How do I complete a session?" 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 plain">/workflow:session:complete </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>
|
||
<p>This archives the session with lessons learned and updates the manifest.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="how-do-i-list-all-sessions">How do I list all sessions?<a href="#how-do-i-list-all-sessions" class="hash-link" aria-label="Direct link to How do I list all sessions?" title="Direct link to How do I list all sessions?" 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 plain">/workflow:session:list</span><br></span></code></pre></div></div>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="artifact-questions">Artifact Questions<a href="#artifact-questions" class="hash-link" aria-label="Direct link to Artifact Questions" title="Direct link to Artifact Questions" translate="no"></a></h2>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="where-are-workflow-artifacts-stored">Where are workflow artifacts stored?<a href="#where-are-workflow-artifacts-stored" class="hash-link" aria-label="Direct link to Where are workflow artifacts stored?" title="Direct link to Where are workflow artifacts stored?" translate="no"></a></h3>
|
||
<table><thead><tr><th>Level</th><th>Artifact Location</th></tr></thead><tbody><tr><td>Level 1</td><td>None (stateless)</td></tr><tr><td>Level 2</td><td><code>memory://plan</code> or <code>.workflow/.lite-fix/</code>, <code>.workflow/.multi-cli-plan/</code></td></tr><tr><td>Level 3</td><td><code>.workflow/active/WFS-{session}/</code></td></tr><tr><td>Level 4</td><td><code>.workflow/active/WFS-{session}/.brainstorming/</code></td></tr><tr><td>Level 5</td><td><code>.workflow/.ccw-coordinator/{session}/</code></td></tr></tbody></table>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-files-are-in-a-session">What files are in a session?<a href="#what-files-are-in-a-session" class="hash-link" aria-label="Direct link to What files are in a session?" title="Direct link to What files are in a session?" translate="no"></a></h3>
|
||
<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/active/WFS-{session}/</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">├── workflow-session.json # Session metadata</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">├── IMPL_PLAN.md # Implementation plan</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">├── TODO_LIST.md # Progress tracking</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">├── .task/</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">│ ├── IMPL-001.json # Task definitions</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">│ ├── IMPL-002.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">└── .process/</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ├── context-package.json # Project context</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> └── planning-notes.md</span><br></span></code></pre></div></div>
|
||
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="testing-questions">Testing Questions<a href="#testing-questions" class="hash-link" aria-label="Direct link to Testing Questions" title="Direct link to Testing Questions" 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>
|
||
<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"># Session Mode (from existing session)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/workflow:test-fix-gen 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"># Prompt Mode (direct description)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">/workflow:test-fix-gen </span><span class="token string" style="color:rgb(195, 232, 141)">"Add unit tests for the auth API"</span><br></span></code></pre></div></div>
|
||
<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>
|
||
<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">/workflow:test-fix-gen </span><span class="token string" style="color:rgb(195, 232, 141)">"Tests failing for user registration"</span><span class="token plain"></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>The workflow will:</p>
|
||
<ol>
|
||
<li class="">Analyze test failures</li>
|
||
<li class="">Identify root causes</li>
|
||
<li class="">Fix issues iteratively</li>
|
||
<li class="">Verify >= 95% pass rate</li>
|
||
</ol>
|
||
<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>
|
||
<ol>
|
||
<li class=""><strong>Check the error message</strong> - Identify the root cause</li>
|
||
<li class=""><strong>Review state.json</strong> - Check <code>.workflow/.ccw-coordinator/{session}/state.json</code></li>
|
||
<li class=""><strong>Resume the session</strong> - Use <code>/workflow:session:resume</code> to continue</li>
|
||
<li class=""><strong>Adjust and retry</strong> - Modify approach based on error</li>
|
||
</ol>
|
||
<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>
|
||
<p>Edit the task JSON to set status to "completed":</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)">'.status = "completed"'</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>
|
||
<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>
|
||
<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">/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">/workflow:clean</span><br></span></code></pre></div></div>
|
||
<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>
|
||
<ol>
|
||
<li class=""><strong>Start simple</strong> - Use the lowest level that meets your needs</li>
|
||
<li class=""><strong>Plan before executing</strong> - Use verification steps when available</li>
|
||
<li class=""><strong>Test continuously</strong> - Integrate testing into your workflow</li>
|
||
<li class=""><strong>Review code</strong> - Use built-in review workflows</li>
|
||
<li class=""><strong>Document decisions</strong> - Use brainstorm workflows for complex decisions</li>
|
||
</ol>
|
||
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="when-should-i-use-worktree-isolation">When should I use worktree isolation?<a href="#when-should-i-use-worktree-isolation" class="hash-link" aria-label="Direct link to When should I use worktree isolation?" title="Direct link to When should I use worktree isolation?" translate="no"></a></h3>
|
||
<p><strong>Worktree isolation</strong> is primarily for <strong>Issue Workflow</strong>:</p>
|
||
<ul>
|
||
<li class="">After main development is complete</li>
|
||
<li class="">Merged to <code>main</code> branch</li>
|
||
<li class="">Issues discovered requiring fixes</li>
|
||
<li class="">Need to fix without affecting current development</li>
|
||
</ul>
|
||
<p><strong>Main Workflow</strong> doesn't need worktree because:</p>
|
||
<ul>
|
||
<li class="">Dependency analysis solves parallelism</li>
|
||
<li class="">Agents execute independent tasks in parallel</li>
|
||
<li class="">No filesystem isolation needed</li>
|
||
</ul>
|
||
<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">Introduction</a> - Workflow overview</li>
|
||
<li class=""><a class="" href="/docs/docs/workflows/level-1-ultra-lightweight">Level 1</a> - Ultra-lightweight workflows</li>
|
||
<li class=""><a class="" href="/docs/docs/workflows/level-2-rapid">Level 2</a> - Rapid workflows</li>
|
||
<li class=""><a class="" href="/docs/docs/workflows/level-3-standard">Level 3</a> - Standard workflows</li>
|
||
<li class=""><a class="" href="/docs/docs/workflows/level-4-brainstorm">Level 4</a> - Brainstorm workflows</li>
|
||
<li class=""><a class="" href="/docs/docs/workflows/level-5-intelligent">Level 5</a> - Intelligent workflows</li>
|
||
<li class=""><a class="" href="/docs/docs/commands/general/ccw">Commands</a> - Command reference</li>
|
||
</ul></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="row margin-top--sm theme-doc-footer-edit-meta-row"><div class="col noPrint_HJkF"><a href="https://github.com/ccw/docs/tree/main/docs/workflows/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"></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-the-difference-between-main-workflow-and-issue-workflow" class="table-of-contents__link toc-highlight">What is the difference between Main Workflow and Issue Workflow?</a></li><li><a href="#how-do-i-choose-the-right-workflow-level" class="table-of-contents__link toc-highlight">How do I choose the right workflow level?</a></li><li><a href="#what-are-minimum-execution-units" class="table-of-contents__link toc-highlight">What are Minimum Execution Units?</a></li></ul></li><li><a href="#level-1-questions" class="table-of-contents__link toc-highlight">Level 1 Questions</a><ul><li><a href="#when-should-i-use-level-1" class="table-of-contents__link toc-highlight">When should I use Level 1?</a></li></ul></li><li><a href="#level-2-questions" class="table-of-contents__link toc-highlight">Level 2 Questions</a><ul><li><a href="#whats-the-difference-between-lite-plan-lite-fix-and-multi-cli-plan" class="table-of-contents__link toc-highlight">What's the difference between lite-plan, lite-fix, and multi-cli-plan?</a></li><li><a href="#what-is-hotfix-mode" class="table-of-contents__link toc-highlight">What is hotfix mode?</a></li><li><a href="#when-should-i-use-multi-cli-plan-vs-lite-plan" class="table-of-contents__link toc-highlight">When should I use multi-cli-plan vs lite-plan?</a></li></ul></li><li><a href="#level-3-questions" class="table-of-contents__link toc-highlight">Level 3 Questions</a><ul><li><a href="#what-is-the-difference-between-plan-tdd-plan-and-test-fix-gen" class="table-of-contents__link toc-highlight">What is the difference between plan, tdd-plan, and test-fix-gen?</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><li><a href="#why-does-tdd-require-tests-to-be-written-first" class="table-of-contents__link toc-highlight">Why does TDD require tests to be written first?</a></li><li><a href="#what-are-the-test-layers-in-test-fix-gen" class="table-of-contents__link toc-highlight">What are the test layers in test-fix-gen?</a></li></ul></li><li><a href="#level-4-questions" class="table-of-contents__link toc-highlight">Level 4 Questions</a><ul><li><a href="#when-should-i-use-brainstorm" class="table-of-contents__link toc-highlight">When should I use brainstorm?</a></li><li><a href="#what-roles-are-available-in-brainstorm" class="table-of-contents__link toc-highlight">What roles are available in brainstorm?</a></li><li><a href="#what-are-with-file-workflows" class="table-of-contents__link toc-highlight">What are With-File workflows?</a></li></ul></li><li><a href="#level-5-questions" class="table-of-contents__link toc-highlight">Level 5 Questions</a><ul><li><a href="#when-should-i-use-ccw-coordinator" class="table-of-contents__link toc-highlight">When should I use ccw-coordinator?</a></li><li><a href="#how-does-ccw-coordinator-differ-from-other-levels" class="table-of-contents__link toc-highlight">How does ccw-coordinator differ from other levels?</a></li></ul></li><li><a href="#execution-questions" class="table-of-contents__link toc-highlight">Execution Questions</a><ul><li><a href="#what-is-lite-execute" class="table-of-contents__link toc-highlight">What is lite-execute?</a></li><li><a href="#what-is-execute" class="table-of-contents__link toc-highlight">What is execute?</a></li></ul></li><li><a href="#session-questions" class="table-of-contents__link toc-highlight">Session Questions</a><ul><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><li><a href="#how-do-i-complete-a-session" class="table-of-contents__link toc-highlight">How do I complete a session?</a></li><li><a href="#how-do-i-list-all-sessions" class="table-of-contents__link toc-highlight">How do I list all sessions?</a></li></ul></li><li><a href="#artifact-questions" class="table-of-contents__link toc-highlight">Artifact Questions</a><ul><li><a href="#where-are-workflow-artifacts-stored" class="table-of-contents__link toc-highlight">Where are workflow artifacts stored?</a></li><li><a href="#what-files-are-in-a-session" class="table-of-contents__link toc-highlight">What files are in a session?</a></li></ul></li><li><a href="#testing-questions" class="table-of-contents__link toc-highlight">Testing Questions</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></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></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="#when-should-i-use-worktree-isolation" class="table-of-contents__link toc-highlight">When should I use worktree isolation?</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> |