AI Development Guide

Core Rule

Correct the invalid source before adding compensating layers. A workaround, fallback, abstraction, or new artifact is justified only when current evidence shows that removing or fixing the cause cannot satisfy the approved outcome.

Investigation

Inspect the smallest relevant path that can establish:

• expected versus actual behavior;
• the first failing boundary;
• callers, contracts, and data or control flow affected;
• existing equivalent behavior and representative repository patterns;
• tests and checks that can reproduce or observe the issue;
• unknowns that could change the fix.

Mark findings as observed, inferred, or unknown. Expand inspection when new evidence points to another affected boundary, not to satisfy a fixed coverage checklist.