wursor/docs/decisions/0021-keep-no-diff-rule-wording.md

21. Keep the "never sees a diff" rule in AGENTS.md as written

• Status: Accepted
• Date: 2026-10-12

Context

AGENTS.md hard rule 3 says the user never sees a diff, a terminal, a settings screen or an error log. PRD Headless revision 4 keeps technical detail (diffs, hashes, logs, traces) one tap away in an expandable section for owners who want it (section 16, RV-01). IMPLEMENTATION section 0.2 asked whether the rule's wording should change.

Decision

Leave rule 3 as it is. It describes the default experience and the test for any change: if a change would put engineer-only UI in front of a non-technical owner by default, it is wrong. The optional, collapsed technical detail in the PRD is read as consistent with that default.

Options considered

• Leave the wording (chosen).
• Reword to "by default" and mention the expandable detail. Not chosen.

Consequences

• AGENTS.md rule 3 is unchanged.
• Reviewers apply the rule to the default view. The expandable technical section must never be the only way to complete a task, and must be collapsed unless the person opens it.