[BUG] Issue: /init skill doesn't discover AGENTS.md
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
(this is what Claude told me to report)
Issue: /init skill doesn't discover AGENTS.md
Expected behavior: When running /init in a project that has an AGENTS.md file (like those from Two Straws SwiftAgents), the skill should:
- Discover the file
- Integrate its guidelines into the generated/updated CLAUDE.md
- Or at minimum, reference it so future Claude sessions know to follow it
Actual behavior: /init generates CLAUDE.md without any reference to existing AGENTS.md, leaving AI assistants unaware of project-specific guidelines.
Impact: In projects with comprehensive style guides (AGENTS.md, .cursorrules, etc.), critical guidelines are missed unless explicitly mentioned.
---
And you're right - going forward, explicitly referencing AGENTS.md at the start is a good safety net. But the tooling should definitely handle this automatically.
Good catch!
What Should Happen?
Claude should look for the agents.md file (which is in the root of the repository) and integrate it.
Error Messages/Logs
Steps to Reproduce
Run /init and notice that agents.md is not referenced. Build a project and see that things specifically mentioned in agents.md are ignored.
Claude Model
Other
Is this a regression?
Yes, this worked in a previous version
Last Working Version
_No response_
Claude Code Version
2.1.87 (Claude Code)
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
iTerm2
Additional Information
_No response_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