@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.
- package/README.md +6 -6
- package/package.json +1 -1
- package/plugins/devflow-core/extensions/devflow-core.ts +87 -33
- package/plugins/devflow-core/runtime/hooks/context_sync_gate.py +3 -3
- package/plugins/devflow-core/runtime/hooks/hook_common.py +65 -11
- package/plugins/devflow-core/runtime/hooks/start.py +13 -13
- package/plugins/devflow-core/skills/wireframe-proposal/SKILL.md +2 -2
- package/plugins/devflow-core/skills/wireframe-validate/SKILL.md +4 -4
- package/plugins/devflow-core/skills/workflow-orchestrator/SKILL.md +19 -19
- package/plugins/devflow-core/skills/workflow-orchestrator/agents/openai.yaml +2 -2
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/acceptance_test_runner.py +5 -5
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/advance_state.rb +9 -9
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/api_test_matrix.py +2 -2
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/architecture_assessment.rb +1 -1
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/architecture_brief.rb +1 -1
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/architecture_feasibility.rb +1 -1
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/business_invalidation.rb +5 -5
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/business_model_commit.rb +4 -4
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/business_model_validate.py +1 -1
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/business_source_resolver.rb +4 -4
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/checker_adapter.rb +7 -7
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/control_io.rb +51 -7
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/cross_track_consistency_check.rb +1 -1
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/execution_contract.rb +6 -6
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/gate_runtime.rb +3 -3
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/init_state.rb +5 -5
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/init_workflow.rb +5 -5
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/inspect_state.rb +13 -13
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/machine_evidence.rb +3 -3
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/manage_lessons.rb +7 -7
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/parallel_recover.rb +2 -2
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/parallel_run.rb +3 -3
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/phase_ownership.rb +6 -6
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/repair_control_plane.rb +1 -1
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/requirement_coverage.rb +1 -1
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/requirement_graph.rb +3 -3
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/review_preflight.py +3 -3
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/review_run.py +18 -18
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/runtime_context_collector.rb +3 -3
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/session_rollover.rb +4 -4
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/static_runtime_context_collector.rb +2 -2
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/sync_artifacts.rb +5 -5
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/tdd_evidence.py +3 -3
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/test_command_policy.py +2 -2
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/test_task_binding_check.py +3 -3
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/update_triage_route.rb +3 -3
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/validate_state.rb +6 -6
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/wireframe_commit.rb +5 -5
- package/plugins/devflow-core/skills/workflow-orchestrator/scripts/wireframe_validate.py +1 -1
- package/plugins/devflow-core/skills/workflow-orchestrator/templates/acceptance-remediation.yaml +12 -12
- package/plugins/devflow-core/skills/workflow-orchestrator/templates/feature-development.yaml +205 -205
- package/plugins/devflow-core/skills/workflow-pipeline/SKILL.md +3 -3
- package/plugins/devflow-core/skills/workflow-pipeline/references/pipeline-flow.md +10 -10
- package/plugins/devflow-core/skills/workflow-project-context/SKILL.md +14 -14
- package/plugins/devflow-core/skills/workflow-project-context/assets/agents-md-template.md +7 -7
- package/plugins/devflow-core/skills/workflow-project-context/assets/codebase-backend-spec-template.md +4 -4
- package/plugins/devflow-core/skills/workflow-project-context/assets/codebase-frontend-spec-template.md +4 -4
- package/plugins/devflow-core/skills/workflow-project-context/assets/codebase-navigation-template.md +1 -1
- package/plugins/devflow-core/skills/workflow-project-context/assets/context-domain-index-template.md +4 -4
- package/plugins/devflow-core/skills/workflow-project-context/assets/context-spec-index-template.md +10 -10
- package/plugins/devflow-core/skills/workflow-project-context/assets/execution-contract-template.md +2 -2
- package/plugins/devflow-core/skills/workflow-project-context/assets/navigation-index-template.md +18 -18
- package/plugins/devflow-core/skills/workflow-project-context/assets/project-initialization-template.md +32 -32
- package/plugins/devflow-core/skills/workflow-project-context/assets/rules-index-template.md +30 -30
- package/plugins/devflow-core/skills/workflow-project-context/assets/state-template.md +7 -7
- package/plugins/devflow-core/skills/workflow-project-context/references/navigation-guide.md +37 -37
- package/plugins/devflow-core/skills/workflow-project-context/scripts/validate_initialization.py +22 -17
- package/plugins/devflow-design/skills/workflow-api-call-guide/SKILL.md +4 -4
- package/plugins/devflow-design/skills/workflow-api-contract/SKILL.md +8 -8
- package/plugins/devflow-design/skills/workflow-api-supplement/SKILL.md +5 -5
- package/plugins/devflow-design/skills/workflow-architecture-feasibility/SKILL.md +1 -1
- package/plugins/devflow-design/skills/workflow-backend-tech-spec/SKILL.md +39 -39
- package/plugins/devflow-design/skills/workflow-backend-tech-spec/assets/backend-spec-template.md +10 -10
- package/plugins/devflow-design/skills/workflow-backend-tech-spec/references/affected-module-exploration.md +2 -2
- package/plugins/devflow-design/skills/workflow-backend-tech-spec/references/code-explore-guide.md +1 -1
- package/plugins/devflow-design/skills/workflow-backend-tech-spec/references/project-rule-contract.md +20 -20
- package/plugins/devflow-design/skills/workflow-design-rule-pack/SKILL.md +8 -8
- package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/index.md +3 -3
- package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/recommendations/accessibility.md +2 -2
- package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/recommendations/component-library.md +2 -2
- package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/recommendations/design-systems.md +1 -1
- package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/recommendations/responsive-grid.md +2 -2
- package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/recommendations/stack-guidelines.md +6 -6
- package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/recommendations/ux-patterns.md +2 -2
- package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/tokens/project-tokens.md +1 -1
- package/plugins/devflow-design/skills/workflow-design-rule-pack/assets/design/tools/ui-ux-pro-max/SKILL.md +12 -12
- package/plugins/devflow-design/skills/workflow-design-rule-pack/scripts/install.py +2 -2
- package/plugins/devflow-design/skills/workflow-feature-breakdown/SKILL.md +30 -30
- package/plugins/devflow-design/skills/workflow-feature-breakdown/assets/output-template.md +2 -2
- package/plugins/devflow-design/skills/workflow-frontend-tech-spec/SKILL.md +41 -41
- package/plugins/devflow-design/skills/workflow-frontend-tech-spec/assets/frontend-spec-template.md +15 -15
- package/plugins/devflow-design/skills/workflow-frontend-tech-spec/references/affected-module-exploration.md +2 -2
- package/plugins/devflow-design/skills/workflow-frontend-tech-spec/references/project-rule-contract.md +25 -25
- package/plugins/devflow-design/skills/workflow-integration-verify/SKILL.md +13 -13
- package/plugins/devflow-design/skills/workflow-ui-spec/SKILL.md +23 -23
- package/plugins/devflow-design/skills/workflow-ui-spec/assets/ui-spec-template.md +3 -3
- package/plugins/devflow-implementation/agents/implementation-worker.md +2 -2
- package/plugins/devflow-implementation/skills/workflow-bug-fix/SKILL.md +9 -9
- package/plugins/devflow-implementation/skills/workflow-bug-fix/references/lesson-format.md +2 -2
- package/plugins/devflow-implementation/skills/workflow-bug-fix/references/root-cause-ladder.md +1 -1
- package/plugins/devflow-implementation/skills/workflow-change-plan/SKILL.md +17 -17
- package/plugins/devflow-implementation/skills/workflow-change-plan/references/code-conventions.md +1 -1
- package/plugins/devflow-implementation/skills/workflow-change-plan/references/output-template.md +3 -3
- package/plugins/devflow-implementation/skills/workflow-change-plan/references/project-rule-contract.md +16 -16
- package/plugins/devflow-implementation/skills/workflow-execute-phase/SKILL.md +38 -38
- package/plugins/devflow-implementation/skills/workflow-execute-phase/references/execute-phase.md +1 -1
- package/plugins/devflow-intel/agents/project-scout.md +3 -1
- package/plugins/devflow-intel/extensions/devflow-intel.ts +20 -19
- package/plugins/devflow-intel/skills/code-index-query/SKILL.md +8 -6
- package/plugins/devflow-intel/skills/workflow-code-index/SKILL.md +12 -12
- package/plugins/devflow-intel/skills/workflow-code-index/references/discovery.md +2 -2
- package/plugins/devflow-intel/skills/workflow-code-index/references/query-guide.md +1 -1
- package/plugins/devflow-intel/skills/workflow-code-index/scripts/code_index.py +8 -8
- package/plugins/devflow-intel/skills/workflow-code-index/scripts/core/discovery.py +2 -2
- package/plugins/devflow-intel/skills/workflow-code-index/scripts/core/scanner.py +4 -1
- package/plugins/devflow-intel/skills/workflow-code-index/scripts/validators/project_binding_check.py +4 -4
- package/plugins/devflow-intel/skills/workflow-context-sync/SKILL.md +14 -14
- package/plugins/devflow-intel/skills/workflow-context-sync/scripts/context_sync_cursor.py +2 -2
- package/plugins/devflow-intel/skills/workflow-update-navigation/SKILL.md +26 -26
- package/plugins/devflow-intel/skills/workflow-update-navigation/references/incremental-update-guide.md +2 -2
- package/plugins/devflow-quality/skills/code-review/SKILL.md +13 -13
- package/plugins/devflow-quality/skills/code-review/references/spec-checklist.md +1 -1
- package/plugins/devflow-quality/skills/workflow-acceptance-test-design/SKILL.md +8 -8
- package/plugins/devflow-quality/skills/workflow-gen-test-guide/SKILL.md +6 -6
- package/plugins/devflow-quality/skills/workflow-gen-test-guide/legacy/SKILL.md +14 -14
- package/plugins/devflow-quality/skills/workflow-generate-mainflow-cases/SKILL.md +23 -23
- package/plugins/devflow-quality/skills/workflow-generate-mainflow-cases/references/codebase-discovery.md +9 -9
- package/plugins/devflow-quality/skills/workflow-generate-mainflow-cases/references/project-dsl-contract.md +1 -1
- package/plugins/devflow-quality/skills/workflow-generate-mainflow-cases/scripts/compile_dsl.py +2 -2
- package/plugins/devflow-quality/skills/workflow-generate-mainflow-cases/scripts/discover_codebases.py +2 -2
- package/plugins/devflow-quality/skills/workflow-release-closeout/SKILL.md +15 -15
- package/plugins/devflow-quality/skills/workflow-run-acceptance-tests/SKILL.md +5 -5
- package/plugins/devflow-requirements/skills/requirement-feasibility-review/SKILL.md +1 -1
- package/plugins/devflow-requirements/skills/workflow-demand-clarify/SKILL.md +10 -10
- package/plugins/devflow-requirements/skills/workflow-domain-modeling/SKILL.md +25 -25
- package/plugins/devflow-requirements/skills/workflow-requirement-baseline/SKILL.md +49 -49
- package/plugins/devflow-requirements/skills/workflow-requirement-baseline/assets/baseline-template.md +22 -22
- package/plugins/devflow-requirements/skills/workflow-requirement-baseline/references/antipatterns.md +3 -3
- package/plugins/devflow-requirements/skills/workflow-requirement-baseline/references/challenge-review-guide.md +3 -3
- package/plugins/devflow-requirements/skills/workflow-requirement-baseline/references/project-context-guide.md +11 -11
- package/plugins/devflow-requirements/skills/workflow-requirement-baseline/references/questioning.md +1 -1
- package/plugins/devflow-requirements/skills/workflow-requirement-baseline/references/requirement-review-checklist.md +4 -4
- package/plugins/devflow-requirements/skills/workflow-requirement-triage/SKILL.md +16 -16
- package/plugins/devflow-requirements/skills/workflow-wayfinder/SKILL.md +6 -6
- package/src/cli.ts +15 -0
- package/src/constants.ts +1 -1
- package/src/initialization-store.ts +3 -2
- package/src/project-context.ts +36 -14
- package/src/project-documents.ts +61 -61
- package/src/project-initializer.ts +23 -9
- package/src/project-layout.ts +217 -0
- package/src/runtime.ts +3 -3
- package/templates/commands/start.md +4 -4
- package/templates/omp/AGENTS.md +1 -1
- package/templates/omp/hook-config.json +7 -7
- 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
|
|
package/plugins/devflow-core/skills/workflow-project-context/assets/codebase-navigation-template.md
CHANGED
|
@@ -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
|
|------|------|--------|
|
package/plugins/devflow-core/skills/workflow-project-context/assets/context-domain-index-template.md
CHANGED
|
@@ -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
|
|
package/plugins/devflow-core/skills/workflow-project-context/assets/context-spec-index-template.md
CHANGED
|
@@ -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
|
|
package/plugins/devflow-core/skills/workflow-project-context/assets/execution-contract-template.md
CHANGED
|
@@ -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 "跳过自动化测试分级".
|
package/plugins/devflow-core/skills/workflow-project-context/assets/navigation-index-template.md
CHANGED
|
@@ -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
|
|