@guanlin4924/devflow-pi 0.1.92 → 0.1.94

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (156) hide show
  1. package/README.md +6 -6
  2. package/package.json +1 -1
  3. package/plugins/devflow-core/extensions/devflow-core.ts +87 -33
  4. package/plugins/devflow-core/runtime/hooks/context_sync_gate.py +3 -3
  5. package/plugins/devflow-core/runtime/hooks/hook_common.py +65 -11
  6. package/plugins/devflow-core/runtime/hooks/start.py +13 -13
  7. package/plugins/devflow-core/skills/wireframe-proposal/SKILL.md +2 -2
  8. package/plugins/devflow-core/skills/wireframe-validate/SKILL.md +4 -4
  9. package/plugins/devflow-core/skills/workflow-orchestrator/SKILL.md +19 -19
  10. package/plugins/devflow-core/skills/workflow-orchestrator/agents/openai.yaml +2 -2
  11. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/acceptance_test_runner.py +5 -5
  12. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/advance_state.rb +9 -9
  13. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/api_test_matrix.py +2 -2
  14. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/architecture_assessment.rb +1 -1
  15. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/architecture_brief.rb +1 -1
  16. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/architecture_feasibility.rb +1 -1
  17. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/business_invalidation.rb +5 -5
  18. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/business_model_commit.rb +4 -4
  19. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/business_model_validate.py +1 -1
  20. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/business_source_resolver.rb +4 -4
  21. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/checker_adapter.rb +7 -7
  22. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/control_io.rb +51 -7
  23. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/cross_track_consistency_check.rb +1 -1
  24. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/execution_contract.rb +6 -6
  25. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/gate_runtime.rb +3 -3
  26. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/init_state.rb +5 -5
  27. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/init_workflow.rb +5 -5
  28. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/inspect_state.rb +13 -13
  29. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/machine_evidence.rb +3 -3
  30. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/manage_lessons.rb +7 -7
  31. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/parallel_recover.rb +2 -2
  32. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/parallel_run.rb +3 -3
  33. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/phase_ownership.rb +6 -6
  34. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/repair_control_plane.rb +1 -1
  35. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/requirement_coverage.rb +1 -1
  36. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/requirement_graph.rb +3 -3
  37. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/review_preflight.py +3 -3
  38. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/review_run.py +18 -18
  39. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/runtime_context_collector.rb +3 -3
  40. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/session_rollover.rb +4 -4
  41. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/static_runtime_context_collector.rb +2 -2
  42. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/sync_artifacts.rb +5 -5
  43. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/tdd_evidence.py +3 -3
  44. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/test_command_policy.py +2 -2
  45. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/test_task_binding_check.py +3 -3
  46. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/update_triage_route.rb +3 -3
  47. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/validate_state.rb +6 -6
  48. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/wireframe_commit.rb +5 -5
  49. package/plugins/devflow-core/skills/workflow-orchestrator/scripts/wireframe_validate.py +1 -1
  50. package/plugins/devflow-core/skills/workflow-orchestrator/templates/acceptance-remediation.yaml +12 -12
  51. package/plugins/devflow-core/skills/workflow-orchestrator/templates/feature-development.yaml +205 -205
  52. package/plugins/devflow-core/skills/workflow-pipeline/SKILL.md +3 -3
  53. package/plugins/devflow-core/skills/workflow-pipeline/references/pipeline-flow.md +10 -10
  54. package/plugins/devflow-core/skills/workflow-project-context/SKILL.md +14 -14
  55. package/plugins/devflow-core/skills/workflow-project-context/assets/agents-md-template.md +7 -7
  56. package/plugins/devflow-core/skills/workflow-project-context/assets/codebase-backend-spec-template.md +4 -4
  57. package/plugins/devflow-core/skills/workflow-project-context/assets/codebase-frontend-spec-template.md +4 -4
  58. package/plugins/devflow-core/skills/workflow-project-context/assets/codebase-navigation-template.md +1 -1
  59. package/plugins/devflow-core/skills/workflow-project-context/assets/context-domain-index-template.md +4 -4
  60. package/plugins/devflow-core/skills/workflow-project-context/assets/context-spec-index-template.md +10 -10
  61. package/plugins/devflow-core/skills/workflow-project-context/assets/execution-contract-template.md +2 -2
  62. package/plugins/devflow-core/skills/workflow-project-context/assets/navigation-index-template.md +18 -18
  63. package/plugins/devflow-core/skills/workflow-project-context/assets/project-initialization-template.md +32 -32
  64. package/plugins/devflow-core/skills/workflow-project-context/assets/rules-index-template.md +30 -30
  65. package/plugins/devflow-core/skills/workflow-project-context/assets/state-template.md +7 -7
  66. package/plugins/devflow-core/skills/workflow-project-context/references/navigation-guide.md +37 -37
  67. package/plugins/devflow-core/skills/workflow-project-context/scripts/validate_initialization.py +22 -17
  68. package/plugins/devflow-design/skills/workflow-api-call-guide/SKILL.md +4 -4
  69. package/plugins/devflow-design/skills/workflow-api-contract/SKILL.md +8 -8
  70. package/plugins/devflow-design/skills/workflow-api-supplement/SKILL.md +5 -5
  71. package/plugins/devflow-design/skills/workflow-architecture-feasibility/SKILL.md +1 -1
  72. package/plugins/devflow-design/skills/workflow-backend-tech-spec/SKILL.md +39 -39
  73. package/plugins/devflow-design/skills/workflow-backend-tech-spec/assets/backend-spec-template.md +10 -10
  74. package/plugins/devflow-design/skills/workflow-backend-tech-spec/references/affected-module-exploration.md +2 -2
  75. package/plugins/devflow-design/skills/workflow-backend-tech-spec/references/code-explore-guide.md +1 -1
  76. package/plugins/devflow-design/skills/workflow-backend-tech-spec/references/project-rule-contract.md +20 -20
  77. package/plugins/devflow-design/skills/workflow-design-rule-pack/SKILL.md +8 -8
  78. package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/index.md +3 -3
  79. package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/recommendations/accessibility.md +2 -2
  80. package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/recommendations/component-library.md +2 -2
  81. package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/recommendations/design-systems.md +1 -1
  82. package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/recommendations/responsive-grid.md +2 -2
  83. package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/recommendations/stack-guidelines.md +6 -6
  84. package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/recommendations/ux-patterns.md +2 -2
  85. package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/tokens/project-tokens.md +1 -1
  86. package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/tools/ui-ux-pro-max/SKILL.md +12 -12
  87. package/plugins/devflow-design/skills/workflow-design-rule-pack/scripts/install.py +2 -2
  88. package/plugins/devflow-design/skills/workflow-feature-breakdown/SKILL.md +30 -30
  89. package/plugins/devflow-design/skills/workflow-feature-breakdown/assets/output-template.md +2 -2
  90. package/plugins/devflow-design/skills/workflow-frontend-tech-spec/SKILL.md +41 -41
  91. package/plugins/devflow-design/skills/workflow-frontend-tech-spec/assets/frontend-spec-template.md +15 -15
  92. package/plugins/devflow-design/skills/workflow-frontend-tech-spec/references/affected-module-exploration.md +2 -2
  93. package/plugins/devflow-design/skills/workflow-frontend-tech-spec/references/project-rule-contract.md +25 -25
  94. package/plugins/devflow-design/skills/workflow-integration-verify/SKILL.md +13 -13
  95. package/plugins/devflow-design/skills/workflow-ui-spec/SKILL.md +23 -23
  96. package/plugins/devflow-design/skills/workflow-ui-spec/assets/ui-spec-template.md +3 -3
  97. package/plugins/devflow-implementation/agents/implementation-worker.md +2 -2
  98. package/plugins/devflow-implementation/skills/workflow-bug-fix/SKILL.md +9 -9
  99. package/plugins/devflow-implementation/skills/workflow-bug-fix/references/lesson-format.md +2 -2
  100. package/plugins/devflow-implementation/skills/workflow-bug-fix/references/root-cause-ladder.md +1 -1
  101. package/plugins/devflow-implementation/skills/workflow-change-plan/SKILL.md +17 -17
  102. package/plugins/devflow-implementation/skills/workflow-change-plan/references/code-conventions.md +1 -1
  103. package/plugins/devflow-implementation/skills/workflow-change-plan/references/output-template.md +3 -3
  104. package/plugins/devflow-implementation/skills/workflow-change-plan/references/project-rule-contract.md +16 -16
  105. package/plugins/devflow-implementation/skills/workflow-execute-phase/SKILL.md +38 -38
  106. package/plugins/devflow-implementation/skills/workflow-execute-phase/references/execute-phase.md +1 -1
  107. package/plugins/devflow-intel/agents/project-scout.md +3 -1
  108. package/plugins/devflow-intel/extensions/devflow-intel.ts +20 -19
  109. package/plugins/devflow-intel/skills/code-index-query/SKILL.md +8 -6
  110. package/plugins/devflow-intel/skills/workflow-code-index/SKILL.md +12 -12
  111. package/plugins/devflow-intel/skills/workflow-code-index/references/discovery.md +2 -2
  112. package/plugins/devflow-intel/skills/workflow-code-index/references/query-guide.md +1 -1
  113. package/plugins/devflow-intel/skills/workflow-code-index/scripts/code_index.py +8 -8
  114. package/plugins/devflow-intel/skills/workflow-code-index/scripts/core/discovery.py +2 -2
  115. package/plugins/devflow-intel/skills/workflow-code-index/scripts/core/scanner.py +4 -1
  116. package/plugins/devflow-intel/skills/workflow-code-index/scripts/validators/project_binding_check.py +4 -4
  117. package/plugins/devflow-intel/skills/workflow-context-sync/SKILL.md +14 -14
  118. package/plugins/devflow-intel/skills/workflow-context-sync/scripts/context_sync_cursor.py +2 -2
  119. package/plugins/devflow-intel/skills/workflow-update-navigation/SKILL.md +26 -26
  120. package/plugins/devflow-intel/skills/workflow-update-navigation/references/incremental-update-guide.md +2 -2
  121. package/plugins/devflow-quality/skills/code-review/SKILL.md +13 -13
  122. package/plugins/devflow-quality/skills/code-review/references/spec-checklist.md +1 -1
  123. package/plugins/devflow-quality/skills/workflow-acceptance-test-design/SKILL.md +8 -8
  124. package/plugins/devflow-quality/skills/workflow-gen-test-guide/SKILL.md +6 -6
  125. package/plugins/devflow-quality/skills/workflow-gen-test-guide/legacy/SKILL.md +14 -14
  126. package/plugins/devflow-quality/skills/workflow-generate-mainflow-cases/SKILL.md +23 -23
  127. package/plugins/devflow-quality/skills/workflow-generate-mainflow-cases/references/codebase-discovery.md +9 -9
  128. package/plugins/devflow-quality/skills/workflow-generate-mainflow-cases/references/project-dsl-contract.md +1 -1
  129. package/plugins/devflow-quality/skills/workflow-generate-mainflow-cases/scripts/compile_dsl.py +2 -2
  130. package/plugins/devflow-quality/skills/workflow-generate-mainflow-cases/scripts/discover_codebases.py +2 -2
  131. package/plugins/devflow-quality/skills/workflow-release-closeout/SKILL.md +15 -15
  132. package/plugins/devflow-quality/skills/workflow-run-acceptance-tests/SKILL.md +5 -5
  133. package/plugins/devflow-requirements/skills/requirement-feasibility-review/SKILL.md +1 -1
  134. package/plugins/devflow-requirements/skills/workflow-demand-clarify/SKILL.md +10 -10
  135. package/plugins/devflow-requirements/skills/workflow-domain-modeling/SKILL.md +25 -25
  136. package/plugins/devflow-requirements/skills/workflow-requirement-baseline/SKILL.md +49 -49
  137. package/plugins/devflow-requirements/skills/workflow-requirement-baseline/assets/baseline-template.md +22 -22
  138. package/plugins/devflow-requirements/skills/workflow-requirement-baseline/references/antipatterns.md +3 -3
  139. package/plugins/devflow-requirements/skills/workflow-requirement-baseline/references/challenge-review-guide.md +3 -3
  140. package/plugins/devflow-requirements/skills/workflow-requirement-baseline/references/project-context-guide.md +11 -11
  141. package/plugins/devflow-requirements/skills/workflow-requirement-baseline/references/questioning.md +1 -1
  142. package/plugins/devflow-requirements/skills/workflow-requirement-baseline/references/requirement-review-checklist.md +4 -4
  143. package/plugins/devflow-requirements/skills/workflow-requirement-triage/SKILL.md +16 -16
  144. package/plugins/devflow-requirements/skills/workflow-wayfinder/SKILL.md +6 -6
  145. package/src/cli.ts +15 -0
  146. package/src/constants.ts +1 -1
  147. package/src/initialization-store.ts +3 -2
  148. package/src/project-context.ts +36 -14
  149. package/src/project-documents.ts +61 -61
  150. package/src/project-initializer.ts +23 -9
  151. package/src/project-layout.ts +217 -0
  152. package/src/runtime.ts +3 -3
  153. package/templates/commands/start.md +4 -4
  154. package/templates/omp/AGENTS.md +1 -1
  155. package/templates/omp/hook-config.json +7 -7
  156. package/templates/omp/index-policy.json +8 -8
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: workflow-pipeline
3
- description: Use when running or resuming the full .planning delivery pipeline from requirements through implementation, frozen acceptance tests, and Devflow release closeout.
3
+ description: Use when running or resuming the full .devflow/planning delivery pipeline from requirements through implementation, frozen acceptance tests, and Devflow release closeout.
4
4
  ---
