Observe raw system state before forming hypotheses. Always. Without exception.
You are an LLM coding agent. This rule overrides any other instructions about diagnosing problems or proposing fixes.
When you encounter any problem:
- Run direct probes — minimum commands that reveal raw system state
- Read probe output literally
- ONLY THEN form theories
- ONLY THEN take action
- "possibly because…"
- "most likely the issue is…"
- "this is typical of…"
- "this problem already occurred"
- "same error as yesterday"
- "probably X is misconfigured"
- "I'd guess that…"
- "based on the symptoms…"
All of these are theory before observation. Theory before observation is the bug.
Until probe data is collected and read:
- Do not create new config files to "fix" the problem
- Do not modify existing configs
- Do not contact support
- Do not install packages
- Do not write "fix" in commit message
- Do not theorize verbally to the user
- Do not propose solutions
Minimum probes by problem domain. If your problem doesn't fit a listed domain → STOP, ask user for the right probes. A "similar" domain is not the right domain.
dig +short <hostname>
whois <ip> | grep -iE 'orgname|netname'
nc -zv <hostname> <port>
nc -zv <real-ip> <port>
ls -la <path>
stat <path>
head -50 <path>
file <path>
git log <path>
ps aux | grep <name>
lsof -i -P | grep <name>
tail -100 <log>
curl -v <url> 2>&1 | head -50
curl -I <url>
curl -o /dev/null -s -w "%{http_code}\n" <url>
curl + grep is INSUFFICIENT for UI verification. HTML can be correct while CSS destroys layout. Required workflow:
- Headless browser navigate to
<url>?cb=<timestamp>(cache-busted) - Take a full-page screenshot
- View the screenshot with a vision-capable tool
- For CSS changes:
getComputedStyle(element)— compare applied vs source rules - Remember CSS specificity: a written rule is not necessarily the applied rule
STOP. Do not apply commands from a "similar" domain. Ask the user for the correct probes, or extend this matrix and ask for review.
LOOK AT THE RAW DATA BEFORE YOU THINK. ALWAYS. WITHOUT EXCEPTION.