Skip to content

chore: add AGENTS.md for codex#1123

Open
asanehisa wants to merge 2 commits intomainfrom
agents
Open

chore: add AGENTS.md for codex#1123
asanehisa wants to merge 2 commits intomainfrom
agents

Conversation

@asanehisa
Copy link
Contributor

@asanehisa asanehisa commented Mar 24, 2026

Am open to adjusting or removing any of this! I think I def would like the tsc reminder as codex gives me a lot of code that fails typescript checks.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 24, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 55c529d1-ba17-4762-b01c-6f5fa5777691

📥 Commits

Reviewing files that changed from the base of the PR and between 8a6b9eb and 137c759.

📒 Files selected for processing (1)
  • AGENTS.md
✅ Files skipped from review due to trivial changes (1)
  • AGENTS.md

Walkthrough

A new AGENTS.md was added, defining repo-wide agent operating instructions. It enforces a naming convention using Id (not ID) for identifiers, prescribes a local verification workflow centered on packages/visual-editor (preferring scoped pnpm commands), and specifies concrete commands for TypeScript checks and editor tests. It classifies mutating commands (lint, format, autofix, i18n:update, docs-generation), requires i18n:update when locale strings change, constrains package structure and public exports, and mandates adding immutable migration files and appending them to migrationRegistry.ts without rewriting existing migrations.

Sequence Diagram(s)

🚥 Pre-merge checks | ✅ 2
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title 'chore: add AGENTS.md for codex' clearly and concisely describes the main change: adding a new AGENTS.md documentation file. It is specific, related to the changeset, and appropriately formatted.
Description check ✅ Passed The description is related to the changeset, noting the author's openness to adjustments and specifically requesting a tsc reminder due to Codex generating TypeScript-failing code, which aligns with the AGENTS.md content.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch agents

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

🧹 Nitpick comments (2)
AGENTS.md (2)

27-27: Consider clarifying "related package index.ts files."

The phrase "related package index.ts files" is slightly vague. If there are specific entrypoint files beyond the main src/index.ts, listing them or being more specific would improve clarity.

💡 Suggested clarification

If there are specific secondary entrypoints, you could list them explicitly:

-- Public exports should go through the package entrypoints such as `packages/visual-editor/src/index.ts` and related package `index.ts` files.
+- Public exports should go through the package entrypoints such as `packages/visual-editor/src/index.ts` and other designated entrypoint files (e.g., `src/components/index.ts`, `src/utils/index.ts`).

Or if all exports go through the main index:

-- Public exports should go through the package entrypoints such as `packages/visual-editor/src/index.ts` and related package `index.ts` files.
+- Public exports should go through the main package entrypoint `packages/visual-editor/src/index.ts` and any designated submodule entrypoints.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@AGENTS.md` at line 27, Clarify the phrase "related package `index.ts` files"
by either listing the specific secondary entrypoint files (for example call out
each package index like packages/visual-editor/src/index.ts,
packages/visual-editor/index.ts, packages/other-package/src/index.ts) or by
replacing the phrase with a precise statement such as "all public exports must
go through the package's main src/index.ts (and its package root index.ts)".
Update AGENTS.md to use the chosen explicit wording so readers know exactly
which index.ts files are authoritative.

5-6: Consider adding examples to clarify the naming convention.

While the Id vs ID guideline is clear, providing concrete examples would help reduce ambiguity and ensure consistent application.

📝 Suggested enhancement with examples
 - Use `Id` instead of `ID` for all variable and property names.
+  - Example: prefer `userId`, `componentId`, `entityId` over `userID`, `componentID`, `entityID`.
 - This applies to code identifiers such as variables, properties, parameters, functions, and types.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@AGENTS.md` around lines 5 - 6, Add concrete before/after examples to the
AGENTS.md naming guideline to clarify using "Id" instead of "ID": include
examples for variable names (e.g., userId vs userID), property names (e.g.,
orderId vs orderID), function/parameter examples (e.g., getUserById(id: string)
vs getUserByID(id: string)), and type/interface examples (e.g., UserId vs
UserID); keep each pair short, labeled, and placed directly beneath the existing
rule so readers can quickly see the preferred form and the discouraged form.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@AGENTS.md`:
- Line 27: Clarify the phrase "related package `index.ts` files" by either
listing the specific secondary entrypoint files (for example call out each
package index like packages/visual-editor/src/index.ts,
packages/visual-editor/index.ts, packages/other-package/src/index.ts) or by
replacing the phrase with a precise statement such as "all public exports must
go through the package's main src/index.ts (and its package root index.ts)".
Update AGENTS.md to use the chosen explicit wording so readers know exactly
which index.ts files are authoritative.
- Around line 5-6: Add concrete before/after examples to the AGENTS.md naming
guideline to clarify using "Id" instead of "ID": include examples for variable
names (e.g., userId vs userID), property names (e.g., orderId vs orderID),
function/parameter examples (e.g., getUserById(id: string) vs getUserByID(id:
string)), and type/interface examples (e.g., UserId vs UserID); keep each pair
short, labeled, and placed directly beneath the existing rule so readers can
quickly see the preferred form and the discouraged form.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: eb24b2cf-65ea-44bf-a25b-2d10f664d3c9

📥 Commits

Reviewing files that changed from the base of the PR and between accd37b and 8a6b9eb.

📒 Files selected for processing (1)
  • AGENTS.md

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.

2 participants