Skip to content

Add CLAUDE.md agent file#676

Open
jakecorrenti wants to merge 1 commit into
containers:mainfrom
jakecorrenti:add-agent-file
Open

Add CLAUDE.md agent file#676
jakecorrenti wants to merge 1 commit into
containers:mainfrom
jakecorrenti:add-agent-file

Conversation

@jakecorrenti
Copy link
Copy Markdown
Member

@jakecorrenti jakecorrenti commented May 13, 2026

Add a CLAUDE.md file to give Claude persistent context about libkrun. This includes project structure, coding standards, and workflows we prefer.

This was initially generated by running /init inside of Claude Code. I took some sections from
https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md?plain=1 and
https://github.com/openai/openai-agents-python/blob/f20aa40f56ec374841dfe6e4f3d6118c8e32fb2b/AGENTS.md.

This should be a living document that we adjust and modify as time goes on to better improve the agentic workflow.

I would love to get some discussion going about a couple things:

  • What would people like to add
  • What would people like to remove
  • How is the formatting
  • How do we handle multiple agent files? Claude doesn't support AGENTS.md, but we could have one AGENTS.md that we symlink to from the other files.

@jakecorrenti
Copy link
Copy Markdown
Member Author

I've also been using the Superpowers Claude plugin which has been useful.

I also want to experiment with Personas to see if that has any workflow improvement as well. If anyone has any other cool plugins/configurations I'd be interested to hear about those here as well.

Copy link
Copy Markdown
Collaborator

@mtjhrc mtjhrc left a comment

Choose a reason for hiding this comment

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

The project overview and information about running tests is definitely something we should have in a commited AGENTS.md and looks useful!

I am not a fan of committing some the general Claude "workflow" sections here however.

Also imagine someone want to override them, because they don't like them for some reason or it doesn't work well with their LLM, then it will become super annoying for them to not be able to use the project provided AGENTS.md at all and having to configure something to ignore them.

How do we handle multiple agent files? Claude doesn't support AGENTS.md, but we could have one AGENTS.md that we symlink to from the other files.

I would strongly prefer AGENTS.md and point CLAUDE.md to it. I think you can just put @AGENTS.md into a CLAUDE.md file and it would work.

Comment thread CLAUDE.md Outdated
Comment thread CLAUDE.md Outdated
Comment thread CLAUDE.md Outdated
Comment thread AGENTS.md Outdated
Comment thread CLAUDE.md Outdated
Comment thread CLAUDE.md Outdated
@jakecorrenti jakecorrenti force-pushed the add-agent-file branch 3 times, most recently from e347e47 to 8b4666e Compare May 14, 2026 16:06
Comment thread AGENTS.md Outdated
@lstocchi
Copy link
Copy Markdown
Contributor

@jakecorrenti have you read this best practice doc? There are some interesting tips related to the AGENTS file.

@jakecorrenti
Copy link
Copy Markdown
Member Author

@jakecorrenti have you read this best practice doc? There are some interesting tips related to the AGENTS file.

I hadn't seen that before. Looking at it now. Thanks!

@mtjhrc
Copy link
Copy Markdown
Collaborator

mtjhrc commented May 18, 2026

Also @jakecorrenti you should probably update the commit message, it doesn't reflect the CLAUDE.md -> AGENTS.md change.

Adds an AGENTS.md file to give agents context about libkrun. This
includes project structure and coding standards.

Create a .claude/ directory that points the Claude Code agent to the AGENTS.md file since
that file isn't supported.

This was initially generated by running /init inside of Claude Code. I
took some sections from
https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md?plain=1
and
https://github.com/openai/openai-agents-python/blob/f20aa40f56ec374841dfe6e4f3d6118c8e32fb2b/AGENTS.md.

Signed-off-by: Jake Correnti <jakecorrenti+github@proton.me>
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.

3 participants