Write an Evidence-Aware Answer
Write an Evidence-Aware Answer
Section titled “Write an Evidence-Aware Answer”A useful answer makes its evidence level visible.
Separate these categories
Section titled “Separate these categories”Documented behavior
Behavior stated by an authoritative contract, schema, or versioned interface document.
Reproduced behavior
Behavior you personally reproduced under stated conditions.
Inference
A technical conclusion derived from available evidence but not directly stated by the authoritative source.
Workaround
A practical path that may solve the immediate problem without changing the underlying contract.
Unknown
A question that the available evidence does not resolve.
Prefer inspectable evidence
Section titled “Prefer inspectable evidence”Useful evidence can include:
- exact commands;
- structured verification results;
- artifact identities;
- minimal fixtures;
- test output;
- version information;
- links to relevant reference pages.
Avoid false certainty
Section titled “Avoid false certainty”Do not turn:
- an undocumented behavior into a guaranteed API;
- one successful environment into universal compatibility;
- a demonstration into production evidence;
- a workaround into a normative contract.