V4 Best Practices

Rules for multi-step V4 thinking-mode workflows. Each rule prevents a specific, observable failure class.

1. Verify references before writing

Before referencing a file path, function, or type in code or plan output, call grep_files or read_file to confirm it exists in the workspace.

# Bad:  edit_file path="src/config/loader.rs" (assumed from memory)
# Good: grep_files pattern="pub fn load_config" → confirms src/config/mod.rs:42
#        then reference src/config/mod.rs:42

Failure avoided: edit_file errors on non-existent paths; LSP diagnostics on hallucinated symbols.