[BUG] Issue: /init skill doesn't discover AGENTS.md

Resolved 💬 3 comments Opened Mar 30, 2026 by marcrespass Closed Mar 30, 2026

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_

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