@guanlin4924/devflow-pi 0.1.93 → 0.1.95

package/plugins/devflow-core/skills/workflow-project-context/assets/project-initialization-template.md

@@ -21,9 +21,9 @@
 ## Current Structure
 
 - **Repository Type**: {{repo_type}}
-- **Planning Root**: `.planning/`
-- **Navigation Root**: `.planning/navigation/`
-- **Code Index Root**: `.planning/code-index/`（generated by default through `workflow-code-index`; skipped only in fast mode）
+- **Planning Root**: `.devflow/planning/`
+- **Navigation Root**: `.devflow/planning/navigation/`
+- **Code Index Root**: `.devflow/planning/code-index/`（generated by default through `workflow-code-index`; skipped only in fast mode）
 - **Code Index Status**: `{{code_index_status}}`
 - **Code Index Skip Reason**: {{code_index_skip_reason}}
 - **Design Rule Pack Status**: `{{design_rule_pack_status}}`
@@ -37,11 +37,11 @@
 
 Detailed code navigation is split by codebase so later skills can load only what they need:
 
-- `.planning/navigation/INDEX.md` — codebase registry and quick pointers
+- `.devflow/planning/navigation/INDEX.md` — codebase registry and quick pointers
 {{#codebases}}
-- `.planning/navigation/{{name}}.md` — {{role}} structure, entries, conventions, commands
+- `.devflow/planning/navigation/{{name}}.md` — {{role}} structure, entries, conventions, commands
 {{/codebases}}
-- `.planning/code-index/` — machine facts for symbols, relations, entrypoints, and data flow; generated during full initialization unless fast mode skipped it
+- `.devflow/planning/code-index/` — machine facts for symbols, relations, entrypoints, and data flow; generated during full initialization unless fast mode skipped it
 
 ## Project Rule Package
 
@@ -49,17 +49,17 @@ Record generated rule snapshots, existing project-specific rules, and workflow c
 
 | Rule Source | Path | Status | Notes |
 |-------------|------|--------|-------|
-| Planning Rules | `.planning/rules/INDEX.md` | {{planning_rules_status}} | {{planning_rules_notes}} |
-| Execution Contract | `.planning/execution-contract.md` | {{execution_contract_status}} | {{execution_contract_notes}} |
-| Toolchain Contract | `.planning/toolchain.md` | {{toolchain_status}} | {{toolchain_notes}} |
-| Planning Lessons | `.planning/lessons/README.md` | {{planning_lessons_status}} | {{planning_lessons_notes}} |
-| Planning Milestones | `.planning/milestones/` | {{planning_milestones_status}} | {{planning_milestones_notes}} |
-| Planning Requirements | `.planning/requirements/` | {{planning_requirements_status}} | {{planning_requirements_notes}} |
-| Context Spec Index | `.context/spec/index.md` | {{context_spec_index_status}} | {{context_spec_index_notes}} |
-| Stack Specs | `.context/spec/stacks/` | {{stack_specs_status}} | {{stack_specs_notes}} |
-| Context Specs | `.context/spec/` | {{context_spec_status}} | {{context_spec_notes}} |
-| Context Workflow | `.context/workflow/` | {{context_workflow_status}} | {{context_workflow_notes}} |
-| Context Lessons | `.context/lessons/README.md` | {{context_lessons_status}} | {{context_lessons_notes}} |
+| Planning Rules | `.devflow/planning/rules/INDEX.md` | {{planning_rules_status}} | {{planning_rules_notes}} |
+| Execution Contract | `.devflow/planning/execution-contract.md` | {{execution_contract_status}} | {{execution_contract_notes}} |
+| Toolchain Contract | `.devflow/planning/toolchain.md` | {{toolchain_status}} | {{toolchain_notes}} |
+| Planning Lessons | `.devflow/planning/lessons/README.md` | {{planning_lessons_status}} | {{planning_lessons_notes}} |
+| Planning Milestones | `.devflow/planning/milestones/` | {{planning_milestones_status}} | {{planning_milestones_notes}} |
+| Planning Requirements | `.devflow/planning/requirements/` | {{planning_requirements_status}} | {{planning_requirements_notes}} |
+| Context Spec Index | `.devflow/context/spec/index.md` | {{context_spec_index_status}} | {{context_spec_index_notes}} |
+| Stack Specs | `.devflow/context/spec/stacks/` | {{stack_specs_status}} | {{stack_specs_notes}} |
+| Context Specs | `.devflow/context/spec/` | {{context_spec_status}} | {{context_spec_notes}} |
+| Context Workflow | `.devflow/context/workflow/` | {{context_workflow_status}} | {{context_workflow_notes}} |
+| Context Lessons | `.devflow/context/lessons/README.md` | {{context_lessons_status}} | {{context_lessons_notes}} |
 | Root Instructions | `AGENTS.md` / `CLAUDE.md` | {{root_instructions_status}} | {{root_instructions_notes}} |
 
 ## History Model
@@ -68,27 +68,27 @@ This workflow uses planning and milestone artifacts as the primary project memor
 
 | History Source | Role | Status | Notes |
 |----------------|------|--------|-------|
-| `.planning/milestones/` | 已归档里程碑和交付结果 | {{planning_milestones_status}} | {{planning_milestones_notes}} |
-| `.planning/requirements/` | 当前或历史需求基线 | {{planning_requirements_status}} | {{planning_requirements_notes}} |
-| `.planning/lessons/` | 跨里程碑经验教训 | {{planning_lessons_status}} | {{planning_lessons_notes}} |
-| `.planning/*/CONTEXT.md` | 阶段上下文与决策记录 | {{planning_context_status}} | {{planning_context_notes}} |
+| `.devflow/planning/milestones/` | 已归档里程碑和交付结果 | {{planning_milestones_status}} | {{planning_milestones_notes}} |
+| `.devflow/planning/requirements/` | 当前或历史需求基线 | {{planning_requirements_status}} | {{planning_requirements_notes}} |
+| `.devflow/planning/lessons/` | 跨里程碑经验教训 | {{planning_lessons_status}} | {{planning_lessons_notes}} |
+| `.devflow/planning/*/CONTEXT.md` | 阶段上下文与决策记录 | {{planning_context_status}} | {{planning_context_notes}} |
 | `features/` | Legacy feature docs, only if present | {{features_history_status}} | {{features_history_notes}} |
-| `.context/lessons/` | Legacy/project-rule lessons, only if present | {{context_lessons_status}} | {{context_lessons_notes}} |
+| `.devflow/context/lessons/` | Legacy/project-rule lessons, only if present | {{context_lessons_status}} | {{context_lessons_notes}} |
 
 ## Shared References
 
 | Item | Path | Notes |
 |------|------|-------|
-| Project Context | `.planning/PROJECT.md` | 项目总览、结构、约束、关键决策 |
-| Workflow State | `.planning/STATE.md` | 初始化状态和后续建议 |
-| Navigation Index | `.planning/navigation/INDEX.md` | 后续 skill 的快捷入口 |
-| Code Index | `.planning/code-index/` | 机器事实索引，细粒度调用/符号/数据流追踪；fast mode 可跳过 |
-| Requirements Baseline | `.planning/requirements/baseline.md` | 需求讨论后生成，不在初始化阶段创建 |
-| Feature Breakdown | `.planning/features/{功能名}/功能点梳理.md` | 需求基线后生成的测试可读功能点梳理 |
-| Frontend Tech Doc | `.planning/features/{功能名}/前端技术方案.md` | 前端技术方案输出 |
-| Backend Tech Doc | `.planning/features/{功能名}/后端技术方案.md` | 后端技术方案输出 |
-| Change List | `.planning/features/{功能名}/变更清单.md` | 变更清单输出 |
-| Codebase Map | `.planning/codebase/` | 可选，深度代码库扫描结果 |
+| Project Context | `.devflow/planning/PROJECT.md` | 项目总览、结构、约束、关键决策 |
+| Workflow State | `.devflow/planning/STATE.md` | 初始化状态和后续建议 |
+| Navigation Index | `.devflow/planning/navigation/INDEX.md` | 后续 skill 的快捷入口 |
+| Code Index | `.devflow/planning/code-index/` | 机器事实索引，细粒度调用/符号/数据流追踪；fast mode 可跳过 |
+| Requirements Baseline | `.devflow/planning/requirements/baseline.md` | 需求讨论后生成，不在初始化阶段创建 |
+| Feature Breakdown | `.devflow/planning/features/{功能名}/功能点梳理.md` | 需求基线后生成的测试可读功能点梳理 |
+| Frontend Tech Doc | `.devflow/planning/features/{功能名}/前端技术方案.md` | 前端技术方案输出 |
+| Backend Tech Doc | `.devflow/planning/features/{功能名}/后端技术方案.md` | 后端技术方案输出 |
+| Change List | `.devflow/planning/features/{功能名}/变更清单.md` | 变更清单输出 |
+| Codebase Map | `.devflow/planning/codebase/` | 可选，深度代码库扫描结果 |
 
 ## Constraints
 

package/plugins/devflow-core/skills/workflow-project-context/assets/rules-index-template.md

@@ -6,15 +6,15 @@
 
 | Rule File | Purpose | Status |
 |-----------|---------|--------|
-| `.planning/execution-contract.md` | Layer order, TDD strategy, codegen and verification gates | {{execution_contract_status}} |
-| `.planning/toolchain.md` | Build, test, lint, mock, migration commands | {{toolchain_status}} |
-| `.planning/lessons/README.md` | Cross-milestone lessons learned | {{lessons_status}} |
-| `.planning/code-index/` | Machine code facts: symbols, relations, entrypoints, and data flow | {{code_index_status}} |
-| `.context/spec/design/` | Frontend UI/UX recommendations and project-level design tokens | {{design_rule_pack_status}} |
-| `.context/spec/index.md` | Generated technical spec registry and read order | {{context_spec_index_status}} |
-| `.context/spec/stacks/` | Generated stack-level technical specs | {{stack_specs_status}} |
-| `.context/workflow/` | Existing workflow gates (TDD, verification, checklist) | {{context_workflow_status}} |
-| `.context/lessons/README.md` | Legacy project lessons | {{context_lessons_status}} |
+| `.devflow/planning/execution-contract.md` | Layer order, TDD strategy, codegen and verification gates | {{execution_contract_status}} |
+| `.devflow/planning/toolchain.md` | Build, test, lint, mock, migration commands | {{toolchain_status}} |
+| `.devflow/planning/lessons/README.md` | Cross-milestone lessons learned | {{lessons_status}} |
+| `.devflow/planning/code-index/` | Machine code facts: symbols, relations, entrypoints, and data flow | {{code_index_status}} |
+| `.devflow/context/spec/design/` | Frontend UI/UX recommendations and project-level design tokens | {{design_rule_pack_status}} |
+| `.devflow/context/spec/index.md` | Generated technical spec registry and read order | {{context_spec_index_status}} |
+| `.devflow/context/spec/stacks/` | Generated stack-level technical specs | {{stack_specs_status}} |
+| `.devflow/context/workflow/` | Existing workflow gates (TDD, verification, checklist) | {{context_workflow_status}} |
+| `.devflow/context/lessons/README.md` | Legacy project lessons | {{context_lessons_status}} |
 | `AGENTS.md` / `CLAUDE.md` | Root agent instructions | {{root_instructions_status}} |
 | `.cursorrules` | IDE-level AI rules | {{cursorrules_status}} |
 
@@ -22,58 +22,58 @@
 
 | Rule File | Path | Status |
 |-----------|------|--------|
-| Frontend Spec Index | `.context/spec/frontend/index.md` | {{frontend_spec_index_status}} |
-| Frontend Specs | `.context/spec/frontend/` | {{frontend_specs_status}} |
-| Design Specs | `.context/spec/design/` | {{design_specs_status}} |
+| Frontend Spec Index | `.devflow/context/spec/frontend/index.md` | {{frontend_spec_index_status}} |
+| Frontend Specs | `.devflow/context/spec/frontend/` | {{frontend_specs_status}} |
+| Design Specs | `.devflow/context/spec/design/` | {{design_specs_status}} |
 
 ## Backend Rules
 
 | Rule File | Path | Status |
 |-----------|------|--------|
-| Backend Spec Index | `.context/spec/backend/index.md` | {{backend_spec_index_status}} |
-| Backend Specs | `.context/spec/backend/` | {{backend_specs_status}} |
+| Backend Spec Index | `.devflow/context/spec/backend/index.md` | {{backend_spec_index_status}} |
+| Backend Specs | `.devflow/context/spec/backend/` | {{backend_specs_status}} |
 
 ## Stack Specs
 
 | Stack Key | Path | Codebases | Status |
 |-----------|------|-----------|--------|
-| {{stack_key}} | `.context/spec/stacks/{{stack_key}}.md` | {{codebases}} | {{stack_spec_status}} |
+| {{stack_key}} | `.devflow/context/spec/stacks/{{stack_key}}.md` | {{codebases}} | {{stack_spec_status}} |
 
 ## Codebase Specs
 
 | Codebase | Type | Stack Key | Path | Status |
 |----------|------|-----------|------|--------|
-| {{codebase_name}} | {{codebase_type}} | {{stack_key}} | `.context/spec/{{domain}}/{{codebase_name}}.md` | {{codebase_spec_status}} |
+| {{codebase_name}} | {{codebase_type}} | {{stack_key}} | `.devflow/context/spec/{{domain}}/{{codebase_name}}.md` | {{codebase_spec_status}} |
 
 ## Spec Read Contract
 
 Downstream skills must read technical rules in this order:
 
-1. `.planning/rules/INDEX.md`
-2. `.context/spec/index.md`
-3. Matching `.context/spec/stacks/{stack_key}.md`
-4. Matching `.context/spec/frontend|backend/{codebase}.md`
-5. Matching `.context/spec/{domain}/index.md` and applicable depth specs
-6. Matching `.planning/navigation/{codebase}.md`
-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
+1. `.devflow/planning/rules/INDEX.md`
+2. `.devflow/context/spec/index.md`
+3. Matching `.devflow/context/spec/stacks/{stack_key}.md`
+4. Matching `.devflow/context/spec/frontend|backend/{codebase}.md`
+5. Matching `.devflow/context/spec/{domain}/index.md` and applicable depth specs
+6. Matching `.devflow/planning/navigation/{codebase}.md`
+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
 8. Actual source files
 
 ## Workflow Rules
 
 | Rule File | Path | Status |
 |-----------|------|--------|
-| TDD Gate | `.context/workflow/tdd.md` | {{tdd_status}} |
-| Verification Gate | `.context/workflow/verification.md` | {{verification_status}} |
-| Checklist | `.context/workflow/checklist.md` | {{checklist_status}} |
+| TDD Gate | `.devflow/context/workflow/tdd.md` | {{tdd_status}} |
+| Verification Gate | `.devflow/context/workflow/verification.md` | {{verification_status}} |
+| Checklist | `.devflow/context/workflow/checklist.md` | {{checklist_status}} |
 
 ## History Model
 
 | Source | Role | Status |
 |--------|------|--------|
-| `.planning/milestones/` | Archived milestone summaries | {{milestones_status}} |
-| `.planning/requirements/` | Requirement baselines | {{requirements_status}} |
-| `.planning/lessons/` | Cross-milestone lessons | {{planning_lessons_status}} |
-| `.planning/*/CONTEXT.md` | Phase/session decisions | {{context_md_status}} |
+| `.devflow/planning/milestones/` | Archived milestone summaries | {{milestones_status}} |
+| `.devflow/planning/requirements/` | Requirement baselines | {{requirements_status}} |
+| `.devflow/planning/lessons/` | Cross-milestone lessons | {{planning_lessons_status}} |
+| `.devflow/planning/*/CONTEXT.md` | Phase/session decisions | {{context_md_status}} |
 
 ---
 

package/plugins/devflow-core/skills/workflow-project-context/assets/state-template.md

@@ -9,9 +9,9 @@
 - **Run Started At**: {{run_started_at}}
 - **Last Scan At**: {{last_scan_at}}
 - **Initialized By**: `workflow-project-context`
-- **Project File**: `.planning/PROJECT.md`
-- **Navigation Root**: `.planning/navigation/`
-- **Code Index Root**: `.planning/code-index/`（generated by default unless fast mode skipped it）
+- **Project File**: `.devflow/planning/PROJECT.md`
+- **Navigation Root**: `.devflow/planning/navigation/`
+- **Code Index Root**: `.devflow/planning/code-index/`（generated by default unless fast mode skipped it）
 
 ## Workflow State
 
@@ -25,7 +25,7 @@
 | Name | Type | Path | Scan Status | Navigation File |
 |------|------|------|-------------|-----------------|
 {{#codebases}}
-| {{name}} | {{type}} | {{path}} | {{scan_status}} | `.planning/navigation/{{name}}.md` |
+| {{name}} | {{type}} | {{path}} | {{scan_status}} | `.devflow/planning/navigation/{{name}}.md` |
 {{/codebases}}
 
 ## Completion
@@ -39,9 +39,9 @@
 {{#codebases}}
 | {{name}} navigation | {{nav_status}} | {{nav_notes}} |
 {{/codebases}}
-| Rules index (`.planning/rules/INDEX.md`) | {{rules_index_status}} | {{rules_index_notes}} |
-| Execution contract (`.planning/execution-contract.md`) | {{execution_contract_status}} | {{execution_contract_notes}} |
-| Toolchain contract (`.planning/toolchain.md`) | {{toolchain_status}} | {{toolchain_notes}} |
+| Rules index (`.devflow/planning/rules/INDEX.md`) | {{rules_index_status}} | {{rules_index_notes}} |
+| Execution contract (`.devflow/planning/execution-contract.md`) | {{execution_contract_status}} | {{execution_contract_notes}} |
+| Toolchain contract (`.devflow/planning/toolchain.md`) | {{toolchain_status}} | {{toolchain_notes}} |
 | Project rule package (other sources) | {{project_rule_package_status}} | {{project_rule_package_notes}} |
 | Requirements baseline | Not created | Created later by workflow-requirement-baseline |
 | Feature breakdown | Not created | Created later by workflow-feature-breakdown |

package/plugins/devflow-core/skills/workflow-project-context/references/navigation-guide.md

@@ -16,20 +16,20 @@ Run the following for EACH codebase identified in Step 1:
 4. Read README files only for commands and architecture notes.
 5. Inspect top-level source folders and common entry files.
 6. Identify project rule package sources (once for the whole project, not per codebase):
-   - `.planning/rules/INDEX.md`
-   - `.planning/execution-contract.md`
-   - `.planning/toolchain.md`
-   - `.planning/lessons/README.md`
-   - `.planning/milestones/`
-   - `.planning/requirements/`
-   - `.context/spec/`
-   - `.context/workflow/`
-   - `.context/lessons/README.md`
+   - `.devflow/planning/rules/INDEX.md`
+   - `.devflow/planning/execution-contract.md`
+   - `.devflow/planning/toolchain.md`
+   - `.devflow/planning/lessons/README.md`
+   - `.devflow/planning/milestones/`
+   - `.devflow/planning/requirements/`
+   - `.devflow/context/spec/`
+   - `.devflow/context/workflow/`
+   - `.devflow/context/lessons/README.md`
    - root `AGENTS.md` / `CLAUDE.md`
    - `.cursorrules` files within each codebase root
 7. Identify history model locations (once for the whole project):
-   - primary: `.planning/milestones/`, `.planning/requirements/`, `.planning/lessons/`, `.planning/*/CONTEXT.md`
-   - optional legacy: `features/`, `.context/lessons/`
+   - primary: `.devflow/planning/milestones/`, `.devflow/planning/requirements/`, `.devflow/planning/lessons/`, `.devflow/planning/*/CONTEXT.md`
+   - optional legacy: `features/`, `.devflow/context/lessons/`
 8. Stop once entry points, conventions, commands, rule package locations, and history model locations are identified for each codebase.
 
 ## Scan Depth
@@ -113,7 +113,7 @@ Frontend navigation fields:
 - Styles / theme
 - Env config
 - Dev/build/test commands
-- Frontend rule sources such as `.context/spec/frontend/`, `.context/spec/design/`, `.planning/rules/`, `.planning/toolchain.md`, and lessons
+- Frontend rule sources such as `.devflow/context/spec/frontend/`, `.devflow/context/spec/design/`, `.devflow/planning/rules/`, `.devflow/planning/toolchain.md`, and lessons
 
 ## Frontend Stack Slot Detection
 
@@ -202,45 +202,45 @@ Common sources:
 
 | Source | Purpose |
 |--------|---------|
-| `.planning/rules/INDEX.md` | Project rule index used by workflow skills |
-| `.planning/execution-contract.md` | Layer order, TDD strategy, codegen and verification gates |
-| `.planning/toolchain.md` | Build, test, lint, mock, migration, and codegen commands |
-| `.planning/lessons/README.md` | Project lessons maintained by workflow |
-| `.planning/milestones/` | Primary milestone/history records for this workflow |
-| `.planning/requirements/` | Current or historical requirement baselines |
-| `.context/spec/index.md` | Generated or existing technical spec registry |
-| `.context/spec/stacks/` | Stack-level technical specs generated from stack profiles |
-| `.context/spec/frontend/` / `.context/spec/backend/` | Codebase-specific technical specs |
-| `.context/workflow/` | Existing workflow gates such as TDD and verification |
-| `.context/lessons/README.md` | Existing lessons from project work |
+| `.devflow/planning/rules/INDEX.md` | Project rule index used by workflow skills |
+| `.devflow/planning/execution-contract.md` | Layer order, TDD strategy, codegen and verification gates |
+| `.devflow/planning/toolchain.md` | Build, test, lint, mock, migration, and codegen commands |
+| `.devflow/planning/lessons/README.md` | Project lessons maintained by workflow |
+| `.devflow/planning/milestones/` | Primary milestone/history records for this workflow |
+| `.devflow/planning/requirements/` | Current or historical requirement baselines |
+| `.devflow/context/spec/index.md` | Generated or existing technical spec registry |
+| `.devflow/context/spec/stacks/` | Stack-level technical specs generated from stack profiles |
+| `.devflow/context/spec/frontend/` / `.devflow/context/spec/backend/` | Codebase-specific technical specs |
+| `.devflow/context/workflow/` | Existing workflow gates such as TDD and verification |
+| `.devflow/context/lessons/README.md` | Existing lessons from project work |
 | `AGENTS.md` / `CLAUDE.md` | Root agent instructions |
 
-If both `.planning/rules/` and `.context/spec/` exist, record both. Do not merge them during initialization.
+If both `.devflow/planning/rules/` and `.devflow/context/spec/` exist, record both. Do not merge them during initialization.
 
 ## Generated Context Spec Checks
 
-When project initialization generates `.context/spec/`, verify:
+When project initialization generates `.devflow/context/spec/`, verify:
 
 - Every local/scannable codebase has a stack profile with `stack_key`, manifest path, and dependency fingerprint.
-- Every unique `stack_key` has exactly one `.context/spec/stacks/{stack_key}.md`.
-- Every frontend-type codebase has `.context/spec/frontend/{name}.md`.
-- Every backend/service-type codebase has `.context/spec/backend/{name}.md`.
-- `.context/spec/index.md` maps each codebase to its stack spec, codebase spec, and navigation file.
+- Every unique `stack_key` has exactly one `.devflow/context/spec/stacks/{stack_key}.md`.
+- Every frontend-type codebase has `.devflow/context/spec/frontend/{name}.md`.
+- Every backend/service-type codebase has `.devflow/context/spec/backend/{name}.md`.
+- `.devflow/context/spec/index.md` maps each codebase to its stack spec, codebase spec, and navigation file.
 - Generated specs include version metadata and regeneration triggers.
 - Stack specs contain stack-level guidance only; codebase-local paths and route/module names belong in codebase specs.
 
 ## History Model Detection
 
-This workflow uses `.planning` artifacts as the primary long-term memory. Do not assume outbound-call style `features/*.spec.md` history exists.
+This workflow uses `.devflow/planning` artifacts as the primary long-term memory. Do not assume outbound-call style `features/*.spec.md` history exists.
 
 | Source | Role |
 |--------|------|
-| `.planning/milestones/` | Archived milestones and delivery summaries |
-| `.planning/requirements/` | Requirement baselines and requirement decisions |
-| `.planning/lessons/` | Cross-milestone lessons |
-| `.planning/*/CONTEXT.md` | Phase/session decisions and handoff context |
+| `.devflow/planning/milestones/` | Archived milestones and delivery summaries |
+| `.devflow/planning/requirements/` | Requirement baselines and requirement decisions |
+| `.devflow/planning/lessons/` | Cross-milestone lessons |
+| `.devflow/planning/*/CONTEXT.md` | Phase/session decisions and handoff context |
 | `features/` | Optional legacy feature docs if the target project already has them |
-| `.context/lessons/` | Optional legacy/project-rule lessons |
+| `.devflow/context/lessons/` | Optional legacy/project-rule lessons |
 
 Record whether each primary source exists. Label legacy sources as legacy/project-rule evidence rather than the default history model.
 
@@ -248,14 +248,14 @@ Record whether each primary source exists. Label legacy sources as legacy/projec
 
 - All codebase locations are recorded in the Codebase Registry.
 - Nonexistent or remote-only locations are marked pending.
-- Each codebase has a navigation file at `.planning/navigation/{name}.md`.
+- Each codebase has a navigation file at `.devflow/planning/navigation/{name}.md`.
 - Frameworks are recorded or `待确认` for each codebase.
 - Entry points and key directories are recorded or `待确认` for each codebase.
 - Frontend-type codebases have component conventions.
 - Backend-type codebases have layer conventions.
 - Dev/build/test commands are recorded or `待确认` for each codebase.
 - Project rule package sources are recorded when present.
-- History model sources are recorded, with `.planning` sources primary and legacy sources labeled.
+- History model sources are recorded, with `.devflow/planning` sources primary and legacy sources labeled.
 - `STATE.md` includes current step, completed steps, pending steps, blockers, and next action.
 - `INDEX.md` includes Codebase Registry and downstream read contract.
 - Initialization quality is marked as `complete`, `partial`, `pending`, or `not_applicable`.

package/plugins/devflow-core/skills/workflow-project-context/scripts/validate_initialization.py

@@ -17,25 +17,25 @@ SKILL_ROOT = Path(__file__).resolve().parents[1]
 SPEC_TEMPLATE_ROOT = SKILL_ROOT / "assets" / "spec-templates"
 
 CODE_INDEX_FILES = (
-    ".planning/code-index/index.sqlite",
-    ".planning/code-index/files.jsonl",
-    ".planning/code-index/symbols.jsonl",
-    ".planning/code-index/relations.jsonl",
-    ".planning/code-index/AUDIT.md",
+    ".devflow/planning/code-index/index.sqlite",
+    ".devflow/planning/code-index/files.jsonl",
+    ".devflow/planning/code-index/symbols.jsonl",
+    ".devflow/planning/code-index/relations.jsonl",
+    ".devflow/planning/code-index/AUDIT.md",
 )
 
 DESIGN_RULE_PACK_FILES = (
-    ".context/spec/design/tokens/project-tokens.md",
-    ".context/spec/design/recommendations/accessibility.md",
-    ".context/spec/design/recommendations/component-library.md",
-    ".context/spec/design/tools/ui-ux-pro-max/SKILL.md",
+    ".devflow/context/spec/design/tokens/project-tokens.md",
+    ".devflow/context/spec/design/recommendations/accessibility.md",
+    ".devflow/context/spec/design/recommendations/component-library.md",
+    ".devflow/context/spec/design/tools/ui-ux-pro-max/SKILL.md",
 )
 
 STATUS_FILES = (
-    ".planning/STATE.md",
-    ".planning/PROJECT.md",
-    ".planning/navigation/INDEX.md",
-    ".planning/rules/INDEX.md",
+    ".devflow/planning/STATE.md",
+    ".devflow/planning/PROJECT.md",
+    ".devflow/planning/navigation/INDEX.md",
+    ".devflow/planning/rules/INDEX.md",
 )
 
 
@@ -44,7 +44,7 @@ def parse_args() -> argparse.Namespace:
     parser.add_argument("--root", default=".")
     parser.add_argument(
         "--manifest",
-        default=".planning/project-context-run.json",
+        default=".devflow/planning/project-context-run.json",
     )
     return parser.parse_args()
 
@@ -136,7 +136,7 @@ def validate_status_markers(
         content = path.read_text(encoding="utf-8")
         if marker not in content:
             errors.append(f"current-run status marker missing: {relative_path}")
-        if relative_path == ".planning/STATE.md" and "PENDING_TEMPLATE" in content:
+        if relative_path == ".devflow/planning/STATE.md" and "PENDING_TEMPLATE" in content:
             errors.append("STATE.md contains an unresolved PENDING_TEMPLATE blocker")
 
 
@@ -459,7 +459,7 @@ def validate_domain_indexes(
         )
 
     for domain, expected_markers in expected_by_domain.items():
-        relative_path = f".context/spec/{domain}/index.md"
+        relative_path = f".devflow/context/spec/{domain}/index.md"
         path = resolve_project_path(root, relative_path)
         require_fresh_file(path, started_at, errors)
         if not path.is_file():

package/plugins/devflow-core/skills/workflow-project-context/scripts/validate_initialization_database.py

@@ -32,7 +32,7 @@ def validate(database: Path, project_id: str, workspace_id: str | None = None, r
     connection.row_factory = sqlite3.Row
     try:
         version = connection.execute("SELECT version FROM schema_meta LIMIT 1").fetchone()
-        if not version or version["version"] != 2:
+        if not version or version["version"] != 3:
             errors.append(f"unsupported initialization schema: {version['version'] if version else 'missing'}")
         if not connection.execute("SELECT 1 FROM projects WHERE id=?", (project_id,)).fetchone():
             errors.append("project identity is not registered in the database")

package/plugins/devflow-design/skills/workflow-api-call-guide/SKILL.md

@@ -26,8 +26,8 @@ description: "Use after backend-tech-spec, before integration-verify. Generates
 
 ## 产出位置
 
-- `.planning/features/{功能名}/api-call-guide.md`
-- `.planning/features/{功能名}/api-call-guide.meta.json`
+- `.devflow/planning/features/{功能名}/api-call-guide.md`
+- `.devflow/planning/features/{功能名}/api-call-guide.meta.json`
 
 `api-call-guide.meta.json` 必须包含：
 
@@ -44,8 +44,8 @@ description: "Use after backend-tech-spec, before integration-verify. Generates
 
 ## 输入
 
-- `.planning/features/{功能名}/api-contract.md` — **API 签名唯一权威源**
-- `.planning/features/{功能名}/后端技术方案.md` — 后端实现细节和 seam 位置
+- `.devflow/planning/features/{功能名}/api-contract.md` — **API 签名唯一权威源**
+- `.devflow/planning/features/{功能名}/后端技术方案.md` — 后端实现细节和 seam 位置
 
 ## 核心原则
 

package/plugins/devflow-design/skills/workflow-api-contract/SKILL.md

@@ -24,17 +24,17 @@ description: "Use after requirement-baseline, before dual-track fork. Defines sh
 
 ## 产出位置
 
-- `.planning/features/{功能名}/api-contract.md`
-- `.planning/features/{功能名}/api-contract.meta.json`
+- `.devflow/planning/features/{功能名}/api-contract.md`
+- `.devflow/planning/features/{功能名}/api-contract.meta.json`
 
 The meta file must also set `traceability_status: "passed"` only after every API design has been written to `traceability.json.designs` and `traceability_check.py --stage design` succeeds; otherwise set `failed` and do not advance.
 
 ## 输入
 
-- `.planning/requirements/baseline.md` — 需求基线（FP/BR/BC）
-- `.planning/navigation/INDEX.md` 和相关 codebase navigation — 粗定位已有接口
-- `.planning/code-index/`（如存在）— 查询已有 route/handler/API symbol 与 `routes_to` / `calls` 关系，确认接口复用和冲突
-- `.planning/requirements/{feature}/traceability.json` — 每个接口必须回指它的 `REQ-*`，不能只写 FP 标题
+- `.devflow/planning/requirements/baseline.md` — 需求基线（FP/BR/BC）
+- `.devflow/planning/navigation/INDEX.md` 和相关 codebase navigation — 粗定位已有接口
+- `.devflow/planning/code-index/`（如存在）— 查询已有 route/handler/API symbol 与 `routes_to` / `calls` 关系，确认接口复用和冲突
+- `.devflow/planning/requirements/{feature}/traceability.json` — 每个接口必须回指它的 `REQ-*`，不能只写 FP 标题
 
 使用 code-index 时，必须回读 `evidence_path:evidence_line` 附近源码后再把既有接口写入契约；不得只凭 Markdown navigation 或 relation 摘要判断。
 
@@ -46,7 +46,7 @@ The meta file must also set `traceability_status: "passed"` only after every API
 4. **负载职责明确** — 事务命令、运营查询和统计查询不得在同一个接口语义中混写；统计查询必须引用已确认的 `METRIC-*`，并在响应中约定 `as_of`/新鲜度语义或明确强一致依据。
 5. **数据模型共享** — 核心业务实体定义在这里，前后端共用一个数据模型
 6. **切片对齐** — 若 baseline 包含 `SL-*`，先读取 `skill://workflow-pipeline/references/slice-safety-guide.md`，只为当前执行切片定义 API。后置切片接口不得提前进入契约。
-7. **既有接口优先查事实索引** — 当 `.planning/code-index/` 存在时，先用 Symbol/Relation 定位候选接口、调用方和处理器，再读取源码证据；缺失或过期时再按 navigation 和 `rg` 兜底。
+7. **既有接口优先查事实索引** — 当 `.devflow/planning/code-index/` 存在时，先用 Symbol/Relation 定位候选接口、调用方和处理器，再读取源码证据；缺失或过期时再按 navigation 和 `rg` 兜底。
 
 ## 可测试 API 契约（强制）
 
@@ -182,7 +182,7 @@ The meta file must also set `traceability_status: "passed"` only after every API
 - [ ] 每个涉及 API 的 FP 至少映射到一个接口
 - [ ] 若存在 `SL-*`，每个接口都标注当前 Slice ID，且未包含后置切片接口
 - [ ] 每个接口有完整的请求/响应结构
-- [ ] 若 `.planning/code-index/` 存在，已有接口复用/冲突判断已查询 code-index 并回读源码 evidence；未使用时已说明原因
+- [ ] 若 `.devflow/planning/code-index/` 存在，已有接口复用/冲突判断已查询 code-index 并回读源码 evidence；未使用时已说明原因
 - [ ] 核心数据模型已定义字段和类型
 - [ ] 没有包含实现细节（SQL、表结构、代码片段）
 - [ ] meta.json 中 `endpoint_count` 已记录接口总数

package/plugins/devflow-design/skills/workflow-api-supplement/SKILL.md

@@ -27,14 +27,14 @@ orchestrator 通过以下方式检测是否需要触发本 skill：
 
 ## 输入
 
-- `.planning/features/{功能名}/api-contract.md` — 已有 API 契约
-- `.planning/features/{功能名}/前端技术方案.md` — 刚刚完成的前端方案
-- `.planning/features/{功能名}/UI-SPEC.md` — UI 设计规范
+- `.devflow/planning/features/{功能名}/api-contract.md` — 已有 API 契约
+- `.devflow/planning/features/{功能名}/前端技术方案.md` — 刚刚完成的前端方案
+- `.devflow/planning/features/{功能名}/UI-SPEC.md` — UI 设计规范
 
 ## 产出
 
-- `.planning/features/{功能名}/api-supplement-requests.md`
-- `.planning/features/{功能名}/api-supplement-requests.meta.json`
+- `.devflow/planning/features/{功能名}/api-supplement-requests.md`
+- `.devflow/planning/features/{功能名}/api-supplement-requests.meta.json`
 
 即使没有 API 补充需求，也要生成 no-op meta：
 

package/plugins/devflow-design/skills/workflow-architecture-feasibility/SKILL.md

@@ -24,7 +24,7 @@ description: "Use after API contract and before frontend/backend technical speci
    - `recommendation_option_id` 是建议，不是自动决策。
 5. 对 `full` 评估，提交 `risk_type: architecture_option_risk` 的 `RISK` candidate，连接 `DECISION/WSH/WLC → RISK`，relation 为 `has_architecture_risk`。必须写失败模式、影响、处理、处理方式、负责人和复核条件。
 6. 只用 `devflow_requirement_graph(action="confirm")` 确认 WSH/WLC、架构 DECISION 和架构 RISK。Core 必须展示确认对话；确认方案比较时，用户确认的是显示的 `recommendation_option_id`，确认风险时只确认处理责任，不宣称生产风险已消失。
-7. 调用 `devflow_architecture_brief(action="render")` 生成 `.planning/features/{feature}/architecture-brief.md` 及 meta。不得手写或补写简报正文。
+7. 调用 `devflow_architecture_brief(action="render")` 生成 `.devflow/planning/features/{feature}/architecture-brief.md` 及 meta。不得手写或补写简报正文。
 
 ## 不变量