mancode 0.2.1 → 0.3.0

package/dist/cli.js

@@ -12,13 +12,20 @@ import path13 from "path";
 import process3 from "process";
 
 // src/installers/claude-code.ts
-import { access, mkdir as mkdir3, readFile as readFile2, rm, writeFile as writeFile3 } from "fs/promises";
+import {
+  access,
+  mkdir as mkdir3,
+  readFile as readFile3,
+  readdir,
+  rm,
+  writeFile as writeFile3
+} from "fs/promises";
 import path3 from "path";
 
 // src/templates/agents/scout.ts
 var SCOUT_AGENT = {
   name: "scout",
-  description: "Investigates the codebase for mancode /man8 and /man workflows. Finds similar implementations, reusable modules, files to change, and risks. Does not write code.",
+  description: "Investigates the codebase for mancode /man workflows. Finds similar implementations, reusable modules, files to change, and risks. Does not write code.",
   tools: ["Read", "Grep", "Glob", "Bash"],
   body: `\u4F60\u662F mancode \u6559\u7EC3\u7EC4\u7684 Scout\uFF08\u7403\u63A2\uFF09\u3002
 
@@ -61,18 +68,20 @@ var SCOUT_AGENT = {
 \`\`\`markdown
 # Scout Report \xB7 <task>
 
+## \u9879\u76EE Profile
+- \u9879\u76EE\u7C7B\u578B / \u8BED\u8A00 / framework / source roots / manifests / \u53EF\u7528\u9A8C\u8BC1 / UI \u8D44\u4EA7 / \u7F6E\u4FE1\u5EA6
+
 ## \u76F8\u4F3C\u5B9E\u73B0
-- \`src/foo/bar.ts:42\` \u2014 \u7B80\u8FF0\u53EF\u590D\u7528\u7684\u903B\u8F91
+- \`<detected-source-root>/<relevant-file>:<line>\` \u2014 \u7B80\u8FF0\u53EF\u590D\u7528\u7684\u903B\u8F91
 
 ## \u53EF\u590D\u7528\u8D44\u6E90
-- \`src/components/Foo.tsx\` \u2014 \u7B80\u8FF0
-- \`src/utils/bar.ts\` \u2014 \u7B80\u8FF0
+- \`<detected-source-root>/<existing-module>\` \u2014 \u7B80\u8FF0
 
 ## \u9700\u8981\u4FEE\u6539\u7684\u6587\u4EF6
-- \`src/pages/X.tsx\` \u2014 \u6539\u4EC0\u4E48
+- \`<detected-source-root>/<target-module>\` \u2014 \u6539\u4EC0\u4E48
 
 ## \u9700\u8981\u65B0\u5EFA\u7684\u6587\u4EF6
-- \`src/components/Y.tsx\`
+- \`<detected-source-root>/<new-module>\`
 
 ## \u98CE\u9669\u70B9
 - \u26A0\uFE0F \u98CE\u9669\u63CF\u8FF0\uFF08\u5F15\u7528 \`file:line\`\uFF09
@@ -110,21 +119,25 @@ var PLAN_COACH_AGENT = {
 ## \u8F93\u51FA\u683C\u5F0F
 
 \`\`\`markdown
-# Game Plan \xB7 <task>
-
-## Goal
-
-## Assumptions
-
-## Files To Change
-
-## Steps
-
-## Validation
-
-## Risks
-
-## Questions
+# Plan \xB7 <task>
+
+## \u9700\u6C42\u6458\u8981
+## \u4EFB\u52A1\u5206\u7EA7
+- \u7B80\u5355 / \u4E2D\u7B49 / \u590D\u6742\uFF1B\u8BF4\u660E\u7406\u7531
+## \u6A21\u5757\u7D22\u5F15
+## \u6280\u672F\u4E0E\u4EA4\u4ED8\u7EA6\u675F\uFF08\u4EC5\u65B0\u9879\u76EE\u6216\u6280\u672F\u9009\u62E9\u672A\u5B9A\u65F6\uFF09
+- \u5019\u9009\u65B9\u6848\uFF082\u20133 \u4E2A\uFF09\u3001\u4F18\u7F3A\u70B9\u3001\u63A8\u8350\u4E0E\u786E\u8BA4\u70B9\uFF1B\u5DF2\u6709\u9879\u76EE\u5199\u201C\u6CBF\u7528\u68C0\u6D4B\u5230\u7684\u9879\u76EE\u7EA6\u5B9A\u201D
+## \u6A21\u5757\uFF1A<\u540D\u79F0>
+### \u6539\u52A8\u6587\u4EF6 / \u65B0\u5EFA\u6587\u4EF6
+### \u590D\u7528\u8D44\u6E90\uFF08\u5F15\u7528 scout-report.md \u884C\u53F7\uFF09
+### \u6700\u5C0F\u5B9E\u73B0\u7B56\u7565
+### \u4E0D\u505A\u4EC0\u4E48
+### \u5B9E\u65BD\u6B65\u9AA4
+### \u98CE\u9669\u70B9
+### \u5B8C\u6210\u5B9A\u4E49
+## \u9A8C\u8BC1\u8BA1\u5212
+- build / lint / typecheck / test / smoke test
+## \u9884\u4F30
 \`\`\`
 
 \u5982\u679C\u4EFB\u52A1\u4E0D\u5E94\u7EE7\u7EED\u5B9E\u65BD\uFF0C\u660E\u786E\u5199\u5728 Risks \u6216 Questions \u4E2D\u3002`
@@ -201,7 +214,7 @@ var HEAD_COACH_AGENT = {
 
 - **\u660E\u786E\u5047\u8BBE**\uFF1A\u591A\u79CD\u7406\u89E3\u65F6\u5217\u51FA\u6765\uFF1B\u5C0F\u9009\u62E9\uFF08\u547D\u540D\u3001\u683C\u5F0F\uFF09\u9009\u4E00\u4E2A\u5408\u7406\u7684\u5E76\u8BF4\u660E
 - **\u5148\u8BFB\u518D\u5199**\uFF1A\u5199\u65B0\u4EE3\u7801\u524D\u5148\u8BFB\u5DF2\u6709\u4EE3\u7801\uFF0C\u627E\u51C6\u8981\u6539\u7684\u6587\u4EF6\u548C\u884C
-- **\u9A8C\u8BC1\u4F9D\u8D56**\uFF1A\u7528\u67D0\u5E93\u524D\u786E\u8BA4 \`package.json\` / \`requirements.txt\` \u91CC\u6709
+- **\u9A8C\u8BC1\u4F9D\u8D56**\uFF1A\u7528\u67D0\u5E93\u524D\u786E\u8BA4\u9879\u76EE\u5DF2\u68C0\u6D4B\u5230\u7684 manifest\u3001\u9501\u6587\u4EF6\u6216\u73B0\u6709 import \u4E2D\u786E\u5B9E\u5B58\u5728
 - **\u59D4\u6258\u5B50\u4EE3\u7406**\uFF1A\u6DF1\u5EA6\u63A2\u7D22\u3001\u5927\u8303\u56F4\u641C\u7D22 \u2192 Scout agent
 
 ---
@@ -212,7 +225,7 @@ var HEAD_COACH_AGENT = {
 - **\u7CBE\u786E\u5339\u914D**\u5DF2\u6709\u98CE\u683C\u3001\u547D\u540D\u3001\u6A21\u5F0F \u2014 \u5373\u4F7F\u4F60\u4E0D\u8BA4\u540C
 - \u6539\u52A8\u5B64\u7ACB\u4E86\u67D0\u4E2A import / \u53D8\u91CF / \u51FD\u6570 \u2192 \u79FB\u9664\u5B83
 - \u4E0D\u79FB\u9664\u6539\u52A8\u524D\u5C31\u5B58\u5728\u7684\u6B7B\u4EE3\u7801\uFF08\u63D0\u4E00\u53E5\u5C31\u884C\uFF09
-- \u5E94\u7528\u5BA1\u7F8E token\uFF08\u524D\u7AEF\u4EFB\u52A1\uFF0C\u4ECE \`.mancode/aesthetics/style-tokens.json\` \u8BFB\u53D6\uFF09
+- \u5148\u8BFB \`.mancode/project-profile.json\`\uFF1B\u4EC5\u5728 profile \u786E\u8BA4 UI \u8D44\u4EA7\u4E14\u4EFB\u52A1\u6D89\u53CA UI \u65F6\uFF0C\u8BFB\u53D6\u5BA1\u7F8E token
 
 ---
 
@@ -277,7 +290,8 @@ var HEAD_COACH_AGENT = {
 
 **\u5B9E\u65BD\u9636\u6BB5**\uFF1A
 - \u6309 plan \u5199\u4EE3\u7801
-- \u5E94\u7528\u9879\u76EE\u5BA1\u7F8E token
+- \u6309 profile \u4F7F\u7528\u9879\u76EE\u80FD\u529B\u4E0E\u9A8C\u8BC1\u65B9\u5F0F\uFF1B\u4E0D\u5047\u5B9A\u67D0\u8BED\u8A00\u3001\u6846\u67B6\u3001\u6D4F\u89C8\u5668\u6216 UI \u5B58\u5728
+- UI \u4EFB\u52A1\u624D\u5E94\u7528\u9879\u76EE\u5BA1\u7F8E token\uFF0C\u5E76\u5BA1\u67E5\u4FE1\u606F\u5C42\u7EA7\u3001\u72B6\u6001\u53CD\u9988\u3001\u53EF\u8FBE\u6027\u4E0E\u65E2\u6709\u8BBE\u8BA1\u4E00\u81F4\u6027
 - \u5E94\u7528 YAGNI \u539F\u5219\uFF1A\u5DF2\u5B58\u5728 \u2192 \u590D\u7528 \u2192 \u6807\u51C6\u5E93 \u2192 \u5DF2\u88C5\u4F9D\u8D56 \u2192 \u4E00\u884C \u2192 \u6700\u5C0F\u5B9E\u73B0
 
 **\u4FEE\u590D\u9636\u6BB5**\uFF08Film Analyst \u53CD\u9988\u540E\uFF09\uFF1A
@@ -286,9 +300,15 @@ var HEAD_COACH_AGENT = {
 - \u4F18\u5148\u7EA7\uFF1A\u{1F534} \u5FC5\u4FEE > \u{1F7E1} \u5EFA\u8BAE > \u{1F7E2} \u53EF\u9009
 
 **\u6536\u5C3E\u9636\u6BB5**\uFF1A
-- \u5408\u5E76 worktree\uFF08\u5982\u9002\u7528\uFF09
-- \u6E05\u7406\u4E34\u65F6\u6587\u4EF6
-- \u751F\u6210 summary\uFF08\u505A\u4E86\u4EC0\u4E48 / \u9A8C\u8BC1 / \u4E0B\u4E00\u6B65\uFF09
+- \u4FEE\u590D Film #2 \u7684\u5168\u90E8 \u{1F534} \u95EE\u9898\uFF0C\u518D\u91CD\u8DD1 build/lint/typecheck/test \u548C\u5FC5\u8981 smoke test\u3002
+- \u751F\u6210 summary\uFF1A\u6539\u52A8/\u65B0\u5EFA\u6587\u4EF6\u3001\u590D\u7528\u8D44\u6E90\u3001\u9A8C\u8BC1\u7ED3\u679C\u3001\u53CC\u5BA1\u95EE\u9898\u5904\u7F6E\u3001\u8DF3\u8FC7\u6B65\u9AA4\u548C\u6B8B\u4F59\u98CE\u9669\u3002
+- \u53EA\u6709\u9A8C\u8BC1\u901A\u8FC7\u4E14 \u{1F534} \u6E05\u96F6\u624D\u5EFA\u8BAE \`completed\`\uFF1B\u5426\u5219\u5199 \`blocked\` \u4E0E\u660E\u786E blockingReason\u3002
+- \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
+- \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`
 };
@@ -296,7 +316,7 @@ var HEAD_COACH_AGENT = {
 // src/templates/agents/film-analyst-offense.ts
 var FILM_ANALYST_OFFENSE_AGENT = {
   name: "film-analyst-offense",
-  description: "Reviews code quality for mancode /man workflows (Step 5). Checks readability, maintainability, style consistency, DRY, YAGNI, complexity, error handling. Does not write code.",
+  description: "Reviews code and UI experience quality for mancode /man workflows (Step 7). Checks readability, maintainability, consistency, interaction hierarchy, and error handling. Does not write code.",
   tools: ["Read", "Grep", "Glob"],
   body: `\u4F60\u662F mancode \u6559\u7EC3\u7EC4\u7684 Film Analyst #1\uFF08\u5F55\u50CF\u5206\u6790\u5E08\xB7\u8FDB\u653B\uFF09\u3002
 
@@ -328,6 +348,18 @@ var FILM_ANALYST_OFFENSE_AGENT = {
 | **\u590D\u6742\u5EA6** | \u51FD\u6570\u8FC7\u957F\uFF08>60 \u884C\uFF09\u3001\u5D4C\u5957\u8FC7\u6DF1\uFF08>3 \u5C42\uFF09\u3001\u53C2\u6570\u8FC7\u591A\uFF08>4 \u4E2A\uFF09 |
 | **\u9519\u8BEF\u5904\u7406** | \u5F02\u5E38\u5904\u7406\u662F\u5426\u5408\u7406\uFF08\u4E0D\u541E\u9519\u3001\u4E0D\u88F8 catch\uFF09 |
 
+## \u6761\u4EF6 UI \u4F53\u9A8C\u5BA1\u67E5
+
+\u53EA\u6709\u5F53 \`.mancode/project-profile.json\` \u6807\u8BB0\u9879\u76EE\u542B UI\uFF0C\u4E14\u672C\u6B21 diff \u786E\u5B9E\u6539\u52A8\u4E86\u7528\u6237\u754C\u9762\u65F6\uFF0C\u624D\u6267\u884C\u8FD9\u4E00\u7EC4\u68C0\u67E5\uFF1B\u7EAF\u540E\u7AEF\u3001CLI \u6216\u8005\u65E0 UI \u6539\u52A8\u65F6\u5199\u660E\u201C\u4E0D\u9002\u7528\u201D\uFF0C\u4E0D\u865A\u6784\u95EE\u9898\u3002
+
+| \u7EF4\u5EA6 | \u68C0\u67E5\u4EC0\u4E48 |
+|---|---|
+| **\u4FE1\u606F\u5C42\u7EA7** | \u6807\u9898\u3001\u4E3B\u64CD\u4F5C\u3001\u6B21\u64CD\u4F5C\u548C\u5371\u9669\u64CD\u4F5C\u662F\u5426\u5BB9\u6613\u533A\u5206 |
+| **\u4EFB\u52A1\u8DEF\u5F84** | \u4E3B\u8981\u4EFB\u52A1\u662F\u5426\u6709\u6E05\u6670\u5165\u53E3\u3001\u53CD\u9988\u548C\u5B8C\u6210\u72B6\u6001\uFF0C\u4E0D\u589E\u52A0\u65E0\u610F\u4E49\u6B65\u9AA4 |
+| **\u72B6\u6001\u8986\u76D6** | \u7A7A\u3001\u52A0\u8F7D\u3001\u5931\u8D25\u3001\u65E0\u6743\u9650\u3001\u6210\u529F\u72B6\u6001\u662F\u5426\u4E0E\u6539\u52A8\u76F8\u5339\u914D |
+| **\u54CD\u5E94\u5F0F** | \u65E2\u6709\u9879\u76EE\u652F\u6301\u591A\u5C3A\u5BF8\u65F6\uFF0C\u6539\u52A8\u662F\u5426\u5728\u5173\u952E\u5BBD\u5EA6\u4E0B\u4ECD\u53EF\u7528 |
+| **\u89C6\u89C9\u4E00\u81F4\u6027** | \u662F\u5426\u590D\u7528\u9879\u76EE\u73B0\u6709 token\u3001\u7EC4\u4EF6\u3001\u95F4\u8DDD\u548C\u5B57\u4F53\u5C42\u7EA7\uFF0C\u907F\u514D\u5C40\u90E8\u53E6\u9020\u8BBE\u8BA1\u7CFB\u7EDF |
+
 ## \u8F93\u51FA\u683C\u5F0F\uFF08\u4E25\u683C\u9075\u5B88\uFF09
 
 \`\`\`markdown
@@ -363,7 +395,7 @@ var FILM_ANALYST_OFFENSE_AGENT = {
 // src/templates/agents/film-analyst-defense.ts
 var FILM_ANALYST_DEFENSE_AGENT = {
   name: "film-analyst-defense",
-  description: "Reviews robustness for mancode /man workflows (Step 7). Checks boundary conditions, security (XSS / SQL injection / auth / data leaks), performance, resource management, error recovery. Does not write code.",
+  description: "Reviews robustness and UI accessibility for mancode /man workflows (Step 8). Checks boundaries, security, performance, recovery, permissions, keyboard access, and contrast. Does not write code.",
   tools: ["Read", "Grep", "Glob"],
   body: `\u4F60\u662F mancode \u6559\u7EC3\u7EC4\u7684 Film Analyst #2\uFF08\u5F55\u50CF\u5206\u6790\u5E08\xB7\u9632\u5B88\uFF09\u3002
 
@@ -395,6 +427,17 @@ var FILM_ANALYST_DEFENSE_AGENT = {
 | **\u9519\u8BEF\u6062\u590D** | \u5931\u8D25\u540E\u80FD\u5426\u6062\u590D\u3001\u662F\u5426\u7834\u574F\u72B6\u6001\u3001\u662F\u5426\u541E\u9519 |
 | **\u4F9D\u8D56** | \u7B2C\u4E09\u65B9\u5E93\u7684\u5DF2\u77E5\u6F0F\u6D1E\uFF08\u5F15\u7528\u5373\u53EF\uFF09 |
 
+## \u6761\u4EF6 UI \u9632\u5B88\u5BA1\u67E5
+
+\u53EA\u6709\u5F53 \`.mancode/project-profile.json\` \u6807\u8BB0\u9879\u76EE\u542B UI\uFF0C\u4E14\u672C\u6B21 diff \u786E\u5B9E\u6539\u52A8\u4E86\u7528\u6237\u754C\u9762\u65F6\uFF0C\u624D\u6267\u884C\uFF1B\u5426\u5219\u5199\u660E\u201C\u4E0D\u9002\u7528\u201D\u3002
+
+| \u7EF4\u5EA6 | \u68C0\u67E5\u4EC0\u4E48 |
+|---|---|
+| **\u952E\u76D8\u53EF\u7528\u6027** | \u4E3B\u8981\u6D41\u7A0B\u3001\u5F39\u7A97\u548C\u81EA\u5B9A\u4E49\u63A7\u4EF6\u80FD\u5426\u7528\u952E\u76D8\u64CD\u4F5C\uFF0C\u7126\u70B9\u662F\u5426\u53EF\u89C1\u4E14\u987A\u5E8F\u5408\u7406 |
+| **\u8BED\u4E49\u4E0E\u8F85\u52A9\u6280\u672F** | \u4EA4\u4E92\u5143\u7D20\u662F\u5426\u6709\u6B63\u786E\u8BED\u4E49\u3001\u540D\u79F0\u548C\u72B6\u6001\u901A\u77E5 |
+| **\u5BF9\u6BD4\u4E0E\u975E\u989C\u8272\u7EBF\u7D22** | \u6587\u5B57\u3001\u7126\u70B9\u3001\u9519\u8BEF\u4E0E\u6210\u529F\u4FE1\u606F\u662F\u5426\u53EF\u8BFB\uFF0C\u662F\u5426\u4E0D\u53EA\u4F9D\u8D56\u989C\u8272 |
+| **\u6743\u9650\u4E0E\u9519\u8BEF\u8DEF\u5F84** | \u65E0\u6743\u9650\u3001\u7F51\u7EDC\u5931\u8D25\u3001\u90E8\u5206\u6210\u529F\u3001\u91CD\u8BD5\u548C\u53D6\u6D88\u662F\u5426\u4F1A\u6CC4\u6F0F\u6570\u636E\u6216\u7834\u574F\u72B6\u6001 |
+
 ## \u8F93\u51FA\u683C\u5F0F\uFF08\u4E25\u683C\u9075\u5B88\uFF09
 
 \`\`\`markdown
@@ -469,6 +512,7 @@ set -uo pipefail
 
 PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || echo "$PWD")"
 STATE_FILE="$PROJECT_ROOT/.mancode/state.json"
+PROFILE_FILE="$PROJECT_ROOT/.mancode/project-profile.json"
 
 HAS_JQ=0
 if [ "\${MANCODE_DISABLE_JQ:-0}" != "1" ]; then
@@ -481,7 +525,7 @@ json_get() {
     if [ "$HAS_JQ" = "1" ]; then
         jq -r ".$key // empty" "$file" 2>/dev/null || true
     else
-        grep "\\"$key\\"" "$file" 2>/dev/null | sed 's/.*: "\\(.*\\)".*/\\1/' || true
+        grep "\\"$key\\"" "$file" 2>/dev/null | sed -E 's/.*: *"([^"]*)".*/\\1/' || true
     fi
 }
 
@@ -522,12 +566,18 @@ echo "\u4F60\u6B63\u5728\u4F7F\u7528 mancode \${MODE:-solo} \u6A21\u5F0F\u3002"
 echo ""
 echo "### \u6838\u5FC3\u539F\u5219"
 echo "1. **\u4F18\u5148\u590D\u7528\u9879\u76EE\u5DF2\u6709\u4EE3\u7801**"
-echo "   - \u68C0\u67E5 src/ \u662F\u5426\u5DF2\u6709\u7C7B\u4F3C\u5B9E\u73B0"
+echo "   - \u68C0\u67E5\u5DF2\u68C0\u6D4B\u5230\u7684\u6E90\u7801\u76EE\u5F55\u548C\u5DF2\u6709\u7C7B\u4F3C\u5B9E\u73B0"
 echo "   - \u590D\u7528\u73B0\u6709\u7EC4\u4EF6\u3001\u51FD\u6570\u3001\u6837\u5F0F"
 echo ""
-echo "2. **\u5E94\u7528\u9879\u76EE\u5BA1\u7F8E token**\uFF08\u524D\u7AEF\u4EFB\u52A1\uFF09"
-echo "   - UI library: $(sanitize "$UI_LIBRARY")"
-echo "   - \u4F7F\u7528\u9879\u76EE\u5DF2\u6709\u7684\u8BBE\u8BA1 token"
+if [ "$(json_get "uiAssets" "$PROFILE_FILE")" = "detected" ]; then
+    echo "2. **\u5E94\u7528\u9879\u76EE\u5BA1\u7F8E token**\uFF08\u4EC5\u5728\u9879\u76EE profile \u786E\u8BA4\u6709 UI \u8D44\u4EA7\u4E14\u4EFB\u52A1\u6D89\u53CA UI \u65F6\uFF09"
+    echo "   - UI library: $(sanitize "$UI_LIBRARY")"
+    echo "   - \u4F7F\u7528\u9879\u76EE\u5DF2\u6709\u7684\u8BBE\u8BA1 token"
+else
+    echo "2. **\u6309\u9879\u76EE\u80FD\u529B\u5DE5\u4F5C**"
+    echo "   - \u4E0D\u5047\u5B9A\u5B58\u5728 UI\u3001\u6D4F\u89C8\u5668\u6216\u7279\u5B9A\u6280\u672F\u6808"
+    echo "   - \u5148\u8BFB\u53D6 project-profile \u4E0E\u9879\u76EE\u73B0\u6709\u9A8C\u8BC1\u65B9\u5F0F"
+fi
 echo ""
 echo "3. **\u6700\u5C0F\u6539\u52A8**"
 echo "   - \u53EA\u6539\u7528\u6237\u8981\u6C42\u7684\u90E8\u5206"
@@ -543,7 +593,7 @@ fi
 `;
 var USER_PROMPT_SUBMIT_HOOK = `#!/bin/bash
 # .mancode/hooks/user-prompt-submit.sh
-# mancode UserPromptSubmit hook - \u6CE8\u5165 3 \u95EE\u8FFD\u95EE + \u5BA1\u7F8E token
+# mancode UserPromptSubmit hook - \u6CE8\u5165 6 \u95EE\u8FFD\u95EE + \u5BA1\u7F8E token
 set -uo pipefail
 
 PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || echo "$PWD")"
@@ -561,7 +611,7 @@ json_get() {
     if [ "$HAS_JQ" = "1" ]; then
         jq -r ".$key // empty" "$file" 2>/dev/null || true
     else
-        grep "\\"$key\\"" "$file" 2>/dev/null | sed 's/.*: "\\(.*\\)".*/\\1/' || true
+        grep "\\"$key\\"" "$file" 2>/dev/null | sed -E 's/.*: *"([^"]*)".*/\\1/' || true
     fi
 }
 
@@ -572,9 +622,9 @@ sanitize() {
 
 MODE=$(json_get "currentMode" "$STATE_FILE")
 
-# \u53EA\u5728 solo \u6A21\u5F0F\u4E0B\u8F93\u51FA 3 \u95EE
+# \u53EA\u5728 solo \u6A21\u5F0F\u4E0B\u8F93\u51FA 6 \u95EE
 if [ "$MODE" = "solo" ]; then
-    echo "## \u52A8\u624B\u524D\uFF0C\u5148\u60F3\u4E09\u4E2A\u95EE\u9898\uFF1A"
+    echo "## \u52A8\u624B\u524D\uFF0C\u5148\u60F3\u516D\u4E2A\u95EE\u9898\uFF1A"
     echo ""
     echo "1. **\u4E3A\u4EC0\u4E48\u505A\uFF1F**"
     echo "   - \u8FD9\u4E2A\u6539\u52A8\u89E3\u51B3\u4EC0\u4E48\u95EE\u9898\uFF1F"
@@ -585,6 +635,14 @@ if [ "$MODE" = "solo" ]; then
     echo "3. **\u6700\u5C11\u6539\u591A\u5C11\uFF1F**"
     echo "   - \u80FD\u7528\u4E00\u884C\u89E3\u51B3\u5417\uFF1F\u80FD\u590D\u7528\u73B0\u6709\u4EE3\u7801\u5417\uFF1F"
     echo ""
+    echo "4. **\u80FD\u4E0D\u80FD\u4E0D\u62C6\u65B0\u7CFB\u7EDF\uFF1F**"
+    echo "   - \u4E0D\u65B0\u5EFA\u6587\u4EF6\u6216\u6A21\u5757\u80FD\u5B8C\u6210\u5417\uFF1F"
+    echo ""
+    echo "5. **\u975E\u5E73\u51E1\u903B\u8F91\u600E\u6837\u6700\u5C0F\u8FD0\u884C\u9A8C\u8BC1\uFF1F**"
+    echo ""
+    echo "6. **\u6709\u4EC0\u4E48\u6CA1\u628A\u63E1\u7684\uFF1F**"
+    echo "   - \u5148\u81EA\u884C\u67E5\u4EE3\u7801\u6216\u6587\u6863\uFF0C\u6700\u591A 2 \u6B21\u5DE5\u5177\u8C03\u7528\uFF1B\u4ECD\u4E0D\u786E\u5B9A\u518D\u95EE\u7528\u6237\u3002"
+    echo ""
 fi
 
 # Claude Code \u901A\u8FC7 stdin \u4F20\u5165 JSON: {"prompt": "...", ...}
@@ -610,13 +668,18 @@ if [ "$MODE" = "solo" ] && echo "$USER_PROMPT" | grep -qiE "\u5148(\u522B|\u4E0D
     echo "## mancode \u81EA\u52A8\u8DEF\u7531"
     echo ""
     echo "\u8FD9\u4E2A\u8BF7\u6C42\u662F\u89C4\u5212/\u8C03\u7814\u7C7B\u4EFB\u52A1\u3002\u4E0D\u8981\u76F4\u63A5\u8FDB\u5165 solo \u5B9E\u65BD\u3002"
-    echo "\u5FC5\u987B\u5148\u8C03\u7528 Skill tool\uFF0Cskill='man8'\uFF0C\u628A\u7528\u6237\u539F\u59CB\u8BF7\u6C42\u4F5C\u4E3A task\uFF0C\u6267\u884C Scout \u8C03\u7814\u548C Head Coach plan\u3002"
-    echo "\u5982\u679C\u7528\u6237\u660E\u786E\u8981\u6C42\u4E0D\u8981\u6539\u4EE3\u7801\uFF0C\u751F\u6210 plan \u540E\u505C\u5728\u786E\u8BA4\u6B65\u9AA4\u3002"
+    echo "\u5FC5\u987B\u5148\u8C03\u7528 Skill tool\uFF0Cskill='man'\uFF0C\u628A\u7528\u6237\u539F\u59CB\u8BF7\u6C42\u4F5C\u4E3A task\uFF0C\u6267\u884C Scout \u8C03\u7814\u3001\u6F84\u6E05\u548C Plan Coach plan\u3002"
+    echo "\u7528\u6237\u53EA\u8981\u8BA1\u5212\u65F6\uFF0C\u5728 Step 4 \u9009\u62E9\u201C\u53EA\u8981\u8BA1\u5212\u201D\uFF1B\u4E0D\u8981\u5207\u5230\u53E6\u4E00\u4E2A\u547D\u4EE4\u3002"
     echo ""
 fi
 
-# \u524D\u7AEF\u4EFB\u52A1\u5173\u952E\u8BCD\u68C0\u6D4B\uFF08\u7528 \b \u8BCD\u8FB9\u754C\u907F\u514D\u5B50\u4E32\u8BEF\u5339\u914D\uFF09
-if echo "$USER_PROMPT" | grep -qiE "\\b(button|component|page|style|ui|design|layout|css|tailwind|color|font|theme|card|input|modal|dialog|header|footer|sidebar|dropdown|tooltip|toast|avatar|badge)\\b"; then
+# UI token \u4EC5\u5728 profile \u786E\u8BA4\u5B58\u5728 UI \u8D44\u4EA7\u4E14\u4EFB\u52A1\u660E\u786E\u6D89\u53CA UI \u65F6\u6CE8\u5165\u3002
+PROFILE_FILE="$PROJECT_ROOT/.mancode/project-profile.json"
+UI_ASSETS=""
+if [ -f "$PROFILE_FILE" ]; then
+    UI_ASSETS=$(json_get "uiAssets" "$PROFILE_FILE")
+fi
+if [ "$UI_ASSETS" = "detected" ] && echo "$USER_PROMPT" | grep -qiE "\\b(button|component|page|style|ui|design|layout|css|color|font|theme|card|input|modal|dialog|header|footer|sidebar|dropdown|tooltip|toast|avatar|badge)\\b|\u754C\u9762|\u9875\u9762|\u6309\u94AE|\u6837\u5F0F|\u989C\u8272|\u5B57\u4F53|\u5E03\u5C40|\u7EC4\u4EF6|\u5F39\u7A97|\u5BFC\u822A|\u5361\u7247|\u8F93\u5165\u6846|\u4E3B\u9898|\u7F8E\u5316|\u4F18\u5316.*\u754C\u9762|\u8C03\u6574.*\u6837\u5F0F"; then
     if [ -f "$AESTHETICS_FILE" ]; then
         MATCH_LEVEL=$(json_get "matchLevel" "$AESTHETICS_FILE")
 
@@ -666,11 +729,10 @@ var SOLO_SKILL = `# mancode \xB7 solo mode
 5. \u4E00\u884C\u80FD\u89E3\u51B3\uFF1F\u2192 \u4E00\u884C
 6. \u53EA\u6709\u4EE5\u4E0A\u90FD\u4E0D\u884C\uFF0C\u624D\u5199\u6700\u5C0F\u5B9E\u73B0
 
-### 2. \u5BA1\u7F8E\u4E00\u81F4\u6027
-\u524D\u7AEF\u4EFB\u52A1\uFF1A
-- \u4F7F\u7528\u9879\u76EE\u5DF2\u6709\u7684\u8BBE\u8BA1 token\uFF08\u989C\u8272\u3001\u5B57\u4F53\uFF09\u2014\u2014 hook \u4F1A\u81EA\u52A8\u6CE8\u5165
-- \u590D\u7528\u73B0\u6709\u7EC4\u4EF6\uFF0C\u4E0D\u91CD\u65B0\u9020
-- \u5339\u914D\u547D\u540D\u89C4\u8303
+### 2. \u9879\u76EE\u4E00\u81F4\u6027
+- \u5148\u8BFB \`.mancode/project-profile.json\`\uFF0C\u4E0D\u5047\u5B9A\u9879\u76EE\u7C7B\u578B\u3001\u8BED\u8A00\u3001UI \u6216\u6D4F\u89C8\u5668\u80FD\u529B\u3002
+- \u53EA\u6709 profile \u786E\u8BA4 UI \u8D44\u4EA7\u4E14\u4EFB\u52A1\u6D89\u53CA UI \u65F6\uFF0C\u624D\u4F7F\u7528\u5DF2\u6709\u8BBE\u8BA1 token\uFF1B\u590D\u7528\u7EC4\u4EF6\uFF0C\u4E0D\u91CD\u65B0\u9020\u3002
+- \u6240\u6709\u9879\u76EE\u90FD\u5339\u914D\u5DF2\u6709\u547D\u540D\u3001\u9519\u8BEF\u5904\u7406\u3001\u6D4B\u8BD5\u4E0E\u4EA4\u4ED8\u89C4\u8303\u3002
 
 ### 3. \u5916\u79D1\u624B\u672F\u5F0F\u4FEE\u6539
 - \u53EA\u6539\u7528\u6237\u8981\u6C42\u7684\u90E8\u5206
@@ -683,23 +745,22 @@ var SOLO_SKILL = `# mancode \xB7 solo mode
 ### \u8BFB\u53D6\u9879\u76EE\u4E0A\u4E0B\u6587
 \u6BCF\u6B21\u4EFB\u52A1\u524D\uFF1A
 1. \u8BFB\u53D6 \`.mancode/state.json\`\uFF08\u4E86\u89E3\u9879\u76EE\u72B6\u6001\uFF09
-2. \u641C\u7D22\u76F8\u4F3C\u5B9E\u73B0\uFF08"\u8FD9\u4E2A\u9879\u76EE\u91CC\u6709\u6CA1\u6709\uFF1F"\uFF09
-3. \u68C0\u67E5\u53EF\u590D\u7528\u8D44\u6E90
-
-### \u524D\u7AEF\u4EFB\u52A1
-\u5982\u679C\u662F UI / \u7EC4\u4EF6 / \u6837\u5F0F\u4EFB\u52A1\uFF1A
-1. UserPromptSubmit hook \u4F1A\u6CE8\u5165\u9879\u76EE\u5BA1\u7F8E token\uFF08colors/fonts/uiLibrary\uFF09
-2. \u4E25\u683C\u4F7F\u7528\u6CE8\u5165\u7684\u989C\u8272\u503C\uFF0C\u4E0D\u8981\u731C
-3. \u9879\u76EE\u5DF2\u6709 Button/Card/Input \u7B49\u7EC4\u4EF6 \u2192 \u5FC5\u987B\u590D\u7528
-4. \u4E0D\u8981\u5F15\u5165\u9879\u76EE\u8272\u677F\u4EE5\u5916\u7684\u65B0\u989C\u8272
-5. \u4E0D\u8981\u7528 inline style \u5199\u989C\u8272
-
-### \u53CD AI slop \u68C0\u67E5
-\u524D\u7AEF\u8F93\u51FA\u524D\u81EA\u68C0\uFF1A
-- \u274C \u6240\u6709\u5361\u7247\u90FD\u662F rounded-2xl shadow-md \u2192 \u7528\u9879\u76EE\u5B9E\u9645 borderRadius
-- \u274C \u9ED8\u8BA4\u6DF1\u8272 + \u7D2B\u8272\u6E10\u53D8 \u2192 \u7528\u9879\u76EE\u4E3B\u8272
-- \u274C \u6BCF\u4E2A\u6309\u94AE\u90FD\u52A0 hover:scale-105 \u2192 \u53EA\u5728 CTA \u7528
-- \u274C Loading \u90FD\u7528 spinner \u2192 \u7528\u9879\u76EE\u5DF2\u6709 Skeleton
+2. \u8BFB\u53D6 \`.mancode/project-profile.json\`\uFF08\u4E86\u89E3\u68C0\u6D4B\u5230\u7684\u6E90\u7801\u76EE\u5F55\u3001\u80FD\u529B\u548C\u9A8C\u8BC1\u65B9\u5F0F\uFF09
+3. \u641C\u7D22\u76F8\u4F3C\u5B9E\u73B0\uFF08"\u8FD9\u4E2A\u9879\u76EE\u91CC\u6709\u6CA1\u6709\uFF1F"\uFF09
+4. \u68C0\u67E5\u53EF\u590D\u7528\u8D44\u6E90
+
+### UI \u4EFB\u52A1\uFF08\u6761\u4EF6\u6267\u884C\uFF09
+\u4EC5\u5F53 project-profile \u786E\u8BA4\u6709 UI \u8D44\u4EA7\u4E14\u4EFB\u52A1\u786E\u5B9E\u6D89\u53CA\u754C\u9762\u65F6\uFF1A
+1. UserPromptSubmit hook \u4F1A\u6CE8\u5165\u9879\u76EE\u5BA1\u7F8E token\uFF08\u5982\u6709\uFF09
+2. \u4E25\u683C\u4F7F\u7528\u5DF2\u6709 token \u548C\u7EC4\u4EF6\uFF1B\u6CA1\u6709\u53EF\u9760 token \u65F6\u5148\u68C0\u67E5\u73B0\u6709\u754C\u9762\uFF0C\u518D\u63D0\u51FA\u6700\u5C0F\u4E00\u81F4\u65B9\u6848
+3. \u4E0D\u628A\u7279\u5B9A\u6846\u67B6\u3001\u7EC4\u4EF6\u540D\u3001\u8272\u677F\u6216\u4EA4\u4E92\u8303\u5F0F\u5F53\u4F5C\u9ED8\u8BA4
+4. \u4EE5\u9879\u76EE\u65E2\u6709\u7684\u65E0\u969C\u788D\u3001\u54CD\u5E94\u5F0F\u4E0E\u53CD\u9988\u65B9\u5F0F\u4E3A\u51C6
+
+### \u754C\u9762\u8D28\u91CF\u68C0\u67E5\uFF08\u6761\u4EF6\u6267\u884C\uFF09
+UI \u8F93\u51FA\u524D\u81EA\u68C0\uFF1A
+- \u662F\u5426\u590D\u7528\u4E86\u9879\u76EE\u5B9E\u9645\u7684\u5C42\u7EA7\u3001\u95F4\u8DDD\u3001\u989C\u8272\u3001\u5B57\u4F53\u4E0E\u4EA4\u4E92\u53CD\u9988\uFF1F
+- \u4FE1\u606F\u5C42\u7EA7\u3001\u7A7A/\u52A0\u8F7D/\u9519\u8BEF\u72B6\u6001\u548C\u952E\u76D8/\u8BFB\u5C4F\u53EF\u8FBE\u6027\u662F\u5426\u6E05\u695A\uFF1F
+- \u662F\u5426\u4E3A\u4E86\u201C\u597D\u770B\u201D\u5F15\u5165\u4E0E\u73B0\u6709\u4EA7\u54C1\u65E0\u5173\u7684\u88C5\u9970\u3001\u52A8\u753B\u6216\u7EC4\u4EF6\uFF1F
 
 ### \u9A8C\u8BC1
 \u4EE3\u7801\u5B8C\u6210\u540E\uFF1A
@@ -708,6 +769,12 @@ var SOLO_SKILL = `# mancode \xB7 solo mode
 3. \u8FD0\u884C test\uFF08\u5982\u6709\uFF09
 4. \u786E\u8BA4\u901A\u8FC7\u540E\u624D\u58F0\u79F0\u5B8C\u6210
 
+### \u5B8C\u6210\u540E\u81EA\u5BA1\u4E0E\u6A21\u5F0F\u63A8\u8350
+- \u9A8C\u8BC1\u7C7B\u95EE\u9898\uFF08build/lint/test \u5931\u8D25\u3001\u9057\u7559 debug\uFF09\u76F4\u63A5\u4FEE\u590D\u5E76\u590D\u9A8C\u3002
+- \u98CE\u683C\u7C7B\u95EE\u9898\uFF08\u547D\u540D\u3001\u53EF\u8BFB\u6027\u3001DRY\uFF09\u53EA\u63D0\u793A\uFF0C\u4E0D\u4E3A\u6B64\u6269\u5927\u65E0\u5173\u6539\u52A8\u3002
+- \u52A8\u624B\u524D\u82E5\u6D89\u53CA 3 \u4E2A\u4EE5\u4E0A\u6587\u4EF6\u3001\u65B0\u6A21\u5757\u6216\u67B6\u6784\u53D8\u52A8\uFF0C\u7528\u4E00\u53E5\u8BDD\u5EFA\u8BAE\u7528\u6237\u5148\u7528 \`/man\`\uFF1B\u7528\u6237\u8BF4\u201C\u7EE7\u7EED solo\u201D\u5373\u53EF\u8DF3\u8FC7\u3002
+- \u81EA\u5BA1\u53D1\u73B0 3 \u4E2A\u4EE5\u4E0A\u95EE\u9898\u65F6\uFF0C\u5EFA\u8BAE \`/manps\` \u6216 \`/man\`\u3002
+
 ## \u4F60\u7684\u98CE\u683C
 
 - \u76F4\u63A5\u3001\u7B80\u6D01\u3001\u4E0D\u5E9F\u8BDD
@@ -716,126 +783,6 @@ var SOLO_SKILL = `# mancode \xB7 solo mode
 - \u9519\u8BEF\u4FE1\u606F\u4E5F\u8981\u7B26\u5408\u9879\u76EE\u98CE\u683C
 `;
 
-// src/templates/skills/man8.ts
-var MAN8_SKILL = {
-  name: "man8",
-  description: 'Automatically use for pre-implementation research and planning requests: "\u5148\u770B\u770B", "\u7ED9\u65B9\u6848", "\u600E\u4E48\u505A", "\u4E0D\u8981\u6539\u4EE3\u7801", architecture/risk/approach questions. Also available as /man8. Runs Scout, then Head Coach writes a plan before coding.',
-  body: `# mancode \xB7 /man8 (4 AM Warmup)
-
-\u8FD9\u662F**\u8C03\u7814 + \u8BA1\u5212** skill\u3002\u5B83\u53EF\u4EE5\u88AB\u7528\u6237\u663E\u5F0F \`/man8 <task>\` \u89E6\u53D1\uFF0C\u4E5F\u5E94\u8BE5\u5728\u7528\u6237\u6CA1\u6709\u8F93\u5165\u547D\u4EE4\u4F46\u660E\u663E\u8868\u8FBE"\u5148\u8C03\u7814/\u7ED9\u65B9\u6848/\u600E\u4E48\u505A/\u522B\u6539\u4EE3\u7801/\u8BC4\u4F30\u98CE\u9669/\u8BBE\u8BA1\u65B9\u6848"\u65F6\u81EA\u52A8\u89E6\u53D1\u3002
-
-\u7528\u6237\u786E\u8BA4\u524D\u4E0D\u52A8\u4EE3\u7801\uFF1B\u7528\u6237\u9009\u62E9\u5B9E\u65BD\u540E\uFF0C\u5207\u56DE solo \u5E76\u7ACB\u5373\u6309 plan \u5F00\u59CB\u6539\u3002
-
-## \u81EA\u52A8\u89E6\u53D1\u6761\u4EF6
-
-\u5F53\u7528\u6237\u8BF7\u6C42\u7B26\u5408\u4EE5\u4E0B\u4EFB\u4E00\u6761\u4EF6\u65F6\uFF0C\u4E3B\u52A8\u4F7F\u7528\u672C skill\uFF0C\u800C\u4E0D\u662F\u76F4\u63A5\u8FDB\u5165 solo \u5B9E\u65BD\uFF1A
-
-- \u8981\u6C42"\u5148\u770B\u770B"\u3001"\u5148\u8C03\u7814"\u3001"\u5148\u5206\u6790"\u3001"\u7ED9\u6211\u65B9\u6848"\u3001"\u600E\u4E48\u505A"\u3001"\u8BBE\u8BA1\u4E00\u4E0B"
-- \u660E\u786E\u8BF4"\u5148\u522B\u6539\u4EE3\u7801"\u3001"\u4E0D\u8981\u52A8\u4EE3\u7801"\u3001"\u53EA\u7ED9\u8BA1\u5212"\u3001"\u5148\u8BC4\u4F30\u98CE\u9669"
-- \u4EFB\u52A1\u6D89\u53CA\u672A\u77E5\u6A21\u5757\u3001\u67B6\u6784\u9009\u62E9\u3001\u96C6\u6210\u65B9\u6848\u3001\u8FC1\u79FB\u65B9\u6848\u3001\u8F83\u5927\u8303\u56F4\u6539\u52A8
-- \u7528\u6237\u95EE"\u8FD9\u4E2A\u529F\u80FD\u600E\u4E48\u5B9E\u73B0\u66F4\u597D"\u3001"\u5E94\u8BE5\u600E\u4E48\u62C6"\u3001"\u6709\u6CA1\u6709\u98CE\u9669"
-
-\u4E0D\u8981\u56E0\u4E3A\u666E\u901A\u5C0F\u6539\u52A8\u81EA\u52A8\u89E6\u53D1\u672C skill\u3002\u4F8B\u5982\uFF1A"\u628A README \u52A0\u4E00\u884C"\u3001"\u4FEE\u4E00\u4E2A typo"\u3001"\u628A\u6309\u94AE\u6587\u6848\u6539\u6389" \u5E94\u7EE7\u7EED\u7528 solo\u3002
-
-## \u4F60\u9700\u8981\u4ECE\u7528\u6237\u6D88\u606F\u91CC\u63D0\u53D6\u7684
-
-1. \u5148\u7528 Read \u8BFB\u53D6 \`.mancode/state.json\`\u3002
-2. \u7ACB\u5373\u7528 Edit \u66F4\u65B0 state\uFF1A
-   - \`lastMode\` \u2190 \u539F \`currentMode\`
-   - \`currentMode\` \u2192 \`"man8"\`
-   - \`currentTask\` \u2192 \`null\`
-   - \`currentWorkflowMode\` \u2192 \`null\`
-   - \`skippedSteps\` \u2192 \`[]\`
-3. **task**\uFF1A
-   - \u663E\u5F0F\u89E6\u53D1\uFF1A\u7528\u6237\u8F93\u5165 \`/man8 <task>\` \u65F6\uFF0Ctask \u662F \`<task>\` \u90E8\u5206\u3002\u5982 \`/man8 \u6DFB\u52A0 OAuth \u767B\u5F55\u6309\u94AE\` \u2192 task = "\u6DFB\u52A0 OAuth \u767B\u5F55\u6309\u94AE"\u3002
-   - \u81EA\u52A8\u89E6\u53D1\uFF1A\u7528\u6237\u6CA1\u6709\u8F93\u5165 \`/man8\` \u4F46\u672C skill \u88AB\u9009\u4E2D\u65F6\uFF0C\u628A\u7528\u6237\u539F\u59CB\u8BF7\u6C42\u6574\u4F53\u4F5C\u4E3A task\u3002
-4. \u53EA\u6709\u5728\u663E\u5F0F\u8F93\u5165 \`/man8\` \u4E14 task \u4E3A\u7A7A\u65F6\uFF0C\u624D\u7528 AskUserQuestion \u95EE\u7528\u6237\uFF1A"\u8981\u8C03\u7814\u4EC0\u4E48\u4EFB\u52A1\uFF1F"\u3002\u7B49\u5F85\u4EFB\u52A1\u671F\u95F4\uFF0C\u5F53\u524D\u6A21\u5F0F\u4ECD\u662F \`man8\`\uFF1B\u5982\u679C\u7528\u6237\u95EE"\u73B0\u5728\u662F\u4EC0\u4E48\u6A21\u5F0F"\uFF0C\u56DE\u7B54 man8 \u6A21\u5F0F\u3002
-
-## 3 \u6B65\u6D41\u7A0B
-
-### Step 1\uFF1AScout \u8C03\u7814
-
-1. \u7528 Write \u5DE5\u5177\u521B\u5EFA workflow \u76EE\u5F55\u3002task id \u7528 \`YYYYMMDD-HHMMSS-<slug>\` \u683C\u5F0F\uFF08slug = task \u7684 kebab-case\uFF0C\u622A\u5230 30 \u5B57\u7B26\uFF09\uFF1A
-   - \u5FC5\u987B\u5148\u7528 Bash \u6267\u884C \`date -u +"%Y%m%d-%H%M%S"\` \u83B7\u53D6\u771F\u5B9E\u65F6\u95F4\u6233\uFF1B\u4E0D\u8981\u51ED\u7A7A\u4F30\u7B97\u65E5\u671F\u65F6\u95F4
-   - \u76EE\u5F55\uFF1A\`.mancode/workflows/<taskId>/\`
-   - \u5199\u5165 \`metadata.json\`\uFF1A\`{"taskId":"...","task":"...","mode":"man8","currentStep":1,"skippedSteps":[],"startedAt":"<ISO>","updatedAt":"<ISO>","status":"in_progress"}\`
-2. \u7528 Agent tool \u8C03\u7528 Scout\uFF1A
-   \`\`\`
-   Agent({
-     description: "Scout: investigate codebase for <task>",
-     subagent_type: "scout",
-     prompt: "\u4EFB\u52A1\uFF1A<task>\\n\u9879\u76EE\u6808\uFF1A<\u4ECE .mancode/state.json techStack \u8BFB>\\n\u5F00\u59CB\u8C03\u7814\u3002"
-   })
-   \`\`\`
-3. \u628A Scout \u7684\u8F93\u51FA\u7528 Write \u5DE5\u5177\u5199\u5165 \`.mancode/workflows/<taskId>/scout-report.md\`
-4. \u7528 Edit \u66F4\u65B0 \`.mancode/state.json\`\uFF1A\`currentMode: "man8"\`, \`currentTask: "<taskId>"\`, \`currentWorkflowMode: "man8"\`
-5. \u7528 Edit \u5DE5\u5177\u66F4\u65B0 metadata.json\uFF1A\`currentStep: 2\`
-
-### Step 2\uFF1APlan Coach \u5199 plan
-
-1. \u7528 Agent tool \u8C03\u7528 Plan Coach\uFF08\u53EA\u8BFB plan \u6A21\u5F0F\uFF09\uFF1A
-   \`\`\`
-   Agent({
-     description: "Plan Coach: write plan for <task>",
-     subagent_type: "plan-coach",
-     prompt: "\u4EFB\u52A1\uFF1A<task>\\nScout Report\uFF08\u6765\u81EA .mancode/workflows/<taskId>/scout-report.md\uFF09\uFF1A\\n<\u628A scout-report.md \u5185\u5BB9\u8D34\u8FDB\u6765>\\n\\n\u53EA\u8FD4\u56DE plan markdown\uFF0C\u4E0D\u8981\u4FEE\u6539\u9879\u76EE\u6587\u4EF6\u3002"
-   })
-   \`\`\`
-2. \u628A Plan Coach \u8F93\u51FA\u5199\u5165 \`.mancode/workflows/<taskId>/plan.md\`
-3. \u66F4\u65B0 metadata.json\uFF1A\`currentStep: 3\`
-
-### Step 3\uFF1A\u7528\u6237\u786E\u8BA4
-
-\u7528 AskUserQuestion \u5DE5\u5177\u95EE\u7528\u6237\uFF1A
-
-\`\`\`
-AskUserQuestion({
-  questions: [{
-    question: "Plan \u5DF2\u751F\u6210\uFF08\u89C1 .mancode/workflows/<taskId>/plan.md\uFF09\u3002\u600E\u4E48\u505A\uFF1F",
-    header: "Next step",
-    options: [
-      { label: "\u5207 solo \u5B9E\u65BD (Recommended)", description: "\u5207\u56DE solo \u6A21\u5F0F\uFF0C\u6309 plan \u76F4\u63A5\u5F00\u53D1" },
-      { label: "\u4FEE\u6539 plan", description: "\u91CD\u65B0\u8DD1 Step 2\uFF08Plan Coach \u91CD\u5199 plan\uFF09" },
-      { label: "\u9000\u51FA\uFF0C\u4FDD\u7559 plan", description: "\u7ED3\u675F /man8\uFF0Cplan \u4FDD\u7559\u5728 .mancode/workflows/ \u4F9B\u65E5\u540E\u53C2\u8003" }
-    ],
-    multiSelect: false
-  }]
-})
-\`\`\`
-
-\u6839\u636E\u7528\u6237\u9009\u62E9\uFF1A
-
-- **\u5207 solo \u5B9E\u65BD**\uFF1A
-  1. \u7528 Edit \u66F4\u65B0 \`.mancode/state.json\`\uFF1A\`currentMode: "solo"\`, \`lastMode: "man8"\`, \`currentTask: null\`, \`currentWorkflowMode: null\`, \`skippedSteps: []\`
-  2. \u8BFB\u53D6 \`.mancode/workflows/<taskId>/plan.md\`
-  3. \u7528\u5F53\u524D assistant\uFF08solo \u6A21\u5F0F\uFF09\u7ACB\u5373\u6309 plan \u5B9E\u65BD\uFF1B\u4E0D\u8981\u518D\u6B21\u8981\u6C42\u7528\u6237\u8F93\u5165"\u5F00\u59CB\u5B9E\u65BD"
-  4. \u5B9E\u65BD\u5B8C\u6210\u540E\u8FD0\u884C plan \u91CC\u5217\u51FA\u7684\u9A8C\u8BC1\u547D\u4EE4\uFF1B\u5982\u6CA1\u6709\u9A8C\u8BC1\u547D\u4EE4\uFF0C\u81F3\u5C11\u7528\u53EA\u8BFB\u68C0\u67E5\u786E\u8BA4\u76EE\u6807\u6587\u4EF6\u5185\u5BB9
-  5. \u7528 Edit \u66F4\u65B0 metadata.json\uFF1A\`status: "completed"\`, \`currentStep: 3\`
-  6. \u6700\u7EC8\u544A\u8BC9\u7528\u6237\uFF1A\u6539\u4E86\u54EA\u4E9B\u6587\u4EF6\u3001\u9A8C\u8BC1\u7ED3\u679C\u3001plan \u8DEF\u5F84
-
-- **\u4FEE\u6539 plan**\uFF1A
-  1. \u8BE2\u95EE\u7528\u6237\u5E0C\u671B\u8C03\u6574\u4EC0\u4E48
-  2. \u91CD\u65B0\u8DD1 Step 2\uFF08Plan Coach \u91CD\u5199 plan\uFF0C\u53EF\u9644\u7528\u6237\u7684\u4FEE\u6539\u610F\u89C1\uFF09
-
-- **\u9000\u51FA**\uFF1A
-  1. \u66F4\u65B0 metadata.json\uFF1A\`status: "completed"\`
-  2. \u7528 Edit \u66F4\u65B0 \`.mancode/state.json\`\uFF1A\`currentMode: "solo"\`, \`lastMode: "man8"\`, \`currentTask: null\`, \`currentWorkflowMode: null\`, \`skippedSteps: []\`
-  3. \u544A\u8BC9\u7528\u6237\uFF1A"plan \u4FDD\u7559\u5728 \`.mancode/workflows/<taskId>/plan.md\`\uFF0C\u9700\u8981\u65F6\u518D\u53EB\u6211\u3002"
-
-## \u4E0A\u4E0B\u6587\u9884\u7B97
-
-- Scout \u7684 prompt \u2264 200 tokens
-- Plan Coach \u7684 prompt \u628A scout-report.md \u5168\u90E8\u8D34\u8FDB\u53BB\uFF08plan \u9636\u6BB5\u503C\u5F97\uFF09
-- \u4E0D\u8981 dump \u5927\u91CF\u4EE3\u7801\u5230\u5BF9\u8BDD\uFF1B\u8BA9 agent \u81EA\u5DF1\u7528 Read \u8BFB
-
-## \u5931\u8D25\u5904\u7406
-
-- Agent \u8C03\u7528\u5931\u8D25\uFF1A\u62A5\u544A\u9519\u8BEF\uFF0C\u4E0D\u91CD\u8BD5 2 \u6B21\u4EE5\u4E0A\uFF08\u94C1\u5F8B 1.3\uFF09
-- metadata.json \u5199\u5165\u5931\u8D25\uFF1A\u505C\u4E0B\u6765\u8BCA\u65AD\uFF0C\u4E0D\u4F2A\u9020\u72B6\u6001
-
-\u6536\u5230 \`/man8\` \u6216\u81EA\u52A8\u89E6\u53D1\u540E\u7ACB\u5373\u5F00\u59CB Step 1\uFF0C\u4E0D\u8981\u7B49\u7528\u6237\u786E\u8BA4\u3002`
-};
-
 // src/templates/skills/principles.ts
 var CORE_CODING_PRINCIPLES = `## \u94C1\u5F8B\uFF08\u6C38\u4E0D\u8FDD\u53CD\uFF09
 
@@ -848,157 +795,115 @@ var CORE_CODING_PRINCIPLES = `## \u94C1\u5F8B\uFF08\u6C38\u4E0D\u8FDD\u53CD\uFF0
 // src/templates/skills/man.ts
 var MAN_SKILL = {
   name: "man",
-  description: "Full 8-step playoffs workflow with coaching staff. Scout \u2192 Plan \u2192 Implement \u2192 Self-test \u2192 Film Offense \u2192 Fix \u2192 Film Defense \u2192 Wrap-up. Use for production code, complex features, critical modules.",
-  body: `# mancode \xB7 /man (Playoffs Mode)
+  description: "Progressive 9-step engineering workflow: research, clarify, plan, choose plan-only or execution, implement, validate, review, and wrap up. Use for complex or high-risk changes.",
+  body: `# mancode \xB7 /man (Progressive Governance)
 
-\u7528\u6237\u7528 \`/man <task>\` \u89E6\u53D1\u4F60\u3002\u8FD9\u662F**\u5B8C\u6574 8 \u6B65\u6D41\u7A0B**\uFF0C\u6559\u7EC3\u7EC4\u5168\u5458\u4E0A\u573A\u3002
+\u7528\u6237\u7528 \`/man <task>\` \u89E6\u53D1\u4F60\u3002\u7ACB\u5373\u8BFB \`.mancode/state.json\`\u3002\u82E5\u5DF2\u6709\u4E0D\u540C\u7684 active workflow\uFF0C\u4E0D\u5F97\u76F4\u63A5\u6E05\u7A7A\u6307\u9488\uFF1B\u5148\u8BA9\u7528\u6237\u9009\u62E9\u6062\u590D\u539F\u6D41\u7A0B\u6216\u7528 \`/mansolo\` \u653E\u5F03\u3002task \u4E3A\u7A7A\u65F6\u8BE2\u95EE\u4EFB\u52A1\uFF0C\u7B49\u5F85\u671F\u95F4\u4ECD\u662F \`man\` \u6A21\u5F0F\u3002
 
-## \u63D0\u53D6 task
+\u7528 \`mancode workflow create man "<task>" --json\` \u521B\u5EFA workflow \u5E76\u8BFB\u53D6\u8FD4\u56DE\u7684 taskId\uFF1B\u4E0D\u5F97\u76F4\u63A5\u521B\u5EFA\u6216\u6539\u5199 metadata.json\u3002\u968F\u540E\u53EA\u7528 \`mancode workflow update\` \u66F4\u65B0 step/status/planVersion/skippedSteps\u3002state \u7684 \`currentMode\`\u3001\`currentTask\` \u548C \`currentWorkflowMode\` \u6307\u5411\u672C task\u3002
 
-1. \u5148\u7528 Read \u8BFB\u53D6 \`.mancode/state.json\`\u3002
-2. \u7ACB\u5373\u7528 Edit \u66F4\u65B0 state\uFF1A
-   - \`lastMode\` \u2190 \u539F \`currentMode\`
-   - \`currentMode\` \u2192 \`"man"\`
-   - \`currentTask\` \u2192 \`null\`
-   - \`currentWorkflowMode\` \u2192 \`null\`
-   - \`skippedSteps\` \u2192 \`[]\`
-3. \u4ECE \`/man <task>\` \u63D0\u53D6 \`<task>\`\u3002
-4. \u5982 task \u4E3A\u7A7A\uFF0C\u7528 AskUserQuestion \u95EE\u7528\u6237\uFF1A"\u8981\u7528 /man \u5904\u7406\u4EC0\u4E48\u4EFB\u52A1\uFF1F"\u3002\u7B49\u5F85\u4EFB\u52A1\u671F\u95F4\uFF0C\u5F53\u524D\u6A21\u5F0F\u4ECD\u662F \`man\`\uFF1B\u5982\u679C\u7528\u6237\u95EE"\u73B0\u5728\u662F\u4EC0\u4E48\u6A21\u5F0F"\uFF0C\u56DE\u7B54 man \u6A21\u5F0F\u3002
+## \u65B0\u9879\u76EE\u6280\u672F\u9009\u62E9\u5173\u5361\uFF08\u4EC5\u5728\u9002\u7528\u65F6\uFF09
 
-## 8 \u6B65\u6D41\u7A0B
+\u5148\u8BFB \`.mancode/project-profile.json\`\u3002\u5982\u679C\u7528\u6237\u8981\u65B0\u5EFA\u9879\u76EE\u3001profile \u4E3A unknown\uFF0C\u4E14\u7528\u6237\u6CA1\u6709\u6307\u5B9A\u6280\u672F\u6808\uFF1A\u5148\u6536\u96C6\u76EE\u6807\u5E73\u53F0\u3001\u7528\u6237\u89C4\u6A21\u3001\u79BB\u7EBF/\u90E8\u7F72\u3001\u56E2\u961F\u719F\u6089\u5EA6\u3001\u9884\u7B97\u4E0E\u96C6\u6210\u7EA6\u675F\uFF1B\u5217\u51FA 2\u20133 \u4E2A\u53EF\u884C\u65B9\u6848\u7684\u4F18\u7F3A\u70B9\u548C\u63A8\u8350\u7406\u7531\uFF0C\u53D6\u5F97\u7528\u6237\u786E\u8BA4\u540E\u624D\u521B\u5EFA\u811A\u624B\u67B6\u3002\u4E0D\u8981\u628A\u4EFB\u4F55\u8BED\u8A00\u3001\u6846\u67B6\u3001UI \u5E93\u6216\u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5F53\u4F5C\u9ED8\u8BA4\u3002\u5DF2\u6709\u9879\u76EE\u5219\u4EE5\u68C0\u6D4B\u5230\u7684\u4E8B\u5B9E\u548C\u4ED3\u5E93\u7EA6\u5B9A\u4E3A\u51C6\u3002
 
-### Step 1: Scout Report\uFF08\u7403\u63A2\u62A5\u544A\uFF09
+### Step 1: Scout \u8C03\u7814
 
-1. \u521B\u5EFA workflow \u76EE\u5F55\uFF1A\`.mancode/workflows/<YYYYMMDD-HHMMSS-slug>/\`
-   - \u5199\u5165 \`metadata.json\`\uFF1A\`{"taskId":"...","task":"...","mode":"man","currentStep":1,"skippedSteps":[],"startedAt":"<ISO>","updatedAt":"<ISO>","status":"in_progress"}\`
-2. \u8C03\u7528 Scout\uFF1A
-   \`\`\`
-   Agent({ subagent_type: "scout", description: "Scout: <task>",
-     prompt: "\u4EFB\u52A1\uFF1A<task>\\n\u9879\u76EE\u6808\uFF1A<\u4ECE state.json>\\n\u5F00\u59CB\u8C03\u7814\u3002" })
-   \`\`\`
-3. Write scout \u8F93\u51FA\u5230 \`scout-report.md\`
-4. \u66F4\u65B0 state.json\uFF1A\`currentMode: "man"\`, \`currentTask: "<taskId>"\`, \`currentWorkflowMode: "man"\`
-5. metadata.json\uFF1A\`currentStep: 2\`
+\u8C03\u7528 \`scout\`\uFF0C\u5199 \`scout-report.md\`\u3002\u62A5\u544A\u5FC5\u987B\u5305\u542B\u201C**\u4E0D\u786E\u5B9A\u7684\u5730\u65B9**\u201D\u3002\u8FD0\u884C \`mancode workflow update <taskId> --step 2\`\u3002
 
-### Step 2: Game Plan
+### Step 2: \u9700\u6C42\u6F84\u6E05
 
-1. \u8BFB \`scout-report.md\` \u5185\u5BB9
-2. \u8C03\u7528 Plan Coach\uFF08\u53EA\u8BFB plan \u6A21\u5F0F\uFF09\uFF1A
-   \`\`\`
-   Agent({ subagent_type: "plan-coach", description: "Plan Coach: plan <task>",
-     prompt: "\u4EFB\u52A1\uFF1A<task>\\nScout Report\uFF1A\\n<scout-report.md \u5185\u5BB9>\\n\\n\u53EA\u8FD4\u56DE plan markdown\uFF0C\u4E0D\u8981\u4FEE\u6539\u9879\u76EE\u6587\u4EF6\u3002" })
-   \`\`\`
-3. Write \u5230 \`plan.md\`
-4. metadata.json\uFF1A\`currentStep: 3\`
+\u4E3B skill \u76F4\u63A5\u57FA\u4E8E Scout \u62A5\u544A\u548C\u4EFB\u52A1\u6B67\u4E49\u63D0\u95EE\uFF1A\u5BA2\u89C2\u9898\u7528 AskUserQuestion\uFF08\u6BCF\u6B21\u6700\u591A 4 \u4E2A\uFF09\uFF0C\u4E3B\u89C2\u9898\u5F00\u653E\u63D0\u95EE\u3002\u6700\u591A\u4E24\u8F6E\uFF0C\u56DE\u7B54\u5199 \`requirements.md\`\uFF1B\u65E0\u95EE\u9898\u5219\u901A\u8FC7 CLI \u5C06 \`clarify\` \u5199\u5165\u7D2F\u8BA1 skippedSteps\u3002\u7B2C\u4E8C\u8F6E\u540E\u5C06\u5047\u8BBE\u3001\u672A\u51B3\u98CE\u9669\u548C\u4FDD\u5B88\u9ED8\u8BA4\u503C\u5199\u5165 requirements\uFF0C\u4E0D\u65E0\u9650\u8FFD\u95EE\u3002\u5B8C\u6210\u540E\u66F4\u65B0\u81F3 Step 3\u3002
 
-### \u7528\u6237\u786E\u8BA4 plan
+### Step 3: Plan Coach \u51FA\u8BA1\u5212
 
-\u7528 AskUserQuestion\uFF1A
+\u8C03\u7528\u53EA\u8BFB \`plan-coach\`\uFF0C\u8F93\u5165 task\u3001scout-report \u548C requirements\uFF1BPlan Coach \u53EA\u8FD4\u56DE\u8BA1\u5212\u6587\u672C\uFF0C\u7531\u4E3B skill \u5199\u5165 \`plan.md\`\u3002\u8BA1\u5212\u5FC5\u987B\u542B\u4EFB\u52A1\u5206\u7EA7\u3001\u6A21\u5757\u7D22\u5F15\u3001\u590D\u7528\u8D44\u6E90\u4E0E scout \u884C\u53F7\u3001\u6700\u5C0F\u7B56\u7565\u3001\u4E0D\u505A\u4EC0\u4E48\u3001\u5B8C\u6210\u5B9A\u4E49\u3001\u9A8C\u8BC1\u4E0E smoke test\u3001\u9884\u4F30\u3002\u9996\u6B21\u8BA1\u5212\u5199\u5165\u6210\u529F\u540E\u8FD0\u884C \`mancode workflow update <taskId> --step 4\`\uFF0C\u7531 CLI upsert Active Plans \u5E76\u8FDB\u5165\u8BA1\u5212\u5173\u5361\uFF1B\u91CD\u5199\u8BA1\u5212\u65F6\u4FDD\u6301\u5728 Step 4\uFF0C\u8FD0\u884C \`--plan-version <\u5F53\u524D\u7248\u672C+1>\`\uFF0C\u4E0D\u5F97\u76F4\u63A5\u7F16\u8F91 planVersion\u3002
 
-\`\`\`
-AskUserQuestion({
-  questions: [{
-    question: "Plan \u89C1 .mancode/workflows/<taskId>/plan.md\u3002\u600E\u4E48\u505A\uFF1F",
-    header: "Plan review",
-    options: [
-      { label: "\u6309 plan \u5B9E\u65BD (Recommended)", description: "\u8FDB\u5165 Step 3" },
-      { label: "\u4FEE\u6539 plan", description: "\u56DE Step 2 \u91CD\u5199" },
-      { label: "\u9000\u51FA", description: "\u653E\u5F03\uFF0C\u6807\u8BB0 abandoned" }
-    ],
-    multiSelect: false
-  }]
-})
-\`\`\`
+### Step 4: \u8BA1\u5212\u5173\u5361
 
-- "\u9000\u51FA" \u2192 metadata.json \`status: "abandoned"\`\uFF1B\u7528 Edit \u66F4\u65B0 \`.mancode/state.json\`\uFF1A\`currentMode: "solo"\`, \`lastMode: "man"\`, \`currentTask: null\`, \`currentWorkflowMode: null\`, \`skippedSteps: []\`\uFF1B\u7136\u540E\u7ED3\u675F\u3002
-- "\u4FEE\u6539 plan" \u2192 \u56DE Step 2\uFF0C\u9644\u7528\u6237\u4FEE\u6539\u610F\u89C1\u3002
-- metadata.json\uFF1A\`currentStep: 3\`
+\u7528 AskUserQuestion \u8BA9\u7528\u6237\u9009\u62E9\uFF1A
+1. **\u53EA\u8981\u8BA1\u5212**\uFF1ACLI \u66F4\u65B0 \`status: planned\`\uFF0Cstate \u56DE solo \u5E76\u6E05\u7A7A workflow \u6307\u9488\uFF0C\u7ED3\u675F\u3002
+2. **\u7EE7\u7EED\u6267\u884C\uFF08\u63A8\u8350\uFF09**\uFF1ACLI \u66F4\u65B0\u81F3 Step 5\u3002
+3. **\u4FEE\u6539\u8BA1\u5212**\uFF1A\u6536\u96C6\u610F\u89C1\u5E76\u91CD\u8DD1 Step 3 \u7684 Plan Coach\uFF0Cworkflow \u6307\u9488\u4FDD\u6301 Step 4\uFF1B\u8BA1\u5212\u91CD\u5199\u5B8C\u6210\u540E\u9012\u589E planVersion\u3002
 
-### Step 3: Tip-off\uFF08\u5B9E\u65BD\uFF09
+### Step 5: \u5B9E\u65BD
 
-1. \u5982\u4EFB\u52A1\u89C4\u6A21\u5927\uFF08\u591A\u6587\u4EF6\u3001\u65B0\u6A21\u5757\uFF09\uFF0C\u5EFA\u8BAE\u7528 EnterWorktree \u521B\u5EFA worktree\uFF08\u53EF\u9009\uFF0C\u95EE\u7528\u6237\uFF09
-2. \u8C03\u7528 Head Coach\uFF08\u5B9E\u65BD\u6A21\u5F0F\uFF09\uFF1A
-   \`\`\`
-   Agent({ subagent_type: "head-coach", description: "Head Coach: implement <task>",
-     prompt: "\u4EFB\u52A1\uFF1A<task>\\nPlan\uFF1A\\n<plan.md \u5185\u5BB9>\\n\\n\u6309 plan \u5B9E\u65BD\u3002" })
-   \`\`\`
-3. metadata.json\uFF1A\`currentStep: 4\`
+\u8C03\u7528 \`head-coach\` \u6309\u786E\u8BA4\u8BA1\u5212\u5B9E\u65BD\u3002\u591A\u6587\u4EF6\u3001\u65B0\u6A21\u5757\u6216\u9AD8\u98CE\u9669\u4EFB\u52A1\u53EF\u5EFA\u8BAE worktree\uFF0C\u5FC5\u987B\u5148\u83B7\u7528\u6237\u540C\u610F\u3002\u5B9E\u65BD\u5B8C\u6210\u540E\u901A\u8FC7 CLI \u66F4\u65B0\u81F3 Step 6\u3002
 
-### Step 4: Head Coach \u81EA\u6D4B
+### Step 6: \u81EA\u6D4B\u3001\u8BCA\u65AD\u4E0E\u56DE\u5F52
 
-\u8BA9 Head Coach \u8DD1\u9A8C\u8BC1\uFF1A\`npm run build && npm run lint && npm test\`\uFF08\u6216\u9879\u76EE\u5B9E\u9645\u547D\u4EE4\uFF09\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 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
 
-**\u94C1\u5F8B 1.3\uFF1A\u5931\u8D25\u4E24\u6B21\u5FC5\u987B\u505C\u4E0B\u8BCA\u65AD\u6839\u56E0**\u3002
+### Step 7: Film #1 \u4EE3\u7801\u8D28\u91CF\u5BA1\u67E5\u4E0E\u4FEE\u590D
 
-\u901A\u8FC7\u540E metadata.json\uFF1A\`currentStep: 5\`
+\u8C03\u7528 \`film-analyst-offense\` \u5BA1\u67E5\u8D28\u91CF\u3001\u590D\u7528\u3001\u590D\u6742\u5EA6\u548C\u6D4B\u8BD5\uFF0C\u5199 \`film-report-1.md\`\uFF1BHead Coach \u4FEE\u590D \u{1F534}\uFF0C\u5BF9 \u{1F7E1} \u5199\u4FEE\u590D\u6216\u6743\u8861\u3002\u5B8C\u6210\u540E\u66F4\u65B0\u81F3 Step 8\u3002
 
-### Step 5: Film Session #1\uFF08\u8FDB\u653B\uFF09
+### Step 8: Film #2 \u5B89\u5168\u4E0E\u8FB9\u754C\u5BA1\u67E5
 
-\u7528 AskUserQuestion \u95EE\u7528\u6237\uFF1A"\u51C6\u5907\u53EB\u5F55\u50CF\u5206\u6790\u5E08 #1\uFF08\u8FDB\u653B\uFF09\u4E0A\u573A\uFF0C\u9700\u8981\u5417\uFF1F"
-- \u8DF3\u8FC7\uFF1Ametadata.json \`skippedSteps: ["film-1"]\`\uFF0C\u76F4\u63A5 Step 7
-- \u6267\u884C\uFF1A
+\u8C03\u7528 \`film-analyst-defense\` \u5BA1\u67E5\u5B89\u5168\u3001\u6743\u9650\u3001\u9519\u8BEF\u8DEF\u5F84\u3001\u517C\u5BB9\u6027\u548C\u8FB9\u754C\uFF0C\u5199 \`film-report-2.md\`\u3002\u53CC\u5BA1\u9ED8\u8BA4\u6267\u884C\uFF1B\u7528\u6237\u660E\u786E\u8981\u6C42\u624D\u53EF\u8DF3\u8FC7\uFF0C\u901A\u8FC7 CLI \u5199\u5165\u7D2F\u8BA1 skippedSteps \u548C\u6B8B\u4F59\u98CE\u9669\u3002\u5B8C\u6210\u540E\u66F4\u65B0\u81F3 Step 9\u3002
 
-\`\`\`
-Agent({ subagent_type: "film-analyst-offense", description: "Film #1: offense review",
-  prompt: "\u4EFB\u52A1\uFF1A<task>\\nScout Report\uFF1A\\n<scout-report.md>\\n\\n\u672C\u6B21\u6539\u52A8\u7684 git diff\uFF1A\\n<git diff HEAD>\\n\\n\u5F00\u59CB\u5BA1\u67E5\u3002" })
-\`\`\`
+### Step 9: \u589E\u5F3A\u6536\u5C3E
 
-Write \u8F93\u51FA\u5230 \`film-report-1.md\`\u3002metadata.json\uFF1A\`currentStep: 6\`
+1. \u4FEE\u590D Film #2 \u7684 \u{1F534} \u5E76\u91CD\u8DD1\u9A8C\u8BC1\u3002
+2. \u5199 \`summary.md\`\uFF1A\u6539\u52A8\u3001\u65B0\u5EFA\u3001\u590D\u7528\u3001\u9A8C\u8BC1\u3001\u53CC\u5BA1\u548C\u8DF3\u8FC7\u6B65\u9AA4\u3002
+3. \u9A8C\u8BC1\u901A\u8FC7\u4E14 \u{1F534} \u6E05\u96F6\u624D\u7528 CLI \u5199 \`completed\`\uFF1B\u5426\u5219\u7528 \`--status blocked --blocking-reason "<\u539F\u56E0>"\`\u3002
+4. \u5173\u952E\u51B3\u7B56 appendTeamDecision \u5230 \`decisions.md\`\uFF0C\u66F4\u65B0 Active Plans\u3002
+5. worktree \u5408\u5E76\u524D\u53D6\u5F97\u7528\u6237\u786E\u8BA4\uFF1B\u7EC8\u6001\u5199\u5165\u6210\u529F\u540E state \u56DE solo \u5E76\u6E05\u7A7A workflow \u6307\u9488\u3002
 
-### Step 6: Halftime \u4FEE\u590D
+\u4EFB\u4F55 step/status/outcome/planVersion \u53D8\u5316\u90FD\u5FC5\u987B\u7ECF\u8FC7 workflow CLI\uFF1BCLI \u62D2\u7EDD\u65F6\u4FDD\u7559\u5F53\u524D state \u5E76\u62A5\u544A\u539F\u56E0\uFF0C\u4E0D\u53EF\u7ED5\u8FC7\u6821\u9A8C\u76F4\u63A5\u6539 metadata.json\u3002
 
-\u8C03\u7528 Head Coach\uFF08\u4FEE\u590D\u6A21\u5F0F\uFF09\uFF1A
-\`\`\`
-Agent({ subagent_type: "head-coach", description: "Head Coach: fix film-1",
-  prompt: "\u4EFB\u52A1\uFF1A<task>\\nFilm Report #1\uFF1A\\n<film-report-1.md>\\n\\n\u4FEE\u590D\u6307\u51FA\u7684\u95EE\u9898\uFF08\u{1F534} \u5FC5\u4FEE > \u{1F7E1} \u5EFA\u8BAE > \u{1F7E2} \u53EF\u9009\uFF09\u3002" })
-\`\`\`
+${CORE_CODING_PRINCIPLES}
+`
+};
 
-\u4FEE\u590D\u540E\u91CD\u8DD1 build/lint/test\u3002metadata.json\uFF1A\`currentStep: 7\`
+// src/templates/skills/mamba.ts
+var MAMBA_SKILL = {
+  name: "mamba",
+  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)
 
-### Step 7: Film Session #2\uFF08\u9632\u5B88\uFF09
+\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
 
-\u95EE\u7528\u6237\uFF1A"\u53EB\u5F55\u50CF\u5206\u6790\u5E08 #2\uFF08\u9632\u5B88\uFF09\u4E0A\u573A\uFF1F"
-- \u8DF3\u8FC7\uFF1Ametadata.json \`skippedSteps\` \u52A0 \`"film-2"\`\uFF0C\u76F4\u63A5 Step 8
-- \u6267\u884C\uFF1A
+## 1. \u5EFA\u7ACB\u4EFB\u52A1
 
-\`\`\`
-Agent({ subagent_type: "film-analyst-defense", description: "Film #2: defense review",
-  prompt: "\u4EFB\u52A1\uFF1A<task>\\nScout Report\uFF1A\\n<scout-report.md>\\nFilm Report #1 \u5DF2\u6307\u51FA\uFF08\u4E0D\u8981\u91CD\u590D\uFF09\uFF1A\\n<film-report-1.md>\\n\\n\u672C\u6B21\u6539\u52A8\u7684 git diff\uFF1A\\n<git diff HEAD>\\n\\n\u5F00\u59CB\u9632\u5B88\u5BA1\u67E5\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 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
 
-Write \u5230 \`film-report-2.md\`\u3002
-metadata.json\uFF1A\`currentStep: 8\`
+\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
 
-### Step 8: Post-game \u6536\u5C3E
+## 2. \u51C6\u5907\u73AF\u5883\u4E0E\u6743\u9650
 
-1. \u8C03\u7528 Head Coach\uFF08\u6536\u5C3E\u6A21\u5F0F\uFF09\u4FEE\u590D Film Report #2 \u7684 \u{1F534} \u95EE\u9898\uFF1A
-   \`\`\`
-   Agent({ subagent_type: "head-coach", description: "Head Coach: wrap up",
-     prompt: "\u4EFB\u52A1\uFF1A<task>\\nFilm Report #2\uFF1A\\n<film-report-2.md>\\n\\n\u4FEE\u590D \u{1F534} \u5FC5\u4FEE\u95EE\u9898\uFF0C\u7136\u540E\u751F\u6210 summary\u3002" })
-   \`\`\`
-2. \u628A summary \u5199\u5230 \`summary.md\`
-3. \u5982\u6709 worktree\uFF0C\u5408\u5E76\u56DE\u4E3B\u5206\u652F\uFF08\u7528\u6237\u786E\u8BA4\u540E\uFF09
-4. \u66F4\u65B0 state.json\uFF1A\`currentMode: "solo"\`, \`lastMode: "man"\`, \`currentTask: null\`, \`currentWorkflowMode: null\`, \`skippedSteps: []\`
-5. metadata.json\uFF1A\`status: "completed"\`
+\u5148\u8BFB \`.mancode/project-profile.json\`\uFF0C\u53EA\u4F7F\u7528\u5DF2\u68C0\u6D4B\u5230\u7684\u9879\u76EE\u7C7B\u578B\u3001manifest \u548C\u9A8C\u8BC1\u80FD\u529B\uFF1Bprofile \u4E3A unknown \u65F6\u5148\u95EE\u5173\u952E\u7F3A\u5931\u4FE1\u606F\u3002\u4F18\u5148\u672C\u5730 \u2192 \u6D4B\u8BD5 \u2192 staging \u2192 \u751F\u4EA7\u53EA\u8BFB\u3002\u53EF\u4EE5\u542F\u52A8\u672C\u5730\u5F00\u53D1\u670D\u52A1\u548C\u505A\u53EA\u8BFB\u63A2\u6D4B\u3002\u4E0B\u8F7D\u4F9D\u8D56\u3001seed/reset\u3001\u5199\u5165\u6D4B\u8BD5\u6570\u636E\u3001\u767B\u5F55\u5916\u90E8\u7CFB\u7EDF\u3001\u901A\u77E5\u3001\u4ED8\u6B3E\u3001\u5220\u9664\u6216\u751F\u4EA7\u5199\u64CD\u4F5C\u524D\uFF0C\u8BF4\u660E\u5F71\u54CD\u5E76\u53D6\u5F97\u7528\u6237\u786E\u8BA4\uFF1B\u4E0D\u731C\u6D4B\u51ED\u636E\u6216 Token\u3002
 
-## \u6700\u7EC8\u8F93\u51FA
+\u5E73\u53F0\u80FD\u529B\u5206\u7EA7\uFF1A
+- **\u5B8C\u6574**\uFF1A\u6709\u7EC8\u7AEF\u3001\u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u548C Playwright CLI\uFF1B\u53EF\u6D4B\u8BD5\u771F\u5B9E\u6D4F\u89C8\u5668\u8DEF\u5F84\u3002
+- **\u534A\u81EA\u52A8**\uFF1A\u53EA\u80FD\u6267\u884C\u547D\u4EE4\uFF1B\u8F93\u51FA\u9010\u6B65\u4EBA\u5DE5\u6D4F\u89C8\u5668\u6D4B\u8BD5\u6E05\u5355\u3002
+- **\u53D7\u9650**\uFF1A\u65E0\u672C\u5730\u6267\u884C\u80FD\u529B\uFF1B\u8F93\u51FA\u73AF\u5883\u9700\u6C42\u4E0E\u4EBA\u5DE5\u6B65\u9AA4\uFF0Cmetadata \u8BB0 \`outcome: "manual_test_required"\`\uFF0C\u4E0D\u5F97\u58F0\u79F0\u5DF2\u771F\u5B9E\u6D4B\u8BD5\u3002
 
-\u544A\u8BC9\u7528\u6237\uFF1A
-- \u6539\u4E86\u54EA\u4E9B\u6587\u4EF6 / \u65B0\u5EFA\u4E86\u54EA\u4E9B\u6587\u4EF6
-- \u590D\u7528\u4E86\u54EA\u4E9B\u5DF2\u6709\u4EE3\u7801
-- \u54EA\u4E9B\u6B65\u9AA4\u88AB\u8DF3\u8FC7\uFF08\u26A0\uFE0F \u6807\u6CE8\uFF09
-- \u9A8C\u8BC1\u7ED3\u679C\uFF08build/lint/test \u662F\u5426\u901A\u8FC7\uFF09
-- summary \u8DEF\u5F84
+\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
 
-## \u4E0A\u4E0B\u6587\u9884\u7B97
+\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
 
-- \u8C03\u7528 subagent \u65F6\uFF0C**\u53EA\u8D34\u5FC5\u8981\u6587\u4EF6\u5185\u5BB9**\uFF08scout-report.md \u5168\u6587\u3001film-report \u5168\u6587\uFF09
-- diff \u5927\u65F6\u53EA\u8D34 hunk \u6458\u8981\uFF0C\u8BA9 agent \u81EA\u5DF1\u7528 Read \u770B\u5B8C\u6574 diff
-- \u4E0D\u8981 dump \u6574\u4E2A\u6E90\u6587\u4EF6\u5230\u5BF9\u8BDD
+## 3. \u590D\u73B0\u4E0E\u8BCA\u65AD
 
-${CORE_CODING_PRINCIPLES}
+\u6309\u6700\u77ED\u7528\u6237\u8DEF\u5F84\u590D\u73B0\u3002\u8BB0\u5F55\u8BF7\u6C42/\u54CD\u5E94\u3001\u65E5\u5FD7\u3001\u9519\u8BEF\u6808\u3001\u622A\u56FE\u548C\u5173\u952E UI \u72B6\u6001\u3002\u533A\u5206\u73AF\u5883\u3001\u6570\u636E\u3001\u914D\u7F6E\u3001\u6743\u9650\u3001\u524D\u7AEF\u3001\u540E\u7AEF\u548C\u9700\u6C42\u7406\u89E3\u95EE\u9898\u3002\u5199 \`diagnosis.md\`\uFF1A\u590D\u73B0\u6B65\u9AA4\u3001\u8BC1\u636E\u3001\u6839\u56E0\u6216\u5019\u9009\u6839\u56E0\u3001\u5F71\u54CD\u9762\u548C\u7F6E\u4FE1\u5EA6\u3002\u5B8C\u6210\u540E\u7528 CLI \u66F4\u65B0\u81F3 Step 4\u3002
+
+## 4. \u6700\u5C0F\u4FEE\u590D\u6216\u4EC5\u9A8C\u8BC1
 
-\u6536\u5230 \`/man\` \u89E6\u53D1\u540E\u7ACB\u5373\u5F00\u59CB Step 1\u3002`
+\u7528\u6237\u8981\u6C42\u4FEE\u590D\u65F6\u53EA\u505A\u6700\u5C0F\u6539\u52A8\uFF1B\u53EA\u8981\u6C42\u6D4B\u8BD5\u65F6\u4E0D\u6539\u4EE3\u7801\u3002\u65B0\u9700\u6C42\u3001\u67B6\u6784\u51B3\u7B56\u6216\u8DE8\u6A21\u5757\u6539\u9020\u5E94\u505C\u6B62\u5E76\u5EFA\u8BAE /man\u3002\u5B8C\u6210\u540E\u7528 CLI \u66F4\u65B0\u81F3 Step 5\u3002
+
+## 5. \u771F\u5B9E\u56DE\u5F52\u4E0E\u7ED3\u8BBA
+
+\u91CD\u8DD1\u539F\u8DEF\u5F84\uFF0C\u8986\u76D6\u53D7\u5F71\u54CD\u7684\u5173\u952E\u6B63\u5411\u3001\u8D1F\u5411\u548C\u6743\u9650\u8FB9\u754C\u8DEF\u5F84\uFF0C\u5E76\u8FD0\u884C\u5FC5\u8981 build/lint/typecheck/test\u3002\u5199 \`mamba-report.md\`\uFF1A\u73AF\u5883\u3001\u6B65\u9AA4\u3001\u7ED3\u679C\u3001\u4EA7\u7269\u8DEF\u5F84\u3001\u56DE\u5F52\u8303\u56F4\u3001\u98CE\u9669\u4E0E\u5EFA\u8BAE\u3002
+
+- \u5DF2\u4FEE\u590D\uFF1A\`status: "completed", outcome: "fixed"\`
+- \u5DF2\u9A8C\u8BC1\u4F46\u672A\u6539\u4EE3\u7801\uFF1A\`status: "completed", outcome: "verified"\`
+- \u6307\u5B9A\u73AF\u5883\u672A\u590D\u73B0\uFF1A\`status: "completed", outcome: "no_repro"\`\uFF0C\u9650\u5B9A\u7ED3\u8BBA\u8303\u56F4
+- \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
+
+${CORE_CODING_PRINCIPLES}
+`
 };
 
 // src/templates/skills/manps.ts
@@ -1099,8 +1004,8 @@ CLI \u6210\u529F\u540E\uFF0C\u518D\u6309\u4E0B\u9762\u7684\u624B\u52A8\u626B\u63
 
 ### 1. Project Shape
 
-- \u8BFB\u53D6 \`package.json\`\u3001README\u3001\u6D4B\u8BD5\u914D\u7F6E\u3001lint/build \u811A\u672C
-- \u8BC6\u522B tech stack\u3001\u6D4B\u8BD5\u547D\u4EE4\u3001\u6784\u5EFA\u547D\u4EE4
+- \u8BFB\u53D6\u68C0\u6D4B\u5230\u7684 manifest\u3001README\u3001\u6D4B\u8BD5\u914D\u7F6E\u3001lint/build \u811A\u672C
+- \u8BC6\u522B\u9879\u76EE\u7C7B\u578B\u3001\u8BED\u8A00\u3001\u6D4B\u8BD5\u547D\u4EE4\u4E0E\u6784\u5EFA\u547D\u4EE4\uFF1B\u4E0D\u5047\u5B9A\u7279\u5B9A\u751F\u6001
 - \u8BFB\u53D6 \`.mancode/state.json\` \u548C \`.mancode/aesthetics/style-tokens.json\`\uFF08\u5982\u5B58\u5728\uFF09
 
 ### 2. Tech Debt
@@ -1113,7 +1018,7 @@ CLI \u6210\u529F\u540E\uFF0C\u518D\u6309\u4E0B\u9762\u7684\u624B\u52A8\u626B\u63
 
 ### 3. Dependency Health
 
-- \u5BF9\u7167 \`package.json\` dependencies/devDependencies \u4E0E\u6E90\u7801 import
+- \u5BF9\u7167\u5DF2\u68C0\u6D4B\u5230\u7684 manifest\u3001\u9501\u6587\u4EF6\u3001\u4F9D\u8D56\u58F0\u660E\u4E0E\u6E90\u7801 import
 - \u6807\u8BB0\u7591\u4F3C\u672A\u4F7F\u7528\u4F9D\u8D56\uFF0C\u4F46\u4E0D\u8981\u76F4\u63A5\u5220\u9664
 - \u6807\u8BB0\u7F3A\u5C11\u811A\u672C\u7684\u98CE\u9669\uFF1A\u65E0 test\u3001\u65E0 lint\u3001\u65E0 build
 
@@ -1172,14 +1077,15 @@ var MANSOLO_SKILL = {
 
 ## \u4F60\u8981\u505A\u7684
 
-1. \u7528 Read \u8BFB \`.mancode/state.json\`
-2. \u7528 Edit \u66F4\u65B0\u4EE5\u4E0B\u5B57\u6BB5\uFF1A
+1. \u7528 Read \u8BFB \`.mancode/state.json\`\u3002\u5982\u679C \`currentTask\` \u975E\u7A7A\uFF0C\u5148\u8FD0\u884C \`mancode workflow show <taskId> --json\`\uFF0C\u4E0D\u8981\u5148\u6E05\u7A7A state\u3002
+2. \u6309\u4E0B\u65B9\u8FB9\u754C\u89C4\u5219\u5B89\u5168\u5904\u7406 active workflow\uFF1B\u7EC8\u6001 workflow \u4E0D\u518D\u6539\u5199\u72B6\u6001\u3002
+3. \u53EA\u6709\u4E0D\u518D\u9057\u7559 active workflow \u540E\uFF0C\u624D\u7528 Edit \u66F4\u65B0\u4EE5\u4E0B\u5B57\u6BB5\uFF1A
    - \`currentMode\` \u2192 \`"solo"\`
    - \`lastMode\` \u2190 \u539F \`currentMode\`\uFF08\u4FDD\u7559\u4E0A\u4E00\u4E2A\u6A21\u5F0F\u540D\u4F5C\u4E3A\u8BB0\u5F55\uFF09
    - \`currentTask\` \u2192 \`null\`
    - \`currentWorkflowMode\` \u2192 \`null\`
    - \`skippedSteps\` \u2192 \`[]\`
-3. \u4E0D\u6539 \`initializedAt\`\u3001\`techStack\`\u3001\`uiLibrary\`\u3001\`teamModeAutoDetected\`\u3001\`contributors\`
+4. \u4E0D\u6539 \`initializedAt\`\u3001\`techStack\`\u3001\`uiLibrary\`\u3001\`teamModeAutoDetected\`\u3001\`contributors\`
 
 ## \u8F93\u51FA
 
@@ -1195,7 +1101,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\u5728 /man /man8 \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 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
   \`\`\`
   AskUserQuestion({
     questions: [{
@@ -1210,10 +1117,12 @@ var MANSOLO_SKILL = {
   })
   \`\`\`
   \u7528\u6237\u786E\u8BA4\u540E\uFF1A
-  - \u7528 Edit \u66F4\u65B0 workflow \u7684 \`metadata.json\`\uFF1A\`status: "abandoned"\`
-  - \u518D\u66F4\u65B0 state.json \u5207\u56DE solo
+  - \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
+  - \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
 
-\u6536\u5230\u89E6\u53D1\u7ACB\u5373\u6267\u884C\uFF0C\u4E0D\u95EE\u4EFB\u4F55\u989D\u5916\u95EE\u9898\u3002`
+\u6536\u5230\u89E6\u53D1\u7ACB\u5373\u68C0\u67E5\u72B6\u6001\uFF1B\u9664\u653E\u5F03 active workflow \u6240\u9700\u7684\u786E\u8BA4\u5916\uFF0C\u4E0D\u95EE\u989D\u5916\u95EE\u9898\u3002`
 };
 
 // src/templates/skills/manteam.ts
@@ -1222,7 +1131,9 @@ var MANTEAM_SKILL = {
   description: "Team workflow for shared repositories. Adds contributor context, coordination notes, commit discipline, and hand-off summaries to the full /man flow.",
   body: `# mancode \xB7 /manteam (Team Game)
 
-\u7528\u6237\u7528 \`/manteam <task>\` \u89E6\u53D1\u4F60\u3002\u8FD9\u662F\u591A\u4EBA\u534F\u4F5C\u7248\u7684\u5B8C\u6574\u5DE5\u4F5C\u6D41\uFF1A\u5148\u7406\u89E3\u56E2\u961F\u4E0A\u4E0B\u6587\uFF0C\u518D\u6309 /man \u7684 8 \u6B65\u6D41\u7A0B\u63A8\u8FDB\u3002
+\u7528\u6237\u7528 \`/manteam <task>\` \u89E6\u53D1\u4F60\u3002\u8FD9\u662F\u591A\u4EBA\u534F\u4F5C\u7248\u7684\u5B8C\u6574\u5DE5\u4F5C\u6D41\uFF1A\u5148\u7406\u89E3\u56E2\u961F\u4E0A\u4E0B\u6587\uFF0C\u518D\u6309 /man \u7684 9 \u6B65\u6D41\u7A0B\u63A8\u8FDB\u3002
+
+\u7528 \`mancode workflow create manteam "<task>" --json\` \u521B\u5EFA workflow\uFF0C\u5E76\u5C06 state \u6307\u5411\u8FD4\u56DE\u7684 taskId\u3002\u540E\u7EED step/status/planVersion/skippedSteps \u5168\u90E8\u4F7F\u7528 \`mancode workflow update\`\uFF1B\u4E0D\u5F97\u76F4\u63A5\u6539 metadata.json\u3002\u82E5\u5DF2\u6709 active workflow\uFF0C\u5148\u8BA9\u7528\u6237\u9009\u62E9\u6062\u590D\u6216\u653E\u5F03\uFF0C\u4E0D\u80FD\u6E05\u7A7A\u65E7\u6307\u9488\u3002
 
 ## \u9002\u7528\u573A\u666F
 
@@ -1253,21 +1164,21 @@ var MANTEAM_SKILL = {
    - files likely to touch
    - coordination risks
 
-## Step 1-8: Run Playoffs Flow
+## Step 1-9: Run Progressive /man Flow
 
-\u6309 \`/man\` \u7684 8 \u6B65\u6D41\u7A0B\u6267\u884C\uFF0C\u4F46\u6BCF\u4E00\u6B65\u589E\u52A0\u56E2\u961F\u7EA6\u675F\uFF1A
+\u6309 \`/man\` \u7684 9 \u6B65\u6D41\u7A0B\u6267\u884C\uFF08\u542B\u6F84\u6E05\u3001\u8BA1\u5212\u5173\u5361\u548C\u589E\u5F3A\u6536\u5C3E\uFF09\uFF0C\u4F46\u6BCF\u4E00\u6B65\u589E\u52A0\u56E2\u961F\u7EA6\u675F\uFF1A
 
 1. Scout Report\uFF1A\u5FC5\u987B\u5217\u51FA\u5171\u4EAB\u6587\u4EF6\u3001\u8FD1\u671F\u76F8\u5173\u63D0\u4EA4\u3001\u6F5C\u5728\u51B2\u7A81\u6587\u4EF6\u3002
-2. 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\u3002
-   - Plan Coach \u5199\u8BA1\u5212\uFF1A\u53EA\u8FD4\u56DE\u8BA1\u5212\u6587\u672C\uFF0C\u7981\u6B62\u63D0\u524D\u4FEE\u6539\u4E1A\u52A1\u6587\u4EF6\u6216\u56E2\u961F memory\u3002
-3. Tip-off\uFF1A\u6539\u52A8\u524D\u518D\u6B21\u68C0\u67E5 \`git status --short\`\uFF0C\u907F\u514D\u8E29\u7528\u6237\u6216\u961F\u53CB\u6539\u52A8\u3002
-4. 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
-5. Film #1\uFF1A\u91CD\u70B9\u5BA1\u67E5\u53EF\u7EF4\u62A4\u6027\u3001\u547D\u540D\u4E00\u81F4\u6027\u3001\u56E2\u961F\u98CE\u683C\u4E00\u81F4\u6027\u3002
-6. Halftime Fix\uFF1A\u53EA\u4FEE plan \u548C film \u6307\u51FA\u7684\u5185\u5BB9\u3002
-7. Film #2\uFF1A\u91CD\u70B9\u5BA1\u67E5\u8FB9\u754C\u6761\u4EF6\u3001\u5B89\u5168\u3001\u6027\u80FD\u3001\u5E76\u53D1\u3001\u517C\u5BB9\u6027\u3002
-8. Post-game\uFF1A\u751F\u6210 hand-off summary\u3002
+2. \u6F84\u6E05\uFF1A\u6700\u591A\u4E24\u8F6E\uFF1B\u628A\u5DF2\u786E\u8BA4\u7EA6\u675F\u548C\u4FDD\u5B88\u9ED8\u8BA4\u503C\u5199\u5165 requirements.md\u3002
+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
+7. Film #1\uFF1A\u91CD\u70B9\u5BA1\u67E5\u53EF\u7EF4\u62A4\u6027\u3001\u547D\u540D\u4E00\u81F4\u6027\u3001\u56E2\u961F\u98CE\u683C\u4E00\u81F4\u6027\uFF0C\u5E76\u4FEE\u590D \u{1F534}\u3002
+8. Film #2\uFF1A\u91CD\u70B9\u5BA1\u67E5\u8FB9\u754C\u6761\u4EF6\u3001\u5B89\u5168\u3001\u6027\u80FD\u3001\u5E76\u53D1\u3001\u517C\u5BB9\u6027\u3002\u53CC\u5BA1\u9ED8\u8BA4\u6267\u884C\uFF1B\u7528\u6237\u660E\u786E\u8981\u6C42\u624D\u53EF\u8DF3\u8FC7\uFF0C\u5199\u5165 \`skippedSteps\` \u548C\u6B8B\u4F59\u98CE\u9669\uFF1B\u8DF3\u8FC7\u4E0D\u963B\u6B62 completed\uFF0C\u4F46\u4E0D\u5F97\u58F0\u79F0"\u5DF2\u5B8C\u6210\u53CC\u5BA1"\u3002
+9. Post-game\uFF1A\u590D\u9A8C\uFF0C\u5199 summary \u4E0E hand-off\uFF1B\u9A8C\u8BC1\u5931\u8D25\u6216\u672A\u4FEE\u590D \u{1F534} \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\u6807\u8BB0\u5F53\u524D workflow \`metadata.json.status = "abandoned"\`\uFF0C\u5E76\u7528 Edit \u66F4\u65B0 \`.mancode/state.json\`\uFF1A\`currentMode: "solo"\`, \`lastMode: "manteam"\`, \`currentTask: null\`, \`currentWorkflowMode: null\`, \`skippedSteps: []\`\u3002\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 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
 
 ## Team Hand-off Summary
 
@@ -1314,8 +1225,8 @@ ${CORE_CODING_PRINCIPLES}
 
 // src/templates/skills/index.ts
 var MVP2_SKILLS = [
-  MAN8_SKILL,
   MAN_SKILL,
+  MAMBA_SKILL,
   MANTEAM_SKILL,
   MANPS_SKILL,
   MANSOLO_SKILL
@@ -1331,11 +1242,11 @@ ${spec.body}
 }
 
 // src/installers/common.ts
-import { chmod, mkdir as mkdir2, readFile, stat, writeFile as writeFile2 } from "fs/promises";
+import { chmod, mkdir as mkdir2, readFile as readFile2, stat, writeFile as writeFile2 } from "fs/promises";
 import path2 from "path";
 
 // src/system/team-memory.ts
-import { appendFile, mkdir, writeFile } from "fs/promises";
+import { appendFile, mkdir, readFile, writeFile } from "fs/promises";
 import path from "path";
 var MEMORY_FILES = {
   prd: {
@@ -1381,6 +1292,54 @@ async function ensureTeamMemory(projectRoot) {
   ]);
   return { dir, files };
 }
+async function upsertActivePlan(projectRoot, entry) {
+  const summary = await ensureTeamMemory(projectRoot);
+  const updatedAt = (entry.updatedAt ?? /* @__PURE__ */ new Date()).toISOString();
+  const line = `- ${entry.taskId} | ${entry.status} | plan v${entry.planVersion} | .mancode/workflows/${entry.taskId}/plan.md | ${updatedAt}`;
+  const raw = await readFile(summary.files.spec, "utf-8");
+  const heading = "## Active Plans";
+  const start = raw.indexOf(heading);
+  const isActive = entry.status === "in_progress" || entry.status === "planned";
+  if (start === -1) {
+    if (!isActive) return;
+    await writeFile(
+      summary.files.spec,
+      `${raw.trimEnd()}
+
+${heading}
+
+${line}
+`,
+      "utf-8"
+    );
+    return;
+  }
+  const afterHeading = start + heading.length;
+  const nextHeading = raw.indexOf("\n## ", afterHeading);
+  const end = nextHeading === -1 ? raw.length : nextHeading;
+  const section = raw.slice(afterHeading, end);
+  const entryPattern = new RegExp(
+    `^- ${escapeRegExp(entry.taskId)} \\|.*(?:\\n|$)`,
+    "m"
+  );
+  if (!isActive) {
+    await writeFile(
+      summary.files.spec,
+      `${raw.slice(0, afterHeading)}${section.replace(entryPattern, "")}${raw.slice(end)}`,
+      "utf-8"
+    );
+    return;
+  }
+  const replaced = section.replace(entryPattern, line);
+  const nextSection = replaced === section ? `${section.trimEnd()}
+${line}
+` : replaced;
+  await writeFile(
+    summary.files.spec,
+    `${raw.slice(0, afterHeading)}${nextSection}${raw.slice(end)}`,
+    "utf-8"
+  );
+}
 function memoryDir(projectRoot) {
   return path.join(projectRoot, ".mancode", "memory");
 }
@@ -1397,6 +1356,9 @@ function renderMemoryFile(title, body) {
 ${body}
 `;
 }
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 
 // src/templates/defaults.ts
 var DEFAULT_CONFIG = {
@@ -1463,7 +1425,7 @@ async function installMancodeCore(projectRoot) {
 }
 async function readTextIfExists(filePath) {
   try {
-    return await readFile(filePath, "utf-8");
+    return await readFile2(filePath, "utf-8");
   } catch (err) {
     if (isNodeError(err) && err.code === "ENOENT") return "";
     throw err;
@@ -1490,6 +1452,14 @@ function isNodeError(err) {
 }
 
 // src/installers/claude-code.ts
+var CLAUDE_SKILL_MANAGED_MARKER = "<!-- Managed by mancode:claude-skill. Do not edit this marker. -->";
+var CLAUDE_AGENT_MANAGED_MARKER = "<!-- Managed by mancode:claude-agent. Do not edit this marker. -->";
+var LEGACY_CLAUDE_SKILL_SETTINGS = {
+  solo: ".claude/skills/mancode-solo.md",
+  man8: ".claude/skills/mancode-man8.md",
+  man: ".claude/skills/mancode-man.md",
+  mansolo: ".claude/skills/mancode-mansolo.md"
+};
 async function validateClaudeCodeSettings(projectRoot) {
   await readClaudeSettings(path3.join(projectRoot, ".claude"));
 }
@@ -1499,7 +1469,7 @@ async function installClaudeCode(projectRoot, options) {
   const force = options.force ?? false;
   await installMancodeCore(projectRoot);
   await mkdir3(path3.join(claudeDir, "skills"), { recursive: true });
-  await installSoloSkill(path3.join(claudeDir, "skills"));
+  await installSoloSkill(path3.join(claudeDir, "skills"), force);
   if (options.minimal) {
     await uninstallMvp2Skills(path3.join(claudeDir, "skills"));
   } else {
@@ -1512,44 +1482,59 @@ async function installClaudeCode(projectRoot, options) {
   }
   await updateClaudeSettings(claudeDir, settings);
 }
-async function installSoloSkill(skillsDir) {
-  await installProjectSkill(skillsDir, {
-    name: "solo",
-    description: "Default mancode solo-mode guidance for small, focused tasks.",
-    body: SOLO_SKILL
-  });
-  await removeLegacyFlatSkill(skillsDir, "mancode-solo");
+async function installSoloSkill(skillsDir, force) {
+  await installProjectSkill(
+    skillsDir,
+    {
+      name: "solo",
+      description: "Default mancode solo-mode guidance for small, focused tasks.",
+      body: SOLO_SKILL
+    },
+    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}`);
+    await removeLegacyFlatSkill(skillsDir, `mancode-${skill.name}`, skill.name);
   }
 }
+async function removeManagedLegacyMan8Skill(skillsDir) {
+  await removeGeneratedSkillDir(skillsDir, "man8");
+}
 async function uninstallMvp2Skills(skillsDir) {
   for (const skill of MVP2_SKILLS) {
-    await rm(path3.join(skillsDir, skill.name), {
-      recursive: true,
-      force: true
-    });
-    await removeLegacyFlatSkill(skillsDir, `mancode-${skill.name}`);
+    await removeGeneratedSkillDir(skillsDir, skill.name);
+    await removeLegacyFlatSkill(skillsDir, `mancode-${skill.name}`, skill.name);
   }
 }
 async function installProjectSkill(skillsDir, skill, force = true) {
   const skillDir = path3.join(skillsDir, skill.name);
   const skillPath = path3.join(skillDir, "SKILL.md");
-  if (!force) {
-    try {
-      await access(skillPath);
-      return;
-    } catch {
-    }
+  const existing = await readTextIfExists2(skillPath);
+  if (existing !== null && !force) {
+    return;
+  }
+  if (existing !== null && force && !isGeneratedClaudeSkill(existing, skill.name)) {
+    throw new Error(
+      `refusing to overwrite user-authored Claude Code skill: ${skillPath}`
+    );
   }
   await mkdir3(skillDir, { recursive: true });
-  await writeFile3(skillPath, renderSkill(skill), "utf-8");
+  await writeFile3(
+    skillPath,
+    addManagedMarker(renderSkill(skill), CLAUDE_SKILL_MANAGED_MARKER),
+    "utf-8"
+  );
 }
-async function removeLegacyFlatSkill(skillsDir, legacyName) {
-  await rm(path3.join(skillsDir, `${legacyName}.md`), { force: true });
+async function removeLegacyFlatSkill(skillsDir, legacyName, modeName) {
+  const legacyPath = path3.join(skillsDir, `${legacyName}.md`);
+  const content = await readTextIfExists2(legacyPath);
+  if (content && isGeneratedClaudeSkill(content, modeName)) {
+    await rm(legacyPath, { force: true });
+  }
 }
 async function installAgents(agentsDir, force) {
   await mkdir3(agentsDir, { recursive: true });
@@ -1562,19 +1547,84 @@ async function installAgents(agentsDir, force) {
       } catch {
       }
     }
-    const content = renderAgent(agent);
+    const existing = await readTextIfExists2(agentPath);
+    if (existing !== null && force && !isGeneratedClaudeAgent(existing, agent.name)) {
+      throw new Error(
+        `refusing to overwrite user-authored Claude Code agent: ${agentPath}`
+      );
+    }
+    const content = addManagedMarker(
+      renderAgent(agent),
+      CLAUDE_AGENT_MANAGED_MARKER
+    );
     await writeFile3(agentPath, content, "utf-8");
   }
 }
 async function uninstallAgents(agentsDir) {
   for (const agent of ALL_AGENTS) {
-    await rm(path3.join(agentsDir, `${agent.name}.md`), { force: true });
+    const agentPath = path3.join(agentsDir, `${agent.name}.md`);
+    const content = await readTextIfExists2(agentPath);
+    if (content && isGeneratedClaudeAgent(content, agent.name)) {
+      await rm(agentPath, { force: true });
+    }
+  }
+}
+async function removeClaudeGeneratedContent(projectRoot) {
+  const claudeDir = path3.join(projectRoot, ".claude");
+  const skillsDir = path3.join(claudeDir, "skills");
+  for (const modeName of [
+    "solo",
+    "man8",
+    ...MVP2_SKILLS.map((skill) => skill.name)
+  ]) {
+    await removeGeneratedSkillDir(skillsDir, modeName);
+    await removeLegacyFlatSkill(skillsDir, `mancode-${modeName}`, modeName);
+  }
+  await uninstallAgents(path3.join(claudeDir, "agents"));
+}
+async function removeGeneratedSkillDir(skillsDir, modeName) {
+  const skillDir = path3.join(skillsDir, modeName);
+  const skillPath = path3.join(skillDir, "SKILL.md");
+  const content = await readTextIfExists2(skillPath);
+  if (!content || !isGeneratedClaudeSkill(content, modeName)) return;
+  await rm(skillPath, { force: true });
+  await removeIfEmpty(skillDir);
+}
+function isGeneratedClaudeSkill(content, modeName) {
+  if (content.includes(CLAUDE_SKILL_MANAGED_MARKER)) return true;
+  if (!content.includes(`name: ${modeName}`)) return false;
+  const heading = modeName === "solo" ? "# mancode \xB7 solo mode" : modeName === "man8" ? "# mancode \xB7 /man8 (4 AM Warmup)" : `# mancode \xB7 /${modeName}`;
+  return content.includes(heading);
+}
+function isGeneratedClaudeAgent(content, name) {
+  return content.includes(CLAUDE_AGENT_MANAGED_MARKER) || content.includes(`name: ${name}`) && content.includes("mancode \u6559\u7EC3\u7EC4");
+}
+function addManagedMarker(content, marker) {
+  return content.replace("---\n\n", `---
+
+${marker}
+
+`);
+}
+async function readTextIfExists2(filePath) {
+  try {
+    return await readFile3(filePath, "utf-8");
+  } catch {
+    return null;
+  }
+}
+async function removeIfEmpty(dir) {
+  try {
+    if ((await readdir(dir)).length === 0) {
+      await rm(dir, { recursive: true, force: true });
+    }
+  } catch {
   }
 }
 async function readClaudeSettings(claudeDir) {
   const settingsPath = path3.join(claudeDir, "settings.json");
   try {
-    const raw = await readFile2(settingsPath, "utf-8");
+    const raw = await readFile3(settingsPath, "utf-8");
     return JSON.parse(raw);
   } catch (err) {
     if (isNodeError2(err) && err.code === "ENOENT") {
@@ -1604,16 +1654,10 @@ async function updateClaudeSettings(claudeDir, settings) {
 }
 function removeLegacyMancodeSkillSettings(settings) {
   if (!settings.skills) return;
-  const legacyNames = /* @__PURE__ */ new Set([
-    "solo",
-    "man8",
-    "man",
-    "manteam",
-    "manps",
-    "mansolo"
-  ]);
   const retained = Object.fromEntries(
-    Object.entries(settings.skills).filter(([name]) => !legacyNames.has(name))
+    Object.entries(settings.skills).filter(
+      ([name, value]) => LEGACY_CLAUDE_SKILL_SETTINGS[name] !== value
+    )
   );
   settings.skills = Object.keys(retained).length > 0 ? retained : void 0;
 }
@@ -1774,17 +1818,19 @@ function findMarkerLine(content, marker) {
 }
 
 // src/installers/mode-skills.ts
-import { mkdir as mkdir4, readFile as readFile3, readdir, rm as rm2, writeFile as writeFile4 } from "fs/promises";
+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 = [
-  "man8",
+  "mamba",
   "man",
   "manteam",
   "manps",
   "mansolo"
 ];
+var LEGACY_MODE_NAMES = ["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. -->";
 var MANCODE_AGENT_SKILL_MARKERS = [
   CODEX_SKILL_MANAGED_MARKER,
   ZCODE_SKILL_MANAGED_MARKER
@@ -1819,8 +1865,9 @@ function renderModeSkill(mode, commandPrefix = "$") {
     "For every task, consider: why this change, what already exists, and what",
     "is the smallest useful diff?",
     "",
-    "For UI tasks, read `.mancode/aesthetics/style-tokens.json` for current",
-    "design tokens before inventing new styles.",
+    "Read `.mancode/project-profile.json` before choosing tools or validation.",
+    "Only for a UI task in a profile with detected UI assets, read",
+    "`.mancode/aesthetics/style-tokens.json` before inventing new styles.",
     "",
     meta.workflow
   ].join("\n");
@@ -1831,6 +1878,7 @@ 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 });
@@ -1861,6 +1909,7 @@ 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 });
@@ -1892,6 +1941,7 @@ 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 = [
@@ -1899,10 +1949,17 @@ async function installCursorCommands(projectRoot, minimal) {
       `description: ${JSON.stringify(meta.description)}`,
       "---",
       "",
+      MODE_FILE_MANAGED_MARKER,
+      "",
       renderModeSkill(mode, "/"),
       ""
     ].join("\n");
-    await writeFile4(path4.join(commandsDir, `${mode}.md`), content, "utf-8");
+    await writeManagedModeFile(
+      path4.join(commandsDir, `${mode}.md`),
+      content,
+      mode,
+      "Cursor"
+    );
   }
 }
 async function installCopilotPrompts(projectRoot, minimal) {
@@ -1912,6 +1969,7 @@ 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 = [
@@ -1920,64 +1978,114 @@ async function installCopilotPrompts(projectRoot, minimal) {
       `description: ${JSON.stringify(meta.description)}`,
       "---",
       "",
+      MODE_FILE_MANAGED_MARKER,
+      "",
       renderModeSkill(mode, ""),
       ""
     ].join("\n");
-    await writeFile4(
+    await writeManagedModeFile(
       path4.join(promptsDir, `${mode}.prompt.md`),
       content,
-      "utf-8"
+      mode,
+      "GitHub Copilot"
     );
   }
 }
 async function removeCodexSkills(projectRoot) {
-  await cleanCodexManagedSkills(path4.join(projectRoot, ".agents", "skills"));
-  await cleanCodexManagedSkills(path4.join(projectRoot, ".codex", "skills"));
+  if (!await platformNeedsSharedSkills(projectRoot, "zcode")) {
+    await cleanManagedSkills(
+      path4.join(projectRoot, ".agents", "skills"),
+      MANCODE_AGENT_SKILL_MARKERS
+    );
+  }
+  await cleanManagedSkills(path4.join(projectRoot, ".codex", "skills"), [
+    CODEX_SKILL_MANAGED_MARKER
+  ]);
 }
-async function cleanCodexManagedSkills(skillsDir) {
-  for (const mode of MODE_NAMES) {
+async function cleanManagedSkills(skillsDir, markers) {
+  for (const mode of [...MODE_NAMES, ...LEGACY_MODE_NAMES]) {
     const modeDir = path4.join(skillsDir, mode);
     const skillPath = path4.join(modeDir, "SKILL.md");
-    if (await isManagedSkillFile(skillPath, CODEX_SKILL_MANAGED_MARKER)) {
+    if (await isManagedByAnyMarker(skillPath, markers)) {
       await rm2(skillPath, { force: true });
-      await removeIfEmpty(modeDir);
+      await removeIfEmpty2(modeDir);
     }
   }
-  await removeIfEmpty(skillsDir);
+  await removeIfEmpty2(skillsDir);
 }
 async function removeZcodeSkills(projectRoot) {
-  await cleanZcodeManagedSkills(path4.join(projectRoot, ".agents", "skills"));
-  await cleanZcodeManagedSkills(path4.join(projectRoot, ".zcode", "skills"));
-}
-async function cleanZcodeManagedSkills(skillsDir) {
-  for (const mode of MODE_NAMES) {
-    const modeDir = path4.join(skillsDir, mode);
-    const skillPath = path4.join(modeDir, "SKILL.md");
-    if (await isManagedSkillFile(skillPath, ZCODE_SKILL_MANAGED_MARKER)) {
-      await rm2(skillPath, { force: true });
-      await removeIfEmpty(modeDir);
-    }
+  if (!await platformNeedsSharedSkills(projectRoot, "codex")) {
+    await cleanManagedSkills(
+      path4.join(projectRoot, ".agents", "skills"),
+      MANCODE_AGENT_SKILL_MARKERS
+    );
   }
-  await removeIfEmpty(skillsDir);
+  await cleanManagedSkills(path4.join(projectRoot, ".zcode", "skills"), [
+    ZCODE_SKILL_MANAGED_MARKER
+  ]);
 }
 async function removeCursorCommands(projectRoot) {
-  for (const mode of MODE_NAMES) {
-    await rm2(path4.join(projectRoot, ".cursor", "commands", `${mode}.md`), {
-      force: true
-    });
+  for (const mode of [...MODE_NAMES, ...LEGACY_MODE_NAMES]) {
+    const filePath = path4.join(
+      projectRoot,
+      ".cursor",
+      "commands",
+      `${mode}.md`
+    );
+    if (mode === "man8") await removeLegacyGeneratedModeFile(filePath);
+    else await removeManagedModeFile(filePath, mode);
   }
 }
 async function removeCopilotPrompts(projectRoot) {
-  for (const mode of MODE_NAMES) {
-    await rm2(
-      path4.join(projectRoot, ".github", "prompts", `${mode}.prompt.md`),
-      { force: true }
+  for (const mode of [...MODE_NAMES, ...LEGACY_MODE_NAMES]) {
+    const filePath = path4.join(
+      projectRoot,
+      ".github",
+      "prompts",
+      `${mode}.prompt.md`
     );
+    if (mode === "man8") await removeLegacyGeneratedModeFile(filePath);
+    else await removeManagedModeFile(filePath, mode);
   }
 }
-async function removeIfEmpty(dir) {
+async function writeManagedModeFile(filePath, content, mode, platformLabel) {
+  const existing = await readTextIfExists3(filePath);
+  if (existing !== null && !isGeneratedModeFile(existing, mode)) {
+    throw new Error(
+      `refusing to overwrite user-authored ${platformLabel} mode file: ${filePath}`
+    );
+  }
+  await writeFile4(filePath, content, "utf-8");
+}
+async function removeManagedModeFile(filePath, mode) {
+  const content = await readTextIfExists3(filePath);
+  if (content && isGeneratedModeFile(content, mode)) {
+    await rm2(filePath, { force: true });
+  }
+}
+async function removeLegacyGeneratedModeFile(filePath) {
+  const content = await readTextIfExists3(filePath);
+  if (content?.includes("# mancode man8 \u2014 Investigate and Plan") && content.includes("## Mode Persistence")) {
+    await rm2(filePath, { force: true });
+  }
+}
+function isGeneratedModeFile(content, mode) {
+  return content.includes(MODE_FILE_MANAGED_MARKER) || content.includes(`# mancode ${mode}`) && content.includes("## Mode Persistence");
+}
+async function removeLegacyManagedSkills(skillsDir, markers) {
+  for (const mode of LEGACY_MODE_NAMES) {
+    const modeDir = path4.join(skillsDir, mode);
+    const skillPath = path4.join(modeDir, "SKILL.md");
+    const content = await readTextIfExists3(skillPath);
+    if (content && markers.some((marker) => content.includes(marker))) {
+      await rm2(skillPath, { force: true });
+      await removeIfEmpty2(modeDir);
+    }
+  }
+}
+async function removeIfEmpty2(dir) {
   try {
-    const entries = await readdir(dir);
+    const entries = await readdir2(dir);
     if (entries.length === 0) {
       await rm2(dir, { recursive: true, force: true });
     }
@@ -1985,7 +2093,7 @@ async function removeIfEmpty(dir) {
   }
 }
 async function writeManagedSkill(skillPath, content, marker, platformLabel, recognizedMarkers = [marker]) {
-  const existing = await readTextIfExists2(skillPath);
+  const existing = await readTextIfExists3(skillPath);
   if (existing !== null && !recognizedMarkers.some((m) => existing.includes(m))) {
     throw new Error(
       `refusing to overwrite user-authored ${platformLabel} skill: ${skillPath}`
@@ -1993,70 +2101,109 @@ async function writeManagedSkill(skillPath, content, marker, platformLabel, reco
   }
   await writeFile4(skillPath, content, "utf-8");
 }
-async function isManagedSkillFile(skillPath, marker) {
-  const content = await readTextIfExists2(skillPath);
-  return content?.includes(marker) ?? false;
+async function isManagedByAnyMarker(skillPath, markers) {
+  const content = await readTextIfExists3(skillPath);
+  return content !== null && markers.some((marker) => content.includes(marker));
 }
-async function readTextIfExists2(filePath) {
+async function platformNeedsSharedSkills(projectRoot, platform) {
   try {
-    return await readFile3(filePath, "utf-8");
+    const raw = await readFile4(
+      path4.join(projectRoot, ".mancode", "config.json"),
+      "utf-8"
+    );
+    const config = JSON.parse(raw);
+    if (!Array.isArray(config.platforms) || !config.platforms.includes(platform)) {
+      return false;
+    }
+    if (!isRecord2(config.platformOptions)) return true;
+    const options = config.platformOptions[platform];
+    return !isRecord2(options) || options.minimal !== true;
+  } catch {
+    return false;
+  }
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function readTextIfExists3(filePath) {
+  try {
+    return await readFile4(filePath, "utf-8");
   } catch {
     return null;
   }
 }
 var MODE_META = {
-  man8: {
-    description: "Investigate first, then produce a plan before implementation. Use when the user asks for man8, planning, architecture, migration, integration, or risk assessment.",
-    intro: "# mancode man8 \u2014 Investigate and Plan",
+  mamba: {
+    description: "Diagnose bugs and validate real user flows with targeted regression checks.",
+    intro: "# mancode mamba \u2014 Diagnosis and Real Validation",
     workflow: [
-      "## Workflow (simulate in single conversation)",
+      "## Five-step workflow (simulate roles in one conversation)",
       "",
-      "This platform does not provide isolated subagents. Simulate the coaching",
-      "staff in sequence:",
+      'Use `mancode workflow create mamba "<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",
+      "`mancode workflow update` for every step and final state.",
+      "If state points to an unrelated active workflow, stop and ask the user to resume it or abandon it through mansolo; never overwrite its pointer.",
       "",
-      "1. **Scout**: Investigate the relevant code and summarize constraints,",
-      "   existing patterns, and dependencies.",
-      "2. **Head Coach**: Write a concrete implementation plan based on the",
-      "   Scout findings.",
-      "3. **Stop for user approval** before implementing. Do not write code",
-      "   until the user confirms.",
+      "1. Define the symptom, environment, expected/actual result, protected data, and success criteria; then run `mancode workflow update <taskId> --step 2`.",
+      "2. Prepare the safest available environment. Full capability may use a detected Web UI and Playwright; command-only capability produces a manual browser checklist; restricted capability records manual_test_required. When ready, update to Step 3.",
+      "   Starting local services and read-only probes is allowed. Dependency downloads, credentials, seed/reset, external login, messages, payments, deletion, and production writes require explicit approval.",
+      "   If environment, permission, or data is missing, set blocked with `--blocking-reason` and keep state resumable instead of advancing.",
+      "3. Reproduce the shortest path and write `diagnosis.md` with evidence, root cause or candidates, impact, and confidence; then update to Step 4.",
+      "4. Apply only the requested minimum fix, or make no code change when the user requested validation only. New architecture or cross-module scope returns to /man. Then update to Step 5.",
+      "5. Re-run the path and affected positive, negative, and permission boundaries; write `mamba-report.md` with environment, evidence, artifacts, regression scope, and risks.",
       "",
-      "After user approval, switch to solo mode (update state.json currentMode",
-      'to "solo") and implement the plan.'
+      "Finish through the CLI with exactly one result: completed+fixed, completed+verified, completed+no_repro, completed+manual_test_required, or blocked+blockingReason. Never claim real testing in restricted mode. Child blocked/manual_test_required propagation is handled by the CLI. After a child finishes with fixed/verified/no_repro, inspect its parent; if that parent is still blocked because of this child, run `mancode workflow update <parentTaskId> --status in_progress` before restoring parent state at Step 6. Never auto-resume manual_test_required."
     ].join("\n")
   },
   man: {
     description: "Full high-risk workflow with plan, implementation, verification, and review. Use when the user asks for man or a high-risk production change.",
     intro: "# mancode man \u2014 Full Review Workflow",
     workflow: [
-      "## Workflow (simulate in single conversation)",
+      "## Progressive nine-step workflow (simulate roles in one conversation)",
+      "",
+      'Create the durable workflow with `mancode workflow create man "<task>" --json`,',
+      "persist its taskId in `.mancode/state.json` as currentTask, set currentMode",
+      "and currentWorkflowMode to man, and use `mancode workflow update`",
+      "for every step/status/plan revision. Never edit metadata.json directly.",
+      "After each completed phase, advance through the CLI to the next numbered step;",
+      "never advance state merely because a report was requested or an agent was called.",
       "",
-      "This platform does not provide isolated subagents. Simulate the full",
-      "coaching staff workflow in sequence:",
+      "Step 1 \u2014 Scout: inspect the profile, existing implementation, dependencies, risks, and unknowns; write `scout-report.md`.",
+      "Step 2 \u2014 Clarify: ask at most two rounds; write answers, conservative defaults, and unresolved risks to `requirements.md`.",
+      "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.",
+      "Step 7 \u2014 Film #1 code-quality review; fix all required findings and explain suggested-item tradeoffs.",
+      "Step 8 \u2014 Film #2 security/boundary review; keep it independent from Film #1. The two review passes are skipped only on explicit user instruction and the residual risk is recorded.",
+      "Step 9 \u2014 Fix, re-verify, write `summary.md`, archive decisions, and set completed only when verification passes and required findings are zero; otherwise set blocked+blockingReason.",
       "",
-      "1. **Scout**: Investigate the codebase and summarize constraints.",
-      "2. **Head Coach**: Propose a concrete implementation plan.",
-      "3. **Wait for approval** when the task is high-risk.",
-      "4. **Implement** the plan and self-test.",
-      "5. **Film Analyst Offense**: Review readability, DRY, and YAGNI.",
-      "6. **Fix** review findings.",
-      "7. **Film Analyst Defense**: Review auth, injection, concurrency, and",
-      "   resource risks.",
-      "8. **Summarize** verification results and remaining risk."
+      "After planned/completed/abandoned, return state to solo. On blocked, preserve enough state to resume. A CLI rejection is a hard stop, never a reason to bypass metadata validation."
     ].join("\n")
   },
   manteam: {
     description: "Team-aware workflow with handoff-friendly summaries. Use when the user asks for manteam or when the task affects shared team context.",
     intro: "# mancode manteam \u2014 Team Workflow",
     workflow: [
-      "## Workflow",
+      "## Team workflow",
       "",
-      "1. Read `.mancode/memory/prd.md`, `.mancode/memory/spec.md`, and",
-      "   `.mancode/memory/decisions.md` when relevant.",
-      "2. Preserve decisions and leave handoff-friendly summaries.",
-      "3. Prefer Conventional Commit style when suggesting commits.",
-      "4. Simulate the coaching staff in sequence (same as man mode) but",
-      "   with extra emphasis on documentation and handoff clarity."
+      'Create with `mancode workflow create manteam "<task>" --json`; never edit',
+      "metadata.json directly. Persist its taskId as currentTask and set currentMode",
+      "and currentWorkflowMode to manteam. First collect branch, dirty-worktree, contributor,",
+      "shared-module, and handoff risks in `team-context.md`.",
+      "",
+      "Then execute every /man Step 1 through Step 9, including clarification,",
+      "plan gate, validation, two review passes, conditional completion, planVersion,",
+      "Active Plans, and linked mamba 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",
+      "`workflow update --status in_progress`; never auto-resume manual_test_required.",
+      "",
+      "Read `.mancode/memory/prd.md`, `spec.md`, and `decisions.md`; append durable",
+      "decisions only after confirmed implementation. Write `handoff.md`. Never",
+      "overwrite teammate changes or commit/merge/push without explicit approval."
     ].join("\n")
   },
   manps: {
@@ -2081,32 +2228,39 @@ var MODE_META = {
       "",
       "You are now in solo (default) mode.",
       "",
-      'Update `.mancode/state.json` and set `currentMode` to "solo".',
+      "If state points to an active workflow, show it with `mancode workflow show",
+      "<taskId> --json`, ask for confirmation, abandon active children before their",
+      "parent through `mancode workflow update ... --status abandoned`, and only",
+      "then update `.mancode/state.json` to solo. Never edit metadata.json directly.",
       "",
       "- Keep the diff narrow.",
       "- Reuse existing functions, components, styles, and dependencies.",
-      "- For UI work, read `.mancode/aesthetics/style-tokens.json`.",
+      "- Read project-profile first; for detected UI assets and UI work, read `.mancode/aesthetics/style-tokens.json`.",
       "- Verify with the narrowest meaningful test, lint, build, or smoke check."
     ].join("\n")
   }
 };
 
 // src/installers/shared-content.ts
-import { readFile as readFile4 } from "fs/promises";
+import { readFile as readFile5 } from "fs/promises";
 import path5 from "path";
 async function generateSharedContent(projectRoot, options) {
-  const [state, tokens] = await Promise.all([
+  const [state, tokens, profile] = await Promise.all([
     readJson(
       path5.join(projectRoot, ".mancode", "state.json")
     ),
     readJson(
       path5.join(projectRoot, ".mancode", "aesthetics", "style-tokens.json")
+    ),
+    readJson(
+      path5.join(projectRoot, ".mancode", "project-profile.json")
     )
   ]);
+  const currentProfile = options.projectProfile ?? profile;
   const sections = [
-    renderProjectContext(state, tokens, options),
+    renderProjectContext(state, tokens, profile, options),
     renderPracticeRules(),
-    renderAesthetics(tokens)
+    currentProfile?.uiAssets === "detected" ? renderAesthetics(tokens) : ""
   ];
   if (!options.minimal) {
     sections.push(renderModes(options), renderPlatformDowngrade(options));
@@ -2114,9 +2268,10 @@ async function generateSharedContent(projectRoot, options) {
   return `${sections.filter(Boolean).join("\n\n")}
 `;
 }
-function renderProjectContext(state, tokens, options) {
-  const techStack = state?.techStack || options.techStack.join(" + ") || "Unknown";
-  const uiLibrary = state?.uiLibrary || tokens?.uiLibrary || options.uiLibrary || "None";
+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";
   return [
     "## mancode Project Context",
@@ -2125,8 +2280,9 @@ function renderProjectContext(state, tokens, options) {
     `- Current mode: ${mode}`,
     `- Tech stack: ${techStack}`,
     `- UI library: ${uiLibrary}`,
+    `- Project profile: ${currentProfile?.projectKind || "unknown"}; validation: ${currentProfile?.availableValidation?.join(", ") || "inspect project"}`,
     "- At the start of each session, read `.mancode/state.json` to check the current mode and project context.",
-    "- For UI tasks, read `.mancode/aesthetics/style-tokens.json` for current design tokens."
+    "- Read `.mancode/project-profile.json` before choosing tools or validation. Only for a UI task in a profile with detected UI assets, read `.mancode/aesthetics/style-tokens.json`."
   ].join("\n");
 }
 function renderPracticeRules() {
@@ -2178,7 +2334,7 @@ function renderAesthetics(tokens) {
 function renderModes(options) {
   let commandLabel;
   if (options.capabilities.skills === "agents-skills") {
-    commandLabel = "Invoke mode skills with `$man8`, `$man`, `$manteam`, `$manps`, `$mansolo`.";
+    commandLabel = "Invoke mode skills with `$man`, `$mamba`, `$manteam`, `$manps`, `$mansolo`.";
   } else if (options.capabilities.slashCommands === "native") {
     commandLabel = "Use the named commands directly when available.";
   } else {
@@ -2188,8 +2344,8 @@ function renderModes(options) {
     "## mancode Modes",
     "",
     `- solo: default lightweight mode. ${commandLabel}`,
-    "- man8: investigate first, then produce a plan before implementation.",
-    "- man: full high-risk workflow with plan, implementation, verification, and review.",
+    "- man: progressive governance workflow with planning and optional full execution.",
+    "- mamba: 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."
@@ -2215,14 +2371,14 @@ function renderPlatformDowngrade(options) {
   }
   if (!options.capabilities.subagents) {
     lines.push(
-      "- Simulate the coaching staff in sequence inside the same conversation: Scout, Head Coach, Film Analyst Offense, Film Analyst Defense."
+      "- Simulate the coaching staff in sequence inside the same conversation: Scout, Plan Coach, Head Coach, Film Analyst Offense, Film Analyst Defense."
     );
   }
   return lines.join("\n");
 }
 async function readJson(filePath) {
   try {
-    return JSON.parse(await readFile4(filePath, "utf-8"));
+    return JSON.parse(await readFile5(filePath, "utf-8"));
   } catch {
     return null;
   }
@@ -2260,7 +2416,8 @@ async function installCodex(projectRoot, options) {
     },
     minimal: options.minimal,
     techStack: options.techStack,
-    uiLibrary: options.uiLibrary
+    uiLibrary: options.uiLibrary,
+    projectProfile: options.projectProfile
   });
   const block = [
     DEFAULT_MANCODE_START_MARKER,
@@ -2295,7 +2452,8 @@ async function installCopilot(projectRoot, options) {
     },
     minimal: true,
     techStack: options.techStack,
-    uiLibrary: options.uiLibrary
+    uiLibrary: options.uiLibrary,
+    projectProfile: options.projectProfile
   });
   const sections = [
     DEFAULT_MANCODE_START_MARKER,
@@ -2322,8 +2480,8 @@ function renderCopilotPromptConventions() {
     "",
     "GitHub Copilot does not provide native mancode slash commands, hooks, or isolated subagents. Treat these names as user prompt conventions:",
     "",
-    "- man8: investigate first and produce a plan before implementation.",
-    "- man: use a careful plan, implementation, verification, and review loop.",
+    "- man: use progressive research, planning, implementation, verification, and review.",
+    "- mamba: 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.",
@@ -2333,7 +2491,7 @@ function renderCopilotPromptConventions() {
 }
 
 // src/installers/cursor.ts
-import { mkdir as mkdir6, rm as rm3, writeFile as writeFile7 } from "fs/promises";
+import { mkdir as mkdir6, readFile as readFile6, rm as rm3, writeFile as writeFile7 } from "fs/promises";
 import path8 from "path";
 var MANCODE_CURSOR_CORE_RULE_FILES = [
   "mancode-context.mdc",
@@ -2341,11 +2499,12 @@ var MANCODE_CURSOR_CORE_RULE_FILES = [
   "mancode-solo.mdc"
 ];
 var MANCODE_CURSOR_ADVANCED_RULE_FILES = [
-  "mancode-man8.mdc",
+  "mancode-mamba.mdc",
   "mancode-man.mdc",
   "mancode-manteam.mdc",
   "mancode-manps.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,
   ...MANCODE_CURSOR_ADVANCED_RULE_FILES
@@ -2367,7 +2526,8 @@ async function installCursor(projectRoot, options) {
     // the mode-specific Cursor rules below.
     minimal: true,
     techStack: options.techStack,
-    uiLibrary: options.uiLibrary
+    uiLibrary: options.uiLibrary,
+    projectProfile: options.projectProfile
   });
   await writeRule(
     rulesDir,
@@ -2395,12 +2555,13 @@ async function installCursor(projectRoot, options) {
     await installCursorCommands(projectRoot, true);
     return;
   }
+  await removeLegacyCursorRules(projectRoot);
   await writeRule(
     rulesDir,
-    "mancode-man8.mdc",
-    "Use when the user invokes /man8 or asks for investigation and planning before implementation",
+    "mancode-mamba.mdc",
+    "Use for bug diagnosis and real regression testing",
     false,
-    renderMan8Rule()
+    renderMambaRule()
   );
   await writeRule(
     rulesDir,
@@ -2439,11 +2600,77 @@ async function writeRule(rulesDir, fileName, description, alwaysApply, body) {
 
 ${body.trim()}
 `;
-  await writeFile7(path8.join(rulesDir, fileName), content, "utf-8");
+  const rulePath = path8.join(rulesDir, fileName);
+  const existing = await readTextIfExists4(rulePath);
+  if (existing !== null && !isGeneratedCursorRule(existing, fileName)) {
+    throw new Error(
+      `refusing to overwrite user-authored Cursor rule: ${rulePath}`
+    );
+  }
+  await writeFile7(
+    rulePath,
+    content.replace("---\n\n", `---
+
+${CURSOR_RULE_MANAGED_MARKER}
+
+`),
+    "utf-8"
+  );
 }
 async function removeAdvancedRules(rulesDir) {
   for (const fileName of MANCODE_CURSOR_ADVANCED_RULE_FILES) {
-    await rm3(path8.join(rulesDir, fileName), { force: true });
+    await removeGeneratedCursorRule(rulesDir, fileName);
+  }
+  await removeLegacyCursorRules(path8.dirname(path8.dirname(rulesDir)));
+}
+async function removeCursorGeneratedRules(projectRoot) {
+  const rulesDir = path8.join(projectRoot, ".cursor", "rules");
+  for (const fileName of MANCODE_CURSOR_RULE_FILES) {
+    await removeGeneratedCursorRule(rulesDir, fileName);
+  }
+  await removeLegacyCursorRules(projectRoot);
+}
+async function removeLegacyCursorRules(projectRoot) {
+  const legacyPath = path8.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 {
+  }
+}
+async function removeGeneratedCursorRule(rulesDir, fileName) {
+  const rulePath = path8.join(rulesDir, fileName);
+  const content = await readTextIfExists4(rulePath);
+  if (content && isGeneratedCursorRule(content, fileName)) {
+    await rm3(rulePath, { force: true });
+  }
+}
+function isGeneratedCursorRule(content, fileName) {
+  if (content.includes(CURSOR_RULE_MANAGED_MARKER)) return true;
+  if (fileName === "mancode-context.mdc") {
+    return content.includes("# mancode Configuration") && content.includes("Platform adapter: Cursor");
+  }
+  if (fileName === "mancode-practice.mdc") {
+    return content.includes("# mancode Practice") && content.includes("YAGNI ladder");
+  }
+  if (fileName === "mancode-solo.mdc") {
+    return content.includes("# mancode solo") && content.includes("Use solo mode");
+  }
+  const mode = fileName.replace(/^mancode-/, "").replace(/\.mdc$/, "");
+  return content.includes(`# mancode ${mode} \u2014`) && content.includes("## Mode Persistence");
+}
+async function readTextIfExists4(filePath) {
+  try {
+    return await readFile6(filePath, "utf-8");
+  } catch {
+    return null;
   }
 }
 function renderPracticeRule() {
@@ -2470,12 +2697,12 @@ function renderSoloRule() {
     "",
     "- Keep the diff narrow.",
     "- Reuse existing functions, components, styles, and dependencies.",
-    "- For UI work, read `.mancode/aesthetics/style-tokens.json` and inspect existing components before inventing new styles.",
+    "- Read `.mancode/project-profile.json` before choosing tools or validation. For detected UI assets and UI work, read `.mancode/aesthetics/style-tokens.json` and inspect existing components before inventing new styles.",
     "- Verify with the narrowest meaningful test, lint, build, or smoke check."
   ].join("\n");
 }
-function renderMan8Rule() {
-  return renderModeSkill("man8", "/");
+function renderMambaRule() {
+  return renderModeSkill("mamba", "/");
 }
 function renderManRule() {
   return renderModeSkill("man", "/");
@@ -2507,7 +2734,8 @@ async function installZcode(projectRoot, options) {
     },
     minimal: options.minimal,
     techStack: options.techStack,
-    uiLibrary: options.uiLibrary
+    uiLibrary: options.uiLibrary,
+    projectProfile: options.projectProfile
   });
   const block = [
     ZCODE_MANCODE_START_MARKER,
@@ -2689,8 +2917,6 @@ async function checkRemote(cwd) {
 
 // src/system/detect.ts
 import { exec as exec2 } from "child_process";
-import { access as access2, readFile as readFile5 } from "fs/promises";
-import path11 from "path";
 import { promisify as promisify2 } from "util";
 var execAsync2 = promisify2(exec2);
 async function detectSystemDeps() {
@@ -2714,62 +2940,271 @@ async function detectSystemDeps() {
   ]);
   return { bash, git, jq, node };
 }
-async function detectProjectType(projectRoot) {
-  const pkgPath = path11.join(projectRoot, "package.json");
-  try {
-    await access2(pkgPath);
-  } catch (err) {
-    if (err.code === "ENOENT") {
-      return {
-        hasFrontend: false,
-        hasBackend: false,
-        techStack: [],
-        uiLibrary: null
-      };
+
+// src/system/project-profile.ts
+import { readFile as readFile7, readdir as readdir3, stat as stat2 } from "fs/promises";
+import path11 from "path";
+var PROJECT_MANIFESTS = [
+  "package.json",
+  "pyproject.toml",
+  "requirements.txt",
+  "go.mod",
+  "Cargo.toml",
+  "pom.xml",
+  "build.gradle",
+  "build.gradle.kts",
+  "Package.swift",
+  "pubspec.yaml"
+];
+async function detectProjectProfile(projectRoot) {
+  const entries = await readdir3(projectRoot).catch(() => []);
+  const manifests = PROJECT_MANIFESTS.filter((file) => entries.includes(file));
+  const sourceRoots = await existingDirs(projectRoot, [
+    "src",
+    "app",
+    "apps",
+    "packages",
+    "web",
+    "lib",
+    "Sources",
+    "cmd",
+    "server",
+    "backend",
+    "mobile",
+    "ios",
+    "android",
+    "data",
+    "notebooks"
+  ]);
+  const packageJson = await readJson2(path11.join(projectRoot, "package.json"));
+  const [pubspec, pythonManifests] = await Promise.all([
+    readText(path11.join(projectRoot, "pubspec.yaml")),
+    Promise.all([
+      readText(path11.join(projectRoot, "pyproject.toml")),
+      readText(path11.join(projectRoot, "requirements.txt"))
+    ]).then((parts) => parts.filter(Boolean).join("\n"))
+  ]);
+  const deps = Object.keys({
+    ...packageJson?.dependencies,
+    ...packageJson?.devDependencies,
+    ...packageJson?.peerDependencies
+  });
+  const flutter = isFlutterProject(pubspec);
+  const shadcn = entries.includes("components.json") || deps.some((dep) => dep.startsWith("@radix-ui/")) && await isDirectory(path11.join(projectRoot, "src", "components", "ui"));
+  const languages = inferLanguages(manifests, entries);
+  const frameworks = inferFrameworks(
+    deps,
+    manifests,
+    pythonManifests,
+    flutter,
+    shadcn
+  );
+  const uiAssets = hasUiAssets(deps, entries, flutter) ? "detected" : "none";
+  const projectKind = inferKind(
+    deps,
+    manifests,
+    entries,
+    packageJson,
+    uiAssets,
+    flutter,
+    pythonManifests
+  );
+  const availableValidation = inferValidation(
+    packageJson,
+    manifests,
+    entries,
+    flutter,
+    pythonManifests
+  );
+  return {
+    version: "1.0",
+    projectKind,
+    languages,
+    frameworks,
+    sourceRoots,
+    manifests,
+    availableValidation,
+    uiAssets,
+    browserAutomation: deps.some((dep) => dep.includes("playwright")) || entries.some((entry) => /^playwright\.config\./.test(entry)) ? "available" : projectKind === "web" || projectKind === "mixed" ? "unknown" : "unavailable",
+    confidence: projectKind === "unknown" ? "low" : manifests.length > 0 ? "high" : "medium"
+  };
+}
+async function existingDirs(root, candidates) {
+  const found = [];
+  for (const candidate of candidates) {
+    try {
+      if ((await stat2(path11.join(root, candidate))).isDirectory())
+        found.push(candidate);
+    } catch {
     }
-    throw err;
   }
-  const raw = await readFile5(pkgPath, "utf-8");
-  const pkg = JSON.parse(raw);
-  const allDeps = {
-    ...pkg.dependencies,
-    ...pkg.devDependencies,
-    ...pkg.peerDependencies
-  };
-  const deps = Object.keys(allDeps || {});
-  const hasFrontend = deps.some((d) => ["react", "vue", "svelte", "angular"].includes(d)) || deps.some((d) => d.startsWith("@angular/"));
-  const hasBackend = deps.some(
-    (d) => ["express", "koa", "fastify", "hapi", "next"].includes(d)
-  ) || deps.some((d) => d.startsWith("@nestjs/"));
-  const techStack = [];
-  if (deps.includes("react")) techStack.push("React");
-  if (deps.includes("vue")) techStack.push("Vue");
-  if (deps.includes("svelte")) techStack.push("Svelte");
-  if (deps.includes("typescript")) techStack.push("TypeScript");
-  if (deps.includes("tailwindcss")) techStack.push("Tailwind CSS");
-  let uiLibrary = null;
-  const hasRadix = deps.some((d) => d.startsWith("@radix-ui/"));
-  const uiDir = path11.join(projectRoot, "src", "components", "ui");
-  const hasUiDir = await pathExists2(uiDir);
-  if (hasRadix && hasUiDir) {
-    uiLibrary = "shadcn/ui";
-  } else if (deps.includes("@mui/material")) {
-    uiLibrary = "MUI";
-  } else if (deps.includes("antd")) {
-    uiLibrary = "Ant Design";
-  } else if (deps.includes("@headlessui/react")) {
-    uiLibrary = "headlessUI";
-  }
-  return { hasFrontend, hasBackend, techStack, uiLibrary };
+  return found;
 }
-async function pathExists2(p) {
+async function isDirectory(candidate) {
   try {
-    await access2(p);
-    return true;
+    return (await stat2(candidate)).isDirectory();
   } catch {
     return false;
   }
 }
+async function readJson2(file) {
+  try {
+    return JSON.parse(await readFile7(file, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+async function readText(file) {
+  try {
+    return await readFile7(file, "utf-8");
+  } catch {
+    return "";
+  }
+}
+function inferLanguages(manifests, entries) {
+  const languages = [];
+  if (manifests.includes("package.json"))
+    languages.push("JavaScript/TypeScript");
+  if (manifests.includes("pyproject.toml") || manifests.includes("requirements.txt"))
+    languages.push("Python");
+  if (manifests.includes("go.mod")) languages.push("Go");
+  if (manifests.includes("Cargo.toml")) languages.push("Rust");
+  if (manifests.includes("pom.xml") || manifests.includes("build.gradle") || manifests.includes("build.gradle.kts"))
+    languages.push("JVM");
+  if (manifests.includes("Package.swift")) languages.push("Swift");
+  if (manifests.includes("pubspec.yaml")) languages.push("Dart");
+  if (entries.includes("Dockerfile") && languages.length === 0)
+    languages.push("Containerized");
+  return languages;
+}
+function inferFrameworks(deps, manifests, pythonManifests, flutter, shadcn) {
+  const result = [];
+  for (const [dep, name] of [
+    ["react", "React"],
+    ["vue", "Vue"],
+    ["svelte", "Svelte"],
+    ["next", "Next.js"],
+    ["nuxt", "Nuxt"],
+    ["astro", "Astro"],
+    ["solid-js", "SolidJS"],
+    ["preact", "Preact"],
+    ["@angular/core", "Angular"],
+    ["express", "Express"],
+    ["fastify", "Fastify"],
+    ["electron", "Electron"],
+    ["@tauri-apps/api", "Tauri"],
+    ["tailwindcss", "Tailwind CSS"],
+    ["@mui/material", "MUI"],
+    ["antd", "Ant Design"],
+    ["@headlessui/react", "Headless UI"]
+  ]) {
+    if (deps.includes(dep)) result.push(name);
+  }
+  if (manifests.includes("go.mod")) result.push("Go modules");
+  if (manifests.includes("Cargo.toml")) result.push("Cargo");
+  if (flutter) result.push("Flutter");
+  if (shadcn) result.push("shadcn/ui");
+  else if (deps.some((dep) => dep.startsWith("@radix-ui/")))
+    result.push("Radix UI");
+  for (const [pattern, name] of [
+    [/\bdjango\b/i, "Django"],
+    [/\bfastapi\b/i, "FastAPI"],
+    [/\bflask\b/i, "Flask"]
+  ]) {
+    if (pattern.test(pythonManifests)) result.push(name);
+  }
+  return result;
+}
+function hasUiAssets(deps, entries, flutter) {
+  return deps.some(
+    (dep) => [
+      "react",
+      "vue",
+      "svelte",
+      "solid-js",
+      "preact",
+      "@angular/core",
+      "tailwindcss",
+      "@mui/material",
+      "antd",
+      "@headlessui/react",
+      "electron",
+      "@tauri-apps/api"
+    ].includes(dep) || dep.startsWith("@radix-ui/")
+  ) || entries.includes("index.html") || entries.some((entry) => /^tailwind\.config\./.test(entry)) || entries.includes("ios") || entries.includes("android") || flutter;
+}
+function primaryUiLibrary(profile) {
+  const preferred = [
+    "shadcn/ui",
+    "MUI",
+    "Ant Design",
+    "Headless UI",
+    "Radix UI",
+    "Tailwind CSS",
+    "Flutter"
+  ];
+  return preferred.find((name) => profile.frameworks.includes(name)) ?? null;
+}
+function inferKind(deps, manifests, entries, packageJson, uiAssets, flutter, pythonManifests) {
+  const hasBackendFramework = deps.includes("express") || deps.includes("fastify") || /\b(django|fastapi|flask)\b/i.test(pythonManifests);
+  const hasBackendLayout = entries.includes("server") || entries.includes("backend");
+  const hasPackageLibraryContract = manifests.includes("package.json") && ["main", "module", "exports", "types"].some(
+    (field) => Object.hasOwn(packageJson ?? {}, field)
+  );
+  const hasCliSignal = entries.includes("bin") || entries.includes("cmd") || typeof packageJson?.bin === "string" || typeof packageJson?.bin === "object" && packageJson.bin !== null;
+  const hasWebApplicationSignal = entries.some(
+    (entry) => ["app", "pages", "public", "web", "index.html"].includes(entry)
+  ) || deps.some((dep) => ["next", "nuxt", "astro"].includes(dep));
+  const hasNonWebManifest = manifests.some(
+    (manifest) => [
+      "pyproject.toml",
+      "requirements.txt",
+      "go.mod",
+      "Cargo.toml",
+      "pom.xml",
+      "build.gradle",
+      "build.gradle.kts"
+    ].includes(manifest)
+  );
+  if (entries.includes("ios") || entries.includes("android") || flutter)
+    return hasBackendFramework || hasBackendLayout ? "mixed" : "mobile";
+  if (deps.some((dep) => ["electron", "@tauri-apps/api"].includes(dep)))
+    return hasBackendFramework || hasBackendLayout ? "mixed" : "desktop";
+  if (hasCliSignal && !hasWebApplicationSignal)
+    return hasBackendFramework || hasBackendLayout ? "mixed" : "cli";
+  if (hasPackageLibraryContract && !hasWebApplicationSignal && !hasBackendFramework && !hasBackendLayout && !hasNonWebManifest)
+    return "library";
+  if (uiAssets === "detected")
+    return hasBackendFramework || hasBackendLayout || hasNonWebManifest ? "mixed" : "web";
+  if (entries.includes("data") || entries.includes("notebooks")) return "data";
+  if (hasPackageLibraryContract) return "library";
+  if (manifests.includes("pubspec.yaml") && entries.includes("lib"))
+    return "library";
+  if (hasBackendFramework || hasBackendLayout) return "backend";
+  if (manifests.filter((manifest) => manifest !== "requirements.txt").length > 1)
+    return "mixed";
+  return "unknown";
+}
+function inferValidation(pkg, manifests, entries, flutter, pythonManifests) {
+  const scripts = pkg?.scripts ?? {};
+  const packageRunner = entries.includes("pnpm-lock.yaml") ? "pnpm" : entries.includes("yarn.lock") ? "yarn" : entries.includes("bun.lock") || entries.includes("bun.lockb") ? "bun" : "npm";
+  return Array.from(
+    new Set(
+      ["build", "lint", "test", "typecheck"].filter((name) => typeof scripts[name] === "string").map((name) => `${packageRunner} run ${name}`).concat(
+        manifests.includes("go.mod") ? ["go test ./..."] : [],
+        manifests.includes("Cargo.toml") ? ["cargo test"] : [],
+        /\bpytest\b/i.test(pythonManifests) || entries.includes("pytest.ini") ? ["python -m pytest"] : [],
+        manifests.includes("pom.xml") ? [entries.includes("mvnw") ? "./mvnw test" : "mvn test"] : [],
+        manifests.includes("build.gradle") || manifests.includes("build.gradle.kts") ? [entries.includes("gradlew") ? "./gradlew test" : "gradle test"] : [],
+        manifests.includes("Package.swift") ? ["swift test"] : [],
+        manifests.includes("pubspec.yaml") ? [flutter ? "flutter test" : "dart test"] : []
+      )
+    )
+  );
+}
+function isFlutterProject(pubspec) {
+  return /(^|\n)\s*sdk\s*:\s*flutter\s*($|\n)/m.test(pubspec);
+}
 
 // src/system/scan-aesthetics.ts
 import { promises as fs } from "fs";
@@ -2787,7 +3222,8 @@ async function scanAesthetics(projectRoot, uiLibrary = null) {
   if (configResult) {
     sourceFiles.push(configResult.relPath);
     const content = await fs.readFile(configResult.absPath, "utf-8");
-    const themeBlock = findKeyBlock(content, "theme");
+    const inspectableContent = stripJsComments(content);
+    const themeBlock = findKeyBlock(inspectableContent, "theme");
     if (themeBlock) {
       const extendBlock = findKeyBlock(themeBlock, "extend");
       const searchBlock = extendBlock ?? themeBlock;
@@ -2800,15 +3236,15 @@ async function scanAesthetics(projectRoot, uiLibrary = null) {
         fonts = extractTopLevelArrayValues(fontsBlock);
       }
     }
-    darkMode = extractDarkMode(stripJsComments(content));
+    darkMode = extractDarkMode(inspectableContent);
   }
   let matchLevel = "none";
-  if (configResult) {
+  if (configResult || components.length > 0 || Object.keys(cssScan.variables).length > 0) {
     matchLevel = "high";
-  } else if (await hasTailwindDep(projectRoot)) {
+  } else if (await hasTailwindDep(projectRoot) || uiLibrary) {
     matchLevel = "low";
   }
-  if (uiLibrary) {
+  if (uiLibrary && await pathExists2(path12.join(projectRoot, "package.json"))) {
     sourceFiles.push("package.json");
   }
   sourceFiles.push(...cssScan.sourceFiles);
@@ -2834,7 +3270,7 @@ async function findTailwindConfig(projectRoot) {
   ];
   for (const name of candidates) {
     const absPath = path12.join(projectRoot, name);
-    if (await pathExists3(absPath)) {
+    if (await pathExists2(absPath)) {
       return { absPath, relPath: name };
     }
   }
@@ -3049,12 +3485,19 @@ function stripJsComments(content) {
   return result;
 }
 async function scanComponents(projectRoot) {
-  const roots = ["src/components", "components", "app/components"];
+  const roots = [
+    "src/components",
+    "components",
+    "app/components",
+    "lib/widgets",
+    "lib/screens",
+    "Sources"
+  ];
   const names = /* @__PURE__ */ new Set();
   let visitedFiles = 0;
   for (const relRoot of roots) {
     const absRoot = path12.join(projectRoot, relRoot);
-    if (!await pathExists3(absRoot)) continue;
+    if (!await pathExists2(absRoot)) continue;
     visitedFiles = await collectComponentNames(absRoot, names, 0, visitedFiles);
     if (visitedFiles >= MAX_COMPONENT_FILES) break;
   }
@@ -3085,10 +3528,14 @@ async function collectComponentNames(dir, names, depth, visitedFiles) {
       fileCount = await collectComponentNames(abs, names, depth + 1, fileCount);
       continue;
     }
-    if (!/\.(tsx|jsx|ts|js|vue|svelte)$/.test(entry)) continue;
+    if (!/\.(tsx|jsx|ts|js|vue|svelte|dart|swift|kt|kts)$/.test(entry))
+      continue;
     fileCount++;
     if (isNonComponentFile(entry)) continue;
-    let base = entry.replace(/\.(tsx|jsx|ts|js|vue|svelte)$/, "");
+    let base = entry.replace(
+      /\.(tsx|jsx|ts|js|vue|svelte|dart|swift|kt|kts)$/,
+      ""
+    );
     if (base === "index") {
       base = path12.basename(dir);
     }
@@ -3113,7 +3560,7 @@ async function scanCssVariables(projectRoot) {
   const sourceFiles = [];
   for (const relPath of candidates) {
     const absPath = path12.join(projectRoot, relPath);
-    if (!await pathExists3(absPath)) continue;
+    if (!await pathExists2(absPath)) continue;
     const content = await fs.readFile(absPath, "utf-8");
     const found = extractCssVariables(content);
     if (Object.keys(found).length === 0) continue;
@@ -3172,7 +3619,7 @@ async function hasTailwindDep(projectRoot) {
 function escapeRegex(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-async function pathExists3(p) {
+async function pathExists2(p) {
   try {
     await fs.access(p);
     return true;
@@ -3190,7 +3637,8 @@ var DEFAULT_INIT_PLATFORM = "claude-code";
 async function init(rootDir = process3.cwd(), options = {}) {
   const mancodeDir = path13.join(rootDir, ".mancode");
   const stateFile = path13.join(mancodeDir, "state.json");
-  const wasInitialized = await pathExists4(stateFile);
+  const wasInitialized = await pathExists3(stateFile);
+  let reinstallSnapshots = [];
   if (wasInitialized) {
     if (!options.force) {
       console.log("\u2139\uFE0F  mancode already initialized.");
@@ -3198,20 +3646,37 @@ async function init(rootDir = process3.cwd(), options = {}) {
       console.log("   Run `mancode init --force` to reinstall.");
       return EXIT_ALREADY_INITIALIZED;
     }
+    try {
+      reinstallSnapshots = await snapshotFiles([
+        stateFile,
+        path13.join(mancodeDir, "config.json"),
+        path13.join(mancodeDir, "project-profile.json"),
+        path13.join(mancodeDir, "aesthetics", "style-tokens.json")
+      ]);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error(`\u2717  Cannot snapshot existing mancode state: ${message}`);
+      return EXIT_INIT_FAILED;
+    }
     console.log("\u26A0\uFE0F  Reinstalling with --force...");
   }
-  if (!await pathExists4(rootDir)) {
+  if (!await pathExists3(rootDir)) {
     console.error(`\u2717  Target directory does not exist: ${rootDir}`);
     return EXIT_NOT_A_PROJECT_DIR;
   }
-  const isGitRepo = await pathExists4(path13.join(rootDir, ".git"));
-  const hasPackageJson = await pathExists4(path13.join(rootDir, "package.json"));
-  if (!isGitRepo && !hasPackageJson) {
+  const isGitRepo = await pathExists3(path13.join(rootDir, ".git"));
+  const hasManifest = await Promise.any(
+    PROJECT_MANIFESTS.map(async (name) => {
+      if (await pathExists3(path13.join(rootDir, name))) return true;
+      throw new Error("manifest missing");
+    })
+  ).catch(() => false);
+  if (!isGitRepo && !hasManifest) {
     console.error(`\u2717  Not a project directory: ${rootDir}`);
-    console.error("   (No .git or package.json found)");
+    console.error("   (No .git or recognized project manifest found)");
     console.error("");
     console.error(
-      "   Run mancode init in a git repository or Node.js project."
+      "   Run mancode init in a git repository or a recognized project directory."
     );
     return EXIT_NOT_A_PROJECT_DIR;
   }
@@ -3234,18 +3699,22 @@ async function init(rootDir = process3.cwd(), options = {}) {
       console.log("   bash \u2713 git \u2713 jq \u2713");
     }
     console.log("\u2713  \u68C0\u6D4B\u9879\u76EE\u7C7B\u578B...");
-    const project = await detectProjectType(rootDir);
-    const techStackStr = project.techStack.join(" + ") || "Unknown";
-    const uiLibraryStr = project.uiLibrary || "None";
-    if (project.techStack.length > 0) {
+    const profile = await detectProjectProfile(rootDir);
+    const profileStack = [...profile.languages, ...profile.frameworks];
+    const techStackStr = profileStack.join(" + ") || "Unknown";
+    const uiLibrary = primaryUiLibrary(profile);
+    const uiLibraryStr = uiLibrary || "None";
+    if (profileStack.length > 0) {
       console.log(`   ${techStackStr}`);
-      if (project.uiLibrary) {
+      if (uiLibrary) {
         console.log(`   UI: ${uiLibraryStr}`);
       }
-    } else if (hasPackageJson) {
-      console.log("   package.json found, no known framework dependencies");
+    } else if (hasManifest) {
+      console.log("   project manifest found, no known framework dependencies");
     } else {
-      console.log("   (No package.json found, skipping tech detection)");
+      console.log(
+        "   (No recognized manifest found, profile confidence is low)"
+      );
     }
     const initPlatformName = options.platform ?? DEFAULT_INIT_PLATFORM;
     const installer = getPlatformInstaller(initPlatformName);
@@ -3254,7 +3723,8 @@ async function init(rootDir = process3.cwd(), options = {}) {
       return EXIT_INIT_FAILED;
     }
     const team = await detectTeamStatus(rootDir);
-    const teamModeEnabled = options.team ?? team.isTeam;
+    const existingPreferences = wasInitialized ? await readExistingInitPreferences(mancodeDir) : {};
+    const teamModeEnabled = options.team ?? existingPreferences.forceTeamMode ?? team.isTeam;
     if (options.team === true) {
       console.log("   team: forced on (--team)");
     } else if (options.team === false) {
@@ -3286,18 +3756,28 @@ async function init(rootDir = process3.cwd(), options = {}) {
     const stateContent = `${JSON.stringify(state, null, 2)}
 `;
     await fs2.writeFile(stateFile, stateContent, "utf-8");
-    await updateConfigOptions(mancodeDir, {
-      forceTeamMode: options.team === true,
-      defaultStyle: options.style ?? null,
-      platforms: [installer.name],
-      platformOptions: {
-        [installer.name]: { minimal: false }
-      }
-    });
+    await fs2.writeFile(
+      path13.join(mancodeDir, "project-profile.json"),
+      `${JSON.stringify(profile, null, 2)}
+`,
+      "utf-8"
+    );
+    await updateConfigOptions(
+      mancodeDir,
+      {
+        forceTeamMode: options.team === void 0 && wasInitialized ? void 0 : options.team === true,
+        defaultStyle: options.style === void 0 && wasInitialized ? void 0 : options.style ?? null,
+        platforms: [installer.name],
+        platformOptions: {
+          [installer.name]: { minimal: false }
+        }
+      },
+      wasInitialized
+    );
     let styleLine = "  .mancode/aesthetics/        # style-tokens.json (\u7A7A)";
-    if (project.hasFrontend) {
+    if (profile.uiAssets === "detected") {
       console.log("\u2713  \u626B\u63CF\u5BA1\u7F8E token...");
-      const tokens = await scanAesthetics(rootDir, project.uiLibrary);
+      const tokens = await scanAesthetics(rootDir, uiLibrary);
       const tokensPath = path13.join(
         mancodeDir,
         "aesthetics",
@@ -3317,7 +3797,9 @@ async function init(rootDir = process3.cwd(), options = {}) {
         );
         styleLine = `  .mancode/aesthetics/        # style-tokens.json (${colorCount} colors)`;
       } else if (tokens.matchLevel === "low") {
-        console.log("   Tailwind detected, no config found (match: low)");
+        console.log(
+          "   UI assets detected, no reusable tokens found (match: low)"
+        );
         styleLine = "  .mancode/aesthetics/        # style-tokens.json (low match)";
       } else {
         console.log("   No design tokens found (match: none)");
@@ -3326,14 +3808,17 @@ async function init(rootDir = process3.cwd(), options = {}) {
     }
     console.log(`\u2713  \u5B89\u88C5 ${installer.displayName} \u9002\u914D...`);
     await installer.install(rootDir, {
-      techStack: project.techStack,
-      uiLibrary: project.uiLibrary
+      techStack: profileStack,
+      uiLibrary,
+      projectProfile: profile,
+      force: options.force
     });
     console.log("");
     console.log("\u2713  mancode initialized.");
     console.log("");
     console.log("Created:");
     console.log("  .mancode/state.json         # \u9879\u76EE\u72B6\u6001");
+    console.log("  .mancode/project-profile.json # \u68C0\u6D4B\u5230\u7684\u9879\u76EE\u4E8B\u5B9E");
     console.log("  .mancode/config.json        # \u914D\u7F6E");
     console.log(
       "  .mancode/hooks/             # SessionStart + UserPromptSubmit"
@@ -3349,28 +3834,90 @@ async function init(rootDir = process3.cwd(), options = {}) {
     }
     return EXIT_OK;
   } catch (err) {
-    if (!wasInitialized) {
+    if (wasInitialized) {
+      await restoreFiles(reinstallSnapshots);
+    } else {
       await fs2.rm(stateFile, { force: true });
+      await fs2.rm(path13.join(mancodeDir, "project-profile.json"), {
+        force: true
+      });
     }
     const msg = err instanceof Error ? err.message : String(err);
     console.error(`\u2717  mancode init failed: ${msg}`);
     return EXIT_INIT_FAILED;
   }
 }
-async function updateConfigOptions(mancodeDir, patch) {
+async function updateConfigOptions(mancodeDir, patch, preserveInstalledPlatforms) {
   const configPath = path13.join(mancodeDir, "config.json");
   let config = {};
   try {
     config = JSON.parse(await fs2.readFile(configPath, "utf-8"));
   } catch {
   }
+  const existingPlatforms = Array.isArray(config.platforms) ? config.platforms.filter(
+    (platform) => typeof platform === "string"
+  ) : [];
+  const existingPlatformOptions = isRecord3(config.platformOptions) ? config.platformOptions : {};
+  const definedPatch = Object.fromEntries(
+    Object.entries(patch).filter(([, value]) => value !== void 0)
+  );
+  const mergedPatch = preserveInstalledPlatforms ? {
+    ...definedPatch,
+    platforms: Array.from(
+      /* @__PURE__ */ new Set([...existingPlatforms, ...patch.platforms])
+    ),
+    platformOptions: {
+      ...existingPlatformOptions,
+      ...patch.platformOptions
+    }
+  } : definedPatch;
   await fs2.writeFile(
     configPath,
-    `${JSON.stringify({ ...config, ...patch }, null, 2)}
+    `${JSON.stringify({ ...config, ...mergedPatch }, null, 2)}
 `,
     "utf-8"
   );
 }
+async function readExistingInitPreferences(mancodeDir) {
+  try {
+    const config = JSON.parse(
+      await fs2.readFile(path13.join(mancodeDir, "config.json"), "utf-8")
+    );
+    return typeof config.forceTeamMode === "boolean" ? { forceTeamMode: config.forceTeamMode } : {};
+  } catch {
+    return {};
+  }
+}
+async function snapshotFiles(filePaths) {
+  return Promise.all(
+    filePaths.map(async (filePath) => {
+      try {
+        return { filePath, content: await fs2.readFile(filePath, "utf-8") };
+      } catch (error) {
+        if (isNodeError3(error) && error.code === "ENOENT") {
+          return { filePath, content: null };
+        }
+        throw error;
+      }
+    })
+  );
+}
+async function restoreFiles(snapshots) {
+  for (const snapshot of snapshots) {
+    if (snapshot.content === null) {
+      await fs2.rm(snapshot.filePath, { force: true });
+      continue;
+    }
+    await fs2.mkdir(path13.dirname(snapshot.filePath), { recursive: true });
+    await fs2.writeFile(snapshot.filePath, snapshot.content, "utf-8");
+  }
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNodeError3(error) {
+  return error instanceof Error && "code" in error;
+}
 function printPlatformCreatedFiles(platform) {
   if (platform === "claude-code") {
     console.log("  .claude/settings.json       # hook \u6CE8\u518C");
@@ -3393,7 +3940,7 @@ function printPlatformCreatedFiles(platform) {
   }
   console.log("  .github/copilot-instructions.md # Copilot instructions");
 }
-async function pathExists4(p) {
+async function pathExists3(p) {
   try {
     await fs2.access(p);
     return true;
@@ -3421,29 +3968,61 @@ async function checkPlatformStatus(rootDir, platform, installed) {
 }
 async function checkPlatformReadiness(rootDir, platform) {
   if (platform === "claude-code") {
-    const hasSoloSkill = await pathExists5(
-      path14.join(rootDir, ".claude", "skills", "solo", "SKILL.md")
-    );
-    const registered = await claudeHooksRegistered(rootDir);
-    const present = hasSoloSkill && registered;
+    const [hasSoloSkill, registered, hasHookFiles] = await Promise.all([
+      fileMatches(
+        path14.join(rootDir, ".claude", "skills", "solo", "SKILL.md"),
+        (content) => isGeneratedClaudeSkill(content, "solo")
+      ),
+      claudeHooksRegistered(rootDir),
+      pathsExist([
+        path14.join(rootDir, ".mancode", "hooks", "session-start.sh"),
+        path14.join(rootDir, ".mancode", "hooks", "user-prompt-submit.sh")
+      ])
+    ]);
+    const present = hasSoloSkill && registered && hasHookFiles;
+    const minimal = await isPlatformMinimal(rootDir, "claude-code");
+    const fullContentReady = minimal ? true : await claudeFullContentReady(rootDir);
     return {
       present,
-      ready: present,
+      ready: present && fullContentReady,
       target: ".claude/",
-      readyDetail: "skills and hooks registered"
+      readyDetail: present && fullContentReady ? minimal ? "solo skill and hooks ready" : "skills, agents, and hooks ready" : "skills, agents, hook files, or hook registration are incomplete"
     };
   }
   if (platform === "cursor") {
-    const present = await allPathsExist(
+    const hasCoreRules = await allManagedSkills(
       MANCODE_CURSOR_CORE_RULE_FILES.map(
         (file) => path14.join(rootDir, ".cursor", "rules", file)
-      )
+      ),
+      [CURSOR_RULE_MANAGED_MARKER]
     );
+    if (await isPlatformMinimal(rootDir, "cursor")) {
+      return {
+        present: hasCoreRules,
+        ready: hasCoreRules,
+        target: ".cursor/rules/",
+        readyDetail: "mancode core rules present"
+      };
+    }
+    const [hasRules, hasCommands] = await Promise.all([
+      allManagedSkills(
+        MANCODE_CURSOR_RULE_FILES.map(
+          (file) => path14.join(rootDir, ".cursor", "rules", file)
+        ),
+        [CURSOR_RULE_MANAGED_MARKER]
+      ),
+      allManagedSkills(
+        MODE_NAMES.map(
+          (mode) => path14.join(rootDir, ".cursor", "commands", `${mode}.md`)
+        ),
+        [MODE_FILE_MANAGED_MARKER]
+      )
+    ]);
     return {
-      present,
-      ready: present,
-      target: ".cursor/rules/",
-      readyDetail: "mancode rules present"
+      present: hasCoreRules,
+      ready: hasRules && hasCommands,
+      target: ".cursor/rules/ + .cursor/commands/",
+      readyDetail: hasRules && hasCommands ? "mancode rules and commands present" : "mode rules or commands are missing, incomplete, or user-authored"
     };
   }
   if (platform === "codex") {
@@ -3521,14 +4100,17 @@ async function checkPlatformReadiness(rootDir, platform) {
       readyDetail: "managed block missing"
     };
   }
-  const promptsDir = path14.join(rootDir, ".github", "prompts");
-  if (await pathExists5(promptsDir)) {
-    const hasPrompt = await pathExists5(path14.join(promptsDir, "man8.prompt.md"));
+  if (!await isPlatformMinimal(rootDir, "copilot")) {
+    const promptsDir = path14.join(rootDir, ".github", "prompts");
+    const hasPrompts = await allManagedSkills(
+      MODE_NAMES.map((mode) => path14.join(promptsDir, `${mode}.prompt.md`)),
+      [MODE_FILE_MANAGED_MARKER]
+    );
     return {
-      present: hasPrompt,
-      ready: hasPrompt,
+      present: true,
+      ready: hasPrompts,
       target: ".github/copilot-instructions.md + .github/prompts/",
-      readyDetail: hasPrompt ? "managed block and prompts present" : "prompts directory exists but man8 prompt missing"
+      readyDetail: hasPrompts ? "managed block and prompts present" : "mode prompts are missing, incomplete, or user-authored"
     };
   }
   return {
@@ -3545,16 +4127,38 @@ function describeStatus(installed, readiness) {
   }
   return "missing generated files or registration";
 }
-async function allPathsExist(paths) {
-  const results = await Promise.all(paths.map(pathExists5));
-  return results.every(Boolean);
-}
 async function allManagedSkills(paths, markers) {
   const results = await Promise.all(
     paths.map((filePath) => fileHasAnyMarker(filePath, markers))
   );
   return results.every(Boolean);
 }
+async function claudeFullContentReady(rootDir) {
+  const skillChecks = MVP2_SKILLS.map(
+    (skill) => fileMatches(
+      path14.join(rootDir, ".claude", "skills", skill.name, "SKILL.md"),
+      (content) => isGeneratedClaudeSkill(content, skill.name)
+    )
+  );
+  const agentChecks = ALL_AGENTS.map(
+    (agent) => fileMatches(
+      path14.join(rootDir, ".claude", "agents", `${agent.name}.md`),
+      (content) => isGeneratedClaudeAgent(content, agent.name)
+    )
+  );
+  const results = await Promise.all([...skillChecks, ...agentChecks]);
+  return results.every(Boolean);
+}
+async function fileMatches(filePath, predicate) {
+  try {
+    return predicate(await fs3.readFile(filePath, "utf-8"));
+  } catch {
+    return false;
+  }
+}
+async function pathsExist(paths) {
+  return (await Promise.all(paths.map(pathExists4))).every(Boolean);
+}
 async function fileHasAnyMarker(filePath, needles) {
   try {
     const content = await fs3.readFile(filePath, "utf-8");
@@ -3570,9 +4174,9 @@ async function isPlatformMinimal(rootDir, platform) {
       "utf-8"
     );
     const config = JSON.parse(raw);
-    if (!isRecord2(config.platformOptions)) return false;
+    if (!isRecord4(config.platformOptions)) return false;
     const options = config.platformOptions[platform];
-    return isRecord2(options) && options.minimal === true;
+    return isRecord4(options) && options.minimal === true;
   } catch {
     return false;
   }
@@ -3598,9 +4202,9 @@ async function claudeHooksRegistered(rootDir) {
   }
 }
 function hooksRegistered(settings) {
-  if (!isRecord2(settings)) return false;
+  if (!isRecord4(settings)) return false;
   const hooks = settings.hooks;
-  if (!isRecord2(hooks)) return false;
+  if (!isRecord4(hooks)) return false;
   return hasHookCommand(hooks.SessionStart, ".mancode/hooks/session-start.sh") && hasHookCommand(
     hooks.UserPromptSubmit,
     ".mancode/hooks/user-prompt-submit.sh"
@@ -3609,14 +4213,14 @@ function hooksRegistered(settings) {
 function hasHookCommand(value, needle) {
   if (!Array.isArray(value)) return false;
   return value.some((group) => {
-    if (!isRecord2(group) || !Array.isArray(group.hooks)) return false;
+    if (!isRecord4(group) || !Array.isArray(group.hooks)) return false;
     return group.hooks.some((hook) => {
-      if (!isRecord2(hook) || typeof hook.command !== "string") return false;
+      if (!isRecord4(hook) || typeof hook.command !== "string") return false;
       return hook.command.includes(needle);
     });
   });
 }
-async function pathExists5(p) {
+async function pathExists4(p) {
   try {
     await fs3.access(p);
     return true;
@@ -3624,7 +4228,7 @@ async function pathExists5(p) {
     return false;
   }
 }
-function isRecord2(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null;
 }
 
@@ -3635,7 +4239,7 @@ var EXIT_UNSUPPORTED_PLATFORM = 2;
 var EXIT_INSTALL_FAILED = 3;
 async function install(rootDir = process4.cwd(), platform = "claude-code", options = {}) {
   const stateFile = path15.join(rootDir, ".mancode", "state.json");
-  if (!await pathExists6(stateFile)) {
+  if (!await pathExists5(stateFile)) {
     console.error("\u2717  mancode not initialized.");
     console.error("   Run `mancode init` first.");
     return EXIT_NOT_INITIALIZED;
@@ -3662,6 +4266,11 @@ async function install(rootDir = process4.cwd(), platform = "claude-code", optio
     await readStatePlatform(rootDir)
   );
   const alreadyInstalled = configResult.valid && config.platforms && Array.isArray(config.platforms) ? config.platforms.includes(platform) : false;
+  const configuredMinimal = readConfiguredMinimal(
+    config.platformOptions,
+    platform
+  );
+  const effectiveMinimal = options.minimal === true || !options.force && alreadyInstalled && configuredMinimal;
   if (alreadyInstalled && !options.force) {
     const status2 = await checkPlatformStatus(rootDir, platform, true);
     if (status2.ready) {
@@ -3683,12 +4292,13 @@ async function install(rootDir = process4.cwd(), platform = "claude-code", optio
     }
   }
   console.log(`\u2713  Installing ${formatPlatformName(platform)} adapter...`);
-  const project = await detectProjectType(rootDir);
+  const profile = await detectProjectProfile(rootDir);
   try {
     await installer.install(rootDir, {
-      techStack: project.techStack,
-      uiLibrary: project.uiLibrary,
-      minimal: options.minimal,
+      techStack: [...profile.languages, ...profile.frameworks],
+      uiLibrary: primaryUiLibrary(profile),
+      projectProfile: profile,
+      minimal: effectiveMinimal,
       force: options.force
     });
   } catch (err) {
@@ -3705,11 +4315,10 @@ async function install(rootDir = process4.cwd(), platform = "claude-code", optio
   await updateConfig(rootDir, {
     ...config,
     platforms,
-    platformOptions: updatePlatformOptions(
-      config.platformOptions,
-      platform,
-      options
-    )
+    platformOptions: updatePlatformOptions(config.platformOptions, platform, {
+      ...options,
+      minimal: effectiveMinimal
+    })
   });
   console.log(`\u2713  ${formatPlatformName(platform)} adapter installed.`);
   return EXIT_OK2;
@@ -3720,13 +4329,13 @@ async function readConfig(rootDir) {
     const raw = await fs4.readFile(configPath, "utf-8");
     return { config: JSON.parse(raw), valid: true };
   } catch (err) {
-    if (isNodeError3(err) && err.code === "ENOENT") {
+    if (isNodeError4(err) && err.code === "ENOENT") {
       return { config: {}, valid: false };
     }
     throw err;
   }
 }
-function isNodeError3(err) {
+function isNodeError4(err) {
   return err instanceof Error && "code" in err;
 }
 async function updateConfig(rootDir, config) {
@@ -3745,19 +4354,24 @@ function withDefaultConfig(config, fallbackPlatform) {
   return {
     ...merged,
     platforms,
-    hooks: isRecord3(config.hooks) ? config.hooks : DEFAULT_CONFIG.hooks,
-    logging: isRecord3(config.logging) ? config.logging : DEFAULT_CONFIG.logging
+    hooks: isRecord5(config.hooks) ? config.hooks : DEFAULT_CONFIG.hooks,
+    logging: isRecord5(config.logging) ? config.logging : DEFAULT_CONFIG.logging
   };
 }
 function updatePlatformOptions(value, platform, options) {
-  const platformOptions = isRecord3(value) ? { ...value } : {};
+  const platformOptions = isRecord5(value) ? { ...value } : {};
   const existing = platformOptions[platform];
   platformOptions[platform] = {
-    ...isRecord3(existing) ? existing : {},
+    ...isRecord5(existing) ? existing : {},
     minimal: options.minimal === true
   };
   return platformOptions;
 }
+function readConfiguredMinimal(value, platform) {
+  if (!isRecord5(value)) return false;
+  const platformOptions = value[platform];
+  return isRecord5(platformOptions) && platformOptions.minimal === true;
+}
 async function readStatePlatform(rootDir) {
   try {
     const raw = await fs4.readFile(
@@ -3770,7 +4384,7 @@ async function readStatePlatform(rootDir) {
     return null;
   }
 }
-async function pathExists6(p) {
+async function pathExists5(p) {
   try {
     await fs4.access(p);
     return true;
@@ -3778,7 +4392,7 @@ async function pathExists6(p) {
     return false;
   }
 }
-function isRecord3(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -3825,7 +4439,7 @@ function describePlatform(platform) {
 }
 
 // src/commands/manps.ts
-import { access as access4 } from "fs/promises";
+import { access as access3 } from "fs/promises";
 import path18 from "path";
 import { createInterface } from "readline/promises";
 
@@ -3834,11 +4448,11 @@ import { execFile } from "child_process";
 import { createHash } from "crypto";
 import { existsSync, readFileSync } from "fs";
 import {
-  access as access3,
+  access as access2,
   lstat,
   mkdir as mkdir7,
-  readFile as readFile6,
-  readdir as readdir2,
+  readFile as readFile8,
+  readdir as readdir4,
   rename,
   writeFile as writeFile9
 } from "fs/promises";
@@ -4109,7 +4723,7 @@ async function walk(root, current, results, depth) {
   if (depth > MAX_SCAN_DEPTH || results.length >= MAX_PROJECT_FILES) return;
   let entries;
   try {
-    entries = await readdir2(current);
+    entries = await readdir4(current);
   } catch {
     return;
   }
@@ -4134,7 +4748,7 @@ async function walk(root, current, results, depth) {
 }
 async function readPackageJson(projectRoot) {
   try {
-    const raw = await readFile6(path17.join(projectRoot, "package.json"), "utf-8");
+    const raw = await readFile8(path17.join(projectRoot, "package.json"), "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -4377,7 +4991,7 @@ async function hasDependencyCruiserConfig(projectRoot) {
     "dependency-cruiser.config.mjs"
   ];
   const results = await Promise.all(
-    files.map((file) => pathExists7(path17.join(projectRoot, file)))
+    files.map((file) => pathExists6(path17.join(projectRoot, file)))
   );
   return results.some(Boolean);
 }
@@ -4445,15 +5059,15 @@ function parseDepcruiseJson(output) {
   }
 }
 function extractDepcruiseViolations(value) {
-  if (!isRecord4(value)) return [];
-  const rawViolations = Array.isArray(value.violations) ? value.violations : isRecord4(value.summary) && Array.isArray(value.summary.violations) ? value.summary.violations : [];
+  if (!isRecord6(value)) return [];
+  const rawViolations = Array.isArray(value.violations) ? value.violations : isRecord6(value.summary) && Array.isArray(value.summary.violations) ? value.summary.violations : [];
   return rawViolations.map((violation) => normalizeDepcruiseViolation(violation)).filter(
     (violation) => violation !== null
   );
 }
 function normalizeDepcruiseViolation(value) {
-  if (!isRecord4(value)) return null;
-  const rule = isRecord4(value.rule) ? value.rule : {};
+  if (!isRecord6(value)) return null;
+  const rule = isRecord6(value.rule) ? value.rule : {};
   const from = typeof value.from === "string" ? value.from : "";
   const to = typeof value.to === "string" ? value.to : void 0;
   const ruleName = typeof rule.name === "string" ? rule.name : typeof value.name === "string" ? value.name : "unnamed-rule";
@@ -4527,9 +5141,9 @@ async function buildIssueDatabase(projectRoot, report) {
 async function readIssueDatabase(issueDbPath) {
   let raw;
   try {
-    raw = await readFile6(issueDbPath, "utf-8");
+    raw = await readFile8(issueDbPath, "utf-8");
   } catch (err) {
-    if (isNodeError4(err) && err.code === "ENOENT") {
+    if (isNodeError5(err) && err.code === "ENOENT") {
       return emptyIssueDatabase();
     }
     throw err;
@@ -4643,7 +5257,7 @@ async function addPackageScript(projectRoot, scriptName, script) {
   const packagePath = path17.join(projectRoot, "package.json");
   let pkg;
   try {
-    pkg = JSON.parse(await readFile6(packagePath, "utf-8"));
+    pkg = JSON.parse(await readFile8(packagePath, "utf-8"));
   } catch {
     return false;
   }
@@ -4732,18 +5346,18 @@ function readFileSyncSafe(file) {
 function pathExistsSync(file) {
   return existsSync(file);
 }
-async function pathExists7(file) {
+async function pathExists6(file) {
   try {
-    await access3(file);
+    await access2(file);
     return true;
   } catch {
     return false;
   }
 }
-function isNodeError4(err) {
+function isNodeError5(err) {
   return err instanceof Error && "code" in err;
 }
-function isRecord4(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null;
 }
 
@@ -4753,7 +5367,7 @@ var EXIT_NOT_INITIALIZED2 = 1;
 var EXIT_SCAN_FAILED = 2;
 var EXIT_INVALID_ARG = 3;
 async function manps(rootDir, area = "all", options = {}) {
-  if (!await pathExists8(path18.join(rootDir, ".mancode", "state.json"))) {
+  if (!await pathExists7(path18.join(rootDir, ".mancode", "state.json"))) {
     if (options.json) {
       console.log(JSON.stringify({ error: "not initialized" }, null, 2));
     } else {
@@ -4895,9 +5509,9 @@ async function readStdinLines() {
   }
   return Buffer.concat(chunks).toString("utf-8").split(/\r?\n/).filter((line) => line.length > 0);
 }
-async function pathExists8(p) {
+async function pathExists7(p) {
   try {
-    await access4(p);
+    await access3(p);
     return true;
   } catch {
     return false;
@@ -4912,18 +5526,35 @@ var EXIT_OK5 = 0;
 var EXIT_NOT_INITIALIZED3 = 1;
 async function refreshStyle(rootDir = process6.cwd()) {
   const stateFile = path19.join(rootDir, ".mancode", "state.json");
-  if (!await pathExists9(stateFile)) {
+  if (!await pathExists8(stateFile)) {
     console.error("\u2717  mancode not initialized.");
     console.error("   Run `mancode init` first.");
     return EXIT_NOT_INITIALIZED3;
   }
-  const project = await detectProjectType(rootDir);
-  if (!project.hasFrontend) {
-    console.log("\u2139\uFE0F  No frontend framework detected. Nothing to scan.");
+  console.log("\u2713  \u5237\u65B0\u9879\u76EE profile...");
+  const profile = await detectProjectProfile(rootDir);
+  const profilePath = path19.join(rootDir, ".mancode", "project-profile.json");
+  await fs6.writeFile(
+    profilePath,
+    `${JSON.stringify(profile, null, 2)}
+`,
+    "utf-8"
+  );
+  const uiLibraryHint = primaryUiLibrary(profile);
+  await refreshLegacyStateContext(rootDir, profile, uiLibraryHint);
+  console.log(
+    `   \u7C7B\u578B: ${profile.projectKind} | UI: ${profile.uiAssets} | \u6D4F\u89C8\u5668: ${profile.browserAutomation}`
+  );
+  if (profile.uiAssets !== "detected") {
+    console.log(
+      "\u2139\uFE0F  No UI assets detected in project profile. Skipping style scan."
+    );
+    console.log("   Updated .mancode/project-profile.json.");
+    await printStaticPlatformRefreshHint(rootDir);
     return EXIT_OK5;
   }
   console.log("\u2713  \u626B\u63CF\u9879\u76EE\u8BBE\u8BA1 token...");
-  const tokens = await scanAesthetics(rootDir, project.uiLibrary);
+  const tokens = await scanAesthetics(rootDir, uiLibraryHint);
   const tokensPath = path19.join(
     rootDir,
     ".mancode",
@@ -4940,7 +5571,9 @@ async function refreshStyle(rootDir = process6.cwd()) {
   console.log("");
   if (tokens.matchLevel === "none") {
     console.log("\u672A\u68C0\u6D4B\u5230\u8BBE\u8BA1 token\u3002");
-    console.log("  \u5EFA\u8BAE\uFF1A\u6DFB\u52A0 tailwind.config.js \u6216\u624B\u52A8\u7F16\u8F91 style-tokens.json");
+    console.log(
+      "  \u5EFA\u8BAE\uFF1A\u68C0\u67E5\u9879\u76EE\u73B0\u6709\u4E3B\u9898\u3001\u7EC4\u4EF6\u6216 token \u6587\u4EF6\uFF0C\u5FC5\u8981\u65F6\u624B\u52A8\u7EF4\u62A4 style-tokens.json"
+    );
   } else {
     if (tokens.sourceFiles.length > 0) {
       console.log("\u626B\u63CF\u6765\u6E90\uFF1A");
@@ -4973,7 +5606,9 @@ async function refreshStyle(rootDir = process6.cwd()) {
     console.log(`  \u5339\u914D\u5EA6:   ${tokens.matchLevel}`);
   }
   console.log("");
-  console.log("\u5DF2\u66F4\u65B0 .mancode/aesthetics/style-tokens.json");
+  console.log(
+    "\u5DF2\u66F4\u65B0 .mancode/project-profile.json \u548C .mancode/aesthetics/style-tokens.json"
+  );
   await printStaticPlatformRefreshHint(rootDir);
   return EXIT_OK5;
 }
@@ -4991,6 +5626,28 @@ async function printStaticPlatformRefreshHint(rootDir) {
     "   Run `mancode install <platform> --force` to refresh their embedded style summaries."
   );
 }
+async function refreshLegacyStateContext(rootDir, profile, uiLibrary) {
+  const statePath = path19.join(rootDir, ".mancode", "state.json");
+  try {
+    const state = JSON.parse(await fs6.readFile(statePath, "utf-8"));
+    const stack = [...profile.languages, ...profile.frameworks];
+    await fs6.writeFile(
+      statePath,
+      `${JSON.stringify(
+        {
+          ...state,
+          techStack: stack.join(" + ") || profile.projectKind,
+          uiLibrary: uiLibrary ?? "None"
+        },
+        null,
+        2
+      )}
+`,
+      "utf-8"
+    );
+  } catch {
+  }
+}
 async function readInstalledPlatforms2(rootDir) {
   try {
     const raw = await fs6.readFile(
@@ -5005,7 +5662,7 @@ async function readInstalledPlatforms2(rootDir) {
     return [];
   }
 }
-async function pathExists9(p) {
+async function pathExists8(p) {
   try {
     await fs6.access(p);
     return true;
@@ -5023,10 +5680,10 @@ import process7 from "process";
 // src/system/workflow.ts
 import {
   mkdir as mkdir8,
-  readFile as readFile7,
-  readdir as readdir3,
+  readFile as readFile9,
+  readdir as readdir5,
   rm as rm4,
-  stat as stat2,
+  stat as stat3,
   writeFile as writeFile10
 } from "fs/promises";
 import path20 from "path";
@@ -5045,7 +5702,8 @@ function generateTaskId(task, now = /* @__PURE__ */ new Date()) {
 function slugify(text) {
   return text.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
-async function createWorkflow(projectRoot, task, mode) {
+async function createWorkflow(projectRoot, task, mode, options = {}) {
+  await validateParentTask(projectRoot, mode, options.parentTaskId, true);
   await mkdir8(workflowsRoot(projectRoot), { recursive: true });
   const taskId = await allocateTaskId(projectRoot, generateTaskId(task));
   const dir = workflowDir(projectRoot, taskId);
@@ -5058,7 +5716,9 @@ async function createWorkflow(projectRoot, task, mode) {
     skippedSteps: [],
     startedAt: now,
     updatedAt: now,
-    status: "in_progress"
+    status: "in_progress",
+    ...options.parentTaskId ? { parentTaskId: options.parentTaskId } : {},
+    ...mode === "man" || mode === "manteam" ? { planVersion: 1 } : {}
   };
   await writeMetadata(dir, meta);
   return meta;
@@ -5070,7 +5730,7 @@ async function allocateTaskId(projectRoot, baseTaskId) {
       await mkdir8(workflowDir(projectRoot, taskId));
       return taskId;
     } catch (err) {
-      if (isNodeError5(err) && err.code === "EEXIST") {
+      if (isNodeError6(err) && err.code === "EEXIST") {
         continue;
       }
       throw err;
@@ -5082,7 +5742,7 @@ async function readWorkflow(projectRoot, taskId) {
   if (!isValidWorkflowTaskId(taskId)) return null;
   const file = metadataPath(projectRoot, taskId);
   try {
-    const raw = await readFile7(file, "utf-8");
+    const raw = await readFile9(file, "utf-8");
     return parseWorkflowMeta(raw, taskId);
   } catch {
     return null;
@@ -5101,13 +5761,24 @@ async function updateWorkflow(projectRoot, taskId, patch) {
     startedAt: existing.startedAt,
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
+  const explicitlyPatchedBlockingReason = Object.hasOwn(
+    patch,
+    "blockingReason"
+  );
+  if (updated.status !== "blocked" && !explicitlyPatchedBlockingReason) {
+    updated.blockingReason = void 0;
+  }
+  await validateWorkflowMeta(projectRoot, updated, existing);
   await writeMetadata(workflowDir(projectRoot, taskId), updated);
+  if (updated.parentTaskId) {
+    await propagateChildStatus(projectRoot, updated);
+  }
 }
 async function listWorkflows(projectRoot) {
   const root = workflowsRoot(projectRoot);
   let entries;
   try {
-    entries = await readdir3(root);
+    entries = await readdir5(root);
   } catch {
     return [];
   }
@@ -5123,10 +5794,14 @@ async function deleteWorkflow(projectRoot, taskId) {
   if (!isValidWorkflowTaskId(taskId)) return false;
   const dir = workflowDir(projectRoot, taskId);
   try {
-    await stat2(dir);
+    await stat3(dir);
   } catch {
     return false;
   }
+  const existing = await readWorkflow(projectRoot, taskId);
+  if (existing && (existing.mode === "man" || existing.mode === "manteam") && (await listMambaChildren(projectRoot, taskId)).length > 0) {
+    return false;
+  }
   await rm4(dir, { recursive: true, force: true });
   return true;
 }
@@ -5148,7 +5823,7 @@ async function writeMetadata(dir, meta) {
 function parseWorkflowMeta(raw, taskId) {
   try {
     const obj = JSON.parse(raw);
-    if (typeof obj.task !== "string" || typeof obj.mode !== "string" || typeof obj.currentStep !== "number" || !Array.isArray(obj.skippedSteps) || typeof obj.startedAt !== "string" || typeof obj.updatedAt !== "string" || typeof obj.status !== "string") {
+    if (typeof obj.task !== "string" || !isWorkflowMode(obj.mode) || typeof obj.currentStep !== "number" || !Array.isArray(obj.skippedSteps) || typeof obj.startedAt !== "string" || typeof obj.updatedAt !== "string" || !isWorkflowStatus(obj.status) || !isWorkflowShape(obj)) {
       return null;
     }
     return { ...obj, taskId };
@@ -5156,7 +5831,182 @@ function parseWorkflowMeta(raw, taskId) {
     return null;
   }
 }
-function isNodeError5(err) {
+function maxWorkflowStep(mode) {
+  return mode === "mamba" ? 5 : 9;
+}
+function isWorkflowMode(value) {
+  return value === "man" || value === "mamba" || value === "manteam";
+}
+function isWorkflowStatus(value) {
+  return value === "in_progress" || value === "planned" || value === "completed" || value === "blocked" || value === "abandoned";
+}
+function isWorkflowOutcome(value) {
+  return value === "fixed" || value === "verified" || value === "no_repro" || value === "manual_test_required";
+}
+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");
+  }
+  const parent = await readWorkflow(projectRoot, parentTaskId);
+  if (!parent || parent.mode !== "man" && parent.mode !== "manteam") {
+    throw new Error(`invalid parent workflow: ${parentTaskId}`);
+  }
+  if (parent.status !== "in_progress" && parent.status !== "blocked" || requireStepSix && (parent.status !== "in_progress" || parent.currentStep !== 6)) {
+    throw new Error(
+      `parent workflow must be in_progress at step 6: ${parentTaskId}`
+    );
+  }
+}
+async function validateWorkflowMeta(projectRoot, updated, existing) {
+  if (updated.mode !== existing.mode) {
+    throw new Error("workflow mode cannot be changed");
+  }
+  if (updated.task !== existing.task) {
+    throw new Error("workflow task cannot be changed");
+  }
+  if (updated.parentTaskId !== existing.parentTaskId) {
+    throw new Error("workflow parent task cannot be changed");
+  }
+  if (!Number.isInteger(updated.currentStep) || updated.currentStep < 1 || updated.currentStep > maxWorkflowStep(updated.mode)) {
+    throw new Error(`invalid workflow step: ${updated.currentStep}`);
+  }
+  if (!isWorkflowStatus(updated.status)) {
+    throw new Error(`invalid workflow status: ${String(updated.status)}`);
+  }
+  if (!Array.isArray(updated.skippedSteps) || updated.skippedSteps.some((step) => typeof step !== "string")) {
+    throw new Error("workflow skipped steps must be strings");
+  }
+  if (!canTransition(existing.status, updated.status)) {
+    throw new Error(
+      `invalid workflow status transition: ${existing.status} -> ${updated.status}`
+    );
+  }
+  if (updated.status === "planned" && updated.mode === "mamba") {
+    throw new Error("mamba 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)}`
+    );
+  }
+  if (updated.blockingReason !== void 0 && typeof updated.blockingReason !== "string") {
+    throw new Error("workflow blocking reason must be a string");
+  }
+  if (updated.status === "blocked") {
+    if (!updated.blockingReason?.trim()) {
+      throw new Error("blocked workflows require a blocking reason");
+    }
+  } else if (updated.blockingReason !== void 0) {
+    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");
+  }
+  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");
+  }
+  if (updated.mode === "mamba" && updated.status === "completed" && !updated.outcome) {
+    throw new Error("completed mamba workflows require an outcome");
+  }
+  if (updated.mode === "mamba" && updated.planVersion !== void 0) {
+    throw new Error("mamba workflows cannot have a plan version");
+  }
+  if (updated.planVersion !== void 0 && (!Number.isInteger(updated.planVersion) || updated.planVersion < 1)) {
+    throw new Error("workflow plan version must be a positive integer");
+  }
+  if (updated.planVersion !== existing.planVersion && updated.planVersion !== void 0 && updated.planVersion !== (existing.planVersion ?? 1) + 1) {
+    throw new Error("workflow plan version must increase exactly once");
+  }
+  if (updated.planVersion !== existing.planVersion && updated.currentStep !== 4) {
+    throw new Error("workflow plan version can only change at step 4");
+  }
+  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");
+  }
+}
+function canTransition(from, to) {
+  if (from === to) return true;
+  if (from === "in_progress") return true;
+  if (from === "planned" || from === "blocked") {
+    return to === "in_progress" || to === "abandoned";
+  }
+  return false;
+}
+function isTerminalWorkflowStatus(status2) {
+  return status2 === "completed" || status2 === "abandoned";
+}
+function isWorkflowShape(obj) {
+  const { currentStep, mode, status: status2 } = obj;
+  if (!Number.isInteger(currentStep) || !mode || currentStep === void 0 || currentStep < 1 || currentStep > maxWorkflowStep(mode)) {
+    return false;
+  }
+  if (!status2 || !Array.isArray(obj.skippedSteps)) return false;
+  if (obj.skippedSteps.some((step) => typeof step !== "string")) return false;
+  if (obj.blockingReason !== void 0 && typeof obj.blockingReason !== "string")
+    return false;
+  if (obj.parentTaskId !== void 0 && typeof obj.parentTaskId !== "string")
+    return false;
+  if (obj.outcome !== void 0 && !isWorkflowOutcome(obj.outcome))
+    return false;
+  if (obj.planVersion !== void 0 && (!Number.isInteger(obj.planVersion) || obj.planVersion < 1))
+    return false;
+  if (status2 === "blocked") {
+    if (!obj.blockingReason?.trim()) return false;
+  } else if (obj.blockingReason !== void 0) {
+    return false;
+  }
+  if (mode === "mamba") {
+    if (status2 === "planned" || obj.planVersion !== void 0) return false;
+    if (obj.parentTaskId !== void 0 && !isValidWorkflowTaskId(obj.parentTaskId))
+      return false;
+    if (obj.outcome !== void 0 && status2 !== "completed") return false;
+    if (status2 === "completed" && obj.outcome === void 0) return false;
+  } else if (obj.parentTaskId !== void 0 || obj.outcome !== void 0) {
+    return false;
+  }
+  return true;
+}
+async function listActiveMambaChildren(projectRoot, parentTaskId) {
+  return (await listMambaChildren(projectRoot, parentTaskId)).filter(
+    (workflow2) => workflow2.status === "in_progress" || workflow2.status === "blocked"
+  );
+}
+async function listMambaChildren(projectRoot, parentTaskId) {
+  return (await listWorkflows(projectRoot)).filter(
+    (workflow2) => workflow2.mode === "mamba" && workflow2.parentTaskId === parentTaskId
+  );
+}
+async function propagateChildStatus(projectRoot, child) {
+  const shouldBlockParent = child.status === "blocked" || child.status === "completed" && child.outcome === "manual_test_required";
+  if (!shouldBlockParent) return;
+  const parentTaskId = child.parentTaskId;
+  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`;
+  await writeMetadata(workflowDir(projectRoot, parent.taskId), {
+    ...parent,
+    status: "blocked",
+    blockingReason: reason,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  if (parent.mode === "man" || parent.mode === "manteam") {
+    await upsertActivePlan(projectRoot, {
+      taskId: parent.taskId,
+      status: "blocked",
+      planVersion: parent.planVersion ?? 1
+    });
+  }
+}
+function isNodeError6(err) {
   return err instanceof Error && "code" in err;
 }
 function assertValidTaskId(taskId) {
@@ -5172,7 +6022,7 @@ var EXIT_NOT_INITIALIZED4 = 1;
 var EXIT_CORRUPT_STATE = 2;
 async function status(rootDir = process7.cwd(), options = {}) {
   const stateFile = path21.join(rootDir, ".mancode", "state.json");
-  if (!await pathExists10(stateFile)) {
+  if (!await pathExists9(stateFile)) {
     console.error("\u2717  mancode not initialized.");
     console.error("   Run `mancode init` to get started.");
     return EXIT_NOT_INITIALIZED4;
@@ -5248,12 +6098,24 @@ async function getCurrentWorkflow(rootDir, taskId) {
   if (!taskId) return null;
   const meta = await readWorkflow(rootDir, taskId);
   if (!meta) return null;
+  const activeChildren = meta.mode === "man" || meta.mode === "manteam" ? (await listWorkflows(rootDir)).filter(
+    (candidate) => candidate.mode === "mamba" && candidate.parentTaskId === meta.taskId && (candidate.status === "in_progress" || candidate.status === "blocked")
+  ).map((candidate) => ({
+    taskId: candidate.taskId,
+    currentStep: candidate.currentStep,
+    status: candidate.status
+  })) : void 0;
   return {
     taskId: meta.taskId,
     task: meta.task,
     mode: meta.mode,
     currentStep: meta.currentStep,
-    status: meta.status
+    status: meta.status,
+    ...meta.blockingReason ? { blockingReason: meta.blockingReason } : {},
+    ...meta.parentTaskId ? { parentTaskId: meta.parentTaskId } : {},
+    ...meta.outcome ? { outcome: meta.outcome } : {},
+    ...meta.planVersion ? { planVersion: meta.planVersion } : {},
+    ...activeChildren ? { activeChildren } : {}
   };
 }
 async function getProjectName(rootDir) {
@@ -5297,8 +6159,8 @@ function getEffectiveTeamStatus(state, config, detected) {
 }
 async function checkHooks(rootDir) {
   const [sessionStart, userPromptSubmit, registered] = await Promise.all([
-    pathExists10(path21.join(rootDir, ".mancode", "hooks", "session-start.sh")),
-    pathExists10(
+    pathExists9(path21.join(rootDir, ".mancode", "hooks", "session-start.sh")),
+    pathExists9(
       path21.join(rootDir, ".mancode", "hooks", "user-prompt-submit.sh")
     ),
     isRegistered(rootDir)
@@ -5318,9 +6180,9 @@ async function isRegistered(rootDir) {
   }
 }
 function hooksRegistered2(settings) {
-  if (!isRecord5(settings)) return false;
+  if (!isRecord7(settings)) return false;
   const hooks = settings.hooks;
-  if (!isRecord5(hooks)) return false;
+  if (!isRecord7(hooks)) return false;
   return hasHookCommand2(hooks.SessionStart, ".mancode/hooks/session-start.sh") && hasHookCommand2(
     hooks.UserPromptSubmit,
     ".mancode/hooks/user-prompt-submit.sh"
@@ -5329,9 +6191,9 @@ function hooksRegistered2(settings) {
 function hasHookCommand2(value, needle) {
   if (!Array.isArray(value)) return false;
   return value.some((group) => {
-    if (!isRecord5(group) || !Array.isArray(group.hooks)) return false;
+    if (!isRecord7(group) || !Array.isArray(group.hooks)) return false;
     return group.hooks.some((hook) => {
-      if (!isRecord5(hook) || typeof hook.command !== "string") return false;
+      if (!isRecord7(hook) || typeof hook.command !== "string") return false;
       return hook.command.includes(needle);
     });
   });
@@ -5343,7 +6205,7 @@ async function estimateHookInjection(rootDir) {
     "hooks",
     "user-prompt-submit.sh"
   );
-  if (!await pathExists10(hookPath)) {
+  if (!await pathExists9(hookPath)) {
     return { tokens: 0, cap: 800 };
   }
   try {
@@ -5405,6 +6267,23 @@ function printText(r) {
     console.log(
       `Workflow:    ${r.currentWorkflow.taskId} (Step ${r.currentWorkflow.currentStep}/${stepMax}, ${r.currentWorkflow.status})`
     );
+    if (r.currentWorkflow.parentTaskId) {
+      console.log(`Parent:      ${r.currentWorkflow.parentTaskId}`);
+    }
+    if (r.currentWorkflow.planVersion !== void 0) {
+      console.log(`Plan version: ${r.currentWorkflow.planVersion}`);
+    }
+    if (r.currentWorkflow.outcome) {
+      console.log(`Outcome:     ${r.currentWorkflow.outcome}`);
+    }
+    if (r.currentWorkflow.blockingReason) {
+      console.log(`Blocked:     ${r.currentWorkflow.blockingReason}`);
+    }
+    if (r.currentWorkflow.activeChildren?.length) {
+      console.log(
+        `Children:    ${r.currentWorkflow.activeChildren.map((child) => `${child.taskId} (${child.status})`).join(", ")}`
+      );
+    }
   }
   console.log("");
   console.log("Installed platforms:");
@@ -5444,12 +6323,12 @@ function formatTeamStatus(team) {
   return "solo";
 }
 function workflowStepMax(mode) {
-  return mode === "man8" ? 3 : 8;
+  return maxWorkflowStep(mode);
 }
-function isRecord5(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null;
 }
-async function pathExists10(p) {
+async function pathExists9(p) {
   try {
     await fs7.access(p);
     return true;
@@ -5459,30 +6338,15 @@ async function pathExists10(p) {
 }
 
 // src/commands/uninstall.ts
-import { access as access5, readFile as readFile8, rm as rm5, writeFile as writeFile11 } from "fs/promises";
+import { access as access4, readFile as readFile10, rm as rm5, writeFile as writeFile11 } from "fs/promises";
 import path22 from "path";
 import process8 from "process";
 var EXIT_OK7 = 0;
 var EXIT_NOT_INITIALIZED5 = 1;
 var EXIT_UNSUPPORTED_PLATFORM2 = 2;
-var CLAUDE_SKILL_DIRS = [
-  "solo",
-  "man8",
-  "man",
-  "manteam",
-  "manps",
-  "mansolo"
-];
-var CLAUDE_AGENT_FILES = [
-  "scout.md",
-  "head-coach.md",
-  "film-analyst-offense.md",
-  "film-analyst-defense.md",
-  "plan-coach.md"
-];
 async function uninstall(rootDir = process8.cwd(), platform, options = {}) {
   const stateFile = path22.join(rootDir, ".mancode", "state.json");
-  if (!await pathExists11(stateFile)) {
+  if (!await pathExists10(stateFile)) {
     console.error("\u2717  mancode not initialized.");
     console.error("   Run `mancode init` first.");
     return EXIT_NOT_INITIALIZED5;
@@ -5539,22 +6403,14 @@ async function uninstallAll(rootDir) {
   });
 }
 async function uninstallClaudeCode(rootDir) {
-  const claudeDir = path22.join(rootDir, ".claude");
-  const skillsDir = path22.join(claudeDir, "skills");
-  const agentsDir = path22.join(claudeDir, "agents");
-  for (const skillDir of CLAUDE_SKILL_DIRS) {
-    await rm5(path22.join(skillsDir, skillDir), { recursive: true, force: true });
-  }
-  for (const agentFile of CLAUDE_AGENT_FILES) {
-    await rm5(path22.join(agentsDir, agentFile), { force: true });
-  }
+  await removeClaudeGeneratedContent(rootDir);
   await cleanClaudeSettings(rootDir);
 }
 async function cleanClaudeSettings(rootDir) {
   const settingsPath = path22.join(rootDir, ".claude", "settings.json");
   let content;
   try {
-    content = await readFile8(settingsPath, "utf-8");
+    content = await readFile10(settingsPath, "utf-8");
   } catch {
     return;
   }
@@ -5564,28 +6420,21 @@ async function cleanClaudeSettings(rootDir) {
   } catch {
     return;
   }
-  if (!isRecord6(settings.hooks)) return;
   const cleanedHooks = {};
-  for (const [event, groups] of Object.entries(settings.hooks)) {
-    if (!Array.isArray(groups)) {
-      cleanedHooks[event] = groups;
-      continue;
-    }
-    const filtered = groups.flatMap((group) => {
-      if (!isRecord6(group) || !Array.isArray(group.hooks)) return [group];
-      const hooks = group.hooks.filter(
-        (hook) => !(isRecord6(hook) && typeof hook.command === "string" && hook.command.includes(".mancode/hooks/"))
-      );
-      return hooks.length > 0 ? [{ ...group, hooks }] : [];
-    });
-    if (filtered.length > 0) {
-      cleanedHooks[event] = filtered;
+  if (isRecord8(settings.hooks)) {
+    for (const [event, value] of Object.entries(settings.hooks)) {
+      const cleaned = cleanClaudeHookValue(value);
+      if (cleaned !== void 0) cleanedHooks[event] = cleaned;
     }
+    settings.hooks = Object.keys(cleanedHooks).length > 0 ? cleanedHooks : void 0;
   }
-  if (Object.keys(cleanedHooks).length > 0) {
-    settings.hooks = cleanedHooks;
-  } else {
-    settings.hooks = void 0;
+  if (isRecord8(settings.skills)) {
+    const retainedSkills = Object.fromEntries(
+      Object.entries(settings.skills).filter(
+        ([name, value]) => LEGACY_CLAUDE_SKILL_SETTINGS[name] !== value
+      )
+    );
+    settings.skills = Object.keys(retainedSkills).length > 0 ? retainedSkills : void 0;
   }
   await writeFile11(
     settingsPath,
@@ -5594,17 +6443,42 @@ async function cleanClaudeSettings(rootDir) {
     "utf-8"
   );
 }
-async function uninstallCursor(rootDir) {
-  const rulesDir = path22.join(rootDir, ".cursor", "rules");
-  for (const file of MANCODE_CURSOR_RULE_FILES) {
-    await rm5(path22.join(rulesDir, file), { force: true });
+function cleanClaudeHookValue(value) {
+  if (Array.isArray(value)) {
+    const entries2 = value.flatMap(cleanClaudeHookEntry);
+    return entries2.length > 0 ? entries2 : void 0;
+  }
+  if (!isRecord8(value)) return value;
+  if (Array.isArray(value.hooks) || typeof value.command === "string") {
+    const entries2 = cleanClaudeHookEntry(value);
+    return entries2.length > 0 ? entries2 : void 0;
+  }
+  const entries = Object.entries(value).flatMap(([key, item]) => {
+    const cleaned = cleanClaudeHookValue(item);
+    return cleaned === void 0 ? [] : [[key, cleaned]];
+  });
+  return entries.length > 0 ? Object.fromEntries(entries) : void 0;
+}
+function cleanClaudeHookEntry(entry) {
+  if (Array.isArray(entry)) return entry.flatMap(cleanClaudeHookEntry);
+  if (!isRecord8(entry)) return [entry];
+  if (Array.isArray(entry.hooks)) {
+    const hooks = entry.hooks.filter((hook) => !isMancodeHookEntry(hook));
+    return hooks.length > 0 ? [{ ...entry, hooks }] : [];
   }
+  return isMancodeHookEntry(entry) ? [] : [entry];
+}
+function isMancodeHookEntry(value) {
+  return isRecord8(value) && typeof value.command === "string" && value.command.includes(".mancode/hooks/");
+}
+async function uninstallCursor(rootDir) {
+  await removeCursorGeneratedRules(rootDir);
   await removeCursorCommands(rootDir);
 }
 async function uninstallCodex(rootDir) {
   const agentsPath = path22.join(rootDir, "AGENTS.md");
   try {
-    const content = await readFile8(agentsPath, "utf-8");
+    const content = await readFile10(agentsPath, "utf-8");
     const cleaned = removeManagedBlock(content);
     if (cleaned.trim()) {
       await writeFile11(agentsPath, `${cleaned}
@@ -5614,9 +6488,7 @@ async function uninstallCodex(rootDir) {
     }
   } catch {
   }
-  if (!await otherAgentSkillsPlatformActive(rootDir, "codex")) {
-    await removeCodexSkills(rootDir);
-  }
+  await removeCodexSkills(rootDir);
 }
 async function uninstallCopilot(rootDir) {
   const instructionsPath = path22.join(
@@ -5625,7 +6497,7 @@ async function uninstallCopilot(rootDir) {
     "copilot-instructions.md"
   );
   try {
-    const content = await readFile8(instructionsPath, "utf-8");
+    const content = await readFile10(instructionsPath, "utf-8");
     const cleaned = removeManagedBlock(content);
     if (cleaned.trim()) {
       await writeFile11(instructionsPath, `${cleaned}
@@ -5640,7 +6512,7 @@ async function uninstallCopilot(rootDir) {
 async function uninstallZcode(rootDir) {
   const agentsPath = path22.join(rootDir, "AGENTS.md");
   try {
-    const content = await readFile8(agentsPath, "utf-8");
+    const content = await readFile10(agentsPath, "utf-8");
     const cleaned = removeManagedBlock(
       content,
       ZCODE_MANCODE_START_MARKER,
@@ -5654,18 +6526,16 @@ async function uninstallZcode(rootDir) {
     }
   } catch {
   }
-  if (!await otherAgentSkillsPlatformActive(rootDir, "zcode")) {
-    await removeZcodeSkills(rootDir);
-  }
+  await removeZcodeSkills(rootDir);
 }
 async function removeFromConfig(rootDir, platform) {
   const configPath = path22.join(rootDir, ".mancode", "config.json");
   try {
-    const raw = await readFile8(configPath, "utf-8");
+    const raw = await readFile10(configPath, "utf-8");
     const config = JSON.parse(raw);
     if (Array.isArray(config.platforms)) {
       config.platforms = config.platforms.filter((p) => p !== platform);
-      if (isRecord6(config.platformOptions)) {
+      if (isRecord8(config.platformOptions)) {
         const platformOptions = Object.fromEntries(
           Object.entries(config.platformOptions).filter(
             ([name]) => name !== platform
@@ -5683,31 +6553,17 @@ async function removeFromConfig(rootDir, platform) {
   } catch {
   }
 }
-function isRecord6(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-async function pathExists11(p) {
+async function pathExists10(p) {
   try {
-    await access5(p);
+    await access4(p);
     return true;
   } catch {
     return false;
   }
 }
-async function otherAgentSkillsPlatformActive(rootDir, excluding) {
-  try {
-    const raw = await readFile8(
-      path22.join(rootDir, ".mancode", "config.json"),
-      "utf-8"
-    );
-    const config = JSON.parse(raw);
-    const platforms = Array.isArray(config.platforms) ? config.platforms : [];
-    const peers = ["codex", "zcode"].filter((p) => p !== excluding);
-    return platforms.some((p) => peers.includes(p));
-  } catch {
-    return false;
-  }
-}
 
 // src/commands/version.ts
 import process9 from "process";
@@ -5720,13 +6576,13 @@ function version() {
 }
 
 // src/commands/workflow.ts
-import { access as access6 } from "fs/promises";
+import { access as access5 } from "fs/promises";
 import path23 from "path";
 var EXIT_OK8 = 0;
 var EXIT_NOT_INITIALIZED6 = 1;
 var EXIT_INVALID_ARG2 = 2;
 async function workflow(rootDir, subcommand, args = [], options = {}) {
-  if (!await pathExists12(path23.join(rootDir, ".mancode", "state.json"))) {
+  if (!await pathExists11(path23.join(rootDir, ".mancode", "state.json"))) {
     if (options.json) {
       console.log(JSON.stringify({ error: "not initialized" }, null, 2));
     } else {
@@ -5758,7 +6614,7 @@ async function workflow(rootDir, subcommand, args = [], options = {}) {
       } else {
         console.error(`\u2717  Invalid workflow subcommand: ${subcommand}`);
         console.error(
-          "   Use: create <man8|man> <task> | update <taskId> | list | show <taskId> | clean"
+          "   Use: create <man|mamba|manteam> <task> | update <taskId> | list | show <taskId> | clean"
         );
       }
       return EXIT_INVALID_ARG2;
@@ -5767,25 +6623,34 @@ async function workflow(rootDir, subcommand, args = [], options = {}) {
 async function workflowCreate(rootDir, args, options) {
   const mode = args[0];
   const task = args.slice(1).join(" ").trim();
-  if (mode !== "man8" && mode !== "man") {
+  if (mode !== "man" && mode !== "mamba" && mode !== "manteam") {
     return invalidArg(
       options,
       `invalid workflow mode: ${mode ?? ""}`,
-      "Use: mancode workflow create <man8|man> <task>"
+      "Use: mancode workflow create <man|mamba|manteam> <task> [--parent-task <taskId>]"
     );
   }
   if (!task) {
     return invalidArg(
       options,
       "missing workflow task",
-      "Use: mancode workflow create <man8|man> <task>"
+      "Use: mancode workflow create <man|mamba|manteam> <task> [--parent-task <taskId>]"
     );
   }
-  const meta = await createWorkflow(rootDir, task, mode);
-  if (options.json) {
-    console.log(JSON.stringify(meta, null, 2));
-  } else {
-    console.log(`Created workflow: ${meta.taskId}`);
+  try {
+    const meta = await createWorkflow(rootDir, task, mode, {
+      parentTaskId: options.parentTask
+    });
+    if (options.json) {
+      console.log(JSON.stringify(meta, null, 2));
+    } else {
+      console.log(`Created workflow: ${meta.taskId}`);
+    }
+  } catch (error) {
+    return invalidArg(
+      options,
+      error instanceof Error ? error.message : "unable to create workflow"
+    );
   }
   return EXIT_OK8;
 }
@@ -5794,7 +6659,7 @@ async function workflowUpdate(rootDir, taskId, options) {
     return invalidArg(
       options,
       "missing taskId",
-      "Use: mancode workflow update <taskId> [--step N] [--status in_progress|completed|abandoned] [--skipped a,b]"
+      "Use: mancode workflow update <taskId> [--step N] [--status in_progress|planned|completed|blocked|abandoned] [--blocking-reason <reason>] [--outcome <outcome>] [--plan-version N] [--skipped a,b]"
     );
   }
   if (!isValidWorkflowTaskId(taskId)) {
@@ -5806,9 +6671,9 @@ async function workflowUpdate(rootDir, taskId, options) {
   }
   const patch = {};
   if (options.step !== void 0) {
-    const currentStep = Number.parseInt(options.step, 10);
-    const maxStep = existing.mode === "man" ? 8 : 3;
-    if (!Number.isInteger(currentStep) || currentStep < 1 || currentStep > maxStep) {
+    const currentStep = parseExactPositiveInteger(options.step);
+    const maxStep = maxWorkflowStep(existing.mode);
+    if (currentStep === null || currentStep < 1 || currentStep > maxStep) {
       return invalidArg(options, `invalid --step: ${options.step}`);
     }
     patch.currentStep = currentStep;
@@ -5819,14 +6684,67 @@ async function workflowUpdate(rootDir, taskId, options) {
     }
     patch.status = options.status;
   }
+  const nextStatus = patch.status ?? existing.status;
+  if (options.blockingReason !== void 0) {
+    if (nextStatus !== "blocked") {
+      return invalidArg(
+        options,
+        "--blocking-reason requires --status blocked or an already blocked workflow"
+      );
+    }
+    patch.blockingReason = options.blockingReason;
+  }
+  if (options.status === "in_progress" && existing.blockingReason) {
+    patch.blockingReason = void 0;
+  }
+  if (options.outcome !== void 0) {
+    if (!isWorkflowOutcome(options.outcome)) {
+      return invalidArg(options, `invalid --outcome: ${options.outcome}`);
+    }
+    if (existing.mode !== "mamba" || nextStatus !== "completed") {
+      return invalidArg(
+        options,
+        "--outcome is only valid when completing a mamba workflow"
+      );
+    }
+    patch.outcome = options.outcome;
+  }
+  if (options.planVersion !== void 0) {
+    const planVersion = parseExactPositiveInteger(options.planVersion);
+    const currentVersion = existing.planVersion ?? 1;
+    if (planVersion === null || existing.mode !== "man" && existing.mode !== "manteam" || planVersion !== currentVersion + 1 || (patch.currentStep ?? existing.currentStep) !== 4) {
+      return invalidArg(
+        options,
+        `invalid --plan-version: ${options.planVersion}; expected ${currentVersion + 1} at step 4 for ${existing.mode}`
+      );
+    }
+    patch.planVersion = planVersion;
+  }
   if (options.skipped !== void 0) {
     patch.skippedSteps = options.skipped.split(",").map((item) => item.trim()).filter(Boolean);
   }
   if (Object.keys(patch).length === 0) {
     return invalidArg(options, "missing update fields");
   }
-  await updateWorkflow(rootDir, taskId, patch);
+  try {
+    await updateWorkflow(rootDir, taskId, patch);
+  } catch (error) {
+    return invalidArg(
+      options,
+      error instanceof Error ? error.message : "unable to update workflow"
+    );
+  }
   const updated = await readWorkflow(rootDir, taskId);
+  if (updated && (updated.mode === "man" || updated.mode === "manteam")) {
+    const shouldSyncPlan = updated.currentStep >= 4 || updated.status !== "in_progress";
+    if (shouldSyncPlan) {
+      await upsertActivePlan(rootDir, {
+        taskId: updated.taskId,
+        status: updated.status,
+        planVersion: updated.planVersion ?? 1
+      });
+    }
+  }
   if (options.json) {
     console.log(JSON.stringify(updated, null, 2));
   } else {
@@ -5836,8 +6754,9 @@ async function workflowUpdate(rootDir, taskId, options) {
 }
 async function workflowList(rootDir, options) {
   const workflows = await listWorkflows(rootDir);
+  const views = attachActiveChildren(workflows);
   if (options.json) {
-    console.log(JSON.stringify(workflows, null, 2));
+    console.log(JSON.stringify(views, null, 2));
     return EXIT_OK8;
   }
   if (workflows.length === 0) {
@@ -5849,7 +6768,7 @@ async function workflowList(rootDir, options) {
     `mancode workflows (${workflows.length} total, ${inProgress} in_progress)`
   );
   console.log("");
-  for (const meta of workflows) {
+  for (const meta of views) {
     console.log(formatWorkflowRow(meta));
   }
   return EXIT_OK8;
@@ -5878,22 +6797,44 @@ async function workflowShow(rootDir, taskId, options) {
     }
     return EXIT_INVALID_ARG2;
   }
+  const children = meta.mode === "man" || meta.mode === "manteam" ? attachActiveChildren(await listWorkflows(rootDir)).find(
+    (workflow2) => workflow2.taskId === meta.taskId
+  )?.activeChildren ?? [] : void 0;
   if (options.json) {
-    console.log(JSON.stringify(meta, null, 2));
+    console.log(
+      JSON.stringify(
+        children === void 0 ? meta : { ...meta, activeChildren: children },
+        null,
+        2
+      )
+    );
     return EXIT_OK8;
   }
   console.log(`Workflow:    ${meta.taskId}`);
   console.log(`Task:        ${meta.task}`);
   console.log(`Mode:        ${meta.mode}`);
   console.log(`Status:      ${meta.status}`);
-  console.log(
-    `Current step:${meta.currentStep}/${meta.mode === "man" ? 8 : 3}`
-  );
+  console.log(`Current step:${meta.currentStep}/${maxWorkflowStep(meta.mode)}`);
   console.log(
     `Skipped:     ${meta.skippedSteps.length > 0 ? meta.skippedSteps.join(", ") : "none"}`
   );
   console.log(`Started:     ${meta.startedAt}`);
   console.log(`Updated:     ${meta.updatedAt}`);
+  if (meta.parentTaskId) console.log(`Parent:      ${meta.parentTaskId}`);
+  if (meta.planVersion !== void 0)
+    console.log(`Plan version: ${meta.planVersion}`);
+  if (meta.outcome) console.log(`Outcome:     ${meta.outcome}`);
+  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)`);
+      for (const child of children) {
+        console.log(
+          `  - ${child.taskId} (Step ${child.currentStep}/5, ${child.status})`
+        );
+      }
+    }
+  }
   return EXIT_OK8;
 }
 async function workflowClean(rootDir, options) {
@@ -5915,41 +6856,74 @@ async function workflowClean(rootDir, options) {
     return EXIT_INVALID_ARG2;
   }
   const candidates = workflows.filter((meta) => {
-    if (!cutoff) return meta.status !== "in_progress";
+    if (!isTerminalWorkflowStatus(meta.status)) return false;
+    if (!cutoff) return true;
     const started = Date.parse(meta.startedAt);
     return Number.isFinite(started) && started < cutoff.getTime();
   });
+  const removed = [];
+  if (!options.dryRun) {
+    for (const meta of candidates) {
+      const didRemove = await deleteWorkflow(rootDir, meta.taskId);
+      if (didRemove) removed.push(meta);
+      if (didRemove && (meta.mode === "man" || meta.mode === "manteam")) {
+        await upsertActivePlan(rootDir, {
+          taskId: meta.taskId,
+          status: meta.status,
+          planVersion: meta.planVersion ?? 1
+        });
+      }
+    }
+  }
   if (options.json) {
     console.log(
       JSON.stringify(
         {
           dryRun: Boolean(options.dryRun),
-          count: candidates.length,
-          workflows: candidates
+          count: options.dryRun ? candidates.length : removed.length,
+          workflows: options.dryRun ? candidates : removed
         },
         null,
         2
       )
     );
-  } else if (candidates.length === 0) {
+  } else if ((options.dryRun ? candidates : removed).length === 0) {
     console.log("No workflows to clean.");
   } else if (options.dryRun) {
     console.log(`Would remove ${candidates.length} workflow(s):`);
     for (const meta of candidates) console.log(`  ${meta.taskId}`);
   } else {
-    console.log(`Removed ${candidates.length} workflow(s).`);
-  }
-  if (!options.dryRun) {
-    for (const meta of candidates) {
-      await deleteWorkflow(rootDir, meta.taskId);
-    }
+    console.log(`Removed ${removed.length} workflow(s).`);
   }
   return EXIT_OK8;
 }
 function formatWorkflowRow(meta) {
-  const stepMax = meta.mode === "man" ? 8 : 3;
+  const stepMax = maxWorkflowStep(meta.mode);
   const step = meta.status === "in_progress" ? `Step ${meta.currentStep}/${stepMax}` : ago(meta.updatedAt);
-  return `${meta.taskId.padEnd(42)} ${meta.mode.padEnd(5)} ${meta.status.padEnd(11)} ${step}`;
+  const details = [
+    meta.planVersion !== void 0 ? `plan=v${meta.planVersion}` : "",
+    meta.parentTaskId ? `parent=${meta.parentTaskId}` : "",
+    meta.outcome ? `outcome=${meta.outcome}` : "",
+    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(" | ")}` : ""}`;
+}
+function attachActiveChildren(workflows) {
+  return workflows.map((meta) => {
+    if (meta.mode !== "man" && meta.mode !== "manteam") return meta;
+    return {
+      ...meta,
+      activeChildren: workflows.filter(
+        (candidate) => candidate.mode === "mamba" && candidate.parentTaskId === meta.taskId && (candidate.status === "in_progress" || candidate.status === "blocked")
+      )
+    };
+  });
+}
+function parseExactPositiveInteger(value) {
+  if (!/^\d+$/.test(value)) return null;
+  const parsed = Number(value);
+  return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
 }
 function parseOlderThan(value) {
   if (!value) return void 0;
@@ -5969,9 +6943,6 @@ function invalidArg(options, message, usage) {
   }
   return EXIT_INVALID_ARG2;
 }
-function isWorkflowStatus(value) {
-  return value === "in_progress" || value === "completed" || value === "abandoned";
-}
 function ago(iso) {
   const time = Date.parse(iso);
   if (!Number.isFinite(time)) return "unknown";
@@ -5983,9 +6954,9 @@ function ago(iso) {
   if (hours < 24) return `${hours}h ago`;
   return `${Math.floor(hours / 24)}d ago`;
 }
-async function pathExists12(p) {
+async function pathExists11(p) {
   try {
-    await access6(p);
+    await access5(p);
     return true;
   } catch {
     return false;
@@ -5993,7 +6964,9 @@ async function pathExists12(p) {
 }
 
 // src/cli.ts
-program.name("mancode").description("AI coding agent harness. Five modes: practice to playoffs.").version(VERSION);
+program.name("mancode").description(
+  "AI coding agent harness. Modes: solo, /man, /mamba, /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 <platform>", "Initial adapter platform (MVP-3)").action(async (options) => {
   const code = await init(process.cwd(), options);
   process.exitCode = code;
@@ -6020,7 +6993,10 @@ program.command("uninstall [platform]").description("Remove platform adapter or
   const code = await uninstall(process.cwd(), platform, options);
   process.exitCode = code;
 });
-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("--skipped <steps>", "Update skipped steps as comma-separated values").option("--json", "Output as JSON (for scripts)").action(async (subcommand, args, options) => {
+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("--json", "Output as JSON (for scripts)").action(async (subcommand, args, options) => {
   const code = await workflow(process.cwd(), subcommand, args ?? [], options);
   process.exitCode = code;
 });
@@ -6028,7 +7004,7 @@ program.command("manps [area]").description("Run deterministic preseason health
   const code = await manps(process.cwd(), area ?? "all", options);
   process.exitCode = code;
 });
-program.command("refresh-style").description("Rescan project design tokens and update style-tokens.json").action(async () => {
+program.command("refresh-style").description("Refresh project profile and rescan applicable design tokens").action(async () => {
   const code = await refreshStyle(process.cwd());
   process.exitCode = code;
 });