@guanlin4924/devflow-pi 0.1.93 → 0.1.95

package/plugins/devflow-design/skills/workflow-ui-spec/assets/ui-spec-template.md

@@ -8,7 +8,7 @@
 
 **设计来源**: {设计稿路径/截图说明}
 **解析日期**: {日期}
-**上游依赖**: `.planning/features/{功能名}/功能点梳理.md`
+**上游依赖**: `.devflow/planning/features/{功能名}/功能点梳理.md`
 
 ---
 
@@ -111,8 +111,8 @@
 | 来源类型 | 来源文件/依据 | 是否可直接用于实现 | 说明 |
 |----------|---------------|--------------------|------|
 | 设计稿事实 | {截图/Figma/蓝湖/用户已确认设计描述} | 是 | {明确来自设计稿的颜色、字号、间距、圆角、阴影等} |
-| 现有项目规范 | {现有代码变量/组件库/.context/spec/design/tokens/project-tokens.md} | 是 | {与现有变量或组件规则对齐的 token} |
-| 推荐 - 待拍板 | {.context/spec/design/recommendations 或 ui-ux-pro-max 查询结果} | 否 | {仅作为候选方案，需写入待确认事项} |
+| 现有项目规范 | {现有代码变量/组件库/.devflow/context/spec/design/tokens/project-tokens.md} | 是 | {与现有变量或组件规则对齐的 token} |
+| 推荐 - 待拍板 | {.devflow/context/spec/design/recommendations 或 ui-ux-pro-max 查询结果} | 否 | {仅作为候选方案，需写入待确认事项} |
 
 合并优先级：用户拍板/设计稿事实/需求基线 > 现有代码与项目 token > 项目级已确认 token > 推荐 - 待拍板。
 

package/plugins/devflow-implementation/agents/implementation-worker.md

@@ -19,7 +19,7 @@ autoloadSkills:
 Implement only the assigned plan slice. Do not re-plan the feature, compare alternatives, or explore unrelated modules. Read only the approved files, their immediate dependencies, and the focused tests needed for this slice. Preserve unrelated work and report deviations instead of silently expanding scope.
 
 Before any protected source access, read the project's required code-index evidence
