Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,9 @@
- To audit noise (alerts, failing jobs), tally the actual signal in the inbox, channel, or logs before sweeping repositories.
- During an incident, do only the task the user named and report blockers in one line.
- Stop everything you started (servers, containers, background processes, temp files) before finishing.
- Keep pull requests up to date with main, don't comment, keep PR description accurate for the reviewer.
- Resolve all code reviews by responding and marking review as resolved.
- If you have questions, use the UI.

## Scope

Expand All @@ -31,6 +34,7 @@
- No dependency overrides (`pnpm.overrides`, `resolutions`, patches, vendoring) as workarounds. Find the upstream fix or report the upgrade blocked.
- "Don't commit" or "edits only" holds for follow-ups until the user lifts it.
- Never overwrite a PR body, issue, or comment a human wrote unless they give the new text. Comment instead.
- Don't create tooling, or extra nonsense without asking.

## Verification

Expand All @@ -53,6 +57,7 @@
- The user pushes to open PR branches. Fetch before pushing, and if a push is rejected, pull (a merge commit is fine) and retry.
- One branch per task. Branch independent PRs off `main`, and stack only when asked, with `gh stack`.
- Pass `--repo owner/name` to `gh pr`. Never run `gh pr merge --auto`, which merges without waiting for CI.
- Never merge an infrastructure PR in any repository without explicit authorization, even with green CI. icco.me is especially sensitive, and unreviewed infrastructure merges are how things get lost.
- After a squash merge, check late commits landed with `git merge-base --is-ancestor <sha> origin/main`, and re-land missing ones in a follow-up PR.
- Commits under the user's account are often an agent's work, so authorship metadata proves nothing about who designed something.
- Report git outcomes, not each step.
Expand Down
Loading