docs(agents): refresh AGENTS.md via /init-deep (CEL-749)

[mong-x]

Summary

Regenerated AGENTS.md via the workspace-level /init-deep skill. One of 9 sibling PRs in the same sweep, tracked under CEL-749.

Why

The workspace-level ~/REPOS/CellarNode/AGENTS.md inventory was significantly outdated and many sibling repos lacked an AGENTS.md at all. This sweep refreshes per-repo agent context so future agent sessions get accurate stack, commands, and architecture pointers.

Scope

Doc-only. No functional changes. No CI impact.

Linear

CEL-749

---

Summary by cubic

Adds a new AGENTS.md for @cellarnode/i18n, regenerated via workspace /init-deep to reflect current languages, stack, commands, exports, structure, copy-common usage, and translation pipeline. Supports CEL-749 by refreshing per-repo agent context; docs-only with no code or CI changes.

^{Written for commit a1bd4ae. Summary will update on new commits.}

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: e78e78c5-b405-49df-921c-130ed4483c0e

📥 Commits

Reviewing files that changed from the base of the PR and between 527e7fa and a1bd4ae.

📒 Files selected for processing (1)

• AGENTS.md

---

📝 Walkthrough

Summary by CodeRabbit

• Documentation
  • Added comprehensive documentation for the i18n package, including supported languages, build and test commands, exported entry points, repository structure, and translation pipeline guidelines.

Walkthrough

A new AGENTS.md file is added to the repository documenting the @cellarnode/i18n package. It covers supported languages, toolchain/dependency expectations, build and test commands, exported entry points, directory structure, the copy-common script behavior, and translation pipeline rules.

Changes

AGENTS.md Package Guide

Layer / File(s)	Summary
AGENTS.md package guide AGENTS.md	New documentation file describing supported languages, expected stack/deps, build/test commands, package exports, repo structure, scripts/copy-common behavior for populating consumer locales, and translation workflow rules (English common.json edits only; non-English via polyglot-i18n).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Suggested labels

enhancement

Poem

🐇 A guide now hops into the repo with care,
Telling agents what languages live there.
Copy-common runs, locales appear,
Polyglot handles translations, never fear.
The warren is documented — hip hip hooray! 🌿

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and specifically describes the main change: refreshing AGENTS.md documentation via the /init-deep tool for the agents package, with proper reference to the tracking issue CEL-749.
Description check	✅ Passed	The description is well-structured and directly related to the changeset, explaining the purpose (refreshing outdated AGENTS.md), scope (doc-only), and context (part of CEL-749 sweep across multiple repos).
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ 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 mjnong/cel-749-agents-md-refresh

---

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

[cubic-dev-ai]

1 issue found across 1 file

Confidence score: 4/5

• In AGENTS.md, the documented pre-publish gate uses make build, but that command cannot run in this repo, which can mislead contributors and cause publish checks to be skipped or inconsistently applied; this is a process risk rather than a runtime regression—update the doc to the actual scripts (e.g., pnpm build and pnpm test) or add a matching Makefile target before merging.

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="AGENTS.md">

<violation number="1" location="AGENTS.md:24">
P2: AGENTS.md references `make build` as the "PREFERRED pre-publish gate" command, but no Makefile exists in this repository. Only `pnpm build` (tsc) and `pnpm test` (vitest) are available via package.json scripts. Developers following this doc will get a `make: *** No rule to make target` error.</violation>
</file>

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[cubic-dev-ai]

P2: AGENTS.md references make build as the "PREFERRED pre-publish gate" command, but no Makefile exists in this repository. Only pnpm build (tsc) and pnpm test (vitest) are available via package.json scripts. Developers following this doc will get a make: *** No rule to make target error.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At AGENTS.md, line 24:

<comment>AGENTS.md references `make build` as the "PREFERRED pre-publish gate" command, but no Makefile exists in this repository. Only `pnpm build` (tsc) and `pnpm test` (vitest) are available via package.json scripts. Developers following this doc will get a `make: *** No rule to make target` error.</comment>

<file context>
@@ -0,0 +1,73 @@
+pnpm install
+pnpm build              # tsc only
+pnpm test               # vitest run
+make build              # clean + lint + typecheck + compile (PREFERRED pre-publish gate)
+```
+
</file context>