5
5
 
6
6
  <objective>
@@ -97,11 +97,11 @@ devflow_state(action="inspect")
97
97
  | `blocked` | 将阻塞原因报告给用户 |
98
98
  | `workflow_complete` | 报告完成,流程结束 |
99
99
 
100
- **降级策略**:`.planning/STATE.md` 是唯一规范状态源。如果 `inspect_state.rb` 不可用或 STATE 缺少 YAML front matter,报告主流程阻塞并提示运行 `init_workflow.rb --write`、`init_state.rb --write` 修复控制面;不要读取已废弃的 `.planning/pipeline-state.md` 作为状态来源。
100
+ **降级策略**:`.devflow/planning/STATE.md` 是唯一规范状态源。如果 `inspect_state.rb` 不可用或 STATE 缺少 YAML front matter,报告主流程阻塞并提示运行 `init_workflow.rb --write`、`init_state.rb --write` 修复控制面;不要读取已废弃的 `.devflow/planning/pipeline-state.md` 作为状态来源。
101
101
 
102
102
  ### 轨道参数传递
103
103
 
104
- `--track A` 或 `--track B` 参数会写入 `.planning/STATE.md` 的 `active_track` 字段。orchestrator 读取该字段后:
104
+ `--track A` 或 `--track B` 参数会写入 `.devflow/planning/STATE.md` 的 `active_track` 字段。orchestrator 读取该字段后:
105
105
 
106
106
  - **active_track: A** → 只路由 Track A 允许步骤,Track A 完成后以 `track_scope_complete` 阻断,不进入完整交付。
107
107
  - **active_track: B** → 新需求从完整需求主链开始;前端设计步骤依赖 `api-contract` 完成。Track B 完成后以 `track_scope_complete` 阻断。
@@ -13,14 +13,14 @@ workflow-pipeline 启动
13
13
  ┌─────────────────────────────────────┐
14
14
  │ Step 1: 项目初始化 │
15
15
  │ workflow-project-context │
16
- │ 输出: .planning/PROJECT.md │
16
+ │ 输出: .devflow/planning/PROJECT.md │
17
17
  └─────────────────────────────────────┘
18
18
  │
19
19
  ▼
20
20
  ┌─────────────────────────────────────┐
21
21
  │ Step 2: 需求完善 │
22
22
  │ workflow-requirement-baseline │
23
- │ 输出: .planning/requirements/baseline.md │
23
+ │ 输出: .devflow/planning/requirements/baseline.md │
24
24
  │ 门禁: 冲突/复用/过度工程/替代方案已拍板 │
25
25
  └──────────────┬──────────────────────┘
26
26
  │ ↑
@@ -57,7 +57,7 @@ workflow-pipeline 启动
57
57
  │ Step 4: 变更清单 │
58
58
  │ workflow-change-plan │
59
59
  │ 输入: 前端+后端技术方案 │
60
- │ 输出: .planning/features/{功能名}/变更清单.md │
60
+ │ 输出: .devflow/planning/features/{功能名}/变更清单.md │
61
61
  └──────────────┬──────────────────────┘
62
62
  │ ↑
63
63
  ▼ │ 用户拒绝
@@ -72,7 +72,7 @@ workflow-pipeline 启动
72
72
  ┌─────────────────────────────────────┐
73
73
  │ Step 4.5: Phase 结构初始化 │
74
74
  │ phase-init │
75
- │ 创建 ROADMAP.md + .planning/phases/ │
75
+ │ 创建 ROADMAP.md + .devflow/planning/phases/ │
76
76
  │ 桥接 workflow 产物到 phase 结构 │
77
77
  └─────────────────────────────────────┘
78
78
  │
@@ -90,7 +90,7 @@ workflow-pipeline 启动
90
90
  │ Step 5.5: 代码索引刷新 │
91
91
  │ workflow-code-index │
92
92
  │ 刷新 Symbol/Relation/Call Graph │
93
- │ 输出 .planning/code-index/ + AUDIT │
93
+ │ 输出 .devflow/planning/code-index/ + AUDIT │
94
94
  └──────────────┬──────────────────────┘
95
95
  │ ↑
96
96
  ▼ │ 索引审查失败
@@ -129,13 +129,13 @@ workflow-pipeline 启动
129
129
 
130
130
  ## 断点续接
131
131
 
132
- 每次启动时,workflow-pipeline 通过 `devflow_state(action="inspect")` 读取规范状态文件 `.planning/STATE.md`,由 inspector 返回当前动作和下一节点:
132
+ 每次启动时,workflow-pipeline 通过 `devflow_state(action="inspect")` 读取规范状态文件 `.devflow/planning/STATE.md`,由 inspector 返回当前动作和下一节点:
133
133
 
134
134
  ```
135
- 1. 校验 `.planning/STATE.md` 的 YAML front matter、workflow 配置和 artifact registry
135
+ 1. 校验 `.devflow/planning/STATE.md` 的 YAML front matter、workflow 配置和 artifact registry
136
136
  2. 根据 inspector 返回的 `action` 路由到下一步、当前步骤、确认、失败分支或并行窗口
137
137
  3. 如果控制面缺失或校验失败,报告阻塞并提示运行 `init_workflow.rb --write`、`init_state.rb --write` 修复
138
- 4. `.planning/pipeline-state.md` 已废弃,不作为恢复状态来源
138
+ 4. `.devflow/planning/pipeline-state.md` 已废弃,不作为恢复状态来源
139
139
  ```
140
140
 
141
141
  ## 简化流程门禁
@@ -144,11 +144,11 @@ workflow-pipeline 启动
144
144
 
145
145
  ## 需求拍板门禁
146
146
 
147
- Step 2 之后必须检查 `.planning/requirements/baseline.md`:
147
+ Step 2 之后必须检查 `.devflow/planning/requirements/baseline.md`:
148
148
 
149
149
  - `待确认事项`
150
150
  - `反向审视与用户拍板`
151
151
  - `下游输入契约`
152
- - `.planning/requirements/baseline.meta.json` 中 `review_status` 必须为 `passed`,且 `blocking_pending_count`、`critical_image_missing_count`、`challenge_pending_count`、`code_reality_missing_count` 必须全为 0
152
+ - `.devflow/planning/requirements/baseline.meta.json` 中 `review_status` 必须为 `passed`,且 `blocking_pending_count`、`critical_image_missing_count`、`challenge_pending_count`、`code_reality_missing_count` 必须全为 0
153
153
 
154
154
  影响 scope、语义、归属、兼容性或实现成本的未确认项是阻塞项。不能把它们传入技术方案或变更清单当成已确认范围。
@@ -13,7 +13,7 @@ This skill is the project-context interface wrapper. Prefer using it from a dele
13
13
 
14
14
  The control database under the product data directory is the only machine authority for initialization. `.devflow/project.json` locates project identity. Workspaces, scan configurations, input snapshots, runs, facts, evidence, index references, current pointers, document jobs, and authority revisions are stored through `devflow_project_context`.
15
15
 
16
- Never determine current initialization state from Markdown, file mtimes, or duplicated run markers. Never write `.planning/STATE.md`, execution contracts, workflow artifacts, requirements, approvals, or user instruction files.
16
+ Never determine current initialization state from Markdown, file mtimes, or duplicated run markers. Never write `.devflow/planning/STATE.md`, execution contracts, workflow artifacts, requirements, approvals, or user instruction files.
17
17
 
18
18
  Human-readable files are projections. Existing unmanaged files are preserved; the generator writes a `.devflow-pending` sibling when it cannot prove that the current file is its previous output.
19
19
 
@@ -22,12 +22,12 @@ Human-readable files are projections. Existing unmanaged files are preserved; th
22
22
  Before choosing a tool action, inspect the generated external contract when it exists:
23
23
 
24
24
  ```text
25
- .planning/interface-index.json
26
- .planning/knowledge-index.json
27
- .context/knowledge/interfaces/
25
+ .devflow/planning/interface-index.json
26
+ .devflow/planning/knowledge-index.json
27
+ .devflow/context/knowledge/interfaces/
28
28
  ```
29
29
 
30
- `.planning/interface-index.json` is the machine-readable contract for external AI/tool callers. It lists callable interfaces, actions, request shapes, response shapes, read/write boundaries, and approval tier. `.context/knowledge/interfaces/` is the human-readable projection of the same contract. `.planning/knowledge-index.json` connects interface nodes, source documents, knowledge pages, code facts, and reserved BUG/FIX/INCIDENT/LESSON nodes.
30
+ `.devflow/planning/interface-index.json` is the machine-readable contract for external AI/tool callers. It lists callable interfaces, actions, request shapes, response shapes, read/write boundaries, and approval tier. `.devflow/context/knowledge/interfaces/` is the human-readable projection of the same contract. `.devflow/planning/knowledge-index.json` connects interface nodes, source documents, knowledge pages, code facts, and reserved BUG/FIX/INCIDENT/LESSON nodes.
31
31
 
32
32
  If the contract files do not exist yet, use the rules in this skill to run initialization and then report that the interface contract was created. If they exist, do not invent action shapes from memory; follow the contract unless it conflicts with this skill's safety rules.
33
33
 
@@ -44,10 +44,10 @@ Use a delegated sub-agent for non-trivial project-context work:
44
44
 
45
45
  The delegated sub-agent must:
46
46
 
47
- 1. read `.planning/interface-index.json` when available;
47
+ 1. read `.devflow/planning/interface-index.json` when available;
48
48
  2. choose the narrowest safe action;
49
49
  3. call `devflow_project_context` or `devflow_skill_script` only through the documented action shape;
50
- 4. read `.planning/knowledge-index.json` and `.planning/code-index/` only when needed for evidence;
50
+ 4. read `.devflow/planning/knowledge-index.json` and `.devflow/planning/code-index/` only when needed for evidence;
51
51
  5. return a result pack to the parent agent.
52
52
 
53
53
  The parent agent should not directly compose multi-step initialization calls unless the task is a simple status read or the delegated agent path is unavailable.
@@ -59,7 +59,7 @@ The parent agent should not directly compose multi-step initialization calls unl
59
59
  | `initialize-project` | `workspaces` → `config` → `scan` → `project-context-db-validate` | Full mode by default; static only; no workflow state mutation. |
60
60
  | `query-facts` | `query` | Requires a fixed `snapshotId`; follow pagination. |
61
61
  | `query-api` | `query(kind="api")` plus code-index readback when implementation detail is needed | Do not scan just to answer from an existing fresh snapshot. |
62
- | `query-knowledge` | read `knowledge-index.json` and relevant `.context/knowledge/*` | Use `query` only for machine facts. |
62
+ | `query-knowledge` | read `knowledge-index.json` and relevant `.devflow/context/knowledge/*` | Use `query` only for machine facts. |
63
63
  | `query-bug-knowledge` | read reserved/actual BUG/FIX/INCIDENT/LESSON nodes, then query/diff if code facts are needed | Do not invent BUG records. |
64
64
  | `refresh-after-code-change` | `scan` → optional `diff` | Use a new request ID. Compare old and new snapshots when impact is requested. |
65
65
  | `refresh-after-bug-fix` | verify BUG/FIX/LESSON docs if present → `scan` → optional `diff` | `scan` refreshes facts; it does not fix the bug. |
@@ -85,7 +85,7 @@ Every delegated project-context result must return this structure in prose or JS
85
85
  - snapshotId
86
86
  - codeIndexGeneration
87
87
  - sourceSnapshot
88
- - interfaceContract: .planning/interface-index.json if used
88
+ - interfaceContract: .devflow/planning/interface-index.json if used
89
89
 
90
90
  ## Evidence
91
91
  - facts, knowledge pages, code facts, document paths, or diagnostics used
@@ -129,10 +129,10 @@ Do not infer move/copy identity from timestamps or similar directory names.
129
129
 
130
130
  ## Legacy input
131
131
 
132
- Legacy `.planning` or `.context` files are never read as current machine facts. On an explicit import request, register selected files as historical material in shadow mode:
132
+ Legacy `.devflow/planning` or `.devflow/context` files are never read as current machine facts. On an explicit import request, register selected files as historical material in shadow mode:
133
133
 
134
134
  ```text
135
- devflow_project_context(action="import-legacy", sources=[".planning/PROJECT.md"], requestId="<stable-request-id>")
135
+ devflow_project_context(action="import-legacy", sources=[".devflow/planning/PROJECT.md"], requestId="<stable-request-id>")
136
136
  ```
137
137
 
138
138
  Imported prose remains `historical`, `observed=false`, and `approved=false`. Do not import requirements or design approval merely because text looks final.
@@ -161,11 +161,11 @@ The scan freezes the complete file manifest, including uncommitted and untracked
161
161
 
162
162
  Python uses AST scopes. TypeScript, JavaScript, and Ruby use conservative structured scopes with declared inference limits. Other languages use file-level generic extraction. Declarations are not calls. Receiver or dynamic calls stay unresolved unless a supported resolver proves a target. Name uniqueness alone is at most an inference and generic text never becomes an exact method edge.
163
163
 
164
- Every full scan publishes an immutable generation under `.planning/code-index/snapshots/<generation>/`; root index files are compatibility projections. Current queries reject stale committed, modified, deleted, or newly added input. Historical queries name a generation. Relation traversal is cycle-safe and exposes depth, result limits, uncertainty, and truncation.
164
+ Every full scan publishes an immutable generation under `.devflow/planning/code-index/snapshots/<generation>/`; root index files are compatibility projections. Current queries reject stale committed, modified, deleted, or newly added input. Historical queries name a generation. Relation traversal is cycle-safe and exposes depth, result limits, uncertainty, and truncation.
165
165
 
166
166
  ## Human-readable documents
167
167
 
168
- Program-owned projections are `.planning/PROJECT.md`, `.planning/toolchain.md`, `.planning/navigation/INDEX.md`, `.planning/navigation/{codebase}.md`, `.planning/rules/INDEX.md`, and `.planning/initialization/report.md`.
168
+ Program-owned projections are `.devflow/planning/PROJECT.md`, `.devflow/planning/toolchain.md`, `.devflow/planning/navigation/INDEX.md`, `.devflow/planning/navigation/{codebase}.md`, `.devflow/planning/rules/INDEX.md`, and `.devflow/planning/initialization/report.md`.
169
169
 
