AGENTS.md ยท diff

git:20261025.3d1f39c to git:20261029.3db47d2

1 added, 1 removed. Audit A to A.

What this update changes in the checks

No check changed: every fixed check gives the same answer before and after this update.

A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.

# AGENTS.md - ddd-ts-kit
A coding agent plugin for Claude Code, Codex and GitHub Copilot (`plugin/`: skills, agents, hooks;
marketplace manifests in `.claude-plugin/` and, for Codex, `.agents/plugins/`), a CLI
(`packages/cli`) and runtime packages (`packages/*`) for DDD and Clean Architecture in
TypeScript. Public repository.
- `docs/ARCHITECTURE.md` is normative: rule ids, canonical tree. Checker, templates and skills
implement it and change together. A test of the CLI fails when its section 3 lists a rule id
the checker does not know. `docs/README.md` indexes the rest of the documentation.
- - Commands: `npm run build`, `npm test`, `npm run lint`, `npm run format` (Biome, width 120), `npm run check:self`, `npm run check:dashes`, `node --test plugin/hooks/guard.test.mjs`.
+ - Commands: `npm run build`, `npm test`, `npm run lint`, `npm run format` (Biome, width 120), `npm run check:self`, `npm run check:dashes`, `npm run test:plugin` (the hooks of the plugin, held to 100 percent coverage).
- `tsc` is TypeScript 7 (native). Do not use the TypeScript compiler JS API.
- Optional peers (zod, class-validator, express, fastify, nest, OpenTelemetry SDK) are imported
only from their subpath entry file.
- Relative imports carry no `.js` and no `/index` (`'../config'`, `moduleResolution: Bundler`); the build writes them in `dist` (`pipeline/monorepo/add-extensions.mjs`).
- English only, no em dash or en dash, no `any`, no non-null assertion.
- What a change does for a user goes in a file of its own under `changes/` (see `changes/README.md`), never in `CHANGELOG.md`, and a change under `plugin/` leaves `version` of `plugin/.claude-plugin/plugin.json` alone: the release writes both, the plugin under the version of the packages; `claude plugin validate . --strict`, `claude plugin validate plugin --strict` and `claude plugin validate plugin/skills --strict` must pass.
- The four ORM, the brokers and the loggers are families at parity: an option or a contract
capability added to one member reaches the others, or `pipeline/monorepo/families.mjs` says
why not (`npm run check:parity`). What `init` refuses and what sibling flags generate
differently is declared, decided or not yet, in `packages/cli/test/support/support-matrix.ts`.
Never add a line there to turn a check green: fill the gap, or stop and ask the maintainer
(the hook of `.claude/settings.json` asks before any edit of the two registries).
- Details: `CONTRIBUTING.md`.