---

name: root-package-json-config description: Root package.json configuration for MetaSaver monorepos. Use when creating or auditing root package.json files to ensure workspace configuration, required scripts (build, dev, lint, test, format, clean), turbo pipeline scripts, packageManager field, and no dependencies at root (only devDependencies).

Root package.json Configuration Skill

Provides root package.json template and validation logic for MetaSaver monorepo configuration.

Purpose

Configure pnpm workspaces, monorepo scripts, package manager, devDependencies, and cross-platform compatibility.

Template

Located at: templates/root-package.json.template

The 5 Root Package.json Standards

Rule	Requirement	Details
1	Monorepo metadata	name: @metasaver/*, private: true, packageManager: pnpm@*, engines (node, pnpm), type: "module"
2	Standard scripts	build, clean, dev, lint*, prettier*, test*, db*, docker*, setup*
3	DevDependencies only	NO dependencies (except cross-platform binaries). Tooling in devDependencies only
4	Workspaces in YAML	NO workspaces field (use pnpm-workspace.yaml)
5	Cross-platform binaries	turbo-linux-64, turbo-windows-64 in dependencies (NOT optionalDependencies)

Rule 1: Monorepo Metadata

{
  "name": "@metasaver/project-name",
  "private": true,
  "packageManager": "pnpm@10.20.0",
  "engines": { "node": ">=22.0.0", "pnpm": ">=9.0.0" },
  "type": "module"
}

Rule 2: Required Scripts (18 total)

Category	Scripts
Build	build, clean, dev
Lint/Format	lint, lint:fix, lint:tsc, prettier, prettier:fix
Test	test:unit, test:coverage, test:watch
Database	db:generate, db:migrate, db:seed, db:studio
Docker	docker:up, docker:down, docker:logs
Setup	setup:npmrc, setup:env, setup:all

Rule 3: Required DevDependencies

Core: @commitlint/cli, @metasaver/core-eslint-config, @metasaver/core-prettier-config, dotenv, husky, lint-staged, prettier, turbo, typescript

Rule 4: No Workspaces Field

Use pnpm-workspace.yaml instead.

Rule 5: Cross-Platform Binaries

{
  "dependencies": {
    "turbo-linux-64": "2.6.1",
    "turbo-windows-64": "2.6.1"
  }
}

Validation

Validation checks (pseudo-code):

// Rule 1: Metadata
validate(
  config.name?.startsWith("@metasaver/"),
  config.private === true,
  config.packageManager?.startsWith("pnpm@"),
  config.engines?.node,
  config.engines?.pnpm,
);

// Rule 2: Scripts (18 required)
const required = [
  "build",
  "clean",
  "dev",
  "lint",
  "lint:fix",
  "lint:tsc",
  "prettier",
  "prettier:fix",
  "test:unit",
  "test:coverage",
  "db:generate",
  "db:migrate",
  "db:seed",
  "db:studio",
  "docker:up",
  "docker:down",
  "setup:npmrc",
  "setup:env",
];
validate(required.every((s) => config.scripts?.[s]));

// Rule 3: DevDependencies
const devDeps = [
  "@commitlint/cli",
  "@metasaver/core-eslint-config",
  "@metasaver/core-prettier-config",
  "dotenv",
  "husky",
  "lint-staged",
  "prettier",
  "turbo",
  "typescript",
];
validate(devDeps.every((d) => config.devDependencies?.[d]));

// Rule 4: No workspaces field
validate(!config.workspaces);

// Rule 5: Cross-platform binaries
validate(
  config.dependencies?.["turbo-linux-64"],
  config.dependencies?.["turbo-windows-64"],
);

Best Practices

1. Use template as starting point
2. All scripts use turbo for orchestration
3. Cross-platform binaries in dependencies (not devDependencies)
4. Keep root dependencies empty (tooling in devDependencies only)
5. Re-audit after changes

Integration

• Repository type: Use /skill scope-check if not provided
• Workflow: /skill audit-workflow
• Remediation: /skill remediation-options
• Related: pnpm-workspace-config, turbo-config