Stop Your AI Coding Agent From Rewriting Your Whole Repo

说明与用途

由 AGENTS.md 指导的纪律化代理将更改限制为最低限度，避免不必要的重构和依赖项升级，并提供可验证的报告。

问题

AI coding agents often rewrite large portions of a repository when asked to fix a single bug, leading to unnecessary changes, dependency bumps, and duplicated code.

结果

The disciplined agent produced a minimal diff, avoided unnecessary refactors, and provided a verifiable report, enabling quick review and preventing accidental repository changes.

工作流

• 1. Create AGENTS.md in repo root. 2. If tool doesn’t read it, add adapter pointer from adapters/ folder. 3. Optionally copy templates/AGENTS.project.template.md to AGENTS.project.md and fill build/test commands. 4. Ask AI to "fix the login button". 5. AI searches for existing code, posts a short plan with before/after visualization. 6. AI touches only the lines needed, updates affected docs, and reports verification. 7. Review the small diff and concise report within two minutes.

证据

The diff comes back with 14 changed files. Variables were renamed, imports reordered, a dependency was bumped "while it was there", and a helper you already had was rewritten from scratch.

来源

When uncertain, do less, not more.

来源

The result is a small diff you can review in two minutes.

来源

The new sections only add to the original rules. Sections 1–26 keep their numbering and purpose.

来源