Agent failure is a codebase signal

When an agent can't resolve an issue, that's a signal — not a prompt problem:

1. Opaque abstractions — if the agent can't find the boundary, humans struggle too
2. Missing documentation — the code never explained the why
3. Insufficient testing — no coverage for the exact condition that broke