Skip to content

Add AGENTS.md and a conventions check - #9

Merged
Mistium merged 2 commits into
developfrom
agents-md
Nov 1, 2026
Merged

Mistium merged 2 commits into
developfrom
agents-md

Conversation

@Mistium

@Mistium Mistium commented Nov 1, 2026

Copy link
Copy Markdown
Member

Adds AGENTS.md, a short guide for coding agents working in this repo. It covers where code goes, what other packages and extensions rely on, and which checks to run.

scripts/check-conventions.mjs enforces two MistWarp rules that were only checked in review: no code comments and no em dashes in added lines. It uses TypeScript's parser, so typescript is now a dev dependency, and it runs on pull requests. Tool directives are allowed, and so are comments that move along with their code. require-jsdoc is off, because it contradicted the no-comments rule.

There is no change to behaviour.

The check passes on this branch, and an independent review checked every claim in AGENTS.md against the code.

AGENTS.md tells coding agents where code goes, what consumers rely on, and which checks to
run. scripts/check-conventions.mjs rejects code comments and em dashes in added lines, and
runs on pull requests. eslint-config-scratch's require-jsdoc rule contradicted the
no-comments rule, so it is off.
…t AGENTS.md details

The conventions check now reads deleted files, compares comment text instead of whole
lines, skips JSX text and allows em dashes on moved lines. require-jsdoc is also off in
src/.eslintrc.js, which is a root config the top-level setting never reached.
@Mistium
Mistium merged commit 1fefb50 into develop Nov 1, 2026
2 checks passed
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.

1 participant