From 290f508bfb293189e49ce9e4c6cb3083b6e79ef1 Mon Sep 17 00:00:00 2001 From: Jasper Date: Fri, 21 Aug 2026 13:36:05 +0000 Subject: [PATCH] docs: keep GitHub comments concise (#11447) Signed-off-by: Jasper Hugo --- AGENTS.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index b9e728f45..705d7e0dc 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -16,6 +16,15 @@ The issue is the source of truth for work intended for an upstream pull request. Maintainer-directed work, urgent security fixes, release automation, and local or exploratory changes do not require a Ready issue. +## GitHub Communication + +Write issue and pull request comments for humans, not as exhaustive work logs. + +- Lead with the conclusion or action needed. +- Keep comments concise; do not repeat context already present in the thread. +- Use short paragraphs or bullets, and include implementation details only when they affect a decision or review. +- Prefer one clear summary over multiple incremental comments. + ## Agent Loop Migration We are replacing the legacy agent loop in `crates/goose/src/agents/agent.rs` with the state machine in `crates/goose/src/agents/state_machine/`. The state-machine path is enabled with `GOOSE_STATE_MACHINE=1`.