ADR 004 pnpm-Only JavaScript Tooling
Decision
Section titled “Decision”JavaScript, TypeScript, Astro, and docs repositories use pnpm only.
- Pin pnpm through
packageManageranddevEngines.packageManager. - Install with
pnpm install --frozen-lockfile. - Run package binaries through
pnpm execor repository scripts. - Block npm, npx, yarn, and bun for project lifecycle commands.
Implementation Evidence
Section titled “Implementation Evidence”- Assembly package-manager pin and lifecycle
- Assembly pnpm enforcement
- Contract package-manager configuration
- Frontend package-manager configuration
Consequences
Section titled “Consequences”Repository instructions and CI must not prescribe npm or npx commands, even when upstream documentation uses them.