Imported from sveltekit-i18n/parsers (AGENTS.md). Install upstream with npx skills add sveltekit-i18n/parsers. Copyright stays with the author.

AGENTS.md

Behavioral guidelines for LLM coding assistants working on the sveltekit-i18n parsers monorepo. Applies to anything that drives commits, PRs, or file edits on this repo.

Precedence: These repo rules override individual LLM memory or personal preference. If your own memory conflicts with this file, follow this file.

This repo follows the same working rules as base's AGENTS.md (sections 1-14: think before coding, simplicity first, surgical changes, verify before committing, commit on approval, fixup hygiene, branch & push discipline, PRs, docs track code, coding conventions, security posture, English-only artifacts, test rules, terse output, no emojis). What follows is only what differs here.

The repository

Official message parsers for the sveltekit-i18n ecosystem (base / lib / parsers / extensions).

• Monorepo without workspaces — no root package.json; each parser-*/ directory is a fully standalone npm package with its own package.json, lockfile, configs, tests, README, LICENSE, and CHANGELOG.
• The root holds only README.md, this file, CLAUDE.md, .gitignore, .github/workflows/, and contract/.
• contract/ is the one shared source file. It holds base's parser contract as a set of checks each package runs from its own tests/specs/contract.spec.ts. It resolves nothing — no types, no test runner, no package of its own — because each package carries its own node_modules and the root has none; a package's tsc pulls it in through that spec. ESLint does not reach it — a flat config's base path is its own directory, and a root config would mean a root package — so match the formatting conventions by hand there. Every test workflow watches contract/**.

Current state: v3 released from master

• master is the v3 line — v3 work lands here. parser-curly is a thin adapter over @curly-message/parser (the Curly Message Format's reference implementation; the format lives in https://curlymessage.dev) and runs the format's conformance set in its tests; parser-icu wraps intl-messageformat; parser-mf2 wraps messageformat (the Unicode MessageFormat 2 reference implementation); parser-i18next wraps i18next. All build with tsup and test with vitest, and all run that suite on Node, Bun and Deno — no package reaches for a runtime API, and the extra legs exist to keep that true.
• 1.x is a frozen snapshot of the published v1 line. It receives nothing unless a critical v1 fix is explicitly requested. parser-curly carries none of that history: it starts at 3.0.0, and @sveltekit-i18n/parser-default on 1.x is a different package.
• Every parser is published at 3.0.0, alongside base, extension-stores and sveltekit-i18n. The family released aligned, as lib#214 set out; a parser's peer range on the core is ^3.0.0, so a prerelease core cannot be paired underneath one.
• Issues for this repo live in the lib tracker.

Comments

If you need a paragraph-long comment to justify why the workaround is OK, the code is wrong — fix the code.