Prowl Change Safety

Prowl change safety

Before you change code, know what depends on it. After you change it, know what you touched and whether the repo is still healthy. When you pick up a task, know what the last session left unfinished. prowl-agent answers all three from the local index in one command each, cited to file and line.

Before editing a file

• prowl-agent impact <path> gives the blast radius: how many files depend on it, the subsystems involved, and the direct importers. Use it to decide how careful to be and what to re-check.
• prowl-agent callers <path> lists what includes, imports, execs, or binds to it.

After editing

• prowl-agent changed maps your git changes to the files they could affect, so you check the right things before committing.
• prowl-agent doctor reports structural health (cycles, dangling references, fan-in risk) with a score. Add --profile rice for desktop and dotfile checks.

Resuming a task

• prowl-agent wip reports uncommitted work: touched files with their git status, the unfinished-work markers inside them (TODO, FIXME, and friends), and the blast radius of each indexed file. Run it first when picking up where a previous session stopped, instead of re-reading the tree to reconstruct state.

All of these re-index what changed before answering, so they never report stale state.