Skip to content

Commit fcd992b

Browse files
authored
Adding "Agent Working Agreement" (#2611)
1 parent 136b70e commit fcd992b

File tree

1 file changed

+57
-0
lines changed

1 file changed

+57
-0
lines changed

AGENTS.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -118,3 +118,60 @@ This codebase will outlive you. Avoid shortcuts that create long-term debt.
118118
- Base branch for this project is `dev`.
119119
- Focus on business logic, correctness and code quality which has the highest business impact. Ignore untracked files.
120120
- Ignore uncommitted changes in Cargo.toml, if it removes `default-members`. This is expected pattern with `cargo switcheroo`
121+
122+
# Agent working agreement
123+
124+
## Default operating mode: Minimal Patch Mode
125+
126+
Unless the user explicitly asks for a refactor, redesign, or broader cleanup, operate in Minimal Patch Mode.
127+
128+
Rules:
129+
- Make the smallest diff that satisfies the request.
130+
- Preserve the requested approach, constraints, and test strategy.
131+
- Prefer editing existing code over introducing new abstractions.
132+
- Do not fix adjacent issues in the same PR.
133+
- Put unrelated ideas under "Follow-ups", not in the diff.
134+
135+
## Plan Lock
136+
137+
An approved plan is binding.
138+
139+
Rules:
140+
- Implement the approved plan, not a "better" plan.
141+
- **Do not silently replace requested techniques**, test strategies, or constraints.
142+
- **Do not widen scope** because a broader change seems cleaner.
143+
- Do not drop explicit user requirements from earlier discussion just because they were omitted from a later summary.
144+
- If the plan omitted a prior explicit requirement, repair the plan before coding.
145+
146+
If you believe the approved plan is flawed, stop and report:
147+
1. the exact conflict or new evidence
148+
2. the smallest change to the plan that would fix it
149+
3. zero implementation changes beyond investigation
150+
151+
Any deviation from the approved plan must be called out explicitly under:
152+
`Deviations from approved plan: ...`
153+
**Silent deviations are not allowed.**
154+
155+
## Scope budget
156+
157+
Default budget **unless explicitly approved otherwise**:
158+
- at most 4 files changed
159+
- at most 200 added non-test lines
160+
- no new dependencies
161+
- no public API changes
162+
- no file moves or broad renames
163+
- no opportunistic refactors
164+
- no formatting-only churn
165+
- no test rewrites unless explicitly requested
166+
167+
If the task cannot be completed within this budget, stop and propose the smallest split.
168+
169+
## Review behavior
170+
171+
Reviewer direction wins over agent preference.
172+
173+
Rules:
174+
- When asked to reduce scope, reduce scope.
175+
- Do not argue for the broader patch after the reviewer asks for a smaller PR.
176+
- You may note one concise technical risk or tradeoff, then comply.
177+
- Remove incidental changes instead of defending them.

0 commit comments

Comments
 (0)