Skip to content

docs: record why goose global rules do not emit ~/.agents/AGENTS.md - #2289

Merged
dyoshikawa merged 1 commit into
mainfrom
resolve-scrap-issue-2207-goose-global-hints
Jul 16, 2026
Merged

docs: record why goose global rules do not emit ~/.agents/AGENTS.md#2289
dyoshikawa merged 1 commit into
mainfrom
resolve-scrap-issue-2207-goose-global-hints

Conversation

@dyoshikawa

Copy link
Copy Markdown
Owner

Summary

Goose v1.41.0 (block/goose#9736) additionally loads the vendor-neutral ~/.agents/AGENTS.md global hints alongside the existing config-dir hints. Issue #2207 framed the follow-up as an explicit Option A (also emit the shared path from the goose target) / Option B (document that the surface is already covered) decision.

This resolves it as Option B, recorded as a comment in goose-rule.ts:

  • Goose's own ~/.config/goose/.goosehints remains fully loaded — there is no capability loss today (the issue itself confirms "nothing breaks").
  • The cross-tool ~/.agents/AGENTS.md is already written by the targets that own it (e.g. cline in global mode). Making goose a second writer of a shared global file would require cross-target shared-file coordination (the same class of problem the antigravity targets needed shared-file keys for) for zero capability gain.

Comment-only change; no behavior difference.

Closes #2207

🤖 Generated with Claude Code

Goose v1.41.0 (aaif-goose/goose#9736) additionally loads the vendor-neutral
~/.agents/AGENTS.md global hints alongside the config-dir hints. The
goose target keeps emitting only ~/.config/goose/.goosehints: the
config-dir hints remain fully loaded (no capability loss), and the
shared ~/.agents/AGENTS.md is already written by the targets that own
it (e.g. cline in global mode) — a second writer would require
cross-target shared-file coordination for zero capability gain.

Closes #2207

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@dyoshikawa
dyoshikawa merged commit 43c304f into main Jul 16, 2026
10 checks passed
@dyoshikawa
dyoshikawa deleted the resolve-scrap-issue-2207-goose-global-hints branch July 16, 2026 07:59
@dyoshikawa

Copy link
Copy Markdown
Owner Author

@dyoshikawa Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Follow up Goose upstream updates: global hints from ~/.agents/AGENTS.md (v1.41.0)

2 participants