## Understand Workflow Fast Path

> **PREREQUISITE: Requires civyk-repoix (REPOIX_MODE != "none").**
> **IF REPOIX_MODE == "none": SKIP this section.** Read all source files directly without cache checks.

Before reading source files, check if the understand workflow has cached understanding:

```text
# [!] PREREQUISITE: Requires repoix (skip when REPOIX_MODE == "none")
# For each source file to read:
understand(action="recall", target="<file_path>")
IF found AND fresh AND cache provides sufficient detail for this stage:
    Use cached key_points, purpose, gotchas instead of reading file
    OUTPUT: "[cache hit] <file_path>"
ELSE:
    Read file normally
    OUTPUT: "[cache miss] <file_path>"
```

**When to read despite cache hit:** If cached understanding lacks the domain-specific detail this stage needs (e.g., field types for models, route parameters for API, error codes for errors), read the file. Cache accelerates triage of irrelevant files, not a replacement for detailed analysis.
