Skip to content

Standardize agent guidance on AGENTS.md and remove .goosehints#1058

Open
jwils wants to merge 1 commit intomainfrom
codex/agents-md-compat-pr
Open

Standardize agent guidance on AGENTS.md and remove .goosehints#1058
jwils wants to merge 1 commit intomainfrom
codex/agents-md-compat-pr

Conversation

@jwils
Copy link
Collaborator

@jwils jwils commented Feb 27, 2026

Summary

  • canonicalize repository agent instructions in AGENTS.md (tool-neutral)
  • keep CLAUDE.md as a compatibility symlink to AGENTS.md
  • remove .goosehints now that agents use AGENTS.md directly
  • add a short memory-bank instruction section to AGENTS.md
  • align ai-memory/README.md and CONTRIBUTING.md with the new instruction hierarchy

Commit Shape

  • this PR now contains a single commit on top of main

Testing

  • not run (docs/symlink-only change)

Copy link
Collaborator

@myronmarston myronmarston left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks reasonable although it's not an approach I've seen in other projects. Is there an emerging AGENTS.md standard you've seen?

@jwils
Copy link
Collaborator Author

jwils commented Feb 28, 2026

This is what we are doing internally - https://agents.md/. For whatever reason though it looks like Claude is the outlier here in not supporting it.

@jwils jwils force-pushed the codex/agents-md-compat-pr branch from 132356c to 87612de Compare February 28, 2026 01:31
@jwils jwils force-pushed the codex/agents-md-compat-pr branch from 300ac58 to a425dd8 Compare February 28, 2026 01:36
@jwils jwils changed the title Canonicalize AGENTS.md and keep CLAUDE.md compatibility symlink Standardize agent guidance on AGENTS.md and remove .goosehints Feb 28, 2026
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.

2 participants