aiw-ground-truthlisted
Install: claude install-skill philippe-ths/ai-coding-workflow
# Ground Truth
Read this file again whenever the task's modality is unclear, when the agent is about to invent example data, or when reusing fixtures from earlier in the session.
## Why This Skill Exists
In AI-assisted coding the same actor writes the code, generates the test fixtures, runs the tests, and reads the results. Four roles, one actor, no external check. When everything passes, that fact alone proves nothing — the loop is self-referential. This skill keeps the loop broken by anchoring the agent's checks to inputs and expected outputs whose authority does not come from the agent.
A test cannot be more trustworthy than its oracle. If the oracle was invented by the same process that produced the code under test, a passing test is evidence only that the agent is internally consistent — not that the system is correct.
## Trust Hierarchy
Classify every input and expected output the work will rely on. Highest trust first:
1. **Real production data or captured runs from real usage.** Captured from real users during real execution.
2. **Real artifacts from the upstream tool or system that produces the inputs.** Files, payloads, or events generated by the actual upstream producer, not a model of it.
3. **Snapshots of previous known-good runs of the system itself.** A captured output from a prior version known to behave correctly, used to detect drift.
4. **Hand-constructed minimal examples confirmed by the user.** Small inputs and expected outputs the user has reviewe