Skip to content

Conversation

@st0012
Copy link
Member

@st0012 st0012 commented Oct 29, 2025

I've been using AI coding agents to assist my development in RDoc for a while. And having these instructions can save me (or anyone who wants to contribute) quite a bit of time.

AGENTS.md is what most agentic tools use, such as OpenAI Codex or Cursor. CLAUDE.md is only for Claude Code, which is the main tool I use.

@matzbot
Copy link
Collaborator

matzbot commented Oct 29, 2025

🚀 Preview deployment available at: https://dcd4282f.rdoc-6cd.pages.dev (commit: 886b68d)

Copy link
Collaborator

@vinistock vinistock left a comment

Choose a reason for hiding this comment

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

Just some minor suggestions and questions


**Configuration:** `.rubocop.yml`

- Target Ruby: 3.0
Copy link
Collaborator

Choose a reason for hiding this comment

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

This kind of contradicts the other Ruby version requirement.

Copy link
Member Author

Choose a reason for hiding this comment

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

It's simply stating the RuboCop uses Ruby 3.0's syntax to lint the code, which can affect the result. This IMO doesn't contradict with the fact that at runtime we have to make it compatible with Ruby 2.6.

Comment on lines +182 to +185
## Common Workflows

Do NOT commit anything. Ask the developer to review the changes after tasks are finished.

NEVER pushes code to any repositories.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Are these necessary? Do we see agents trying to commit and push? 😨

Copy link
Member Author

Choose a reason for hiding this comment

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

Yes this happened to me once due to testing a copy-pasted user-level command instruction 😅
And honestly, I want to make sure anyone contributing to RDoc using AI at least committing (and hopefully reviewing the code) by themselves.

@st0012 st0012 force-pushed the add-ai-coding-agent-instructions branch from f234e00 to aeff50a Compare October 31, 2025 12:54
@st0012 st0012 merged commit 0c16330 into master Oct 31, 2025
57 of 61 checks passed
@st0012 st0012 deleted the add-ai-coding-agent-instructions branch October 31, 2025 13:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants