From ea2d8029ff17fa56c26aa0da80f365d133bbd3b9 Mon Sep 17 00:00:00 2001 From: saravanakumardb1 Date: Tue, 14 Apr 2026 11:57:26 -0700 Subject: [PATCH] docs(agents): add .npmrc canonical template rule to AGENTS.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Never edit .npmrc directly in product repos — managed by canonical template in learning_ai_common_plat/scripts/npmrc.template. Use sync-npmrc.sh to propagate. Prevents gitea.bytelyst.com hardcoding. --- AGENTS.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index cf6da7a..d81df3a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -178,6 +178,15 @@ learning_ai_notes/ - All colors via `--nl-*` CSS custom properties from `@bytelyst/design-tokens` — never hardcode hex values - Every interactive element must have `aria-label` or visible text label + +### .npmrc — NEVER edit directly + +**`.npmrc` is managed by a canonical template in `learning_ai_common_plat`.** Never create or hand-edit `.npmrc` — it will drift. + +- **Template:** `../learning_ai_common_plat/scripts/npmrc.template` +- **Sync:** `cd ../learning_ai_common_plat && bash scripts/sync-npmrc.sh` +- **Key rule:** Never hardcode `gitea.bytelyst.com` — use `${GITEA_NPM_HOST:-localhost}:3300` (SSH tunnel on corp network) + ### MUST NOT do - Never use `console.log` in production code — use `req.log` or `app.log` in Fastify