@@ -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