Skip to content

docs: instructions for coding agents#3946

Open
albinsuresh wants to merge 4 commits into
thin-edge:mainfrom
albinsuresh:coding-agent-instructions
Open

docs: instructions for coding agents#3946
albinsuresh wants to merge 4 commits into
thin-edge:mainfrom
albinsuresh:coding-agent-instructions

Conversation

@albinsuresh
Copy link
Copy Markdown
Contributor

@albinsuresh albinsuresh commented Jan 27, 2026

Proposed changes

  • A coding agent agnostic AGENTS.md file with project specific instructions
  • Dedicated CLAUDE.md file which just refers to AGENTS.md, since claude code doesn't respect AGENTS.md files (yet)
  • Dedicated skills for commonly used tasks.

The content was generated by claude code itself.

Types of changes

  • Bugfix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Improvement (general improvements like code refactoring that doesn't explicitly fix a bug or add any new functionality)
  • Documentation Update (if none of the other choices apply)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)

Paste Link to the issue


Checklist

  • I have read the CONTRIBUTING doc
  • I have signed the CLA (in all commits with git commit -s. You can activate automatic signing by running just prepare-dev once)
  • I ran just format as mentioned in CODING_GUIDELINES
  • I used just check as mentioned in CODING_GUIDELINES
  • I have added tests that prove my fix is effective or that my feature works
  • I have added necessary documentation (if appropriate)

Further comments

Comment thread AGENTS.md Outdated
@codecov
Copy link
Copy Markdown

codecov Bot commented Jan 27, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@albinsuresh albinsuresh force-pushed the coding-agent-instructions branch from 0c53f97 to cd0675c Compare April 16, 2026 05:55
@albinsuresh albinsuresh requested a review from a team as a code owner April 16, 2026 05:55
@albinsuresh albinsuresh force-pushed the coding-agent-instructions branch from cd0675c to 123e1a8 Compare April 16, 2026 06:12
@albinsuresh albinsuresh requested a review from jarhodes314 April 16, 2026 06:23
@reubenmiller reubenmiller added the theme:developer-exp Theme: improve developer experience label Apr 17, 2026
@reubenmiller reubenmiller changed the title chore: instructions for coding agents docs: instructions for coding agents Apr 17, 2026
Copy link
Copy Markdown
Contributor

@reubenmiller reubenmiller left a comment

Choose a reason for hiding this comment

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

Approved. We can always iterate on this after we've used it more

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

theme:developer-exp Theme: improve developer experience

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants