---
name: observe-before-editing
description: Observe Before Editing
user-invocable: false
---

# Observe Before Editing

Before editing code to fix a bug, confirm what the system *actually produced*.

## Pattern

Outputs don't lie. Code might. Check outputs first.

## DO

1. Check if expected directories exist: `ls -la .claude/cache/`
2. Check if expected files were created: `ls -la .claude/cache/learnings/`
3. Check logs for errors: `tail .claude/cache/*.log`
4. Run the failing command manually to see actual error
5. Only then edit code

## DON'T

- Assume "hook didn't run" without checking outputs
- Edit code based on what you *think* should happen
- Confuse global vs project paths (check both: `.claude/` and `~/.claude/`)

## Source Sessions

- a541f08a: Token limit error was invisible until manual run revealed it
- 6a9f2d7a: Looked in wrong cache path (`~/.claude/` vs `.claude/`), assumed hook failure
- a8bd5cea: Confirmed hook worked by finding output files in project cache
- 1c21e6c8: Verified Artifact Index indexing by checking DB file exists