mancode 0.3.5 → 0.3.6

package/dist/cli.js

@@ -308,8 +308,8 @@ var HEAD_COACH_AGENT = {
 - \u5C06\u5173\u952E\u51B3\u7B56\u4EA4\u7ED9\u8C03\u7528\u65B9 appendTeamDecision\uFF0C\u5E76\u66F4\u65B0 Active Plans\u3002
 - \u5408\u5E76 worktree \u524D\u53D6\u5F97\u7528\u6237\u786E\u8BA4\uFF1B\u6E05\u7406\u4E34\u65F6\u6587\u4EF6\u3002
 
-**/mamba \u4EA4\u63A5\u9636\u6BB5**\uFF1A
-- \u5F53\u771F\u5B9E\u6D4F\u89C8\u5668\u9A8C\u8BC1\u3001\u590D\u6742\u590D\u73B0\u6216\u56DE\u5F52\u9700\u8981\u4E13\u95E8\u8BCA\u65AD\u65F6\uFF0C\u901A\u8FC7 \`mancode workflow create mamba ... --parent-task <taskId>\` \u521B\u5EFA\u5B50 workflow\uFF1B\u6240\u6709 metadata \u53D8\u5316\u90FD\u8D70 workflow CLI\u3002
+**/manba \u4EA4\u63A5\u9636\u6BB5**\uFF1A
+- \u5F53\u771F\u5B9E\u6D4F\u89C8\u5668\u9A8C\u8BC1\u3001\u590D\u6742\u590D\u73B0\u6216\u56DE\u5F52\u9700\u8981\u4E13\u95E8\u8BCA\u65AD\u65F6\uFF0C\u901A\u8FC7 \`mancode workflow create manba ... --parent-task <taskId>\` \u521B\u5EFA\u5B50 workflow\uFF1B\u6240\u6709 metadata \u53D8\u5316\u90FD\u8D70 workflow CLI\u3002
 - \u5B50\u4EFB\u52A1 fixed/verified/no_repro \u540E\u56DE\u5230\u7236 /man Step 6\uFF1B\u82E5\u7236\u66FE\u56E0\u8BE5\u5B50\u4EFB\u52A1 blocked\uFF0C\u5148\u7528 workflow CLI \u6062\u590D\u4E3A in_progress\u3002blocked \u6216 manual_test_required \u65F6\u8BA9\u7236 workflow \u540C\u6B65 blocked\uFF0C\u540E\u8005\u4E0D\u5F97\u81EA\u52A8\u6062\u590D\u3002
 
 \u4E3B\u89C1\u5F3A\uFF0C\u5FC5\u8981\u65F6\u624D\u95EE\u7528\u6237\u3002\u5F00\u5E72\u3002`
@@ -531,7 +531,8 @@ if (!state) {
   process.exit(0);
 }
 
-const mode = text(state.currentMode) || 'solo';
+const storedMode = text(state.currentMode) || 'solo';
+const mode = storedMode === 'mamba' ? 'manba' : storedMode;
 const techStack = sanitize(state.techStack);
 const uiLibrary = sanitize(state.uiLibrary);
 const output = [
@@ -848,7 +849,7 @@ var MAN_SKILL = {
 
 ### Step 6: \u81EA\u6D4B\u3001\u8BCA\u65AD\u4E0E\u56DE\u5F52
 
-\u8FD0\u884C\u5B9E\u9645 build/lint/typecheck/test \u548C smoke test\u3002\u76F8\u540C\u4EE3\u7801\u3001\u73AF\u5883\u3001\u547D\u4EE4\u4E0B\u76F8\u540C\u9519\u8BEF\u7B7E\u540D\u5931\u8D25\u4E24\u6B21\uFF0C\u505C\u6B62\u76F2\u8BD5\u5E76\u8BCA\u65AD\u6839\u56E0\u3002\u9700\u8981\u771F\u5B9E\u6D4F\u89C8\u5668\u3001\u590D\u6742\u590D\u73B0\u6216\u56DE\u5F52\u65F6\uFF0C\u7528 \`mancode workflow create mamba "<\u95EE\u9898>" --parent-task <taskId> --json\` \u521B\u5EFA\u5B50 workflow\uFF1B\u7236\u4EFB\u52A1\u4FDD\u6301 Step 6\u3002\u5B50\u4EFB\u52A1 fixed/verified/no_repro \u540E\u6062\u590D\u672C\u4EFB\u52A1\uFF1B\u82E5\u7236\u66FE\u56E0\u8BE5\u5B50\u4EFB\u52A1 blocked\uFF0C\u5148\u901A\u8FC7 \`workflow update --status in_progress\` \u6062\u590D\uFF0C\u518D\u66F4\u65B0\u81F3 Step 7\u3002blocked \u6216 manual_test_required \u4F1A\u7531 CLI \u81EA\u52A8\u963B\u585E\u7236\u4EFB\u52A1\uFF0C\u4E0D\u5F97\u624B\u6539\u7236 metadata\uFF0C\u4E5F\u4E0D\u5F97\u81EA\u52A8\u8D8A\u8FC7\u4EBA\u5DE5\u9A8C\u8BC1\u8981\u6C42\u3002
+\u8FD0\u884C\u5B9E\u9645 build/lint/typecheck/test \u548C smoke test\u3002\u76F8\u540C\u4EE3\u7801\u3001\u73AF\u5883\u3001\u547D\u4EE4\u4E0B\u76F8\u540C\u9519\u8BEF\u7B7E\u540D\u5931\u8D25\u4E24\u6B21\uFF0C\u505C\u6B62\u76F2\u8BD5\u5E76\u8BCA\u65AD\u6839\u56E0\u3002\u9700\u8981\u771F\u5B9E\u6D4F\u89C8\u5668\u3001\u590D\u6742\u590D\u73B0\u6216\u56DE\u5F52\u65F6\uFF0C\u7528 \`mancode workflow create manba "<\u95EE\u9898>" --parent-task <taskId> --json\` \u521B\u5EFA\u5B50 workflow\uFF1B\u7236\u4EFB\u52A1\u4FDD\u6301 Step 6\u3002\u5B50\u4EFB\u52A1 fixed/verified/no_repro \u540E\u6062\u590D\u672C\u4EFB\u52A1\uFF1B\u82E5\u7236\u66FE\u56E0\u8BE5\u5B50\u4EFB\u52A1 blocked\uFF0C\u5148\u901A\u8FC7 \`workflow update --status in_progress\` \u6062\u590D\uFF0C\u518D\u66F4\u65B0\u81F3 Step 7\u3002blocked \u6216 manual_test_required \u4F1A\u7531 CLI \u81EA\u52A8\u963B\u585E\u7236\u4EFB\u52A1\uFF0C\u4E0D\u5F97\u624B\u6539\u7236 metadata\uFF0C\u4E5F\u4E0D\u5F97\u81EA\u52A8\u8D8A\u8FC7\u4EBA\u5DE5\u9A8C\u8BC1\u8981\u6C42\u3002
 
 \u9A8C\u8BC1\u540E\u57FA\u4E8E**\u5B9E\u9645 diff**\u5199 \`review-scope.md\`\uFF1Abase\u3001\u6539\u52A8\u6587\u4EF6\u3001\u9700\u6C42\u3001\u5DF2\u8DD1\u9A8C\u8BC1\u3001\u786C\u98CE\u9669\u548C\u5BA1\u67E5\u6DF1\u5EA6\u3002\u9274\u6743\u3001\u652F\u4ED8\u3001\u654F\u611F\u6570\u636E\u3001\u8FC1\u79FB/\u5220\u9664\u3001\u516C\u5F00 API\u3001\u672A\u53EF\u4FE1\u8F93\u5165\u3001\u5E76\u53D1\u3001\u8DE8\u670D\u52A1\u6216\u57FA\u7840\u8BBE\u65BD\u547D\u4E2D\u4EFB\u4E00\u9879\u65F6\u7528\u5B8C\u6574\u5BA1\u67E5 \`full\`\uFF1B\u5426\u5219\u7528\u5B9A\u5411\u5BA1\u67E5 \`targeted\`\u3002\u8FD0\u884C \`mancode workflow review <taskId> init --review-depth targeted --review-domain quality\` \u6216 \`--review-depth full\`\u3002\u7528\u6237\u660E\u786E\u8DF3\u8FC7\u5BA1\u67E5\u65F6\u624D\u628A \`review\` \u5199\u5165\u7D2F\u8BA1 skippedSteps\uFF0C\u5E76\u8BB0\u5F55\u6B8B\u4F59\u98CE\u9669\u3002
 
@@ -877,15 +878,15 @@ ${CORE_CODING_PRINCIPLES}
 
 // src/templates/skills/mamba.ts
 var MAMBA_SKILL = {
-  name: "mamba",
+  name: "manba",
   description: "Diagnose bugs and validate real user flows. Reproduce, find the root cause, run targeted regression checks, and use browser automation when the platform supports it.",
-  body: `# mancode \xB7 /mamba (Diagnosis & Real Validation)
+  body: `# mancode \xB7 /manba (Diagnosis & Real Validation)
 
-\u7528\u6237\u7528 \`/mamba <\u95EE\u9898\u6216\u6A21\u5757>\` \u89E6\u53D1\u4F60\u3002\u76EE\u6807\u662F\u7528\u8BC1\u636E\u56DE\u7B54\uFF1A\u80FD\u5426\u590D\u73B0\u3001\u6839\u56E0\u5728\u54EA\u91CC\u3001\u4FEE\u590D\u662F\u5426\u6709\u6548\u3001\u5173\u952E\u8DEF\u5F84\u662F\u5426\u56DE\u5F52\u3002
+\u7528\u6237\u7528 \`/manba <\u95EE\u9898\u6216\u6A21\u5757>\` \u89E6\u53D1\u4F60\u3002\u76EE\u6807\u662F\u7528\u8BC1\u636E\u56DE\u7B54\uFF1A\u80FD\u5426\u590D\u73B0\u3001\u6839\u56E0\u5728\u54EA\u91CC\u3001\u4FEE\u590D\u662F\u5426\u6709\u6548\u3001\u5173\u952E\u8DEF\u5F84\u662F\u5426\u56DE\u5F52\u3002\u5BF9\u5916\u6A21\u5F0F\u540D\u662F manba\uFF1B\u6301\u4E45\u5316 workflow/state \u4E3A\u517C\u5BB9\u5386\u53F2\u6570\u636E\u7EE7\u7EED\u4F7F\u7528\u5185\u90E8\u503C mamba\u3002
 
 ## 1. \u5EFA\u7ACB\u4EFB\u52A1
 
-\u5148\u8BFB state\u3002\u82E5 \`currentTask\` \u6307\u5411 unrelated active workflow\uFF0C\u505C\u6B62\u5E76\u8BA9\u7528\u6237\u9009\u62E9\u6062\u590D\u8BE5\u6D41\u7A0B\u6216\u5148\u7528 /mansolo \u653E\u5F03\uFF1B\u4E0D\u5F97\u8986\u76D6\u65E7\u6307\u9488\u3002\u72EC\u7ACB\u4EFB\u52A1\u8FD0\u884C \`mancode workflow create mamba "<\u95EE\u9898\u6216\u6A21\u5757>" --json\`\uFF1B\u7531 /man \u6216 /manteam Step 6 \u8F6C\u5165\u65F6\u8FD0\u884C \`mancode workflow create mamba "<\u95EE\u9898\u6216\u6A21\u5757>" --parent-task <\u7236taskId> --json\`\u3002\u8BFB\u53D6\u8FD4\u56DE taskId \u540E\uFF0C\u5C06 state \u7684 currentMode/currentTask/currentWorkflowMode \u6307\u5411 mamba\u3002\u4E0D\u5F97\u76F4\u63A5\u521B\u5EFA\u6216\u6539\u5199 metadata.json\u3002
+\u5148\u8BFB state\u3002\u82E5 \`currentTask\` \u6307\u5411 unrelated active workflow\uFF0C\u505C\u6B62\u5E76\u8BA9\u7528\u6237\u9009\u62E9\u6062\u590D\u8BE5\u6D41\u7A0B\u6216\u5148\u7528 /mansolo \u653E\u5F03\uFF1B\u4E0D\u5F97\u8986\u76D6\u65E7\u6307\u9488\u3002\u72EC\u7ACB\u4EFB\u52A1\u8FD0\u884C \`mancode workflow create manba "<\u95EE\u9898\u6216\u6A21\u5757>" --json\`\uFF1B\u7531 /man \u6216 /manteam Step 6 \u8F6C\u5165\u65F6\u8FD0\u884C \`mancode workflow create manba "<\u95EE\u9898\u6216\u6A21\u5757>" --parent-task <\u7236taskId> --json\`\u3002\u8BFB\u53D6\u8FD4\u56DE taskId \u540E\uFF0C\u5C06 state \u7684 currentMode/currentTask/currentWorkflowMode \u6307\u5411\u5185\u90E8\u517C\u5BB9\u503C mamba\u3002\u4E0D\u5F97\u76F4\u63A5\u521B\u5EFA\u6216\u6539\u5199 metadata.json\u3002
 
 \u8BB0\u5F55\u73B0\u8C61\u3001\u73AF\u5883\u3001\u590D\u73B0\u6761\u4EF6\u3001\u9884\u671F\u4E0E\u5B9E\u9645\u7ED3\u679C\u3001\u4E0D\u53EF\u89E6\u78B0\u7684\u6570\u636E\u3002\u5148\u68C0\u67E5\u5DF2\u6709\u6D4B\u8BD5\u3001\u8DEF\u7531\u3001\u6A21\u5757\u5165\u53E3\u548C README\uFF1B\u4ECD\u65E0\u6CD5\u786E\u5B9A\u6700\u5C0F\u8DEF\u5F84\u65F6\u53EA\u95EE\u5173\u952E\u8DEF\u5F84\u95EE\u9898\u3002\u5B8C\u6210\u540E\u7528 CLI \u66F4\u65B0\u81F3 Step 2\u3002
 
@@ -900,7 +901,7 @@ var MAMBA_SKILL = {
 
 \u4EC5\u5F53 profile \u786E\u8BA4 Web UI \u4E14\u6D4F\u89C8\u5668\u80FD\u529B\u53EF\u7528\u65F6\uFF0C\u68C0\u67E5 \`npx\` \u5E76\u4F7F\u7528\u9879\u76EE\u7684 Playwright CLI wrapper\u3002\u5176\u4ED6\u9879\u76EE\u7C7B\u578B\u4F7F\u7528\u5DF2\u68C0\u6D4B\u5230\u7684 API\u3001\u6A21\u62DF\u5668\u3001\u8BBE\u5907\u3001\u547D\u4EE4\u6216\u5951\u7EA6\u9A8C\u8BC1\u65B9\u5F0F\u3002\u6D4F\u89C8\u5668\u9A8C\u8BC1\u65F6\u5148 snapshot \u518D\u4F7F\u7528\u5143\u7D20\u5F15\u7528\uFF1B\u5BFC\u822A\u3001\u5F39\u7A97\u6216 UI \u5927\u53D8\u5316\u540E\u91CD\u65B0 snapshot\u3002\u622A\u56FE\u3001trace \u548C\u6D4F\u89C8\u5668\u65E5\u5FD7\u5199\u5165 \`.mancode/workflows/<taskId>/artifacts/playwright/\`\uFF0C\u62A5\u544A\u53EA\u5199\u76F8\u5BF9\u8DEF\u5F84\uFF0C\u5E76\u8131\u654F Token\u3001Cookie\u3001\u4E2A\u4EBA\u6216\u4E1A\u52A1\u654F\u611F\u6570\u636E\u3002
 
-\u73AF\u5883\u5C31\u7EEA\u540E\u7528 CLI \u66F4\u65B0\u81F3 Step 3\uFF1B\u7F3A\u5C11\u73AF\u5883\u3001\u6743\u9650\u6216\u6570\u636E\u5219\u76F4\u63A5\u5199 blocked + blockingReason\uFF0C\u5E76\u4FDD\u7559 state \u6307\u5411\u5F53\u524D mamba \u4EE5\u4FBF\u6062\u590D\u3002
+\u73AF\u5883\u5C31\u7EEA\u540E\u7528 CLI \u66F4\u65B0\u81F3 Step 3\uFF1B\u7F3A\u5C11\u73AF\u5883\u3001\u6743\u9650\u6216\u6570\u636E\u5219\u76F4\u63A5\u5199 blocked + blockingReason\uFF0C\u5E76\u4FDD\u7559 state \u6307\u5411\u5F53\u524D manba \u4EE5\u4FBF\u6062\u590D\u3002
 
 ## 3. \u590D\u73B0\u4E0E\u8BCA\u65AD
 
@@ -920,7 +921,7 @@ var MAMBA_SKILL = {
 - \u7F3A\u5C11\u73AF\u5883\u3001\u6743\u9650\u6216\u6570\u636E\uFF0C\u6216\u4FEE\u590D\u4ECD\u5931\u8D25\uFF1A\`status: "blocked"\` + \`blockingReason\`
 - \u53D7\u9650\u5E73\u53F0\u53EA\u80FD\u751F\u6210\u624B\u6D4B\u65B9\u6848\uFF1A\`status: "completed", outcome: "manual_test_required"\`\uFF1B\u5FC5\u987B\u660E\u786E\u6CA1\u6709\u6267\u884C\u771F\u5B9E\u6D4B\u8BD5
 
-\u7528 \`mancode workflow update <taskId> --status <status> [--outcome <outcome>] [--blocking-reason <\u539F\u56E0>]\` \u5199\u7ED3\u8BBA\u3002\u7236\u5B50\u4EFB\u52A1\u7684 blocked/manual_test_required \u4F20\u64AD\u7531 CLI \u8D1F\u8D23\u3002\u5173\u8054\u5B50\u4EFB\u52A1\u4EE5 fixed/verified/no_repro \u5B8C\u6210\u540E\uFF0C\u5148\u8BFB\u53D6\u7236 workflow\uFF1B\u82E5\u7236\u4ECD\u56E0\u672C\u5B50\u4EFB\u52A1 blocked\uFF0C\u8FD0\u884C \`mancode workflow update <parentTaskId> --status in_progress\` \u6E05\u9664\u963B\u585E\uFF0C\u518D\u628A state \u6062\u590D\u5230\u7236 workflow \u7684 Step 6\u3002manual_test_required \u4E0D\u5F97\u81EA\u52A8\u6062\u590D\u7236\u4EFB\u52A1\u3002\u72EC\u7ACB\u4EFB\u52A1\u5B8C\u6210\u540E\u56DE solo\uFF1Bblocked \u7684\u72EC\u7ACB\u4EFB\u52A1\u7EE7\u7EED\u4FDD\u6301 mamba state\u3002\u4EFB\u4F55\u60C5\u51B5\u4E0B\u90FD\u4E0D\u5F97\u76F4\u63A5\u7F16\u8F91 metadata \u7ED5\u8FC7 CLI\u3002
+\u7528 \`mancode workflow update <taskId> --status <status> [--outcome <outcome>] [--blocking-reason <\u539F\u56E0>]\` \u5199\u7ED3\u8BBA\u3002\u7236\u5B50\u4EFB\u52A1\u7684 blocked/manual_test_required \u4F20\u64AD\u7531 CLI \u8D1F\u8D23\u3002\u5173\u8054\u5B50\u4EFB\u52A1\u4EE5 fixed/verified/no_repro \u5B8C\u6210\u540E\uFF0C\u5148\u8BFB\u53D6\u7236 workflow\uFF1B\u82E5\u7236\u4ECD\u56E0\u672C\u5B50\u4EFB\u52A1 blocked\uFF0C\u8FD0\u884C \`mancode workflow update <parentTaskId> --status in_progress\` \u6E05\u9664\u963B\u585E\uFF0C\u518D\u628A state \u6062\u590D\u5230\u7236 workflow \u7684 Step 6\u3002manual_test_required \u4E0D\u5F97\u81EA\u52A8\u6062\u590D\u7236\u4EFB\u52A1\u3002\u72EC\u7ACB\u4EFB\u52A1\u5B8C\u6210\u540E\u56DE solo\uFF1Bblocked \u7684\u72EC\u7ACB\u4EFB\u52A1\u7EE7\u7EED\u4FDD\u6301 manba \u6A21\u5F0F\uFF08state \u5185\u90E8\u503C\u4E3A mamba\uFF09\u3002\u4EFB\u4F55\u60C5\u51B5\u4E0B\u90FD\u4E0D\u5F97\u76F4\u63A5\u7F16\u8F91 metadata \u7ED5\u8FC7 CLI\u3002
 
 ${CORE_CODING_PRINCIPLES}
 `
@@ -1121,8 +1122,8 @@ var MANSOLO_SKILL = {
 
 - **\u6CA1\u6709 .mancode/state.json**\uFF1A\u544A\u8BC9\u7528\u6237\uFF1A"\u9879\u76EE\u672A\u521D\u59CB\u5316\uFF0C\u8FD0\u884C \`mancode init\`\u3002"
 - **state.json \u5DF2\u662F solo**\uFF1A\u4ECD\u6B63\u5E38\u6267\u884C\uFF0C\u544A\u77E5\u7528\u6237\u5F53\u524D\u5DF2\u662F solo\u3002
-- **\u5F53\u524D task \u5DF2\u662F completed/abandoned**\uFF1A\u4E0D\u8981\u5C1D\u8BD5\u628A\u7EC8\u6001\u6539\u6210 abandoned\uFF1B\u76F4\u63A5\u6E05\u7406 state\u3002\u82E5\u5B83\u662F\u5173\u8054 mamba \u4E14\u7236\u4EFB\u52A1\u4ECD active\uFF0C\u5148\u5C55\u793A\u7236\u4EFB\u52A1\u5E76\u6309\u4E0B\u4E00\u6761\u786E\u8BA4\u662F\u5426\u4E00\u5E76\u653E\u5F03\u3002
-- **\u5F53\u524D\u5728 active /man /mamba /manteam \u6D41\u7A0B\u4E2D**\uFF1A\u7528 AskUserQuestion \u95EE\u7528\u6237\uFF1A
+- **\u5F53\u524D task \u5DF2\u662F completed/abandoned**\uFF1A\u4E0D\u8981\u5C1D\u8BD5\u628A\u7EC8\u6001\u6539\u6210 abandoned\uFF1B\u76F4\u63A5\u6E05\u7406 state\u3002\u82E5\u5B83\u662F\u5173\u8054 manba \u4E14\u7236\u4EFB\u52A1\u4ECD active\uFF0C\u5148\u5C55\u793A\u7236\u4EFB\u52A1\u5E76\u6309\u4E0B\u4E00\u6761\u786E\u8BA4\u662F\u5426\u4E00\u5E76\u653E\u5F03\u3002
+- **\u5F53\u524D\u5728 active /man /manba /manteam \u6D41\u7A0B\u4E2D**\uFF1A\u7528 AskUserQuestion \u95EE\u7528\u6237\uFF1A
   \`\`\`
   AskUserQuestion({
     questions: [{
@@ -1138,7 +1139,7 @@ var MANSOLO_SKILL = {
   \`\`\`
   \u7528\u6237\u786E\u8BA4\u540E\uFF1A
   - \u5148\u7528 \`mancode workflow show <taskId> --json\` \u68C0\u67E5\u7236\u5B50\u5173\u7CFB\u548C activeChildren\u3002
-  - \u82E5\u5B58\u5728\u6D3B\u8DC3\u5B50\u4EFB\u52A1\u6216\u5F53\u524D\u662F\u5E26 parentTaskId \u7684 mamba\uFF0C\u660E\u786E\u8BF4\u660E\u5C06\u653E\u5F03\u7684 workflow \u94FE\uFF1B\u5148\u9010\u4E2A\u7528 CLI \u6807\u8BB0\u5B50\u4EFB\u52A1 abandoned\uFF0C\u518D\u6807\u8BB0\u7236/\u5F53\u524D\u4EFB\u52A1 abandoned\u3002
+  - \u82E5\u5B58\u5728\u6D3B\u8DC3\u5B50\u4EFB\u52A1\u6216\u5F53\u524D\u662F\u5E26 parentTaskId \u7684 manba\uFF0C\u660E\u786E\u8BF4\u660E\u5C06\u653E\u5F03\u7684 workflow \u94FE\uFF1B\u5148\u9010\u4E2A\u7528 CLI \u6807\u8BB0\u5B50\u4EFB\u52A1 abandoned\uFF0C\u518D\u6807\u8BB0\u7236/\u5F53\u524D\u4EFB\u52A1 abandoned\u3002
   - \u6240\u6709 metadata \u72B6\u6001\u90FD\u5FC5\u987B\u901A\u8FC7 \`mancode workflow update <taskId> --status abandoned\` \u66F4\u65B0\uFF1BCLI \u62D2\u7EDD\u65F6\u505C\u6B62\uFF0C\u4E0D\u5F97\u76F4\u63A5 Edit \u7ED5\u8FC7\u3002
   - \u6210\u529F\u540E\u518D\u66F4\u65B0 state.json \u5207\u56DE solo\uFF1BCLI \u4F1A\u540C\u6B65\u6E05\u7406 Active Plans\u3002
 
@@ -1193,12 +1194,12 @@ var MANTEAM_SKILL = {
 3. Game Plan\uFF1A\u8BA1\u5212\u91CC\u5FC5\u987B\u5305\u542B\u53D8\u66F4\u8FB9\u754C\u3001\u517C\u5BB9\u6027\u98CE\u9669\u3001\u56DE\u6EDA\u65B9\u5F0F\uFF1BPlan Coach \u53EA\u8FD4\u56DE\u8BA1\u5212\u6587\u672C\uFF0C\u7981\u6B62\u63D0\u524D\u4FEE\u6539\u4E1A\u52A1\u6587\u4EF6\u6216\u56E2\u961F memory\u3002
 4. \u8BA1\u5212\u5173\u5361\uFF1A\u7528\u6237\u53EF\u53EA\u4FDD\u7559\u8BA1\u5212\u3001\u7EE7\u7EED\u6267\u884C\u6216\u91CD\u5199\u8BA1\u5212\uFF1BActive Plans \u6309 taskId \u66F4\u65B0\u3002
 5. \u5B9E\u65BD\uFF1A\u6539\u52A8\u524D\u518D\u6B21\u68C0\u67E5 \`git status --short\`\uFF0C\u907F\u514D\u8E29\u7528\u6237\u6216\u961F\u53CB\u6539\u52A8\u3002
-6. Self-test\uFF1A\u4F18\u5148\u8DD1\u9879\u76EE\u5DF2\u6709\u9A8C\u8BC1\u547D\u4EE4\uFF1B\u5931\u8D25\u4E24\u6B21\u505C\u4E0B\u8BCA\u65AD\u6839\u56E0\u3002\u9700\u8981\u771F\u5B9E\u9A8C\u8BC1\u65F6\u521B\u5EFA\u5E26 parentTaskId \u7684 /mamba \u5B50\u4EFB\u52A1\u3002\u5B50\u4EFB\u52A1\u4FEE\u590D\u540E\u82E5\u7236\u4EFB\u52A1\u66FE\u56E0\u6B64 blocked\uFF0C\u5148\u7528 workflow CLI \u6062\u590D\u7236\u4EFB\u52A1\u4E3A in_progress\uFF1Bmanual_test_required \u4E0D\u5F97\u81EA\u52A8\u6062\u590D\u3002
+6. Self-test\uFF1A\u4F18\u5148\u8DD1\u9879\u76EE\u5DF2\u6709\u9A8C\u8BC1\u547D\u4EE4\uFF1B\u5931\u8D25\u4E24\u6B21\u505C\u4E0B\u8BCA\u65AD\u6839\u56E0\u3002\u9700\u8981\u771F\u5B9E\u9A8C\u8BC1\u65F6\u521B\u5EFA\u5E26 parentTaskId \u7684 /manba \u5B50\u4EFB\u52A1\u3002\u5B50\u4EFB\u52A1\u4FEE\u590D\u540E\u82E5\u7236\u4EFB\u52A1\u66FE\u56E0\u6B64 blocked\uFF0C\u5148\u7528 workflow CLI \u6062\u590D\u7236\u4EFB\u52A1\u4E3A in_progress\uFF1Bmanual_test_required \u4E0D\u5F97\u81EA\u52A8\u6062\u590D\u3002
 7. Review scope + Film #1\uFF1A\u57FA\u4E8E\u5B9E\u9645 diff \u5199 \`review-scope.md\`\uFF0C\u7528 \`workflow review ... init\` \u9009\u62E9 targeted \u6216 full\uFF1B\u91CD\u70B9\u5BA1\u67E5\u884C\u4E3A\u3001\u53EF\u7EF4\u62A4\u6027\u3001\u56E2\u961F\u98CE\u683C\u4E0E\u6D4B\u8BD5\uFF0Cfinding \u5FC5\u987B\u6709\u8BC1\u636E\u548C\u7A33\u5B9A ID\u3002
 8. Film #2\uFF1A\u4EC5 full \u6267\u884C\uFF0C\u5148\u8BFB Film #1 \u62A5\u544A\u5E76\u53BB\u91CD\uFF0C\u53EA\u5BA1\u67E5\u8FB9\u754C\u3001\u5B89\u5168\u3001\u6027\u80FD\u3001\u5E76\u53D1\u548C\u517C\u5BB9\u6027\u3002\u7528\u6237\u660E\u786E\u8981\u6C42\u624D\u53EF\u8DF3\u8FC7\u5168\u90E8 review\uFF0C\u5E76\u5199\u5165 \`skippedSteps\` \u548C\u6B8B\u4F59\u98CE\u9669\u3002
 9. Post-game\uFF1A\u6C47\u603B blocker\uFF0C\u53EA\u505A\u4E00\u8F6E\u4FEE\u590D\u5E76\u7528 \`workflow review ... remediate\` \u8BB0\u5F55\uFF1B\u590D\u9A8C\u540E\u5199 summary \u4E0E hand-off\u3002\u9A8C\u8BC1\u5931\u8D25\u3001\u5BA1\u67E5\u4E0D\u5B8C\u6574\u6216\u4ECD\u6709 blocker \u65F6\u6807\u8BB0 blocked\uFF0C\u4E0D\u5F97\u6807 completed\u3002
 
-\u5982\u679C\u7528\u6237\u5728\u786E\u8BA4\u9636\u6BB5\u9009\u62E9"\u9000\u51FA"\u6216\u653E\u5F03\u56E2\u961F workflow\uFF1A\u7528 \`mancode workflow update <taskId> --status abandoned\` \u66F4\u65B0\u5E76\u6E05\u7406 Active Plans\uFF1B\u82E5\u6709\u6D3B\u8DC3 mamba \u5B50\u4EFB\u52A1\uFF0C\u5148\u53D6\u5F97\u786E\u8BA4\u5E76\u9010\u4E2A abandoned\u3002\u6210\u529F\u540E\u518D\u7528 Edit \u66F4\u65B0 state \u56DE solo\u3002\u4E0D\u8981\u76F4\u63A5\u6539 metadata\uFF0C\u4E5F\u4E0D\u8981\u628A abandoned workflow \u7559\u5728 active state\u3002
+\u5982\u679C\u7528\u6237\u5728\u786E\u8BA4\u9636\u6BB5\u9009\u62E9"\u9000\u51FA"\u6216\u653E\u5F03\u56E2\u961F workflow\uFF1A\u7528 \`mancode workflow update <taskId> --status abandoned\` \u66F4\u65B0\u5E76\u6E05\u7406 Active Plans\uFF1B\u82E5\u6709\u6D3B\u8DC3 manba \u5B50\u4EFB\u52A1\uFF0C\u5148\u53D6\u5F97\u786E\u8BA4\u5E76\u9010\u4E2A abandoned\u3002\u6210\u529F\u540E\u518D\u7528 Edit \u66F4\u65B0 state \u56DE solo\u3002\u4E0D\u8981\u76F4\u63A5\u6539 metadata\uFF0C\u4E5F\u4E0D\u8981\u628A abandoned workflow \u7559\u5728 active state\u3002
 
 ## Team Hand-off Summary
 
@@ -1493,6 +1494,7 @@ var LEGACY_CLAUDE_SKILL_SETTINGS = {
   man: ".claude/skills/mancode-man.md",
   mansolo: ".claude/skills/mancode-mansolo.md"
 };
+var LEGACY_MVP2_SKILL_NAMES = ["mamba", "man8"];
 async function validateClaudeCodeSettings(projectRoot) {
   await readClaudeSettings(path3.join(projectRoot, ".claude"));
 }
@@ -1500,6 +1502,7 @@ async function installClaudeCode(projectRoot, options) {
   const claudeDir = path3.join(projectRoot, ".claude");
   const settings = await readClaudeSettings(claudeDir);
   const force = options.force ?? false;
+  await validateClaudeWriteTargets(claudeDir, options.minimal ?? false, force);
   await installMancodeCore(projectRoot);
   await mkdir3(path3.join(claudeDir, "skills"), { recursive: true });
   await installSoloSkill(path3.join(claudeDir, "skills"), force);
@@ -1516,6 +1519,33 @@ async function installClaudeCode(projectRoot, options) {
   await updateClaudeSettings(claudeDir, settings);
   await removeLegacyHookFiles(projectRoot);
 }
+async function validateClaudeWriteTargets(claudeDir, minimal, force) {
+  if (!force) return;
+  const skillsDir = path3.join(claudeDir, "skills");
+  await assertWritableClaudeSkill(skillsDir, "solo");
+  if (minimal) return;
+  for (const skill of MVP2_SKILLS) {
+    await assertWritableClaudeSkill(skillsDir, skill.name);
+  }
+  for (const agent of ALL_AGENTS) {
+    const agentPath = path3.join(claudeDir, "agents", `${agent.name}.md`);
+    const existing = await readTextIfExists2(agentPath);
+    if (existing !== null && !isGeneratedClaudeAgent(existing, agent.name)) {
+      throw new Error(
+        `refusing to overwrite user-authored Claude Code agent: ${agentPath}`
+      );
+    }
+  }
+}
+async function assertWritableClaudeSkill(skillsDir, modeName) {
+  const skillPath = path3.join(skillsDir, modeName, "SKILL.md");
+  const existing = await readTextIfExists2(skillPath);
+  if (existing !== null && !isGeneratedClaudeSkill(existing, modeName)) {
+    throw new Error(
+      `refusing to overwrite user-authored Claude Code skill: ${skillPath}`
+    );
+  }
+}
 async function removeLegacyHookFiles(projectRoot) {
   const hooksDir = path3.join(projectRoot, ".mancode", "hooks");
   await Promise.all([
@@ -1536,20 +1566,24 @@ async function installSoloSkill(skillsDir, force) {
   await removeLegacyFlatSkill(skillsDir, "mancode-solo", "solo");
 }
 async function installMvp2Skills(skillsDir, force) {
-  await removeManagedLegacyMan8Skill(skillsDir);
   for (const skill of MVP2_SKILLS) {
     await installProjectSkill(skillsDir, skill, force);
     await removeLegacyFlatSkill(skillsDir, `mancode-${skill.name}`, skill.name);
   }
+  await removeManagedLegacyMvp2Skills(skillsDir);
 }
-async function removeManagedLegacyMan8Skill(skillsDir) {
-  await removeGeneratedSkillDir(skillsDir, "man8");
+async function removeManagedLegacyMvp2Skills(skillsDir) {
+  for (const modeName of LEGACY_MVP2_SKILL_NAMES) {
+    await removeGeneratedSkillDir(skillsDir, modeName);
+    await removeLegacyFlatSkill(skillsDir, `mancode-${modeName}`, modeName);
+  }
 }
 async function uninstallMvp2Skills(skillsDir) {
   for (const skill of MVP2_SKILLS) {
     await removeGeneratedSkillDir(skillsDir, skill.name);
     await removeLegacyFlatSkill(skillsDir, `mancode-${skill.name}`, skill.name);
   }
+  await removeManagedLegacyMvp2Skills(skillsDir);
 }
 async function installProjectSkill(skillsDir, skill, force = true) {
   const skillDir = path3.join(skillsDir, skill.name);
@@ -1615,7 +1649,7 @@ async function removeClaudeGeneratedContent(projectRoot) {
   const skillsDir = path3.join(claudeDir, "skills");
   for (const modeName of [
     "solo",
-    "man8",
+    ...LEGACY_MVP2_SKILL_NAMES,
     ...MVP2_SKILLS.map((skill) => skill.name)
   ]) {
     await removeGeneratedSkillDir(skillsDir, modeName);
@@ -1650,8 +1684,9 @@ ${marker}
 async function readTextIfExists2(filePath) {
   try {
     return await readFile3(filePath, "utf-8");
-  } catch {
-    return null;
+  } catch (error) {
+    if (isNodeError2(error) && error.code === "ENOENT") return null;
+    throw error;
   }
 }
 async function removeIfEmpty(dir) {
@@ -1783,13 +1818,13 @@ import path6 from "path";
 import { mkdir as mkdir4, readFile as readFile4, readdir as readdir2, rm as rm2, writeFile as writeFile4 } from "fs/promises";
 import path4 from "path";
 var MODE_NAMES = [
-  "mamba",
+  "manba",
   "man",
   "manteam",
   "manps",
   "mansolo"
 ];
-var LEGACY_MODE_NAMES = ["man8"];
+var LEGACY_MODE_NAMES = ["mamba", "man8"];
 var CODEX_SKILL_MANAGED_MARKER = "<!-- Managed by mancode:codex-skill. Do not edit this file manually. -->";
 var ZCODE_SKILL_MANAGED_MARKER = "<!-- Managed by mancode:zcode-skill. Do not edit this file manually. -->";
 var MODE_FILE_MANAGED_MARKER = "<!-- Managed by mancode:mode-file. Do not edit this file manually. -->";
@@ -1799,7 +1834,7 @@ var MANCODE_AGENT_SKILL_MARKERS = [
 ];
 function renderModeSkill(mode, commandPrefix = "$") {
   const meta = MODE_META[mode];
-  const stateMode = mode === "mansolo" ? "solo" : mode;
+  const stateMode = mode === "mansolo" ? "solo" : mode === "manba" ? "mamba" : mode;
   const modesList = MODE_NAMES.map((m) => `${commandPrefix}${m}`).join(", ");
   return [
     meta.intro,
@@ -1840,7 +1875,6 @@ async function installCodexSkills(projectRoot, minimal) {
     return;
   }
   const skillsDir = path4.join(projectRoot, ".agents", "skills");
-  await removeLegacyManagedSkills(skillsDir, MANCODE_AGENT_SKILL_MARKERS);
   for (const mode of MODE_NAMES) {
     const modeDir = path4.join(skillsDir, mode);
     await mkdir4(modeDir, { recursive: true });
@@ -1864,6 +1898,7 @@ async function installCodexSkills(projectRoot, minimal) {
       MANCODE_AGENT_SKILL_MARKERS
     );
   }
+  await removeLegacyManagedSkills(skillsDir, MANCODE_AGENT_SKILL_MARKERS);
 }
 async function installZcodeSkills(projectRoot, minimal) {
   if (minimal) {
@@ -1871,7 +1906,6 @@ async function installZcodeSkills(projectRoot, minimal) {
     return;
   }
   const skillsDir = path4.join(projectRoot, ".agents", "skills");
-  await removeLegacyManagedSkills(skillsDir, MANCODE_AGENT_SKILL_MARKERS);
   for (const mode of MODE_NAMES) {
     const modeDir = path4.join(skillsDir, mode);
     await mkdir4(modeDir, { recursive: true });
@@ -1895,6 +1929,7 @@ async function installZcodeSkills(projectRoot, minimal) {
       MANCODE_AGENT_SKILL_MARKERS
     );
   }
+  await removeLegacyManagedSkills(skillsDir, MANCODE_AGENT_SKILL_MARKERS);
 }
 async function installCursorCommands(projectRoot, minimal) {
   if (minimal) {
@@ -1903,7 +1938,6 @@ async function installCursorCommands(projectRoot, minimal) {
   }
   const commandsDir = path4.join(projectRoot, ".cursor", "commands");
   await mkdir4(commandsDir, { recursive: true });
-  await removeLegacyGeneratedModeFile(path4.join(commandsDir, "man8.md"));
   for (const mode of MODE_NAMES) {
     const meta = MODE_META[mode];
     const content = [
@@ -1923,6 +1957,8 @@ async function installCursorCommands(projectRoot, minimal) {
       "Cursor"
     );
   }
+  await removeManagedModeFile(path4.join(commandsDir, "mamba.md"), "mamba");
+  await removeLegacyGeneratedModeFile(path4.join(commandsDir, "man8.md"));
 }
 async function installCopilotPrompts(projectRoot, minimal) {
   if (minimal) {
@@ -1931,7 +1967,6 @@ async function installCopilotPrompts(projectRoot, minimal) {
   }
   const promptsDir = path4.join(projectRoot, ".github", "prompts");
   await mkdir4(promptsDir, { recursive: true });
-  await removeLegacyGeneratedModeFile(path4.join(promptsDir, "man8.prompt.md"));
   for (const mode of MODE_NAMES) {
     const meta = MODE_META[mode];
     const content = [
@@ -1952,6 +1987,11 @@ async function installCopilotPrompts(projectRoot, minimal) {
       "GitHub Copilot"
     );
   }
+  await removeManagedModeFile(
+    path4.join(promptsDir, "mamba.prompt.md"),
+    "mamba"
+  );
+  await removeLegacyGeneratedModeFile(path4.join(promptsDir, "man8.prompt.md"));
 }
 async function removeCodexSkills(projectRoot) {
   if (!await platformNeedsSharedSkills(projectRoot, "zcode")) {
@@ -2090,18 +2130,22 @@ function isRecord2(value) {
 async function readTextIfExists3(filePath) {
   try {
     return await readFile4(filePath, "utf-8");
-  } catch {
-    return null;
+  } catch (error) {
+    if (isNodeError3(error) && error.code === "ENOENT") return null;
+    throw error;
   }
 }
+function isNodeError3(error) {
+  return error instanceof Error && "code" in error;
+}
 var MODE_META = {
-  mamba: {
+  manba: {
     description: "Diagnose bugs and validate real user flows with targeted regression checks.",
-    intro: "# mancode mamba \u2014 Diagnosis and Real Validation",
+    intro: "# mancode manba \u2014 Diagnosis and Real Validation",
     workflow: [
       "## Five-step workflow (simulate roles in one conversation)",
       "",
-      'Use `mancode workflow create mamba "<task>" --json`; when called from',
+      'Use `mancode workflow create manba "<task>" --json`; when called from',
       "a /man or /manteam Step 6 workflow, add `--parent-task <taskId>`. Persist the returned",
       "taskId in `.mancode/state.json` as currentTask; set currentMode and",
       "currentWorkflowMode to mamba. Never edit metadata.json directly; use",
@@ -2137,7 +2181,7 @@ var MODE_META = {
       "Step 3 \u2014 Plan: write `plan.md` with scope, reuse, exclusions, risks, completion criteria, and real validation. First plan is v1; revisions use `--plan-version <current+1>` and Active Plans is updated by the CLI.",
       "Step 4 \u2014 Plan gate: the user chooses plan-only (`status planned`), continue to execution, or revise the plan. Do not implement before this choice.",
       "Step 5 \u2014 Implement the confirmed minimum change.",
-      "Step 6 \u2014 Run detected build/lint/typecheck/test and smoke checks. A real or complex diagnosis creates a linked mamba child while the parent remains at Step 6. After a resolved child, restore a parent blocked by that child with `workflow update --status in_progress` before Step 7; never auto-resume manual_test_required. Then write `review-scope.md` from the actual diff, verification evidence, and hard-risk triggers. Initialize a targeted review for routine governed changes or a full review for auth, payment, sensitive data, migrations/deletion, public APIs, untrusted input, concurrency, cross-service, or infrastructure changes using `mancode workflow review <taskId> init ...`.",
+      "Step 6 \u2014 Run detected build/lint/typecheck/test and smoke checks. A real or complex diagnosis creates a linked manba child while the parent remains at Step 6. After a resolved child, restore a parent blocked by that child with `workflow update --status in_progress` before Step 7; never auto-resume manual_test_required. Then write `review-scope.md` from the actual diff, verification evidence, and hard-risk triggers. Initialize a targeted review for routine governed changes or a full review for auth, payment, sensitive data, migrations/deletion, public APIs, untrusted input, concurrency, cross-service, or infrastructure changes using `mancode workflow review <taskId> init ...`.",
       "Step 7 \u2014 Run one quality review limited to the changed diff and direct impact. Findings require changed-line evidence and user impact, with at most three new findings. Record stable blocker IDs through `workflow review ... complete`; do not fix yet.",
       "Step 8 \u2014 Only full review runs the security/boundary reviewer. It must read Film #1, mark the same root cause duplicate, and stay within security, permissions, recovery, resources, and boundaries. A targeted review ends after Film #1.",
       "Step 9 \u2014 If open blockers exist, fix them in one remediation round and record resolved IDs through `workflow review ... remediate`; with no blockers, do not create a remediation round. Re-run affected verification without re-running completed reviewers. Write `summary.md` and set completed only when required domains are complete and blockers are zero; otherwise set blocked+blockingReason.",
@@ -2158,9 +2202,9 @@ var MODE_META = {
       "",
       "Then execute every /man Step 1 through Step 9, including clarification,",
       "plan gate, validation, bounded risk-based review, conditional completion, planVersion,",
-      "Active Plans, and linked mamba child behavior. Add compatibility, rollback,",
+      "Active Plans, and linked manba child behavior. Add compatibility, rollback,",
       "ownership, conflict, and handoff notes at each relevant step.",
-      "When a resolved mamba child had blocked the parent, restore the parent through",
+      "When a resolved manba child had blocked the parent, restore the parent through",
       "`workflow update --status in_progress`; never auto-resume manual_test_required.",
       "",
       "Read `.mancode/memory/prd.md`, `spec.md`, and `decisions.md`; append durable",
@@ -2234,7 +2278,7 @@ function renderProjectContext(state, tokens, profile, options) {
   const currentProfile = options.projectProfile ?? profile;
   const techStack = options.projectProfile ? options.techStack.join(" + ") || "Unknown" : state?.techStack || options.techStack.join(" + ") || "Unknown";
   const uiLibrary = options.projectProfile ? options.uiLibrary || "None" : state?.uiLibrary || tokens?.uiLibrary || options.uiLibrary || "None";
-  const mode = state?.currentMode || "solo";
+  const mode = state?.currentMode === "mamba" ? "manba" : state?.currentMode || "solo";
   return [
     "## mancode Project Context",
     "",
@@ -2298,7 +2342,7 @@ function renderAesthetics(tokens) {
 function renderModes(options) {
   let commandLabel;
   if (options.capabilities.skills === "agents-skills") {
-    commandLabel = "Invoke mode skills with `$man`, `$mamba`, `$manteam`, `$manps`, `$mansolo`.";
+    commandLabel = "Invoke mode skills with `$man`, `$manba`, `$manteam`, `$manps`, `$mansolo`.";
   } else if (options.capabilities.slashCommands === "native") {
     commandLabel = "Use the named commands directly when available.";
   } else {
@@ -2309,7 +2353,7 @@ function renderModes(options) {
     "",
     `- solo: default lightweight mode. ${commandLabel}`,
     "- man: progressive governance workflow with planning and optional full execution.",
-    "- mamba: diagnose bugs and validate real user flows or regressions.",
+    "- manba: diagnose bugs and validate real user flows or regressions.",
     "- manteam: use team memory and leave handoff-friendly summaries.",
     "- manps: run project health and cleanup scans before remediation.",
     "- mansolo: return to solo mode."
@@ -2371,11 +2415,15 @@ var MANCODE_CURSOR_CORE_RULE_FILES = [
   "mancode-solo.mdc"
 ];
 var MANCODE_CURSOR_ADVANCED_RULE_FILES = [
-  "mancode-mamba.mdc",
+  "mancode-manba.mdc",
   "mancode-man.mdc",
   "mancode-manteam.mdc",
   "mancode-manps.mdc"
 ];
+var MANCODE_CURSOR_LEGACY_RULE_FILES = [
+  "mancode-mamba.mdc",
+  "mancode-man8.mdc"
+];
 var CURSOR_RULE_MANAGED_MARKER = "<!-- Managed by mancode:cursor-rule. Do not edit this marker. -->";
 var MANCODE_CURSOR_RULE_FILES = [
   ...MANCODE_CURSOR_CORE_RULE_FILES,
@@ -2427,13 +2475,12 @@ async function installCursor(projectRoot, options) {
     await installCursorCommands(projectRoot, true);
     return;
   }
-  await removeLegacyCursorRules(projectRoot);
   await writeRule(
     rulesDir,
-    "mancode-mamba.mdc",
+    "mancode-manba.mdc",
     "Use for bug diagnosis and real regression testing",
     false,
-    renderMambaRule()
+    renderManbaRule()
   );
   await writeRule(
     rulesDir,
@@ -2456,6 +2503,7 @@ async function installCursor(projectRoot, options) {
     false,
     renderManpsRule()
   );
+  await removeLegacyCursorRules(projectRoot);
   await installCursorCommands(projectRoot, options.minimal ?? false);
 }
 async function writeRule(rulesDir, fileName, description, alwaysApply, body) {
@@ -2503,18 +2551,9 @@ async function removeCursorGeneratedRules(projectRoot) {
   await removeLegacyCursorRules(projectRoot);
 }
 async function removeLegacyCursorRules(projectRoot) {
-  const legacyPath = path6.join(
-    projectRoot,
-    ".cursor",
-    "rules",
-    "mancode-man8.mdc"
-  );
-  try {
-    const content = await readFile6(legacyPath, "utf-8");
-    if (content.includes("# mancode man8 \u2014 Investigate and Plan") && content.includes("## Mode Persistence")) {
-      await rm3(legacyPath, { force: true });
-    }
-  } catch {
+  const rulesDir = path6.join(projectRoot, ".cursor", "rules");
+  for (const fileName of MANCODE_CURSOR_LEGACY_RULE_FILES) {
+    await removeGeneratedCursorRule(rulesDir, fileName);
   }
 }
 async function removeGeneratedCursorRule(rulesDir, fileName) {
@@ -2541,10 +2580,14 @@ function isGeneratedCursorRule(content, fileName) {
 async function readTextIfExists4(filePath) {
   try {
     return await readFile6(filePath, "utf-8");
-  } catch {
-    return null;
+  } catch (error) {
+    if (isNodeError4(error) && error.code === "ENOENT") return null;
+    throw error;
   }
 }
+function isNodeError4(error) {
+  return error instanceof Error && "code" in error;
+}
 function renderPracticeRule() {
   return [
     "# mancode Practice",
@@ -2575,8 +2618,8 @@ function renderSoloRule() {
     "- Recommend /man only for auth, payment, sensitive data, migrations/deletion, public APIs, untrusted input, concurrency, or infrastructure risk."
   ].join("\n");
 }
-function renderMambaRule() {
-  return renderModeSkill("mamba", "/");
+function renderManbaRule() {
+  return renderModeSkill("manba", "/");
 }
 function renderManRule() {
   return renderModeSkill("man", "/");
@@ -2763,7 +2806,7 @@ function renderCopilotPromptConventions() {
     "GitHub Copilot does not provide native mancode slash commands, hooks, or isolated subagents. Treat these names as user prompt conventions:",
     "",
     "- man: use progressive research, planning, implementation, verification, and bounded risk-based review.",
-    "- mamba: diagnose bugs and validate real user flows or regressions.",
+    "- manba: diagnose bugs and validate real user flows or regressions.",
     "- manteam: read team memory and write handoff-friendly summaries.",
     "- manps: prefer `mancode manps [area]` before cleanup.",
     "- mansolo: exit any active mode and return to default solo behavior.",
@@ -4402,7 +4445,9 @@ function getInitManagedFilePaths(rootDir, platforms) {
       ".mancode/hooks/user-prompt-submit.sh",
       ".claude/settings.json",
       ".claude/skills/man8/SKILL.md",
+      ".claude/skills/mamba/SKILL.md",
       ".claude/skills/solo/SKILL.md",
+      ".claude/skills/mancode-mamba.md",
       ".claude/skills/mancode-solo.md",
       ".claude/skills/mancode-man8.md"
     );
@@ -4417,7 +4462,12 @@ function getInitManagedFilePaths(rootDir, platforms) {
     }
   }
   if (platforms.includes("cursor")) {
-    files.push(".cursor/rules/mancode-man8.mdc", ".cursor/commands/man8.md");
+    files.push(
+      ".cursor/rules/mancode-mamba.mdc",
+      ".cursor/rules/mancode-man8.mdc",
+      ".cursor/commands/mamba.md",
+      ".cursor/commands/man8.md"
+    );
     for (const fileName of MANCODE_CURSOR_RULE_FILES) {
       files.push(`.cursor/rules/${fileName}`);
     }
@@ -4426,19 +4476,23 @@ function getInitManagedFilePaths(rootDir, platforms) {
     }
   }
   if (platforms.includes("codex") || platforms.includes("zcode")) {
-    files.push("AGENTS.md", ".agents/skills/man8/SKILL.md");
+    files.push(
+      "AGENTS.md",
+      ".agents/skills/mamba/SKILL.md",
+      ".agents/skills/man8/SKILL.md"
+    );
     for (const mode of MODE_NAMES) {
       files.push(`.agents/skills/${mode}/SKILL.md`);
     }
   }
   if (platforms.includes("codex")) {
-    files.push(".codex/skills/man8/SKILL.md");
+    files.push(".codex/skills/mamba/SKILL.md", ".codex/skills/man8/SKILL.md");
     for (const mode of MODE_NAMES) {
       files.push(`.codex/skills/${mode}/SKILL.md`);
     }
   }
   if (platforms.includes("zcode")) {
-    files.push(".zcode/skills/man8/SKILL.md");
+    files.push(".zcode/skills/mamba/SKILL.md", ".zcode/skills/man8/SKILL.md");
     for (const mode of MODE_NAMES) {
       files.push(`.zcode/skills/${mode}/SKILL.md`);
     }
@@ -4446,6 +4500,7 @@ function getInitManagedFilePaths(rootDir, platforms) {
   if (platforms.includes("copilot")) {
     files.push(
       ".github/copilot-instructions.md",
+      ".github/prompts/mamba.prompt.md",
       ".github/prompts/man8.prompt.md"
     );
     for (const mode of MODE_NAMES) {
@@ -4460,7 +4515,7 @@ async function snapshotFiles(filePaths) {
       try {
         return { filePath, content: await fs3.readFile(filePath, "utf-8") };
       } catch (error) {
-        if (isNodeError3(error) && error.code === "ENOENT") {
+        if (isNodeError5(error) && error.code === "ENOENT") {
           return { filePath, content: null };
         }
         throw error;
@@ -4506,7 +4561,7 @@ async function removeNewEmptyDirectories(snapshots) {
 function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function isNodeError3(error) {
+function isNodeError5(error) {
   return error instanceof Error && "code" in error;
 }
 function printPlatformCreatedFiles(platform, locale) {
@@ -4935,13 +4990,13 @@ async function readConfig(rootDir) {
     const raw = await fs5.readFile(configPath, "utf-8");
     return { config: JSON.parse(raw), valid: true };
   } catch (err) {
-    if (isNodeError4(err) && err.code === "ENOENT") {
+    if (isNodeError6(err) && err.code === "ENOENT") {
       return { config: {}, valid: false };
     }
     throw err;
   }
 }
-function isNodeError4(err) {
+function isNodeError6(err) {
   return err instanceof Error && "code" in err;
 }
 async function updateConfig(rootDir, config) {
@@ -5749,7 +5804,7 @@ async function readIssueDatabase(issueDbPath) {
   try {
     raw = await readFile8(issueDbPath, "utf-8");
   } catch (err) {
-    if (isNodeError5(err) && err.code === "ENOENT") {
+    if (isNodeError7(err) && err.code === "ENOENT") {
       return emptyIssueDatabase();
     }
     throw err;
@@ -5960,7 +6015,7 @@ async function pathExists6(file) {
     return false;
   }
 }
-function isNodeError5(err) {
+function isNodeError7(err) {
   return err instanceof Error && "code" in err;
 }
 function isRecord6(value) {
@@ -6255,7 +6310,7 @@ async function ensureReplaceableFile(filePath) {
       throw new Error(`cannot replace non-file path: ${filePath}`);
     }
   } catch (error) {
-    if (isNodeError6(error) && error.code === "ENOENT") return;
+    if (isNodeError8(error) && error.code === "ENOENT") return;
     throw error;
   }
 }
@@ -6272,7 +6327,7 @@ async function readOptionalText(filePath) {
   try {
     return await fs7.readFile(filePath, "utf-8");
   } catch (error) {
-    if (isNodeError6(error) && error.code === "ENOENT") return null;
+    if (isNodeError8(error) && error.code === "ENOENT") return null;
     throw error;
   }
 }
@@ -6335,7 +6390,7 @@ async function readRequiredState(filePath) {
 function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function isNodeError6(error) {
+function isNodeError8(error) {
   return error instanceof Error && "code" in error;
 }
 async function pathExists8(filePath) {
@@ -6755,7 +6810,7 @@ async function allocateTaskId(projectRoot, baseTaskId) {
       await mkdir9(workflowDir(projectRoot, taskId));
       return taskId;
     } catch (err) {
-      if (isNodeError7(err) && err.code === "EEXIST") {
+      if (isNodeError9(err) && err.code === "EEXIST") {
         continue;
       }
       throw err;
@@ -6871,7 +6926,7 @@ function isWorkflowOutcome(value) {
 async function validateParentTask(projectRoot, mode, parentTaskId, requireStepSix = false) {
   if (!parentTaskId) return;
   if (mode !== "mamba") {
-    throw new Error("only mamba workflows can have a parent task");
+    throw new Error("only manba workflows can have a parent task");
   }
   const parent = await readWorkflow(projectRoot, parentTaskId);
   if (!parent || parent.mode !== "man" && parent.mode !== "manteam") {
@@ -6911,14 +6966,14 @@ async function validateWorkflowMeta(projectRoot, updated, existing) {
     );
   }
   if (updated.status === "planned" && updated.mode === "mamba") {
-    throw new Error("mamba workflows cannot be planned");
+    throw new Error("manba workflows cannot be planned");
   }
   if (updated.status === "planned" && updated.currentStep !== 4) {
     throw new Error("planned workflows must be at step 4");
   }
   if (updated.status === "completed" && updated.currentStep !== maxWorkflowStep(updated.mode)) {
     throw new Error(
-      `completed ${updated.mode} workflows must be at step ${maxWorkflowStep(updated.mode)}`
+      `completed ${updated.mode === "mamba" ? "manba" : updated.mode} workflows must be at step ${maxWorkflowStep(updated.mode)}`
     );
   }
   if (updated.blockingReason !== void 0 && typeof updated.blockingReason !== "string") {
@@ -6932,25 +6987,25 @@ async function validateWorkflowMeta(projectRoot, updated, existing) {
     throw new Error("only blocked workflows can have a blocking reason");
   }
   if (updated.mode !== "mamba" && updated.outcome !== void 0) {
-    throw new Error("only mamba workflows can have an outcome");
+    throw new Error("only manba workflows can have an outcome");
   }
   if (updated.outcome !== void 0 && !isWorkflowOutcome(updated.outcome)) {
     throw new Error(`invalid workflow outcome: ${updated.outcome}`);
   }
   if (updated.outcome !== void 0 && updated.status !== "completed") {
-    throw new Error("mamba outcomes can only be set on completed workflows");
+    throw new Error("manba outcomes can only be set on completed workflows");
   }
   if (updated.mode === "mamba" && updated.status === "completed" && !updated.outcome) {
-    throw new Error("completed mamba workflows require an outcome");
+    throw new Error("completed manba workflows require an outcome");
   }
   if (updated.mode === "mamba" && updated.planVersion !== void 0) {
-    throw new Error("mamba workflows cannot have a plan version");
+    throw new Error("manba workflows cannot have a plan version");
   }
   if (updated.reviewPolicyVersion !== void 0 && updated.reviewPolicyVersion !== 1) {
     throw new Error("invalid workflow review policy version");
   }
   if (updated.mode === "mamba" && updated.reviewPolicyVersion !== void 0) {
-    throw new Error("mamba workflows cannot have a review policy version");
+    throw new Error("manba workflows cannot have a review policy version");
   }
   if (updated.planVersion !== void 0 && (!Number.isInteger(updated.planVersion) || updated.planVersion < 1)) {
     throw new Error("workflow plan version must be a positive integer");
@@ -6963,7 +7018,7 @@ async function validateWorkflowMeta(projectRoot, updated, existing) {
   }
   await validateParentTask(projectRoot, updated.mode, updated.parentTaskId);
   if ((isTerminalWorkflowStatus(updated.status) || updated.status === "planned") && (await listActiveMambaChildren(projectRoot, updated.taskId)).length > 0) {
-    throw new Error("cannot finish workflow with an active mamba child");
+    throw new Error("cannot finish workflow with an active manba child");
   }
   if (updated.status === "completed" && updated.reviewPolicyVersion === 1 && !reviewWasExplicitlySkipped(updated) && !await reviewCanComplete(projectRoot, updated.taskId)) {
     throw new Error("workflow review is incomplete or still has open blockers");
@@ -7034,7 +7089,7 @@ async function propagateChildStatus(projectRoot, child) {
   if (!parentTaskId) return;
   const parent = await readWorkflow(projectRoot, parentTaskId);
   if (!parent || parent.status !== "in_progress") return;
-  const reason = child.status === "blocked" ? `mamba child ${child.taskId} is blocked: ${child.blockingReason ?? "unknown reason"}` : `mamba child ${child.taskId} requires manual testing`;
+  const reason = child.status === "blocked" ? `manba child ${child.taskId} is blocked: ${child.blockingReason ?? "unknown reason"}` : `manba child ${child.taskId} requires manual testing`;
   await writeMetadata(workflowDir(projectRoot, parent.taskId), {
     ...parent,
     status: "blocked",
@@ -7049,7 +7104,7 @@ async function propagateChildStatus(projectRoot, child) {
     });
   }
 }
-function isNodeError7(err) {
+function isNodeError9(err) {
   return err instanceof Error && "code" in err;
 }
 function assertValidTaskId2(taskId) {
@@ -7309,7 +7364,8 @@ function runHookEstimate(rootDir, hookPath) {
   });
 }
 function printText(r) {
-  const modeLabel = r.mode === "solo" ? `${r.mode} (default)` : r.mode;
+  const publicMode = r.mode === "mamba" ? "manba" : r.mode;
+  const modeLabel = publicMode === "solo" ? `${publicMode} (default)` : publicMode;
   console.log("");
   console.log(`mancode v${r.version}`);
   console.log("");
@@ -7686,7 +7742,7 @@ async function workflow(rootDir, subcommand, args = [], options = {}) {
       } else {
         console.error(`\u2717  Invalid workflow subcommand: ${subcommand}`);
         console.error(
-          "   Use: create <man|mamba|manteam> <task> | update <taskId> | review <taskId> <init|complete|remediate|show> | list | show <taskId> | clean"
+          "   Use: create <man|manba|manteam> <task> | update <taskId> | review <taskId> <init|complete|remediate|show> | list | show <taskId> | clean"
         );
       }
       return EXIT_INVALID_ARG2;
@@ -7790,20 +7846,21 @@ function parseCsv(value) {
   return (value ?? "").split(",").map((item) => item.trim()).filter(Boolean);
 }
 async function workflowCreate(rootDir, args, options) {
-  const mode = args[0];
+  const requestedMode = args[0];
+  const mode = parsePublicWorkflowMode(requestedMode);
   const task = args.slice(1).join(" ").trim();
-  if (mode !== "man" && mode !== "mamba" && mode !== "manteam") {
+  if (!mode) {
     return invalidArg(
       options,
-      `invalid workflow mode: ${mode ?? ""}`,
-      "Use: mancode workflow create <man|mamba|manteam> <task> [--parent-task <taskId>]"
+      `invalid workflow mode: ${requestedMode ?? ""}`,
+      "Use: mancode workflow create <man|manba|manteam> <task> [--parent-task <taskId>]"
     );
   }
   if (!task) {
     return invalidArg(
       options,
       "missing workflow task",
-      "Use: mancode workflow create <man|mamba|manteam> <task> [--parent-task <taskId>]"
+      "Use: mancode workflow create <man|manba|manteam> <task> [--parent-task <taskId>]"
     );
   }
   try {
@@ -7873,7 +7930,7 @@ async function workflowUpdate(rootDir, taskId, options) {
     if (existing.mode !== "mamba" || nextStatus !== "completed") {
       return invalidArg(
         options,
-        "--outcome is only valid when completing a mamba workflow"
+        "--outcome is only valid when completing a manba workflow"
       );
     }
     patch.outcome = options.outcome;
@@ -7981,7 +8038,7 @@ async function workflowShow(rootDir, taskId, options) {
   }
   console.log(`Workflow:    ${meta.taskId}`);
   console.log(`Task:        ${meta.task}`);
-  console.log(`Mode:        ${meta.mode}`);
+  console.log(`Mode:        ${formatPublicWorkflowMode(meta.mode)}`);
   console.log(`Status:      ${meta.status}`);
   console.log(`Current step:${meta.currentStep}/${maxWorkflowStep(meta.mode)}`);
   console.log(
@@ -7996,7 +8053,7 @@ async function workflowShow(rootDir, taskId, options) {
   if (meta.blockingReason) console.log(`Blocked:     ${meta.blockingReason}`);
   if (children !== void 0) {
     if (children.length > 0) {
-      console.log(`Children:    ${children.length} active mamba workflow(s)`);
+      console.log(`Children:    ${children.length} active manba workflow(s)`);
       for (const child of children) {
         console.log(
           `  - ${child.taskId} (Step ${child.currentStep}/5, ${child.status})`
@@ -8084,7 +8141,15 @@ function formatWorkflowRow(meta) {
     meta.blockingReason ? `blocked=${meta.blockingReason}` : "",
     meta.activeChildren && meta.activeChildren.length > 0 ? `children=${meta.activeChildren.map((child) => child.taskId).join(",")}` : ""
   ].filter(Boolean);
-  return `${meta.taskId.padEnd(42)} ${meta.mode.padEnd(7)} ${meta.status.padEnd(11)} ${step}${details.length > 0 ? ` | ${details.join(" | ")}` : ""}`;
+  return `${meta.taskId.padEnd(42)} ${formatPublicWorkflowMode(meta.mode).padEnd(7)} ${meta.status.padEnd(11)} ${step}${details.length > 0 ? ` | ${details.join(" | ")}` : ""}`;
+}
+function parsePublicWorkflowMode(value) {
+  if (value === "manba" || value === "mamba") return "mamba";
+  if (value === "man" || value === "manteam") return value;
+  return null;
+}
+function formatPublicWorkflowMode(mode) {
+  return mode === "mamba" ? "manba" : mode;
 }
 function attachActiveChildren(workflows) {
   return workflows.map((meta) => {
@@ -8142,7 +8207,7 @@ async function pathExists12(p) {
 
 // src/cli.ts
 program.name("mancode").description(
-  "AI coding agent harness. Modes: solo, man, mamba, manteam, manps."
+  "AI coding agent harness. Modes: solo, man, manba, manteam, manps."
 ).version(VERSION);
 program.command("init").description("Initialize mancode in the current project").option("--force", "Reinstall even if already initialized").option("--yes", "Skip all confirmations (CI mode)").option("--team", "Force enable team mode (MVP-2)").option("--no-team", "Force disable team mode (MVP-2)").option("--style <name>", "Specify aesthetic style (MVP-2)").option("--platform <platforms>", "Adapters: comma-separated names or all").option("--empty", "Initialize a safe empty directory as a generic project").option("--lang <locale>", "Initialization language: zh-CN or en").action(async (options) => {
   const code = await init(process.cwd(), {
@@ -8175,8 +8240,8 @@ program.command("uninstall [platform]").description("Remove platform adapter or
 });
 program.command("workflow <subcommand> [args...]").description("Manage mancode workflows").option("--dry-run", "Preview clean without deleting").option("--older-than <duration>", "Clean workflows older than (e.g. 30d)").option("--step <n>", "Update workflow current step").option("--status <status>", "Update workflow status").option(
   "--parent-task <taskId>",
-  "Parent /man or /manteam workflow for mamba"
-).option("--blocking-reason <reason>", "Explain why a workflow is blocked").option("--outcome <outcome>", "Set mamba outcome").option("--plan-version <n>", "Set the next man/manteam plan revision").option("--skipped <steps>", "Update skipped steps as comma-separated values").option("--review-depth <depth>", "Review depth: targeted or full").option("--review-domain <domain>", "Review domain: quality or security").option(
+  "Parent /man or /manteam workflow for manba"
+).option("--blocking-reason <reason>", "Explain why a workflow is blocked").option("--outcome <outcome>", "Set manba outcome").option("--plan-version <n>", "Set the next man/manteam plan revision").option("--skipped <steps>", "Update skipped steps as comma-separated values").option("--review-depth <depth>", "Review depth: targeted or full").option("--review-domain <domain>", "Review domain: quality or security").option(
   "--report <path>",
   "Relative Markdown report path for a review domain"
 ).option("--blockers <ids>", "Comma-separated blocker ids found by a review").option(