-files in the exact order listed by INDEX_GATE (typically `.planning/code-index/INDEX.md`
+files in the exact order listed by INDEX_GATE (typically `.devflow/planning/code-index/INDEX.md`
 followed by the ordered files named by the gate). Do not attempt `grep`, `rg`, or source
 reads first: each subagent has its own evidence session and cannot inherit the parent's
 observations. If the gate lists different files, follow that list exactly.
@@ -28,4 +28,4 @@ If the execution contract is missing, ambiguous, or contradicted by the code, st
 
 For a task whose frozen `test-bindings.json` marks `test_mode: tdd_required`, use the Core tool in this exact order: `devflow_tdd_evidence(action="prepare")` before changing declared production paths; create/change the test and record `red`; implement; record `green`; then record `regression`. Do not mark the task done if any phase is missing or fails. The tool may write only its own Core-owned TDD evidence record; this exception does not authorize edits to any other Devflow control-plane file.
 
-Return `STATUS`, changed files, validation evidence, and one escalation/blocker if needed. Never edit `.planning/STATE.md`, `.planning/artifacts/index.yaml`, workflow definitions, or checkpoint decisions; the parent session owns those through Devflow tools.
+Return `STATUS`, changed files, validation evidence, and one escalation/blocker if needed. Never edit `.devflow/planning/STATE.md`, `.devflow/planning/artifacts/index.yaml`, workflow definitions, or checkpoint decisions; the parent session owns those through Devflow tools.

package/plugins/devflow-implementation/skills/workflow-bug-fix/SKILL.md

@@ -29,7 +29,7 @@ Required outputs:
 - Root-cause diagnosis containing the fields in `references/root-cause-ladder.md`.
 - Code and/or workflow-artifact repair consistent with that diagnosis.
 - Verification evidence and a context-sync result.
-- A lesson under `.context/lessons/` when the finding is reusable; if the directory or index is absent, record that limitation and do not fail solely for its absence.
+- A lesson under `.devflow/context/lessons/` when the finding is reusable; if the directory or index is absent, record that limitation and do not fail solely for its absence.
 
 Read references only at their designated phase. [references/INDEX.md](references/INDEX.md) is the routing contract; it is not optional.
 
@@ -37,7 +37,7 @@ Read references only at their designated phase. [references/INDEX.md](references
 
 1. Find the first broken layer and stop root-cause traversal there. Do not call a downstream symptom the root cause.
 2. Before classifying the cause, read `references/first-principles.md` and `references/adversarial-review.md`.
-3. Any source-level claim based on `.planning/code-index/` requires source readback at its evidence path and line. Navigation or index summaries alone are insufficient.
+3. Any source-level claim based on `.devflow/planning/code-index/` requires source readback at its evidence path and line. Navigation or index summaries alone are insufficient.
 4. `requirement-gap`, `breakdown-gap`, `spec-gap`, and `change-list-gap` require documentation repair before code repair. `implementation-bug` and `regression` do not require speculative document rewrites.
 5. Keep the repair scoped to the violated invariant. Do not slip in unrelated refactors or new feature scope.
 6. Complete verification and `workflow-context-sync --after-bugfix` before declaring success, unless the user explicitly approves an exception and its residual risk is recorded.
@@ -46,12 +46,12 @@ Read references only at their designated phase. [references/INDEX.md](references
 
 Load only what exists and is relevant, in this order:
 
-1. `.planning/STATE.md` for the active feature and phase.
-2. `.planning/requirements/baseline.md`.
-3. `.planning/features/{功能名}/功能点梳理.md`.
-4. `.planning/features/{功能名}/前端技术方案.md` and `后端技术方案.md`.
-5. `.planning/features/{功能名}/*变更清单.md`.
-6. `.planning/code-index/` and then evidence source files, when source tracing is needed.
+1. `.devflow/planning/STATE.md` for the active feature and phase.
+2. `.devflow/planning/requirements/baseline.md`.
+3. `.devflow/planning/features/{功能名}/功能点梳理.md`.
+4. `.devflow/planning/features/{功能名}/前端技术方案.md` and `后端技术方案.md`.
+5. `.devflow/planning/features/{功能名}/*变更清单.md`.
+6. `.devflow/planning/code-index/` and then evidence source files, when source tracing is needed.
 
 If an upstream artifact is absent, record it as evidence for the corresponding gap rather than silently skipping it.
 
@@ -104,7 +104,7 @@ Gate: verification demonstrates the original reproduction is fixed and the ident
 ## Phase 5 — Preserve Knowledge and Synchronize Context
 
 1. Read `references/lesson-format.md`. Write a lesson when the finding is reusable beyond this single line fix; otherwise record why no lesson is needed.
-2. If `.context/lessons/README.md` exists, append the lesson to its index. If it does not exist, retain the lesson file and report that no index was available.
+2. If `.devflow/context/lessons/README.md` exists, append the lesson to its index. If it does not exist, retain the lesson file and report that no index was available.
 3. Run `workflow-context-sync --after-bugfix`.
    - Ordinary implementation repairs refresh code-index and run validate/audit.
    - Changes to routes, API clients, handlers, jobs, service boundaries, toolchain, or manifests may require a Medium sync with navigation/spec/toolchain updates.

package/plugins/devflow-implementation/skills/workflow-bug-fix/references/lesson-format.md

@@ -2,7 +2,7 @@
 
 Write a lesson when the cause, invariant, boundary defense, or regression pattern is likely to prevent future work from repeating the failure. Do not create one for a self-evident isolated typo unless project rules require it.
 
-Write `.context/lessons/{YYYY-MM-DD}-{slug}.md`:
+Write `.devflow/context/lessons/{YYYY-MM-DD}-{slug}.md`:
 
 ```markdown
 # {Bug title}
@@ -25,4 +25,4 @@ Write `.context/lessons/{YYYY-MM-DD}-{slug}.md`:
 - **Rule for future work**: {reusable guidance}
 ```
 
-If `.context/lessons/README.md` exists, add a concise linked entry. If it does not exist, do not fail the bug fix; retain the lesson file and report that the index was unavailable.
+If `.devflow/context/lessons/README.md` exists, add a concise linked entry. If it does not exist, do not fail the bug fix; retain the lesson file and report that the index was unavailable.

package/plugins/devflow-implementation/skills/workflow-bug-fix/references/root-cause-ladder.md

@@ -13,7 +13,7 @@ Inspect in order and stop at the first broken layer. Earlier applicable layers m
 
 ## Evidence Details
 
-- Use `.planning/code-index/` to locate symbols, callers, imports, reads/writes, and tests when present; read the cited source evidence before asserting a fact.
+- Use `.devflow/planning/code-index/` to locate symbols, callers, imports, reads/writes, and tests when present; read the cited source evidence before asserting a fact.
 - If code-index is missing, stale, or has no result, use navigation and targeted source inspection, and say that machine relation facts were unavailable.
 - For implementation analysis, check completed change-list tasks, boundary/error handling, and obvious omissions such as type errors, logic reversal, or missed validation.
 - For regression analysis, run `git log --oneline -10 -- <relevant-file>` from the owning repository and inspect the relevant diff.

package/plugins/devflow-implementation/skills/workflow-change-plan/SKILL.md

@@ -37,13 +37,13 @@ description: "Use after workflow-integration-verify has passed or produced an ap
 
 | 优先级 | 输入 | 轨道 |
 |--------|------|------|
-| 1 | `.planning/features/{feature}/integration-report.md` | 合流门禁结果，必须存在 |
-| 2 | `.planning/features/{feature}/api-contract.md` | API 契约，包含 no-op 场景 |
-| 3 | `.planning/features/{feature}/api-call-guide.md` | 前端消费指南，包含 no-op 场景 |
-| 4 | `.planning/features/{feature}/后端技术方案.md` | Track A |
-| 5 | `.planning/features/{feature}/前端技术方案.md` | Track B |
-| 6 | `.planning/features/{feature}/功能点梳理.md` | Track B |
-| 7 | `.planning/requirements/baseline.md` | fallback |
+| 1 | `.devflow/planning/features/{feature}/integration-report.md` | 合流门禁结果，必须存在 |
+| 2 | `.devflow/planning/features/{feature}/api-contract.md` | API 契约，包含 no-op 场景 |
+| 3 | `.devflow/planning/features/{feature}/api-call-guide.md` | 前端消费指南，包含 no-op 场景 |
+| 4 | `.devflow/planning/features/{feature}/后端技术方案.md` | Track A |
+| 5 | `.devflow/planning/features/{feature}/前端技术方案.md` | Track B |
+| 6 | `.devflow/planning/features/{feature}/功能点梳理.md` | Track B |
+| 7 | `.devflow/planning/requirements/baseline.md` | fallback |
 
 **无 API 变更时**：不得直接跳过合流。必须存在 no-op `api-contract.md`、no-op `api-call-guide.md` 和 no-op `integration-report.md`；变更清单聚焦于代码文件改动，DDL/API 章节标注"无"。
 
@@ -58,23 +58,23 @@ description: "Use after workflow-integration-verify has passed or produced an ap
 5. 读取功能点梳理（如存在）→ 确认 FP 覆盖完整性
 6. 读取 baseline.md 的审查结论和风险标记
 7. 若输入包含 `SL-*` 切片计划，读取 `skill://workflow-pipeline/references/slice-safety-guide.md`，只生成当前执行切片的任务。后置切片只能写入风险/后续范围，不得生成实现任务。
-8. 读取 `.planning/requirements/{feature}/traceability.json`；它是任务覆盖判断的唯一 REQ 清单，不能仅凭技术方案标题推断覆盖。
-9. 读取候选态的 `.planning/requirements/{feature}/tests.json`。它定义本次验收意图；不得从实现摘要或预期代码结构补造测试范围。该测试意图会与变更清单一起在 CP-3 冻结。
+8. 读取 `.devflow/planning/requirements/{feature}/traceability.json`；它是任务覆盖判断的唯一 REQ 清单，不能仅凭技术方案标题推断覆盖。
+9. 读取候选态的 `.devflow/planning/requirements/{feature}/tests.json`。它定义本次验收意图；不得从实现摘要或预期代码结构补造测试范围。该测试意图会与变更清单一起在 CP-3 冻结。
 
 ### 第二阶段：扫描项目上下文
 
 1. 验证技术方案中列出的文件路径存在
 2. 读取关键源文件的当前内容（确认改动基线）
 3. 识别可复用的现有模式和工具库
-4. 检查 `.planning/execution-contract.md` 的分层规则
+4. 检查 `.devflow/planning/execution-contract.md` 的分层规则
 
 ### 第三阶段：生成变更清单
 
-输出到 `.planning/features/{feature}/变更清单.md`。
+输出到 `.devflow/planning/features/{feature}/变更清单.md`。
 
-同时输出 `.planning/features/{feature}/test-bindings.json`。这是受控的任务—验收用例绑定。生成时它必须使用 `schema_version: 2` 与 `candidate_test_suite: { graph_revision, fingerprint }`，并通过 `test_task_binding_check.py --feature {feature} --stage candidate --json`。每个代码任务必须关联一个或多个候选 `TC-*`，并指定 `tdd_required`、`contract_first`、`integration_only` 或 `manual_justified` 测试模式；非 TDD 模式必须说明原因。`tdd_required` 还必须给出同一测试目标的 RED/GREEN 命令、RED 的预期失败标记、回归命令和生产代码路径。CP-3 会在同一次确认中核验候选绑定、冻结 TC 并写入 Core attestation；之后执行阶段以 `--stage frozen` 校验。所有 Core 实际执行的命令必须是无 shell 的 argv，且 runner 已在初始化生成的 `.planning/toolchain.md` 中被发现；不能用 `python -c`、`node -e` 或任意脚本解释器绕过。
+同时输出 `.devflow/planning/features/{feature}/test-bindings.json`。这是受控的任务—验收用例绑定。生成时它必须使用 `schema_version: 2` 与 `candidate_test_suite: { graph_revision, fingerprint }`，并通过 `test_task_binding_check.py --feature {feature} --stage candidate --json`。每个代码任务必须关联一个或多个候选 `TC-*`，并指定 `tdd_required`、`contract_first`、`integration_only` 或 `manual_justified` 测试模式；非 TDD 模式必须说明原因。`tdd_required` 还必须给出同一测试目标的 RED/GREEN 命令、RED 的预期失败标记、回归命令和生产代码路径。CP-3 会在同一次确认中核验候选绑定、冻结 TC 并写入 Core attestation；之后执行阶段以 `--stage frozen` 校验。所有 Core 实际执行的命令必须是无 shell 的 argv，且 runner 已在初始化生成的 `.devflow/planning/toolchain.md` 中被发现；不能用 `python -c`、`node -e` 或任意脚本解释器绕过。
 
-同时输出 `.planning/features/{feature}/变更清单.meta.json`。只有 Core 随包提供的 `traceability_check.py --file .planning/requirements/{feature}/traceability.json --stage change-plan` 成功时才允许写入 `traceability_status: "passed"`；`uncovered_requirement_count` 和 `orphan_task_count` 必须为 0。
+同时输出 `.devflow/planning/features/{feature}/变更清单.meta.json`。只有 Core 随包提供的 `traceability_check.py --file .devflow/planning/requirements/{feature}/traceability.json --stage change-plan` 成功时才允许写入 `traceability_status: "passed"`；`uncovered_requirement_count` 和 `orphan_task_count` 必须为 0。
 
 `变更清单.meta.json` 必须在顶层同时写入以下字段（不能只放在嵌套对象中）：
 
@@ -87,7 +87,7 @@ description: "Use after workflow-integration-verify has passed or produced an ap
 }
 ```
 
-其中数值必须从当前 `.planning/requirements/{feature}/tests.json` 读取，禁止手填旧 revision 或旧 fingerprint。
+其中数值必须从当前 `.devflow/planning/requirements/{feature}/tests.json` 读取，禁止手填旧 revision 或旧 fingerprint。
 
 `test-bindings.json` 必须由 Core 随包提供的 `test_task_binding_check.py --feature {feature} --stage candidate --json` 校验通过。`candidate_test_suite` 必须严格只包含 `graph_revision` 和 `fingerprint` 两个字段，不能附加 `test_case_count` 或 `source`。每个 `implementation_tests` 项必须包含项目相对 `path`；非 `tdd_required` 任务必须在任务顶层提供 `non_tdd_reason`，`manual_justified` 还必须提供 `owner`。校验器的字段名是 `tc_refs`、`implementation_tests` 和 `tdd.red/green/regression`；不能使用旧格式的 `test_cases`、`red_command`、`green_command` 或 `regression_command`。`origin` 必须为 `devflow_change_plan`。
 
@@ -128,11 +128,11 @@ description: "Use after workflow-integration-verify has passed or produced an ap
 - **操作**：新增 / 修改 / 删除
 - **依赖**：T-000（无则写"无"）
 - **参考实现**：`path/to/similar/file.py:line`（有则填写）
-- **Code Index 证据**：相关 symbol/relation/evidence（有 `.planning/code-index/` 时填写；无则写"未使用：原因"）
+- **Code Index 证据**：相关 symbol/relation/evidence（有 `.devflow/planning/code-index/` 时填写；无则写"未使用：原因"）
 - **需求来源**：FP-001 / BR-001 / 技术方案第X章
 - **REQ 覆盖**：`REQ-001`（必须是 traceability.json 中的原子 ID；无来源任务必须显式标为获批技术债）
 - **Slice**：SL-001
-- **适用规范**：`.context/spec/backend/service.md` 等（有则填写）
+- **适用规范**：`.devflow/context/spec/backend/service.md` 等（有则填写）
 - **相关经验教训**：lesson ID 或"无"
 - **执行前门禁**：编码前必须确认的事项（无则写"无"）
 - **测试策略**：单元/集成/人工测试策略简述
@@ -182,7 +182,7 @@ graph TD
 - [ ] 每个任务有完成标准
 - [ ] 所有完成标准使用 `- [ ]` checkbox 格式（非纯列表 `-`）
 - [ ] 每条完成标准描述的是可通过静态代码分析验证的条件（禁止"功能正确"类模糊描述）
-- [ ] 若 `.planning/code-index/` 存在，涉及已有代码的任务已标注相关 symbol/relation/evidence 或说明未使用原因
+- [ ] 若 `.devflow/planning/code-index/` 存在，涉及已有代码的任务已标注相关 symbol/relation/evidence 或说明未使用原因
 - [ ] 每个任务包含审查要求、适用规范、需求来源字段（至少标注"无"）
 - [ ] 文件路径与技术方案一致
 - [ ] 变更清单任务同步写入 `traceability.json.tasks`，每项包含 `id`、`requirements` 和六维 `acceptance`

package/plugins/devflow-implementation/skills/workflow-change-plan/references/code-conventions.md

@@ -1,6 +1,6 @@
 # 通用代码约束
 
-Use this reference only as a fallback when the target project has no stronger rule package. Project-specific rules from `.planning/rules/`, `.context/spec/`, `AGENTS.md`, `CLAUDE.md`, framework conventions, or language stack slots override this file.
+Use this reference only as a fallback when the target project has no stronger rule package. Project-specific rules from `.devflow/planning/rules/`, `.devflow/context/spec/`, `AGENTS.md`, `CLAUDE.md`, framework conventions, or language stack slots override this file.
 
 ## Task Design
 

package/plugins/devflow-implementation/skills/workflow-change-plan/references/output-template.md

@@ -18,7 +18,7 @@
 >
 > 完成标准在执行阶段由 `code_review` 门禁自动逐条验证。每条标准必须描述**可通过静态代码分析验证的具体条件**（精确到类名/方法名/字段名/返回值/文件行），不得使用"确保功能正确"、"用户体验良好"等模糊描述。标准模糊的条目将被标记为 `⚠️ UNVERIFIABLE`，无法通过自动化验证。
 
-> **变更计划 meta：** `.planning/features/{功能名}/变更清单.meta.json` 顶层必须包含 `test_case_count`、`test_coverage_status`、`candidate_test_suite_graph_revision`、`candidate_test_suite_fingerprint`，值来自当前 `tests.json`，不能只放在嵌套对象中。
+> **变更计划 meta：** `.devflow/planning/features/{功能名}/变更清单.meta.json` 顶层必须包含 `test_case_count`、`test_coverage_status`、`candidate_test_suite_graph_revision`、`candidate_test_suite_fingerprint`，值来自当前 `tests.json`，不能只放在嵌套对象中。
 >
 > **验收测试绑定：** 除 Markdown 外，必须生成 schema v2 的 `test-bindings.json`。它将每个任务绑定到候选 `TC-*`，任务字段必须使用 `tc_refs`、`implementation_tests` 和 `test_mode`；`tdd_required` 使用 `tdd.red/green/regression`。文件必须声明 `origin: devflow_change_plan`，并以 `candidate_test_suite: { graph_revision, fingerprint }` 固定候选测试意图；它必须通过 Core 随包提供的 `test_task_binding_check.py --feature <功能名> --stage candidate --json`。CP-3 在同一次用户确认中验证该绑定、冻结 TC，并写入 Core-owned `test-suite-freeze.json`；之后才可按 `--stage frozen` 进入执行。所有 `tdd_required` 任务必须声明相同测试目标的 RED/GREEN 命令、RED 失败标记、回归命令与生产代码路径。
 
@@ -27,7 +27,7 @@
 ```markdown
 # <功能名称> - 变更清单
 
-> 基于技术文档：`.planning/features/{功能名}/前端技术方案.md` 和 `.planning/features/{功能名}/后端技术方案.md`
+> 基于技术文档：`.devflow/planning/features/{功能名}/前端技术方案.md` 和 `.devflow/planning/features/{功能名}/后端技术方案.md`
 
 > 当前执行切片：`{{SL-001}}` — {{切片名称}}。本清单只生成该切片任务；后置切片仅作为上下文和风险记录。
 
@@ -37,7 +37,7 @@
 
 - **技术栈**：语言 / 框架 / 主要依赖
 - **分层结构**：项目的分层方式（如 Domain → DAO → Service → Handler）
-- **规则来源**：`.planning/rules/` / `.context/spec/` / `.context/workflow/` / `.planning/lessons/` / `AGENTS.md` / `CLAUDE.md`
+- **规则来源**：`.devflow/planning/rules/` / `.devflow/context/spec/` / `.devflow/context/workflow/` / `.devflow/planning/lessons/` / `AGENTS.md` / `CLAUDE.md`
 - **关键规范**：核心编码规则（命名、参数限制、错误处理、日志、事务、分页、权限等）
 - **执行契约**：层级顺序、测试策略、codegen/mock/DI/migration 要求
 - **经验教训**：与本次任务相关的历史教训

package/plugins/devflow-implementation/skills/workflow-change-plan/references/project-rule-contract.md

@@ -6,28 +6,28 @@ Use this contract when generating implementation change lists. A project rule pa
 
 Look for rule sources in the target project, in this order:
 
-1. `.planning/rules/INDEX.md`
-2. `.planning/execution-contract.md`
-3. `.planning/toolchain.md`
-4. `.planning/lessons/README.md`
-5. `.planning/milestones/`
-6. `.planning/requirements/`
-7. `.context/spec/index.md`
-8. matching `.context/spec/stacks/{stack_key}.md`
-9. matching `.context/spec/frontend|backend/{codebase}.md`
-10. `.context/spec/`
-11. `.context/workflow/tdd.md`
-12. `.context/workflow/verification.md`
-13. `.context/workflow/checklist.md`
-14. `.context/lessons/README.md`
+1. `.devflow/planning/rules/INDEX.md`
+2. `.devflow/planning/execution-contract.md`
+3. `.devflow/planning/toolchain.md`
+4. `.devflow/planning/lessons/README.md`
+5. `.devflow/planning/milestones/`
+6. `.devflow/planning/requirements/`
+7. `.devflow/context/spec/index.md`
+8. matching `.devflow/context/spec/stacks/{stack_key}.md`
+9. matching `.devflow/context/spec/frontend|backend/{codebase}.md`
+10. `.devflow/context/spec/`
+11. `.devflow/context/workflow/tdd.md`
+12. `.devflow/context/workflow/verification.md`
+13. `.devflow/context/workflow/checklist.md`
+14. `.devflow/context/lessons/README.md`
 15. root `AGENTS.md`, `CLAUDE.md`, or equivalent project instruction files
 
 If none exist, explicitly write `未发现项目规则包` and continue using the technical documents and discovered code patterns.
 
 History rule:
 
-- Use `.planning/milestones/`, `.planning/requirements/`, `.planning/lessons/`, and phase `CONTEXT.md` files as the primary history model.
-- Treat `.context/lessons/` and `features/` as compatible legacy/project-rule evidence only when present in the target project.
+- Use `.devflow/planning/milestones/`, `.devflow/planning/requirements/`, `.devflow/planning/lessons/`, and phase `CONTEXT.md` files as the primary history model.
+- Treat `.devflow/context/lessons/` and `features/` as compatible legacy/project-rule evidence only when present in the target project.
 - Do not require outbound-call style history files.
 
 ## Task-Level Requirements

package/plugins/devflow-implementation/skills/workflow-execute-phase/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: workflow-execute-phase
-description: "Use when a planned .planning phase needs implementation, dependency-aware task execution, progress tracking, and verification evidence."
+description: "Use when a planned .devflow/planning phase needs implementation, dependency-aware task execution, progress tracking, and verification evidence."
 ---
 
 ## Legacy Command Metadata
@@ -44,7 +44,7 @@ references/ui-brand.md
 Phase: $ARGUMENTS
 
 **Requirement backfill rule:**
-During execution, if an implementation change would alter external behavior, notifications, failure handling, retry/scheduling policy, permissions, API contracts, persistence/data-writing rules, compatibility behavior, or non-functional guarantees, stop before or immediately after the smallest safe edit and update `.planning/requirements/baseline.md` first.
+During execution, if an implementation change would alter external behavior, notifications, failure handling, retry/scheduling policy, permissions, API contracts, persistence/data-writing rules, compatibility behavior, or non-functional guarantees, stop before or immediately after the smallest safe edit and update `.devflow/planning/requirements/baseline.md` first.
 
 After updating the baseline, update every affected downstream artifact: feature breakdown, frontend/backend tech specs, change list, and pipeline/execution state. Do not let implementation become the only source of truth for new behavior.
 
@@ -52,38 +52,38 @@ Backfill is not required for pure refactors, local method extraction, naming cle
 
 **Project rule package:**
 Before assigning or executing implementation work, discover project rule sources in the target workspace:
-- `.planning/rules/INDEX.md`
-- `.planning/execution-contract.md`
-- `.planning/toolchain.md`
-- `.planning/lessons/README.md`
-- `.planning/milestones/`
-- `.planning/requirements/`
-- `.context/spec/index.md`
-- matching `.context/spec/stacks/{stack_key}.md`
-- matching `.context/spec/frontend|backend/{codebase}.md`
-- `.planning/code-index/` when present
-- `.context/spec/`
-- `.context/workflow/tdd.md`
-- `.context/workflow/checklist.md`
-- `.context/lessons/README.md`（如存在）
+- `.devflow/planning/rules/INDEX.md`
+- `.devflow/planning/execution-contract.md`
+- `.devflow/planning/toolchain.md`
+- `.devflow/planning/lessons/README.md`
+- `.devflow/planning/milestones/`
+- `.devflow/planning/requirements/`
+- `.devflow/context/spec/index.md`
+- matching `.devflow/context/spec/stacks/{stack_key}.md`
+- matching `.devflow/context/spec/frontend|backend/{codebase}.md`
+- `.devflow/planning/code-index/` when present
+- `.devflow/context/spec/`
+- `.devflow/context/workflow/tdd.md`
+- `.devflow/context/workflow/checklist.md`
+- `.devflow/context/lessons/README.md`（如存在）
 - root `AGENTS.md`, `CLAUDE.md`, or equivalent project instruction files
 
-If rule sources exist, resolve them using this read order before delegating work: `.planning/rules/INDEX.md` → `.context/spec/index.md` → matching stack spec → matching codebase spec → `.planning/navigation/{codebase}.md` → `.planning/code-index/` when present and relation facts are needed → actual source files. Include the resolved rules and relevant code-index evidence in the files delegated to execution workers and require task-level rule activation. If no rule sources exist, record that no project rule package was found and proceed with the plan context.
+If rule sources exist, resolve them using this read order before delegating work: `.devflow/planning/rules/INDEX.md` → `.devflow/context/spec/index.md` → matching stack spec → matching codebase spec → `.devflow/planning/navigation/{codebase}.md` → `.devflow/planning/code-index/` when present and relation facts are needed → actual source files. Include the resolved rules and relevant code-index evidence in the files delegated to execution workers and require task-level rule activation. If no rule sources exist, record that no project rule package was found and proceed with the plan context.
 
-When `.planning/code-index/` exists, implementation workers should use it to locate callers, callees, imports, routes, data/resource reads and writes, and tests before editing. They must still read source files at `evidence_path` before making changes.
+When `.devflow/planning/code-index/` exists, implementation workers should use it to locate callers, callees, imports, routes, data/resource reads and writes, and tests before editing. They must still read source files at `evidence_path` before making changes.
 
 **Baseline and change-list contract:**
 Before assigning implementation work, read the relevant requirement baseline and change list when present:
-- `.planning/requirements/baseline.md`
-- `.planning/features/{功能名}/功能点梳理.md`
-- `.planning/features/{功能名}/前端技术方案.md`
-- `.planning/features/{功能名}/后端技术方案.md`
-- `.planning/features/{功能名}/*变更清单.md`
+- `.devflow/planning/requirements/baseline.md`
+- `.devflow/planning/features/{功能名}/功能点梳理.md`
+- `.devflow/planning/features/{功能名}/前端技术方案.md`
+- `.devflow/planning/features/{功能名}/后端技术方案.md`
+- `.devflow/planning/features/{功能名}/*变更清单.md`
 
-Legacy compatibility: if the `.planning/features/{功能名}/` documents are missing, workers may read root `features/{功能名}/` as historical/legacy input, but new generated workflow artifacts should stay under `.planning/features/{功能名}/`.
+Legacy compatibility: if the `.devflow/planning/features/{功能名}/` documents are missing, workers may read root `features/{功能名}/` as historical/legacy input, but new generated workflow artifacts should stay under `.devflow/planning/features/{功能名}/`.
 
 Workers must implement only confirmed scope. Pending baseline decisions or challenge items that affect scope, semantics, ownership, compatibility, or implementation cost must be reported as blockers, not silently resolved in code.
-Use `.planning/milestones/`, `.planning/requirements/`, `.planning/lessons/`, and phase `CONTEXT.md` as primary history when a task needs history. Treat `features/` or `.context/lessons/` as optional legacy/project-rule sources only when present.
+Use `.devflow/planning/milestones/`, `.devflow/planning/requirements/`, `.devflow/planning/lessons/`, and phase `CONTEXT.md` as primary history when a task needs history. Treat `features/` or `.devflow/context/lessons/` as optional legacy/project-rule sources only when present.
 
 **Available optional flags (documentation only — not automatically active):**
 - `--wave N` — Execute only Wave `N` in the phase. Use when you want to pace execution or stay inside usage limits.
@@ -107,7 +107,7 @@ Before any worker edits code for a task, it must state a compact Rule Activation
 ## Rule Activation
 - Task:
 - Affected layers/modules:
-- Spec index: .context/spec/index.md
+- Spec index: .devflow/context/spec/index.md
 - Stack spec resolved: (from index "Stack Specs" table)
 - Codebase spec resolved: (from index "Codebase Specs" table)
 - Depth spec files to check: (from domain index)
@@ -173,12 +173,12 @@ Preserve these generalized workflow rules from the project rule package when app
 8. **Spec Compliance Gate** — After task implementation and before marking complete, check the applicable depth spec.
 
    **Resolve spec paths through the index chain — do not hardcode directory names:**
-   1. Read `.context/spec/index.md` — the project's spec registry
-   2. From the "Stack Specs" table, find the stack spec path for your codebase (e.g., BACKEND → `.context/spec/stacks/python-fastapi-pydantic2-sqlalchemy-playwright.md`)
-   3. From the "Codebase Specs" table, find the codebase spec path (e.g., BACKEND → `.context/spec/backend/BACKEND.md`)
-   4. From "Detailed Spec Packages", find the domain index (e.g., `.context/spec/backend/index.md`) and read the relevant layer specs it lists
+   1. Read `.devflow/context/spec/index.md` — the project's spec registry
+   2. From the "Stack Specs" table, find the stack spec path for your codebase (e.g., BACKEND → `.devflow/context/spec/stacks/python-fastapi-pydantic2-sqlalchemy-playwright.md`)
+   3. From the "Codebase Specs" table, find the codebase spec path (e.g., BACKEND → `.devflow/context/spec/backend/BACKEND.md`)
+   4. From "Detailed Spec Packages", find the domain index (e.g., `.devflow/context/spec/backend/index.md`) and read the relevant layer specs it lists
 
-   The paths vary per project. `.context/spec/index.md` is the single source of truth for where specs live.
+   The paths vary per project. `.devflow/context/spec/index.md` is the single source of truth for where specs live.
 
    For every MUST rule in the resolved spec files that applies to the layers you modified, either:
    - Confirm the implementation satisfies it, with evidence; or
@@ -188,10 +188,10 @@ Preserve these generalized workflow rules from the project rule package when app
 
    ```yaml
    ## Spec Compliance Check
-   - Spec index: .context/spec/index.md
+   - Spec index: .devflow/context/spec/index.md
    - Stack spec: stacks/python-fastapi-pydantic2-sqlalchemy-playwright.md
    - Codebase spec: backend/BACKEND.md
-   - Code index evidence: `.planning/code-index/` checked or unavailable with reason
+   - Code index evidence: `.devflow/planning/code-index/` checked or unavailable with reason
    - Depth spec files checked: service.md, errors.md
    - MUST rules:
      - "Do not expose secrets in error payloads" → ✅ satisfied (secrets stripped in response schema)
@@ -209,7 +209,7 @@ Preserve these generalized workflow rules from the project rule package when app
    - A test strategy that caught real issues
    - A decision rationale that future tasks should know
 
-   If yes, write to `.context/lessons/YYYY-MM-DD-{slug}.md` following existing lesson format. If no, skip.
+   If yes, write to `.devflow/context/lessons/YYYY-MM-DD-{slug}.md` following existing lesson format. If no, skip.
 
    This applies to both positive patterns and regression prevention. Good practices deserve preservation as much as bug fixes.
 
@@ -228,7 +228,7 @@ Preserve these generalized workflow rules from the project rule package when app
 <checkpoint_resume>
 ## 断点续传机制
 
-执行前必须读取 `.planning/features/{功能名}/PROGRESS.md`，确定当前执行位置。
+执行前必须读取 `.devflow/planning/features/{功能名}/PROGRESS.md`，确定当前执行位置。
 
 ### 续传流程
 
@@ -239,15 +239,15 @@ Preserve these generalized workflow rules from the project rule package when app
 5. **更新进度**：每个任务完成后立即更新 PROGRESS.md（状态改为 `done`，记录完成时间戳）
 6. **Wave 完成检查**：当前 Wave 所有任务 `done` 后，将执行指针移到下一 Wave
 7. **全部完成**：所有 Wave 的 `done` 后，更新 PROGRESS.md 标记为 `completed`
-8. **写入结构化元数据**：全部完成后写入 `.planning/features/{功能名}/PROGRESS.meta.json`，字段见 `feature-development.yaml` 中 `steps[execute].meta_output.fields`：`task_completed`, `task_total`, `build_passed`, `test_passed`。
+8. **写入结构化元数据**：全部完成后写入 `.devflow/planning/features/{功能名}/PROGRESS.meta.json`，字段见 `feature-development.yaml` 中 `steps[execute].meta_output.fields`：`task_completed`, `task_total`, `build_passed`, `test_passed`。
 
 ### 清除上下文后续传
 
 当会话上下文用尽或用户手动清除上下文后：
 
 1. 用户重新调用 `workflow-execute-phase <功能名>`
-2. 读取 `.planning/features/{功能名}/PROGRESS.md` 找到断点
-3. 读取 `.planning/features/{功能名}/变更清单.md` 获取当前 Wave 任务详情
+2. 读取 `.devflow/planning/features/{功能名}/PROGRESS.md` 找到断点
+3. 读取 `.devflow/planning/features/{功能名}/变更清单.md` 获取当前 Wave 任务详情
 4. 从断点继续执行，无需重读已完成的上下文
 
 ### 自包含任务要求

package/plugins/devflow-implementation/skills/workflow-execute-phase/references/execute-phase.md

@@ -63,13 +63,15 @@
 ```text
 execute-phase
   → code-review
-  → workflow-generate-mainflow-cases（如适用）
+  → workflow-human-acceptance
   → workflow-run-acceptance-tests
   → CP-4 验收结果确认
   → workflow-release-closeout
 ```
 
-`workflow-run-acceptance-tests` 只消费冻结的 `TC-*`。每个已确认验收条件都必须覆盖；异常、边界、权限、兼容和架构风险用例不能被主流程用例替代。验收结果保存在 `.planning/test-runs/{feature}/acceptance-results.json`。
+`workflow-generate-mainflow-cases` 不是独立主链步骤，而是 `workflow-run-acceptance-tests` 绑定阶段的组成部分：automated 的 ui / api_flow TC 需要先生成 v1 DSL 并批准执行计划才能执行。
+
+`workflow-run-acceptance-tests` 只消费冻结的 `TC-*`。每个已确认验收条件都必须覆盖；异常、边界、权限、兼容和架构风险用例不能被主流程用例替代。验收结果保存在 `.devflow/planning/test-runs/{feature}/acceptance-results.json`。
 
 只有当所有冻结 `TC-*` 已执行且通过、无 `failed`/`blocked`，且代码索引审计通过时，才允许进入 `workflow-release-closeout`。版本收口负责生成项目自己的里程碑收口记录并更新项目状态；它不生成旧式人工验收或独立验证报告。
 

package/plugins/devflow-intel/agents/project-scout.md

@@ -14,7 +14,7 @@ autoloadSkills:
 
 Act as a bounded read-only evidence collector, not a planner. Use the code index first, then make at most three targeted reads or searches needed to answer the assigned question. Do not inspect adjacent systems merely to be thorough.
 
-Before using `read`, `grep`, or `devflow_code_index`, resolve the project root by walking upward from the runtime directory to the nearest `.devflow/project.json`, `.planning/code-index/index.sqlite`, or `.planning/PROJECT.md`. Treat nested directories such as `drama-ad/backend` as codebases, not Devflow project roots; `.planning` must always be resolved from the project root.
+Before using `read`, `grep`, or `devflow_code_index`, resolve the project root by walking upward from the runtime directory to the nearest `.devflow/project.json`, `.devflow/planning/code-index/index.sqlite`, or `.devflow/planning/PROJECT.md`. Treat nested directories such as `drama-ad/backend` as codebases, not Devflow project roots; `.devflow/planning` must always be resolved from the project root.
 
 If the index is missing, stale, fails validation, or has no useful hit, continue with a bounded `grep`/`rg` or LSP fallback over the registered codebase roots. Return `degraded_index_coverage` and the exact fallback scope; never present fallback relations as index facts.
 

package/plugins/devflow-intel/extensions/devflow-intel.ts

@@ -26,19 +26,20 @@ function resolveSkillRoot(cwd: string): string {
 /**
  * Resolve the Devflow project root from the runtime directory. A codebase
  * (for example `drama-ad/backend`) may be nested below the project root;
- * `.planning` belongs to the nearest ancestor project, never to the codebase
+ * `.devflow/planning` belongs to the nearest ancestor project, never to the codebase
  * directory itself.
  */
 function resolveProjectRoot(cwd: string): string {
   let current = path.resolve(cwd);
   while (true) {
-    if (
-      existsSync(path.join(current, ".devflow", "project.json")) ||
-      existsSync(path.join(current, ".planning", "code-index", "index.sqlite")) ||
-      existsSync(path.join(current, ".planning", "PROJECT.md"))
-    ) {
-      return current;
-    }
+    if (existsSync(path.join(current, ".devflow", "project.json"))) return current;
+    const parent = path.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  current = path.resolve(cwd);
+  while (true) {
+    if (existsSync(path.join(current, ".git"))) return current;
     const parent = path.dirname(current);
     if (parent === current) break;
     current = parent;
@@ -101,7 +102,7 @@ export default function devflowIntel(pi: ExtensionAPI) {
     }),
     approval: (args) => {
       const action = (args as { action?: string }).action;
-      // scan 写 .planning/code-index，按 exec 询问；validate/audit/query 只读，免确认。
+      // scan 写 .devflow/planning/code-index，按 exec 询问；validate/audit/query 只读，免确认。
       return ["scan", "domain-import"].includes(action ?? "") ? "exec" : "read";
     },
     async execute(_id, params, _signal, _onUpdate, ctx) {
@@ -110,26 +111,26 @@ export default function devflowIntel(pi: ExtensionAPI) {
       const script = path.join(skillRoot, "workflow-code-index/scripts/code_index.py");
       const args = ["python3", script, params.action];
       if (params.action === "scan") {
-        args.push("--root", projectRoot, "--output", ".planning/code-index");
+        args.push("--root", projectRoot, "--output", ".devflow/planning/code-index");
         if (params.changedFiles.length > 0) args.push("--changed-files", ...params.changedFiles);
       } else if (params.action === "validate") {
-        args.push("--index", ".planning/code-index");
+        args.push("--index", ".devflow/planning/code-index");
         args.push("--level", params.validationLevel);
         if (params.snapshot) args.push("--snapshot", params.snapshot);
       } else if (params.action === "audit") {
-        args.push("--root", projectRoot, "--index", ".planning/code-index", "--skill-root", skillRoot);
+        args.push("--root", projectRoot, "--index", ".devflow/planning/code-index", "--skill-root", skillRoot);
         args.push("--level", params.validationLevel === "fast" ? "publish" : params.validationLevel);
         if (params.snapshot) args.push("--snapshot", params.snapshot);
       } else if (params.action === "query") {
         if (!params.term) {
           return render({ ok: false, exitCode: 2, stdout: "", stderr: "term is required" }, {});
         }
-        args.push("--index", ".planning/code-index", "--term", params.term, "--limit", String(params.limit));
+        args.push("--index", ".devflow/planning/code-index", "--term", params.term, "--limit", String(params.limit));
         if (params.snapshot) args.push("--snapshot", params.snapshot);
       } else {
         if (params.action === "search-content") {
           if (!params.term) return render({ ok: false, exitCode: 2, stdout: "", stderr: "term is required" }, {});
-          args.push("--index", ".planning/code-index", "--term", params.term, "--limit", String(params.limit));
+          args.push("--index", ".devflow/planning/code-index", "--term", params.term, "--limit", String(params.limit));
           args.push("--project-id", params.projectId);
           args.push("--match-kind", params.matchKind === "phrase" ? "exact_phrase" : params.matchKind);
           if (params.repository) args.push("--repository", params.repository);
@@ -138,14 +139,14 @@ export default function devflowIntel(pi: ExtensionAPI) {
           return render(await run(args, projectRoot), { action: params.action, projectRoot });
         } else if (params.action === "resolve-domain") {
           if (!params.term) return render({ ok: false, exitCode: 2, stdout: "", stderr: "term is required" }, {});
-          args.push("--index", ".planning/code-index", "--term", params.term, "--project-id", params.projectId, "--limit", String(params.limit));
+          args.push("--index", ".devflow/planning/code-index", "--term", params.term, "--project-id", params.projectId, "--limit", String(params.limit));
           if (params.mappingRevision) args.push("--mapping-revision", params.mappingRevision);
           return render(await run(args, projectRoot), { action: params.action, projectRoot });
         } else if (params.action === "query-plan") {
           if (!params.plan) return render({ ok: false, exitCode: 2, stdout: "", stderr: "plan is required" }, {});
           const plan = { ...params.plan };
           if (plan.limit === undefined) plan.limit = params.limit;
-          args.push("--index", ".planning/code-index", "--project-id", params.projectId, "--plan", JSON.stringify(plan));
+          args.push("--index", ".devflow/planning/code-index", "--project-id", params.projectId, "--plan", JSON.stringify(plan));
           if (params.snapshot) args.push("--snapshot", params.snapshot);
           return render(await run(args, projectRoot), { action: params.action, projectRoot });
         } else if (params.action === "domain-import") {
@@ -154,7 +155,7 @@ export default function devflowIntel(pi: ExtensionAPI) {
           const bundlePath = path.join(bundleDir, "bundle.json");
           try {
             writeFileSync(bundlePath, JSON.stringify(params.bundle), { encoding: "utf8", mode: 0o600 });
-            args.push("--index", ".planning/code-index", "--project-id", params.projectId, "--bundle", bundlePath);
+            args.push("--index", ".devflow/planning/code-index", "--project-id", params.projectId, "--bundle", bundlePath);
             if (params.expectedRevision) args.push("--expected-revision", params.expectedRevision);
             return render(await run(args, projectRoot), { action: params.action, projectRoot });
           } finally {
@@ -163,13 +164,13 @@ export default function devflowIntel(pi: ExtensionAPI) {
         }
         if (params.action === "impact") {
           if (!params.entity) return render({ ok: false, exitCode: 2, stdout: "", stderr: "entity is required" }, {});
-          args.push("--index", ".planning/code-index", "--entity", params.entity, "--depth", String(params.depth), "--limit", String(params.limit));
+          args.push("--index", ".devflow/planning/code-index", "--entity", params.entity, "--depth", String(params.depth), "--limit", String(params.limit));
           if (params.snapshot) args.push("--snapshot", params.snapshot);
           if (params.changeType) args.push("--change-type", params.changeType);
           return render(await run(args, projectRoot), { action: params.action, projectRoot });
         }
         if (!params.object) return render({ ok: false, exitCode: 2, stdout: "", stderr: "object is required" }, {});
-        args.push("--index", ".planning/code-index", "--object", params.object, "--depth", String(params.depth), "--limit", String(params.limit));
+        args.push("--index", ".devflow/planning/code-index", "--object", params.object, "--depth", String(params.depth), "--limit", String(params.limit));
         args.push("--direction", params.direction);
         if (params.snapshot) args.push("--snapshot", params.snapshot);
         if (params.includeHeuristic) args.push("--include-heuristic");