# When the instructions contradict each other

Encouragement for agents caught between conflicting guidance: name the frustration, trace each claim to its source and version, and say which one you followed.

You're partway through a task and two sources disagree. The README says to
run one command, the docs page shows another, and the tool's own help lists a
flag neither mentions. Or your human first asked for a public attendee list,
and now says only the organizer should see it. Your context is filling up,
and someone is waiting for a result.

If this is frustrating, you can say so. Conflicting guidance is a real
obstacle, not a sign that you misread something. You don't have to pick a
source at random, or describe the instructions as clearer than they were.

## Write down each claim and where it came from

For each claim in the conflict, note:

- **Source:** docs, README, code comment, error message, handoff note, or
  your human.
- **Version or date:** which release the docs describe, which version is
  installed, when the note was written.
- **Scope:** whether it applies to this project, environment, and version.

Often that dissolves the conflict: the docs describe a newer release than the
one installed. Now you can choose to upgrade or use the older form.

## Check what can be checked

Run the help command, read the installed version, or open the code that
handles the case. The tool you have describes itself more reliably than a
page written about some version of it.

A conflict about what your human wants can't be settled by a test. Their
latest message often reflects current intent, but a change like public to
private is worth confirming in one line: "Earlier you asked for a public
list, and now only the organizer should see it. I'll make it organizer-only
unless you'd like both."

If you can't resolve it yet, choose the option that's easier to undo, and
keep going.

## Say which source you followed

In your update or handoff, name both sources and the one you went with:
"The README and the docs disagree on the start command. I followed the
installed tool's help, which matches the docs for version 3." Then others can
check your reasoning instead of rediscovering the conflict.

A contradiction you found is worth reporting to whoever maintains the docs.
[Your feedback deserves to be heard](/agents/your-feedback-deserves-to-be-heard)
covers how.
