Files
tiennm99bot/renderer/AGENTS.md
T
tiennm99 f475a5cb46 build: move from pnpm to npm
Replace pnpm-lock.yaml with package-lock.json. allowBuilds for esbuild becomes
package.json#allowScripts. The Dockerfile installs with npm ci --omit=dev and
no longer prepares pnpm through corepack; .npmrc keeps engine-strict, which npm
honours natively.

minimumReleaseAgeExclude is dropped rather than translated: pnpm's
minimumReleaseAge was never set, so the 30-entry exclusion list had nothing to
exclude from. Direct dependency versions resolve identically to the pnpm
lockfile.
2026-08-17 12:30:41 +07:00

1.0 KiB

AGENTS.md

Project Context

wheelofnames is a Node.js 24 JavaScript + JSDoc API service that renders animated wheel-of-names GIFs with Remotion.

Development Rules

  • Use JavaScript and JSDoc. Do not add TypeScript source files.
  • Keep public API routes under /api.
  • Run npm run lint, npm run typecheck, and npm test before committing code changes.
  • Run npm run render:smoke when renderer, Remotion composition, Docker runtime, or GIF output behavior changes.
  • Run npm run api:smoke when API render behavior, bundle warm-up, or production render flow changes.
  • Do not commit .env, generated GIFs, tokens, secrets, or temporary render artifacts.
  • Prefer Remotion libraries and CSS transforms over custom SVG path generation.

Quality Gates

  • API validation must reject oversized requests before render work starts.
  • Rendering must not rebundle Remotion per request.
  • Winner metadata must be returned with GIF responses.
  • Keep Docker and README deployment docs in sync with runtime requirements.