Skip to content

docs(all): add AGENTS.md and update development guide - #203

Open
fefi95 wants to merge 2 commits into
mainfrom
docs/agents-md-and-development-guide
Open

fefi95 wants to merge 2 commits into
mainfrom
docs/agents-md-and-development-guide

Conversation

@fefi95

@fefi95 fefi95 commented Oct 16, 2026

Copy link
Copy Markdown

Closes #190
Closes #194

Verified (Node 25.2.1 from .nvmrc, fresh clone, cold cache)

Command Result
npm install -g corepack && corepack enable ok, yarn --version → 4.1.0
yarn install --immutable ok, ~11 s
yarn compile / yarn lint / yarn test exit 0; ~6 s / ~17 s / ~6 s
yarn compile && yarn lint && yarn test exit 0, ~29 s
yarn check exit 0, ~21 s
cd packages/core && yarn test 399 passing, ~1 s
yarn why tar ok
yarn npm audit --all --recursive --severity high exit 1 today (existing high findings, e.g. @isaacs/brace-expansion); exit 0 means clean
yarn dedupe tar --check ok

Where the code disagreed with the issues

  • Corepack on Node 25: .nvmrc pins 25.2.1, which no longer bundles Corepack, so a bare corepack enable fails. development.md adds npm install -g corepack for Node 25+.
  • Commit scopes: there is no commitlint config in the repo. The scopes live only in the development.md table (plus per-package .releaserc.json rules), so AGENTS.md links to that table.
  • usePlugin(): it is defined in packages/core/src/main.ts and calls config.addPlugin in config/Config.ts. AGENTS.md describes both.
  • Lint: yarn lint prints react-native parse warnings but exits 0; AGENTS.md says to trust the exit code.
  • Audit: added --severity high (per task) and noted the exit code.

AGENTS.md is the only agent file on purpose: it is the cross-tool convention, and #190's original title also mentioned CLAUDE.md.

Stefani Castellanos and others added 2 commits October 16, 2026 09:06
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@fefi95
fefi95 marked this pull request as ready for review October 16, 2026 15:13

This branch has not been deployed

No deployments
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.

Fix stale contributor docs (Yarn 4, main branch, package scopes) Add an agent instruction file (AGENTS.md + CLAUDE.md)

1 participant