learn-investigate

Flags:

• --scope <path> — Restrict to files under this directory (default: entire project)
• --max-hypotheses N — Max hypotheses before escalating (default: 3)
• --no-persist — Skip writing to learnings.md (report.md still written locally)
• -y — Skip user confirmation prompts (headless mode)

Output: .workflow/knowhow/KNW-investigate-{slug}/ (evidence.ndjson, understanding.md, report.md)

Output boundary: ALL file writes MUST target .workflow/knowhow/KNW-investigate-{slug}/ and .workflow/specs/learnings.md only. NEVER modify source code or files outside these paths.