Skip to content

Commit c8bb844

Browse files
committed
docs: fix overeager agents
1 parent d62ea10 commit c8bb844

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

AGENTS.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,8 @@ When asked to plan, write to `PLAN.md`. Write for someone else, not yourself; do
2020

2121
## Research
2222

23+
**If you were given a link, read it now.** Do not explore code, do not pass go. Fetch the linked issue or document first. Summarize what it asks for before proceeding. If you cannot restate the problem, you are not ready to solve it.
24+
2325
**Read the issue carefully.** Before designing a solution, verify you understand what's actually being requested. Restate the problem in your own words. A solution to the wrong problem wastes everyone's time.
2426

2527
**Understand the protocol first.** Code comments reference RFC 6455 (WebSocket), RFC 7692 (compression), and RFC 8441 (HTTP/2). When behavior seems odd, check the RFC section cited nearby.
@@ -34,6 +36,8 @@ When asked to plan, write to `PLAN.md`. Write for someone else, not yourself; do
3436

3537
## Making Changes
3638

39+
**Did you do your research?** If you haven't read the linked issue, traced the code paths, and verified your understanding, stop. Go back to Research.
40+
3741
**Every change needs a reason.** Don't reword comments, rename variables, or restructure code without justification. If you can't articulate why a change improves things, don't make it.
3842

3943
**Understand before changing.** Research the code you're modifying. Trace the call paths, read the tests, check both platforms. A change with good intentions but incomplete understanding can break things in ways you won't notice.

0 commit comments

Comments
 (0)