Skip to content

Add AGENTS.md - #55

Open
mokagio wants to merge 3 commits into
mainfrom
mokagio/add-agents-md
Open

mokagio wants to merge 3 commits into
mainfrom
mokagio/add-agents-md

Conversation

@mokagio

@mokagio mokagio commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

The repo had no agent instructions.
Build and test commands, the generated-file rules (both READMEs, commands.generated.ts), and the files a new command has to touch (manifest, smoke test, API copy) weren't written down anywhere, so agents had to rediscover them each time.
CLAUDE.md imports AGENTS.md so Claude Code picks it up too.

Important

Obviously, given I didn't make this project, I don't know if the file is okay. I let my agent write it, of course.

I added a section that didn't make sense to me, and maybe it's more of a devex question for the repo owners:

packages/cli/scripts/ has extensionless scripts (format, mock, test, …) that nothing uses; AGENTS.md tells agents to ignore them rather than deleting them here.

How to test

Run the documented commands from the repo root: bun install --frozen-lockfile, bun run typecheck, bun run test, bun run lint.
All pass locally on Bun 1.3.10.

mokagio and others added 2 commits October 30, 2026 11:44
The repo had no agent instructions.
The build and test commands, the generated-file rules (`README.md`, `commands.generated.ts`), and the multi-file checklist for adding a command weren't written down anywhere.

---

Generated with the help of Claude Code, https://claude.ai/code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude Code reads `CLAUDE.md`, not `AGENTS.md`.

---

Generated with the help of Claude Code, https://claude.ai/code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mokagio mokagio self-assigned this Oct 30, 2026
Whether those scripts stay is the team's call, not something `AGENTS.md` should decide for them.

---

Generated with the help of Claude Code, https://claude.ai/code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mokagio
mokagio requested a review from batuhan October 30, 2026 02:50
@mokagio
mokagio marked this pull request as ready for review October 30, 2026 02:50
Copilot AI balanced review requested due to automatic review settings October 30, 2026 02:50

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.

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

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants