Sync .cursor from suite (autodev orchestrator + monorepo skills)

.cursor/skills/document/workflows/task.md

@@ -26,6 +26,27 @@ One or more task spec files from `_docs/02_tasks/todo/` or `_docs/02_tasks/done/
 - System-level docs (only if the task changed API endpoints, data models, or external integrations)
 - Problem-level docs (only if the task changed input parameters, acceptance criteria, or restrictions)
 
+### Task Step 0.5: Import-Graph Ripple
+
+A module that changed may be imported by other modules whose docs are now stale even though those other modules themselves were not directly edited. Compute the reverse-dependency set and fold it into the update list.
+
+1. For each source file in the set of changed files from Step 0, build its module-level identifier (Python module path, C# namespace, Rust module path, TS import-specifier, Go package path — depending on the project language).
+2. Search the codebase for files that import from any of those identifiers. Preferred tooling per language:
+   - **Python**: `rg -e "^(from|import) <module>"` then parse with `ast` to confirm actual symbol use.
+   - **TypeScript / JavaScript**: `rg "from ['\"].*<path>"` then resolve via `tsconfig.json` paths / `jsconfig.json` if present.
+   - **C#**: `rg "^using <namespace>"` plus `.csproj` `ProjectReference` graph.
+   - **Rust**: `rg "use <crate>::"` plus `Cargo.toml` workspace members.
+   - **Go**: `rg "\"<module-path>\""` plus `go.mod` requires.
+
+   If a static analyzer is available for the project (e.g., `pydeps`, `madge`, `depcruise`, `NDepend`, `cargo modules`, `go list -deps`), prefer its output — it is more reliable than regex.
+3. For each importing file found, look up the component it belongs to via `_docs/02_document/module-layout.md` (if present) or by directory match against `DOCUMENT_DIR/components/`.
+4. Add every such component and module to the update list, even if it was not in the current cycle's task spec.
+5. Produce `_docs/02_document/ripple_log_cycle<N>.md` (where `<N>` is `state.cycle` from `_docs/_autodev_state.md`, default `1`) listing each downstream doc that was added to the refresh set and the reason (which changed file triggered it). Example line:
+   ```
+   - docs/components/02_ingestor.md — refreshed because src/ingestor/queue.py imports src/shared/serializer.py (changed by AZ-173)
+   ```
+6. When parsing imports fails (missing tooling, unsupported language), log the parse failure in the ripple log and fall back to a directory-proximity heuristic: any component whose source directory contains files matching the changed-file basenames. Note: heuristic mode is explicitly marked in the log so the user can request a manual pass.
+
 ### Task Step 1: Module Doc Updates
 
 For each affected module:
@@ -78,6 +99,7 @@ Present a summary of all docs updated:
  Component docs updated: [count]
  System-level docs updated: [list or "none"]
  Problem-level docs updated: [list or "none"]
+ Ripple-refreshed docs (imports changed indirectly): [count, see ripple_log_cycle<N>.md]
 ══════════════════════════════════════
 ```