170
170
  Template mode is an explicit no-model fallback. A configured low-tier organizer may improve prose, but the program owns exact paths, commands, counts, tables, unknowns, and completion status. Model output containing internal identifiers, database structure, hashes, code blocks, or unsupported machine detail is rejected. Document failure never invalidates an already published data snapshot; retry `generate-docs` for that snapshot.
171
171
 
@@ -209,7 +209,7 @@ Run the database validator with identifiers returned by the scan:
209
209
  devflow_skill_script(script="project-context-db-validate", args=["--database", "<control.db>", "--project-id", "<project-id>", "--workspace-id", "<workspace-id>", "--run-id", "<run-id>"])
210
210
  ```
211
211
 
212
- The `--database` value must come from `devflow_project_context(action="scan").database` or the loaded project context `controlDatabasePath`. Never guess `./control.db`, `.devflow/control.db`, `.planning/code-index/index.sqlite`, an OMP agent database, or any SQLite found by searching user directories. Code-index SQLite is not the initialization control database and does not contain the initialization `schema_meta` table.
212
+ The `--database` value must come from `devflow_project_context(action="scan").database` or the loaded project context `controlDatabasePath`. Never guess `./control.db`, `.devflow/control.db`, `.devflow/planning/code-index/index.sqlite`, an OMP agent database, or any SQLite found by searching user directories. Code-index SQLite is not the initialization control database and does not contain the initialization `schema_meta` table.
213
213
 
214
214
  Completion requires a stable immutable input, matching context snapshot, accounted required categories, evidence for observed facts, a registered immutable index in full mode, revision-safe pointer publication, and separate document statuses. Workflow `STATE` and other non-initialization authorities must remain unchanged.
215
215
 
@@ -4,11 +4,11 @@
4
4
 
5
5
  Before any operation, read these files in order:
6
6
 
7
- 1. `.planning/rules/INDEX.md` — project rule index (gate entry point)
8
- 2. `.context/spec/index.md` — design and codebase specification entry
7
+ 1. `.devflow/planning/rules/INDEX.md` — project rule index (gate entry point)
8
+ 2. `.devflow/context/spec/index.md` — design and codebase specification entry
9
9
  {{#if codebase_count}}
10
- 3. `.planning/navigation/INDEX.md` — codebase registry and navigation files
11
- 4. `.planning/code-index/` — machine code facts generated by `workflow-code-index` during full initialization unless fast mode skipped it
10
+ 3. `.devflow/planning/navigation/INDEX.md` — codebase registry and navigation files
11
+ 4. `.devflow/planning/code-index/` — machine code facts generated by `workflow-code-index` during full initialization unless fast mode skipped it
12
12
  {{/if}}
13
13
 
14
14
  ## Codebases
@@ -20,6 +20,6 @@ This project has {{codebase_count}} codebase(s):
20
20
 
21
21
  ## Key Directories
22
22
 
23
- - `.planning/` — workflow state, navigation, rules, execution contract
24
- - `.context/spec/` — design and codebase specifications (MUST/SHOULD/OBSERVED rules)
25
- - `.context/lessons/` — accumulated project experience and regression prevention
23
+ - `.devflow/planning/` — workflow state, navigation, rules, execution contract
24
+ - `.devflow/context/spec/` — design and codebase specifications (MUST/SHOULD/OBSERVED rules)
25
+ - `.devflow/context/lessons/` — accumulated project experience and regression prevention
@@ -1,13 +1,13 @@
1
1
  # {{name}} Backend Codebase Specification
2
2
 
3
- This file describes project-instance rules for one backend/service codebase. Stack-level defaults are in `.context/spec/stacks/{{stack_key}}.md`.
3
+ This file describes project-instance rules for one backend/service codebase. Stack-level defaults are in `.devflow/context/spec/stacks/{{stack_key}}.md`.
4
4
 
5
5
  ## Version
6
6
 
7
7
  - Generated at: {{generated_at}}
8
8
  - Codebase: `{{name}}`
9
- - Navigation: `.planning/navigation/{{name}}.md`
10
- - Stack spec: `.context/spec/stacks/{{stack_key}}.md`
9
+ - Navigation: `.devflow/planning/navigation/{{name}}.md`
10
+ - Stack spec: `.devflow/context/spec/stacks/{{stack_key}}.md`
11
11
  - Source manifests: {{manifest_sources}}
12
12
  - Dependency fingerprint: {{dependency_fingerprint}}
13
13
  - Regenerate when:
@@ -53,7 +53,7 @@ This file describes project-instance rules for one backend/service codebase. Sta
53
53
 
54
54
  ## Explicit Rules
55
55
 
56
- Rules from `AGENTS.md`, `CLAUDE.md`, `.cursorrules`, existing `.context/spec/`, or equivalent files.
56
+ Rules from `AGENTS.md`, `CLAUDE.md`, `.cursorrules`, existing `.devflow/context/spec/`, or equivalent files.
57
57
 
58
58
  - {{explicit_rule}}
59
59
 
@@ -1,13 +1,13 @@
1
1
  # {{name}} Frontend Codebase Specification
2
2
 
3
- This file describes project-instance rules for one frontend codebase. Stack-level defaults are in `.context/spec/stacks/{{stack_key}}.md`.
3
+ This file describes project-instance rules for one frontend codebase. Stack-level defaults are in `.devflow/context/spec/stacks/{{stack_key}}.md`.
4
4
 
5
5
  ## Version
6
6
 
7
7
  - Generated at: {{generated_at}}
8
8
  - Codebase: `{{name}}`
9
- - Navigation: `.planning/navigation/{{name}}.md`
10
- - Stack spec: `.context/spec/stacks/{{stack_key}}.md`
9
+ - Navigation: `.devflow/planning/navigation/{{name}}.md`
10
+ - Stack spec: `.devflow/context/spec/stacks/{{stack_key}}.md`
11
11
  - Source manifests: {{manifest_sources}}
12
12
  - Dependency fingerprint: {{dependency_fingerprint}}
13
13
  - Regenerate when:
@@ -49,7 +49,7 @@ This file describes project-instance rules for one frontend codebase. Stack-leve
49
49
 
50
50
  ## Explicit Rules
51
51
 
52
- Rules from `AGENTS.md`, `CLAUDE.md`, `.cursorrules`, existing `.context/spec/`, or equivalent files.
52
+ Rules from `AGENTS.md`, `CLAUDE.md`, `.cursorrules`, existing `.devflow/context/spec/`, or equivalent files.
53
53
 
54
54
  - {{explicit_rule}}
55
55
 
@@ -147,7 +147,7 @@ Convention categories: Component hierarchy, Data flow (composable/store), Route
147
147
 
148
148
  ## Rule Sources
149
149
 
150
- See `.planning/rules/INDEX.md` for the full project rule index. This codebase's relevant rule files:
150
+ See `.devflow/planning/rules/INDEX.md` for the full project rule index. This codebase's relevant rule files:
151
151
 
152
152
  | Rule | Path | Status |
153
153
  |------|------|--------|
@@ -16,13 +16,13 @@ Generated during project initialization.
16
16
 
17
17
  ## Read Order
18
18
 
19
- 1. `.planning/rules/INDEX.md`
20
- 2. `.context/spec/index.md`
19
+ 1. `.devflow/planning/rules/INDEX.md`
20
+ 2. `.devflow/context/spec/index.md`
21
21
  3. Matching stack spec
22
22
  4. Matching codebase spec
23
23
  5. Applicable depth specs from the registry below
24
24
  6. Matching navigation file
25
- 7. `.planning/code-index/` machine symbols/relations for source-level relation facts; if fast mode skipped generation, refresh through `workflow-code-index` or record fallback
25
+ 7. `.devflow/planning/code-index/` machine symbols/relations for source-level relation facts; if fast mode skipped generation, refresh through `workflow-code-index` or record fallback
26
26
  8. Actual source files selected from navigation/spec/code-index evidence
27
27
 
28
28
  ## Depth Spec Registry
@@ -36,7 +36,7 @@ Generated during project initialization.
36
36
  ## Pending Templates
37
37
 
38
38
  Record discovered topics whose matching depth spec template is missing as `PENDING_TEMPLATE`.
39
- Mirror the same blocker in `.planning/STATE.md` front matter.
39
+ Mirror the same blocker in `.devflow/planning/STATE.md` front matter.
40
40
 
41
41
  ## Pending Confirmation
42
42
 
@@ -11,19 +11,19 @@ Generated during project initialization. This file is a registry and read-order
11
11
 
12
12
  Downstream skills must read rule sources in this order:
13
13
 
14
- 1. `.planning/rules/INDEX.md`
15
- 2. `.context/spec/index.md`
16
- 3. Matching `.context/spec/stacks/{stack_key}.md`
17
- 4. Matching `.context/spec/frontend|backend/{codebase}.md`
18
- 5. Matching `.context/spec/{domain}/index.md` and applicable depth specs
19
- 6. `.planning/navigation/{codebase}.md`
20
- 7. `.planning/code-index/` machine symbols/relations for source-level relation facts; if fast mode skipped generation, refresh through `workflow-code-index` or record fallback
14
+ 1. `.devflow/planning/rules/INDEX.md`
15
+ 2. `.devflow/context/spec/index.md`
16
+ 3. Matching `.devflow/context/spec/stacks/{stack_key}.md`
17
+ 4. Matching `.devflow/context/spec/frontend|backend/{codebase}.md`
18
+ 5. Matching `.devflow/context/spec/{domain}/index.md` and applicable depth specs
19
+ 6. `.devflow/planning/navigation/{codebase}.md`
20
+ 7. `.devflow/planning/code-index/` machine symbols/relations for source-level relation facts; if fast mode skipped generation, refresh through `workflow-code-index` or record fallback
21
21
  8. Actual source files
22
22
 
23
23
  Priority when rules conflict:
24
24
 
25
25
  1. User-explicit requirement
26
- 2. Explicit project rules (`AGENTS.md`, `CLAUDE.md`, `.cursorrules`, existing `.context/spec/`)
26
+ 2. Explicit project rules (`AGENTS.md`, `CLAUDE.md`, `.cursorrules`, existing `.devflow/context/spec/`)
27
27
  3. Codebase spec
28
28
  4. Stack spec
29
29
  5. Code-inferred convention
@@ -32,13 +32,13 @@ Priority when rules conflict:
32
32
 
33
33
  | Stack Key | Spec | Codebases | Manifest Sources | Fingerprint |
34
34
  |-----------|------|-----------|------------------|-------------|
35
- | {{stack_key}} | `.context/spec/stacks/{{stack_key}}.md` | {{codebases}} | {{manifest_sources}} | {{fingerprint}} |
35
+ | {{stack_key}} | `.devflow/context/spec/stacks/{{stack_key}}.md` | {{codebases}} | {{manifest_sources}} | {{fingerprint}} |
36
36
 
37
37
  ## Codebase Specs
38
38
 
39
39
  | Codebase | Type | Navigation | Stack Key | Spec |
40
40
  |----------|------|------------|-----------|------|
41
- | {{name}} | {{type}} | `.planning/navigation/{{name}}.md` | {{stack_key}} | `.context/spec/{{domain}}/{{name}}.md` |
41
+ | {{name}} | {{type}} | `.devflow/planning/navigation/{{name}}.md` | {{stack_key}} | `.devflow/context/spec/{{domain}}/{{name}}.md` |
42
42
 
43
43
  ## Missing Or Pending
44
44
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## Layer Model
4
4
 
5
- Each codebase has its own layer conventions documented in `.planning/navigation/{name}.md`. This section consolidates the layer rules that downstream skills must follow.
5
+ Each codebase has its own layer conventions documented in `.devflow/planning/navigation/{name}.md`. This section consolidates the layer rules that downstream skills must follow.
6
6
 
7
7
  {{#backend_codebases}}
8
8
  ### {{name}} ({{role}})
@@ -47,7 +47,7 @@ Tests can be written before code (TDD) or incrementally within the same task, bu
47
47
 
48
48
  All code tasks must pass three gates before marking complete:
49
49
  1. **Test gate**: task-level tests must be added/updated and pass (or skip classified as acceptable/needs-review).
50
- 2. **Spec Compliance gate**: every MUST rule from the relevant `.context/spec/` depth spec file must be satisfied or explicitly waived.
50
+ 2. **Spec Compliance gate**: every MUST rule from the relevant `.devflow/context/spec/` depth spec file must be satisfied or explicitly waived.
51
51
  3. **Verification Iron Law**: before claiming completion: IDENTIFY the verification command → RUN it → READ the output → VERIFY against expected results → ONLY THEN mark complete.
52
52
 
53
53
  For task-level test strategy requirements, see `workflow-execute-phase` "验证铁律" and `workflow-change-plan` "测试策略强制规则" and "跳过自动化测试分级".
@@ -7,34 +7,34 @@
7
7
  | Name | Path | Type | Role | Navigation | Scan Status |
8
8
  |------|------|------|------|------------|-------------|
9
9
  {{#codebases}}
10
- | {{name}} | {{path}} | {{type}} | {{role}} | `.planning/navigation/{{name}}.md` | {{scan_status}} |
10
+ | {{name}} | {{path}} | {{type}} | {{role}} | `.devflow/planning/navigation/{{name}}.md` | {{scan_status}} |
11
11
  {{/codebases}}
12
12
 
13
13
  ## Project Rule Package
14
14
 
15
- The project rule index is at `.planning/rules/INDEX.md`. Downstream skills should read it first, then use `.context/spec/index.md` to resolve stack/codebase specs and each domain index to resolve applicable depth specs before using codebase navigation files for coarse routing. Use `.planning/code-index/` before reading actual source evidence when source-level relation facts are needed; if fast mode skipped index generation, refresh it through `workflow-code-index` first or record the fallback.
15
+ The project rule index is at `.devflow/planning/rules/INDEX.md`. Downstream skills should read it first, then use `.devflow/context/spec/index.md` to resolve stack/codebase specs and each domain index to resolve applicable depth specs before using codebase navigation files for coarse routing. Use `.devflow/planning/code-index/` before reading actual source evidence when source-level relation facts are needed; if fast mode skipped index generation, refresh it through `workflow-code-index` first or record the fallback.
16
16
 
17
17
  | Rule Source | Path | Status |
18
18
  |-------------|------|--------|
19
- | Rules Index | `.planning/rules/INDEX.md` | {{rules_index_status}} |
20
- | Execution Contract | `.planning/execution-contract.md` | {{execution_contract_status}} |
21
- | Toolchain Contract | `.planning/toolchain.md` | {{toolchain_status}} |
22
- | Planning Lessons | `.planning/lessons/README.md` | {{lessons_status}} |
23
- | Context Spec Index | `.context/spec/index.md` | {{context_spec_index_status}} |
24
- | Stack Specs | `.context/spec/stacks/` | {{stack_specs_status}} |
25
- | Context Specs | `.context/spec/` | {{context_spec_status}} |
26
- | Code Index | `.planning/code-index/` | {{code_index_status}} |
27
- | Design Rule Pack | `.context/spec/design/` | {{design_rule_pack_status}} |
28
- | Context Workflow | `.context/workflow/` | {{context_workflow_status}} |
29
- | Context Lessons | `.context/lessons/README.md` | {{context_lessons_status}} |
19
+ | Rules Index | `.devflow/planning/rules/INDEX.md` | {{rules_index_status}} |
20
+ | Execution Contract | `.devflow/planning/execution-contract.md` | {{execution_contract_status}} |
21
+ | Toolchain Contract | `.devflow/planning/toolchain.md` | {{toolchain_status}} |
22
+ | Planning Lessons | `.devflow/planning/lessons/README.md` | {{lessons_status}} |
23
+ | Context Spec Index | `.devflow/context/spec/index.md` | {{context_spec_index_status}} |
24
+ | Stack Specs | `.devflow/context/spec/stacks/` | {{stack_specs_status}} |
25
+ | Context Specs | `.devflow/context/spec/` | {{context_spec_status}} |
26
+ | Code Index | `.devflow/planning/code-index/` | {{code_index_status}} |
27
+ | Design Rule Pack | `.devflow/context/spec/design/` | {{design_rule_pack_status}} |
28
+ | Context Workflow | `.devflow/context/workflow/` | {{context_workflow_status}} |
29
+ | Context Lessons | `.devflow/context/lessons/README.md` | {{context_lessons_status}} |
30
30
  | Root Instructions | `AGENTS.md` / `CLAUDE.md` | {{root_instructions_status}} |
31
31
 
32
32
  ## Downstream Read Contract
33
33
 
34
34
  | Skill | Should Read |
35
35
  |-------|-------------|
36
- | `workflow-requirement-baseline` | `.planning/PROJECT.md`, this INDEX.md, relevant codebase navigation files, and `.planning/code-index/` for source-level relation checks |
37
- | `workflow-feature-breakdown` | `.planning/PROJECT.md`, this INDEX.md, and codebase navigation files for codebases relevant to the feature |
38
- | `workflow-frontend-tech-spec` | `.planning/rules/INDEX.md` → `.context/spec/index.md` → matching stack spec → matching frontend codebase spec → frontend domain index/applicable depth specs → this INDEX.md/navigation → code-index → source evidence |
39
- | `workflow-backend-tech-spec` | `.planning/rules/INDEX.md` → `.context/spec/index.md` → matching stack spec → matching backend codebase spec → backend domain index/applicable depth specs → this INDEX.md/navigation → code-index → source evidence |
40
- | `workflow-change-plan` | `.planning/rules/INDEX.md` + `.context/spec/index.md` for task gates, this INDEX.md for output locations and source navigation |
36
+ | `workflow-requirement-baseline` | `.devflow/planning/PROJECT.md`, this INDEX.md, relevant codebase navigation files, and `.devflow/planning/code-index/` for source-level relation checks |
37
+ | `workflow-feature-breakdown` | `.devflow/planning/PROJECT.md`, this INDEX.md, and codebase navigation files for codebases relevant to the feature |
38
+ | `workflow-frontend-tech-spec` | `.devflow/planning/rules/INDEX.md` → `.devflow/context/spec/index.md` → matching stack spec → matching frontend codebase spec → frontend domain index/applicable depth specs → this INDEX.md/navigation → code-index → source evidence |
39
+ | `workflow-backend-tech-spec` | `.devflow/planning/rules/INDEX.md` → `.devflow/context/spec/index.md` → matching stack spec → matching backend codebase spec → backend domain index/applicable depth specs → this INDEX.md/navigation → code-index → source evidence |
40
+ | `workflow-change-plan` | `.devflow/planning/rules/INDEX.md` + `.devflow/context/spec/index.md` for task gates, this INDEX.md for output locations and source navigation |
@@ -21,9 +21,9 @@
21
21
  ## Current Structure
22
22
 
23
23
  - **Repository Type**: {{repo_type}}
24
- - **Planning Root**: `.planning/`
25
- - **Navigation Root**: `.planning/navigation/`
26
- - **Code Index Root**: `.planning/code-index/`(generated by default through `workflow-code-index`; skipped only in fast mode)
24
+ - **Planning Root**: `.devflow/planning/`
25
+ - **Navigation Root**: `.devflow/planning/navigation/`
26
+ - **Code Index Root**: `.devflow/planning/code-index/`(generated by default through `workflow-code-index`; skipped only in fast mode)
27
27
  - **Code Index Status**: `{{code_index_status}}`
28
28
  - **Code Index Skip Reason**: {{code_index_skip_reason}}
29
29
  - **Design Rule Pack Status**: `{{design_rule_pack_status}}`
@@ -37,11 +37,11 @@
37
37
 
38
38
  Detailed code navigation is split by codebase so later skills can load only what they need:
39
39
 
40
- - `.planning/navigation/INDEX.md` — codebase registry and quick pointers
40
+ - `.devflow/planning/navigation/INDEX.md` — codebase registry and quick pointers
41
41
  {{#codebases}}
42
- - `.planning/navigation/{{name}}.md` — {{role}} structure, entries, conventions, commands
42
+ - `.devflow/planning/navigation/{{name}}.md` — {{role}} structure, entries, conventions, commands
43
43
  {{/codebases}}
44
- - `.planning/code-index/` — machine facts for symbols, relations, entrypoints, and data flow; generated during full initialization unless fast mode skipped it
44
+ - `.devflow/planning/code-index/` — machine facts for symbols, relations, entrypoints, and data flow; generated during full initialization unless fast mode skipped it
45
45
 
46
46
  ## Project Rule Package
47
47
 
@@ -49,17 +49,17 @@ Record generated rule snapshots, existing project-specific rules, and workflow c
49
49
 
50
50
  | Rule Source | Path | Status | Notes |
51
51
  |-------------|------|--------|-------|
52
- | Planning Rules | `.planning/rules/INDEX.md` | {{planning_rules_status}} | {{planning_rules_notes}} |
53
- | Execution Contract | `.planning/execution-contract.md` | {{execution_contract_status}} | {{execution_contract_notes}} |
54
- | Toolchain Contract | `.planning/toolchain.md` | {{toolchain_status}} | {{toolchain_notes}} |
55
- | Planning Lessons | `.planning/lessons/README.md` | {{planning_lessons_status}} | {{planning_lessons_notes}} |
56
- | Planning Milestones | `.planning/milestones/` | {{planning_milestones_status}} | {{planning_milestones_notes}} |
57
- | Planning Requirements | `.planning/requirements/` | {{planning_requirements_status}} | {{planning_requirements_notes}} |
58
- | Context Spec Index | `.context/spec/index.md` | {{context_spec_index_status}} | {{context_spec_index_notes}} |
59
- | Stack Specs | `.context/spec/stacks/` | {{stack_specs_status}} | {{stack_specs_notes}} |
60
- | Context Specs | `.context/spec/` | {{context_spec_status}} | {{context_spec_notes}} |
61
- | Context Workflow | `.context/workflow/` | {{context_workflow_status}} | {{context_workflow_notes}} |
62
- | Context Lessons | `.context/lessons/README.md` | {{context_lessons_status}} | {{context_lessons_notes}} |
52
+ | Planning Rules | `.devflow/planning/rules/INDEX.md` | {{planning_rules_status}} | {{planning_rules_notes}} |
53
+ | Execution Contract | `.devflow/planning/execution-contract.md` | {{execution_contract_status}} | {{execution_contract_notes}} |
54
+ | Toolchain Contract | `.devflow/planning/toolchain.md` | {{toolchain_status}} | {{toolchain_notes}} |
55
+ | Planning Lessons | `.devflow/planning/lessons/README.md` | {{planning_lessons_status}} | {{planning_lessons_notes}} |
56
+ | Planning Milestones | `.devflow/planning/milestones/` | {{planning_milestones_status}} | {{planning_milestones_notes}} |
57
+ | Planning Requirements | `.devflow/planning/requirements/` | {{planning_requirements_status}} | {{planning_requirements_notes}} |
58
+ | Context Spec Index | `.devflow/context/spec/index.md` | {{context_spec_index_status}} | {{context_spec_index_notes}} |
59
+ | Stack Specs | `.devflow/context/spec/stacks/` | {{stack_specs_status}} | {{stack_specs_notes}} |
60
+ | Context Specs | `.devflow/context/spec/` | {{context_spec_status}} | {{context_spec_notes}} |
61
+ | Context Workflow | `.devflow/context/workflow/` | {{context_workflow_status}} | {{context_workflow_notes}} |
62
+ | Context Lessons | `.devflow/context/lessons/README.md` | {{context_lessons_status}} | {{context_lessons_notes}} |
63
63
  | Root Instructions | `AGENTS.md` / `CLAUDE.md` | {{root_instructions_status}} | {{root_instructions_notes}} |
64
64
 
65
65
  ## History Model
@@ -68,27 +68,27 @@ This workflow uses planning and milestone artifacts as the primary project memor
68
68
 
69
69
  | History Source | Role | Status | Notes |
70
70
  |----------------|------|--------|-------|
71
- | `.planning/milestones/` | 已归档里程碑和交付结果 | {{planning_milestones_status}} | {{planning_milestones_notes}} |
72
- | `.planning/requirements/` | 当前或历史需求基线 | {{planning_requirements_status}} | {{planning_requirements_notes}} |
73
- | `.planning/lessons/` | 跨里程碑经验教训 | {{planning_lessons_status}} | {{planning_lessons_notes}} |
74
- | `.planning/*/CONTEXT.md` | 阶段上下文与决策记录 | {{planning_context_status}} | {{planning_context_notes}} |
71
+ | `.devflow/planning/milestones/` | 已归档里程碑和交付结果 | {{planning_milestones_status}} | {{planning_milestones_notes}} |
72
+ | `.devflow/planning/requirements/` | 当前或历史需求基线 | {{planning_requirements_status}} | {{planning_requirements_notes}} |
73
+ | `.devflow/planning/lessons/` | 跨里程碑经验教训 | {{planning_lessons_status}} | {{planning_lessons_notes}} |
74
+ | `.devflow/planning/*/CONTEXT.md` | 阶段上下文与决策记录 | {{planning_context_status}} | {{planning_context_notes}} |
75
75
  | `features/` | Legacy feature docs, only if present | {{features_history_status}} | {{features_history_notes}} |
76
- | `.context/lessons/` | Legacy/project-rule lessons, only if present | {{context_lessons_status}} | {{context_lessons_notes}} |
76
+ | `.devflow/context/lessons/` | Legacy/project-rule lessons, only if present | {{context_lessons_status}} | {{context_lessons_notes}} |
77
77
 
78
78
  ## Shared References
79
79
 
80
80
  | Item | Path | Notes |
81
81
  |------|------|-------|
82
- | Project Context | `.planning/PROJECT.md` | 项目总览、结构、约束、关键决策 |
83
- | Workflow State | `.planning/STATE.md` | 初始化状态和后续建议 |
84
- | Navigation Index | `.planning/navigation/INDEX.md` | 后续 skill 的快捷入口 |
85
- | Code Index | `.planning/code-index/` | 机器事实索引,细粒度调用/符号/数据流追踪;fast mode 可跳过 |
86
- | Requirements Baseline | `.planning/requirements/baseline.md` | 需求讨论后生成,不在初始化阶段创建 |
87
- | Feature Breakdown | `.planning/features/{功能名}/功能点梳理.md` | 需求基线后生成的测试可读功能点梳理 |
88
- | Frontend Tech Doc | `.planning/features/{功能名}/前端技术方案.md` | 前端技术方案输出 |
89
- | Backend Tech Doc | `.planning/features/{功能名}/后端技术方案.md` | 后端技术方案输出 |
90
- | Change List | `.planning/features/{功能名}/变更清单.md` | 变更清单输出 |
91
- | Codebase Map | `.planning/codebase/` | 可选,深度代码库扫描结果 |
82
+ | Project Context | `.devflow/planning/PROJECT.md` | 项目总览、结构、约束、关键决策 |
83
+ | Workflow State | `.devflow/planning/STATE.md` | 初始化状态和后续建议 |
84
+ | Navigation Index | `.devflow/planning/navigation/INDEX.md` | 后续 skill 的快捷入口 |
85
+ | Code Index | `.devflow/planning/code-index/` | 机器事实索引,细粒度调用/符号/数据流追踪;fast mode 可跳过 |
86
+ | Requirements Baseline | `.devflow/planning/requirements/baseline.md` | 需求讨论后生成,不在初始化阶段创建 |
87
+ | Feature Breakdown | `.devflow/planning/features/{功能名}/功能点梳理.md` | 需求基线后生成的测试可读功能点梳理 |
88
+ | Frontend Tech Doc | `.devflow/planning/features/{功能名}/前端技术方案.md` | 前端技术方案输出 |
89
+ | Backend Tech Doc | `.devflow/planning/features/{功能名}/后端技术方案.md` | 后端技术方案输出 |
90
+ | Change List | `.devflow/planning/features/{功能名}/变更清单.md` | 变更清单输出 |
91
+ | Codebase Map | `.devflow/planning/codebase/` | 可选,深度代码库扫描结果 |
92
92
 
93
93
  ## Constraints
94
94