@guanlin4924/devflow-pi 0.1.93 → 0.1.95

package/plugins/devflow-intel/skills/code-index-query/SKILL.md

@@ -1,29 +1,29 @@
 ---
 name: code-index-query
-description: Query a generated .planning/code-index machine index to answer code structure questions. Use when the OMP development agent needs callers, callees, entrypoint flows, imports, resource reads/writes, tested_by links, or symbol locations before reading source evidence.
+description: Query a generated .devflow/planning/code-index machine index to answer code structure questions. Use when the OMP development agent needs callers, callees, entrypoint flows, imports, resource reads/writes, tested_by links, or symbol locations before reading source evidence.
 ---
 
 # Code Index Query
 
-Use this skill to answer source-structure questions from `.planning/code-index/`.
+Use this skill to answer source-structure questions from `.devflow/planning/code-index/`.
 
 ## Project-root resolution
 
 The runtime directory may be a nested codebase such as `drama-ad/backend`. Before checking the index, resolve the project root from the runtime directory using the same rule as project initialization:
 
 1. Walk upward from the runtime directory and select the nearest ancestor containing `.devflow/project.json`.
-2. If no manifest exists, select the nearest ancestor containing `.planning/code-index/index.sqlite` or `.planning/PROJECT.md`.
+2. If no manifest exists, select the nearest ancestor containing `.devflow/planning/code-index/index.sqlite` or `.devflow/planning/PROJECT.md`.
 3. Only if neither exists, use the runtime directory and report that the project root is uninitialized.
 
-All index checks and `devflow_code_index` calls must run with that resolved root as the working directory. Source paths remain relative to the resolved root, so a source file may be `drama-ad/backend/...` while the index remains `.planning/code-index/...`. Never append `.planning` to a selected source/codebase directory.
+All index checks and `devflow_code_index` calls must run with that resolved root as the working directory. Source paths remain relative to the resolved root, so a source file may be `drama-ad/backend/...` while the index remains `.devflow/planning/code-index/...`. Never append `.devflow/planning` to a selected source/codebase directory.
 
-The tool returns the resolved `projectRoot` in its details. If the root cannot be resolved, stop and report the exact check command/path instead of probing `<source-dir>/.planning`.
+The tool returns the resolved `projectRoot` in its details. If the root cannot be resolved, stop and report the exact check command/path instead of probing `<source-dir>/.devflow/planning`.
 
 If the index is missing, stale, fails validation, or returns no useful hit, do not block the source question. Record the machine failure and use a bounded `rg`/`grep` or LSP search within the registered codebase roots. Mark the result `degraded_index_coverage` and include the exact fallback scope; do not claim index-derived relations or complete impact coverage.
 
 ## Required Flow
 
-1. Check that `.planning/code-index/index.sqlite` or JSONL sidecars exist.
+1. Check that `.devflow/planning/code-index/index.sqlite` or JSONL sidecars exist.
 2. Search symbols or relations using the machine index.
 3. Expand relation edges as needed.
 4. Read source files at `evidence_path`.

package/plugins/devflow-intel/skills/workflow-code-index/SKILL.md

@@ -11,17 +11,17 @@ Build a generic code intelligence index for the current project. This skill is p
 
 Write generated artifacts to the target project:
 
-- `.planning/code-index/files.jsonl`
-- `.planning/code-index/symbols.jsonl`
-- `.planning/code-index/relations.jsonl`
-- `.planning/code-index/diagnostics.jsonl`
-- `.planning/code-index/index.sqlite`
-- `.planning/code-index/INDEX.md`
-- `.planning/code-index/SYMBOLS.md`
-- `.planning/code-index/RELATIONS.md`
-- `.planning/code-index/ENTRYPOINTS.md`
-- `.planning/code-index/DATAFLOW.md`
-- `.planning/code-index/AUDIT.md` when auditing
+- `.devflow/planning/code-index/files.jsonl`
+- `.devflow/planning/code-index/symbols.jsonl`
+- `.devflow/planning/code-index/relations.jsonl`
+- `.devflow/planning/code-index/diagnostics.jsonl`
+- `.devflow/planning/code-index/index.sqlite`
+- `.devflow/planning/code-index/INDEX.md`
+- `.devflow/planning/code-index/SYMBOLS.md`
+- `.devflow/planning/code-index/RELATIONS.md`
+- `.devflow/planning/code-index/ENTRYPOINTS.md`
+- `.devflow/planning/code-index/DATAFLOW.md`
+- `.devflow/planning/code-index/AUDIT.md` when auditing
 
 Markdown is a display layer only. JSONL/SQLite is the machine fact layer.
 
@@ -69,7 +69,7 @@ devflow_code_index(action="scan", changedFiles=["path/to/file.ext"])
 
 ## Audit Gate
 
-`audit` is part of this skill's normal lifecycle, not a separate workflow. Run `validate` before `audit` whenever index files were edited or refreshed, then review `.planning/code-index/AUDIT.md` against `references/audit-checklist.md`.
+`audit` is part of this skill's normal lifecycle, not a separate workflow. Run `validate` before `audit` whenever index files were edited or refreshed, then review `.devflow/planning/code-index/AUDIT.md` against `references/audit-checklist.md`.
 
 Blocking findings are stale file hashes, missing indexed files, dangling `to_id` relations, missing relation evidence, and invalid schema. Unresolved heuristic calls, low-confidence diagnostics, and possible project-bound examples in generic skills are non-blocking but must be reported.
 

package/plugins/devflow-intel/skills/workflow-code-index/references/discovery.md

@@ -3,8 +3,8 @@
 Discover codebases in this order:
 
 1. Explicit CLI arguments: `--codebase name:path[:type]`.
-2. `.planning/navigation/INDEX.md` Codebase Registry.
-3. `.context/spec/index.md` codebase mapping.
+2. `.devflow/planning/navigation/INDEX.md` Codebase Registry.
+3. `.devflow/context/spec/index.md` codebase mapping.
 4. Current working directory fallback.
 
 Normalize each codebase to:

package/plugins/devflow-intel/skills/workflow-code-index/references/query-guide.md

@@ -3,7 +3,7 @@
 Query flow:
 
 1. Load project rules and navigation if present.
-2. Check `.planning/code-index/index.sqlite` or JSONL sidecars.
+2. Check `.devflow/planning/code-index/index.sqlite` or JSONL sidecars.
 3. Search symbols using exact name, qualified name, path, or FTS.
 4. Expand relations by type and depth.
 5. Read source files at `evidence_path`.

package/plugins/devflow-intel/skills/workflow-code-index/scripts/code_index.py

@@ -150,7 +150,7 @@ def _worktree_signature(root: Path) -> str:
     kept = []
     for line in proc.stdout.splitlines():
         path = line[3:].strip() if len(line) > 3 else ""
-        if path.startswith(".planning/code-index/"):
+        if path.startswith(".devflow/planning/code-index/"):
             continue
         kept.append(line)
     return "\n".join(kept)
@@ -198,7 +198,7 @@ def main(argv=None) -> int:
 
     scan = sub.add_parser("scan", help="Build or refresh the code index.")
     scan.add_argument("--root", default=".", help="Project root. Defaults to current directory.")
-    scan.add_argument("--output", default=".planning/code-index", help="Index output directory.")
+    scan.add_argument("--output", default=".devflow/planning/code-index", help="Index output directory.")
     scan.add_argument("--codebase", action="append", default=[], help="Explicit codebase: name:path[:type]. Can repeat.")
     scan.add_argument("--changed-files", nargs="*", default=[], help="Optional changed files for incremental refresh.")
     scan.add_argument("--include", action="append", default=[], help="Repository-relative include glob. Can repeat.")
@@ -206,7 +206,7 @@ def main(argv=None) -> int:
     scan.add_argument("--exclude", action="append", default=[], help="Additional directory names to exclude.")
 
     validate = sub.add_parser("validate", help="Validate an index in staged levels.")
-    validate.add_argument("--index", default=".planning/code-index", help="Index directory.")
+    validate.add_argument("--index", default=".devflow/planning/code-index", help="Index directory.")
     validate.add_argument("--snapshot", help="Immutable generation id.")
     validate.add_argument(
         "--level",
@@ -217,19 +217,19 @@ def main(argv=None) -> int:
 
     audit = sub.add_parser("audit", help="Audit stale files and relation integrity.")
     audit.add_argument("--root", default=".", help="Project root.")
-    audit.add_argument("--index", default=".planning/code-index", help="Index directory.")
+    audit.add_argument("--index", default=".devflow/planning/code-index", help="Index directory.")
     audit.add_argument("--skill-root", default=".skills", help="Optional skill root for project-binding checks.")
     audit.add_argument("--snapshot", help="Immutable generation id.")
     audit.add_argument("--level", choices=("publish", "full"), default="publish")
 
     query = sub.add_parser("query", help="Search symbols using SQLite FTS or LIKE fallback.")
-    query.add_argument("--index", default=".planning/code-index", help="Index directory.")
+    query.add_argument("--index", default=".devflow/planning/code-index", help="Index directory.")
     query.add_argument("--term", required=True, help="Search term.")
     query.add_argument("--limit", type=int, default=20)
     query.add_argument("--snapshot", help="Immutable generation id. Historical queries do not require current workspace freshness.")
 
     relations = sub.add_parser("relations", help="Traverse resolved relations in a fixed snapshot.")
-    relations.add_argument("--index", default=".planning/code-index")
+    relations.add_argument("--index", default=".devflow/planning/code-index")
     relations.add_argument("--object", required=True, help="Source symbol id.")
     relations.add_argument("--depth", type=int, default=3)
     relations.add_argument("--limit", type=int, default=100)
@@ -238,7 +238,7 @@ def main(argv=None) -> int:
     relations.add_argument("--direction", choices=["incoming", "outgoing", "both"], default="outgoing")
 
     impact = sub.add_parser("impact", help="Traverse cross-layer semantic facts in a fixed snapshot.")
-    impact.add_argument("--index", default=".planning/code-index")
+    impact.add_argument("--index", default=".devflow/planning/code-index")
     impact.add_argument("--entity", required=True, help="Logical entity id, feature id, API id, or symbol id.")
     impact.add_argument("--depth", type=int, default=5)
     impact.add_argument("--limit", type=int, default=200)
@@ -247,7 +247,7 @@ def main(argv=None) -> int:
 
     for action in ("search-content", "resolve-domain", "query-plan", "domain-import"):
         operation = sub.add_parser(action)
-        operation.add_argument("--index", default=".planning/code-index")
+        operation.add_argument("--index", default=".devflow/planning/code-index")
         operation.add_argument("--snapshot")
         operation.add_argument("--project-id", default="")
         operation.add_argument("--limit", type=int, default=20)
@@ -615,7 +615,7 @@ def command_structured(args) -> int:
             errors = _validate_snapshot_bundle(selected, snapshot)
             if errors:
                 raise ValueError(errors[0])
-            if not requested and not _query_is_fresh(Path(snapshot.get("workspace", {}).get("root", output.parent.parent)), snapshot, read_jsonl(selected / INDEX_FILES["files"])):
+            if not requested and not _snapshot_is_fresh(snapshot, read_jsonl(selected / INDEX_FILES["files"])):
                 print(json.dumps({"_meta": {"status": "stale_index", "snapshot": snapshot.get("generation")}}))
                 return 1
             conn = read_connection(selected / "index.sqlite")
@@ -662,7 +662,7 @@ def command_query(args) -> int:
             return 1
         limit = _bounded_limit(getattr(args, "limit", 20), 1000)
         files = read_jsonl(selected / INDEX_FILES["files"])
-        if not getattr(args, "snapshot", None) and not _query_is_fresh(output.parent.parent, snapshot, files):
+        if not getattr(args, "snapshot", None) and not _snapshot_is_fresh(snapshot, files):
             print("Stale code index: refresh required before query.", file=sys.stderr)
             return 1
         conn = read_connection(index)
@@ -717,7 +717,7 @@ def command_relations(args) -> int:
         bundle_errors = _validate_snapshot_bundle(selected, snapshot)
         if bundle_errors:
             print(bundle_errors[0], file=sys.stderr); return 1
-        if not getattr(args, "snapshot", None) and not _query_is_fresh(output.parent.parent, snapshot, files):
+        if not getattr(args, "snapshot", None) and not _snapshot_is_fresh(snapshot, files):
             print("Stale code index: refresh required before query.", file=sys.stderr); return 1
         conn = read_connection(selected / "index.sqlite")
         try:
@@ -785,7 +785,7 @@ def command_impact(args) -> int:
             print(bundle_errors[0], file=sys.stderr); return 1
         if not getattr(args, "snapshot", None):
             files = read_jsonl(selected / INDEX_FILES["files"])
-            if not _query_is_fresh(output.parent.parent, snapshot, files):
+            if not _snapshot_is_fresh(snapshot, files):
                 print("Stale code index: refresh required before impact query.", file=sys.stderr)
                 return 1
         conn = read_connection(selected / "index.sqlite")
@@ -905,6 +905,25 @@ def _validate_snapshot_bundle(selected: Path, snapshot: Dict[str, object]) -> Li
     return errors
 
 
+def _snapshot_workspace_root(snapshot: Dict[str, object]) -> Path | None:
+    """The scan root recorded by command_scan, or None when the snapshot has no usable workspace.root.
+
+    Never guessed from the index location: a missing, non-string, blank, relative or non-directory root
+    means freshness cannot be verified, so callers must treat the snapshot as stale.
+    """
+    workspace = snapshot.get("workspace") if isinstance(snapshot, dict) else None
+    raw = workspace.get("root") if isinstance(workspace, dict) else None
+    if not isinstance(raw, str) or not raw.strip() or "\x00" in raw:
+        return None
+    root = Path(raw)
+    return root if root.is_absolute() and root.is_dir() else None
+
+
+def _snapshot_is_fresh(snapshot: Dict[str, object], files: List[dict]) -> bool:
+    root = _snapshot_workspace_root(snapshot)
+    return root is not None and _query_is_fresh(root, snapshot, files)
+
+
 def _query_is_fresh(root: Path, snapshot: Dict[str, object], files: List[dict]) -> bool:
     workspace = snapshot.get("workspace") if isinstance(snapshot, dict) else None
     if not isinstance(workspace, dict):

package/plugins/devflow-intel/skills/workflow-code-index/scripts/core/discovery.py

@@ -45,7 +45,7 @@ def _parse_explicit(root: Path, value: str) -> Optional[Codebase]:
 
 
 def _from_navigation(root: Path) -> List[Codebase]:
-    index = root / ".planning/navigation/INDEX.md"
+    index = root / ".devflow/planning/navigation/INDEX.md"
     if not index.exists():
         return []
     rows = _read_markdown_table(index)
@@ -72,7 +72,7 @@ def _from_navigation(root: Path) -> List[Codebase]:
 
 
 def _from_spec_index(root: Path) -> List[Codebase]:
-    index = root / ".context/spec/index.md"
+    index = root / ".devflow/context/spec/index.md"
     if not index.exists():
         return []
     rows = _read_markdown_table(index)

package/plugins/devflow-intel/skills/workflow-code-index/scripts/core/scanner.py

@@ -7,7 +7,11 @@ from typing import Iterable, List, Sequence
 
 DEFAULT_EXCLUDES = {
     ".git",
+    ".devflow",
+    # Old protocol directories are excluded as source even after the new
+    # namespaced layout becomes authoritative.
     ".planning",
+    ".context",
     "node_modules",
     "vendor",
     "dist",
@@ -139,4 +143,3 @@ def _is_excluded(path: Path, root: Path, excluded: Sequence[str]) -> bool:
     if any(fnmatch.fnmatch(relative, pattern) or fnmatch.fnmatch(relative + "/", pattern.rstrip("/") + "/") for pattern in excluded):
         return True
     return any(part in excluded for part in parts) or any("/" in pattern and ("/" + "/".join(parts) + "/").find("/" + pattern.strip("/") + "/") >= 0 for pattern in excluded)
-

package/plugins/devflow-intel/skills/workflow-code-index/scripts/validators/project_binding_check.py

@@ -5,8 +5,8 @@ from pathlib import Path
 PLACEHOLDER_OK = re.compile(r"\{[A-Za-z0-9_:-]+\}")
 
 GENERIC_TOKENS = (
-    ".planning/",
-    ".context/",
+    ".devflow/planning/",
+    ".devflow/context/",
     ".skills/",
     "references/",
     "scripts/",
@@ -40,8 +40,8 @@ def audit_project_binding(paths):
                 stripped = PLACEHOLDER_OK.sub("", line)
                 if (
                     path_like.search(stripped)
-                    and ".planning/" not in stripped
-                    and ".context/" not in stripped
+                    and ".devflow/planning/" not in stripped
+                    and ".devflow/context/" not in stripped
                     and ".skills/" not in stripped
                 ):
                     findings.append(

package/plugins/devflow-intel/skills/workflow-context-sync/SKILL.md

@@ -28,7 +28,7 @@ code facts changed -> project context must remain trustworthy
 
 Preserve these properties:
 
-- **Freshness**: `.planning/code-index/`, `.planning/navigation/`, and `.context/spec/` must not describe old routes, APIs, entries, services, commands, or codebase roots.
+- **Freshness**: `.devflow/planning/code-index/`, `.devflow/planning/navigation/`, and `.devflow/context/spec/` must not describe old routes, APIs, entries, services, commands, or codebase roots.
 - **Minimality**: do not run a full project initialization when changed-file indexing is enough.
 - **Evidence**: do not update navigation/spec from memory or inference alone; read the changed source or manifest evidence first.
 - **Non-destruction**: do not overwrite user-authored business context; append logs or update machine-derived sections only.
@@ -40,7 +40,7 @@ Preserve these properties:
 |---|---|---|
 | project indexes | Accelerate rule/spec/navigation discovery; fall back to LSP/search/source when stale | Advisory evidence, never a source-read blocker |
 | `workflow-code-index` | Refresh, validate, and audit machine facts | Light, Medium, Full; audit/staleness problems |
-| `workflow-update-navigation` | Update `.planning/navigation/*.md` | Medium route/API/page/service/command changes |
+| `workflow-update-navigation` | Update `.devflow/planning/navigation/*.md` | Medium route/API/page/service/command changes |
 | `workflow-project-context` | Full reinitialization | Full only |
 | `workflow-bug-fix` | Bug-fix main workflow | Must call this skill after verification and lesson capture |
 | `workflow-execute-phase` | Feature implementation workflow | Must call this skill after implementation verification |
@@ -63,9 +63,9 @@ If no flag is provided, default to `--dry-run` and infer changed files from git.
 
 ```text
 workflow-context-sync
-  -> read .planning/rules/INDEX.md
-  -> read .context/spec/index.md
-  -> read .planning/navigation/INDEX.md
+  -> read .devflow/planning/rules/INDEX.md
+  -> read .devflow/context/spec/index.md
+  -> read .devflow/planning/navigation/INDEX.md
   -> collect changed files with per-repo cursor
   -> classify files and affected codebases
   -> choose Light / Medium / Full
@@ -81,7 +81,7 @@ workflow-context-sync
 Maintain pull synchronization state in:
 
 ```text
-.planning/context-sync-state.json
+.devflow/planning/context-sync-state.json
 ```
 
 This file is workflow-owned machine state. It stores one cursor per independently discovered Git repository:
@@ -104,7 +104,7 @@ This file is workflow-owned machine state. It stores one cursor per independentl
 
 Rules:
 
-- Discover repositories from `.planning/navigation/INDEX.md` Codebase Registry, then deduplicate by `git rev-parse --show-toplevel`.
+- Discover repositories from `.devflow/planning/navigation/INDEX.md` Codebase Registry, then deduplicate by `git rev-parse --show-toplevel`.
 - For `--after-pull`, diff `last_synced_head..HEAD` per repo.
 - If a repo has no cursor yet, fall back to `ORIG_HEAD..HEAD` for that repo.
 - If the stored cursor is unavailable or not an ancestor of `HEAD`, use the script-reported fallback/warning and prefer a broader sync level.
@@ -150,7 +150,7 @@ Map paths to codebases:
 | skit-admin | `skit/frontend/admin/**` |
 | skit-h5 | `skit/frontend/h5/**` |
 | skit-backend | `skit/internal/**`, `skit/ioc/**`, `skit/pkg/**`, `skit/backend/migrations/**`, `skit/go.mod`, `skit/Makefile`, `skit/main.go` |
-| project context | `.planning/**`, `.context/spec/**`, `.omp/**`, `AGENTS.md` |
+| project context | `.devflow/planning/**`, `.devflow/context/spec/**`, `.omp/**`, `AGENTS.md` |
 
 Classify impact:
 
@@ -162,7 +162,7 @@ Classify impact:
 | backend boundary | `internal/web/*handler.go`, `ioc/web.go`, `internal/job/**`, public service interfaces | Medium |
 | toolchain/manifest | `package.json`, `go.mod`, `Makefile`, vite/router config | Medium or Full |
 | structure | codebase roots, large directory moves, new top-level/second-level directories | Full |
-| context docs | `.planning/**`, `.context/spec/**` | validate consistency; avoid blind overwrite |
+| context docs | `.devflow/planning/**`, `.devflow/context/spec/**` | validate consistency; avoid blind overwrite |
 
 ## Sync Levels
 
@@ -178,7 +178,7 @@ devflow_code_index(action="validate")
 devflow_code_index(action="audit")
 ```
 
-Then append a concise `.planning/STATE.md` change-log line if this skill modified files.
+Then append a concise `.devflow/planning/STATE.md` change-log line if this skill modified files.
 
 ### Medium
 
@@ -190,10 +190,10 @@ Actions:
 2. Read relevant changed source files.
 3. Read matching navigation/spec entry for each affected codebase.
 4. Update only stale sections, usually:
-   - `.planning/navigation/{codebase}.md`
-   - `.context/spec/frontend|backend/{codebase}.md` only when a codebase rule or stack fact changed
-   - `.planning/toolchain.md` only when commands/manifests changed
-   - `.planning/STATE.md` change log
+   - `.devflow/planning/navigation/{codebase}.md`
+   - `.devflow/context/spec/frontend|backend/{codebase}.md` only when a codebase rule or stack fact changed
+   - `.devflow/planning/toolchain.md` only when commands/manifests changed
+   - `.devflow/planning/STATE.md` change log
 5. Validate and audit code-index again if navigation/spec edits introduce new files or references.
 
 ### Full

package/plugins/devflow-intel/skills/workflow-context-sync/scripts/context_sync_cursor.py

@@ -13,8 +13,8 @@ from pathlib import Path
 from typing import Any
 
 
-DEFAULT_STATE = ".planning/context-sync-state.json"
-NAVIGATION_INDEX = ".planning/navigation/INDEX.md"
+DEFAULT_STATE = ".devflow/planning/context-sync-state.json"
+NAVIGATION_INDEX = ".devflow/planning/navigation/INDEX.md"
 
 
 def run_git(repo: Path, args: list[str], check: bool = True) -> subprocess.CompletedProcess[str]:

package/plugins/devflow-intel/skills/workflow-update-navigation/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: workflow-update-navigation
-description: "Use when code changes require incremental updates to .planning/navigation files before audit, archive, or future workflow steps."
+description: "Use when code changes require incremental updates to .devflow/planning/navigation files before audit, archive, or future workflow steps."
 ---
 
 ## Legacy Command Metadata
@@ -11,9 +11,9 @@ Original slash-command metadata retained only as workflow invocation guidance.
 user-invocable: true
 pattern: generator+reviewer
 inputs:
-- .planning/features/{功能名}/变更清单.md
-- .planning/navigation/
-output: .planning/navigation/{name}.md (updated)
+- .devflow/planning/features/{功能名}/变更清单.md
+- .devflow/planning/navigation/
+output: .devflow/planning/navigation/{name}.md (updated)
 phase-gate:
   step1: 加载变更清单和当前 navigation
   step2: 识别受影响的代码库和模块
@@ -36,22 +36,22 @@ Incrementally update navigation files after code changes. Do not re-scan the ent
 
 Always update:
 
-- `.planning/navigation/{name}.md` — affected codebase navigation files
-- `.planning/navigation/INDEX.md` — Codebase Registry scan status timestamps
+- `.devflow/planning/navigation/{name}.md` — affected codebase navigation files
+- `.devflow/planning/navigation/INDEX.md` — Codebase Registry scan status timestamps
 
-When `.planning/code-index/` exists or code-index support is part of the project workflow, also refresh and audit the machine index before editing Markdown navigation:
+When `.devflow/planning/code-index/` exists or code-index support is part of the project workflow, also refresh and audit the machine index before editing Markdown navigation:
 
-- `.planning/code-index/files.jsonl`
-- `.planning/code-index/symbols.jsonl`
-- `.planning/code-index/relations.jsonl`
-- `.planning/code-index/diagnostics.jsonl`
-- `.planning/code-index/index.sqlite`
-- `.planning/code-index/AUDIT.md`
+- `.devflow/planning/code-index/files.jsonl`
+- `.devflow/planning/code-index/symbols.jsonl`
+- `.devflow/planning/code-index/relations.jsonl`
+- `.devflow/planning/code-index/diagnostics.jsonl`
+- `.devflow/planning/code-index/index.sqlite`
+- `.devflow/planning/code-index/AUDIT.md`
 
 Do not create by default:
 
 - New navigation files (only update existing ones)
-- New `.planning/` directories
+- New `.devflow/planning/` directories
 
 ## Resource Loading
 
@@ -59,10 +59,10 @@ Do not create by default:
 
 ## Phase 1 — Load Change List And Current Navigation
 
-1. Read `.planning/features/{功能名}/变更清单.md` — extract all code-level changes (new/modified/deleted/renamed files).
-2. Read `.planning/navigation/INDEX.md` — identify which codebases are affected by the changes.
-3. For each affected codebase, read its `.planning/navigation/{name}.md`.
-4. If `.planning/code-index/` exists, collect changed file paths and run an incremental code-index refresh before updating Markdown navigation:
+1. Read `.devflow/planning/features/{功能名}/变更清单.md` — extract all code-level changes (new/modified/deleted/renamed files).
+2. Read `.devflow/planning/navigation/INDEX.md` — identify which codebases are affected by the changes.
+3. For each affected codebase, read its `.devflow/planning/navigation/{name}.md`.
+4. If `.devflow/planning/code-index/` exists, collect changed file paths and run an incremental code-index refresh before updating Markdown navigation:
 
 ```text
 devflow_code_index(action="scan", changedFiles=["<changed-file>", "..."])
@@ -130,7 +130,7 @@ For affected handlers, routes, components, jobs, or integrations identified in P
 
 Use the same call chain tracing method as `workflow-project-context` Step 3b, but limited to changed modules only.
 
-If code-index is available, use `.planning/code-index/relations.jsonl` or `index.sqlite` as the first source for fine-grained call relationships, then read the changed source files to confirm evidence before updating navigation. Navigation remains a human-readable summary; do not copy unverified low-confidence relations into navigation as facts.
+If code-index is available, use `.devflow/planning/code-index/relations.jsonl` or `index.sqlite` as the first source for fine-grained call relationships, then read the changed source files to confirm evidence before updating navigation. Navigation remains a human-readable summary; do not copy unverified low-confidence relations into navigation as facts.
 
 Gate: every changed handler/route/component/job from the change list has its corresponding row updated in the navigation file.
 
@@ -150,7 +150,7 @@ If conventions haven't changed, skip this phase.
 1. For each updated codebase navigation file:
    - Update `Identity → Scan Status` to the current date
    - Add a note: "Updated after 变更清单 execution, {日期}"
-2. Update `.planning/navigation/INDEX.md`:
+2. Update `.devflow/planning/navigation/INDEX.md`:
    - Sync the `Scan Status` column in the Codebase Registry for affected codebases
 3. Run the review checklist:
 
@@ -169,18 +169,18 @@ Fix gaps before reporting completion.
 Run these commands after all navigation edits. Replace `<affected-navigation-file>` with every navigation file selected in Phase 1.
 
 ```bash
-test -s .planning/navigation/INDEX.md
-test -s .planning/navigation/<affected-navigation-file>
-test -s .planning/code-index/AUDIT.md  # when the code index exists
+test -s .devflow/planning/navigation/INDEX.md
+test -s .devflow/planning/navigation/<affected-navigation-file>
+test -s .devflow/planning/code-index/AUDIT.md  # when the code index exists
 ```
 
-When `.planning/code-index/` exists, call `devflow_code_index(action="validate")` and
+When `.devflow/planning/code-index/` exists, call `devflow_code_index(action="validate")` and
 `devflow_code_index(action="audit")` before the shell artifact checks.
 
-The code-index commands are required only when `.planning/code-index/` exists or this workflow refreshed it. Pass only when every selected navigation file and `INDEX.md` is non-empty, `validate` and `audit` exit with code 0, and `AUDIT.md` contains no blocking finding. Also complete every Phase 6 checklist item; commands validate artifact integrity, while the checklist validates change-list coverage. If any check fails, do not advance to audit or archive: correct the navigation/index discrepancy and rerun the failed checks.
+The code-index commands are required only when `.devflow/planning/code-index/` exists or this workflow refreshed it. Pass only when every selected navigation file and `INDEX.md` is non-empty, `validate` and `audit` exit with code 0, and `AUDIT.md` contains no blocking finding. Also complete every Phase 6 checklist item; commands validate artifact integrity, while the checklist validates change-list coverage. If any check fails, do not advance to audit or archive: correct the navigation/index discrepancy and rerun the failed checks.
 
 ## Downstream Read Contract
 
 - `workflow-release-closeout` should verify that navigation `Scan Status` is not older than the last commit before archiving.
 - Future `workflow-requirement-baseline` invocations will read the updated navigation for conflict and reuse detection.
-- Future source-tracing tasks should use `.planning/code-index/` for fine-grained relation facts when available, with source readback before answering.
+- Future source-tracing tasks should use `.devflow/planning/code-index/` for fine-grained relation facts when available, with source readback before answering.

package/plugins/devflow-intel/skills/workflow-update-navigation/references/incremental-update-guide.md

@@ -4,7 +4,7 @@
 
 只重新扫描变更清单中涉及的模块。变更清单外的代码库和模块不做任何扫描或写入。
 
-如果项目存在 `.planning/code-index/`，先按变更文件刷新机器索引，再更新 Markdown navigation：
+如果项目存在 `.devflow/planning/code-index/`，先按变更文件刷新机器索引，再更新 Markdown navigation：
 
 ```text
 devflow_code_index(action="scan", changedFiles=["<changed-file>", "..."])
@@ -34,7 +34,7 @@ devflow_code_index(action="audit")
 
 当 code-index 可用时：
 
-1. 先从 `.planning/code-index/index.sqlite` 或 `relations.jsonl` 查 changed files 对应 symbols/relations。
+1. 先从 `.devflow/planning/code-index/index.sqlite` 或 `relations.jsonl` 查 changed files 对应 symbols/relations。
 2. 按 `routes_to`、`calls`、`imports`、`reads`、`writes` 扩展相关边。
 3. 回读 `evidence_path` 源码。
 4. 只把已确认且适合人读摘要的链路写入 navigation。