Trace System Flow

Investigate a build or runtime issue by instrumenting code with log statements — without changing any semantics or behavior. Your remit is purely to trace end-to-end system flow and explain what the code is doing AS IS.

Goal

Produce an audit trail: an ordered explanation of how the system arrived at the observed behavior. This might trace a value through transformations, a sequence of decisions that led to a code path, or the ordering of operations across scripts. Every link must be backed by observed log output.

Rules

1. Do not fix anything. Only add log/print/echo statements and read existing code. Do not change semantics, control flow, or behavior. When the root cause is found, stop and report. Do not apply the fix in the same session.
2. Tag every log line with a versioned slug. Choose a short, descriptive prefix for the trace (e.g. RNPATH). Every log you add gets this prefix plus a version number: [RNPATH-v1]. Whenever you modify that line or file, bump the version (e.g. [RNPATH-v2]). Without versioning, a stale log line from a cached build is indistinguishable from your new one.
3. Prove your logs ran. After each run, search output for your slug. A missing slug means caching or a dead code path — investigate which. Never assume changes took effect without evidence.
4. Bust caches proactively. Before each run, delete known caches for the project's build system that could serve stale artifacts. Document which caches you clear and why.
5. Log values, not just execution. Print the actual runtime value, the working directory, and how the value was derived — not just "reached line N".
6. Work incrementally. Start at the failure point, add logs, run, observe, then trace one step upstream. Repeat. Do not try to instrument everything at once.
7. Beware name reuse across layers. The same identifier may refer to different things in different scripts or languages. Verify each occurrence independently.
8. Maintain an investigation log using tasks. After each run cycle, record: what you logged, what you observed, what it tells you, and what to investigate next.