// Upgrade outdated npm dependencies in the pnpm monorepo (recursive update, latest, targeted packages). Use when the user asks to upgrade dependencies, bump packages, refresh lockfile, pnpm update, outdated packages, latest versions, or dependency refresh—not monorepo release versions.
Format code, run linters and static analysis, and find unused code (ESLint + Knip). Use when the user asks to fix lint, format code, run formatters, find dead code, unused exports, run knip, fix style, tidy code, or run eslint --fix.
Manage Architecture Decision Records (ADRs). Use this to initialize, create, list, and link ADRs to document architectural evolution. Requires 'adr-tools' to be installed.
Use at the end of a coding session to summarize outcomes, failures, inefficiencies, and root causes, then output a concise postmortem report with ranked improvements for next time. Output only in chat; do not edit project files unless the user explicitly asks. Skip nit-picks and one-off mistakes.
Interactively bump package versions for the parser package. Use when the user asks to bump version, increment version, set release version, or release dbt-artifacts-parser.
Regenerates TypeScript types from dbt artifact JSON schemas. Use when the user asks to update parsers, sync with upstream, refresh types, or regenerate parser types from existing schemas.
Interactive deep research and decision support: frame the real problem (XY-aware), ask exactly 10 multiple-choice questions one at a time, then produce a rigorous comparative evaluation (default 5 approaches, 0–100 scores) and recommendation. Use when the user wants structured discovery before committing to a solution, a scored comparison of approaches, or to avoid jumping straight to an answer—especially for architecture, strategy, or high-stakes trade-offs.
| name | dependency-upgrade |
| description | Upgrade outdated npm dependencies in the pnpm monorepo (recursive update, latest, targeted packages). Use when the user asks to upgrade dependencies, bump packages, refresh lockfile, pnpm update, outdated packages, latest versions, or dependency refresh—not monorepo release versions. |
| compatibility | Requires **pnpm** and **Node.js** matching [.node-version](../../../.node-version). Run all install/update commands from the **repository root** where `pnpm-workspace.yaml` and `pnpm-lock.yaml` live. Does not replace the **version-bump** skill for workspace package `"version"` fields. |
Activate when the user says or implies:
@aws-sdk/client-s3 across workspaces)| Topic | Use instead |
|---|---|
| Bumping parser package versions | version-bump |
Editing workspace:* links | Leave as-is unless adding/removing packages |
Dependencies live in dependencies / devDependencies / optionalDependencies. Release package semver is the "version" field—different workflow.
| Approach | Feasibility | Risk | Fit for agents | Score |
|---|---|---|---|---|
Tiered: outdated → range update → targeted @latest → full --latest with consent | High | Controlled | Matches monorepo + CI | 92 |
Only pnpm -r update --latest | High | High breaks | Poor default | 45 |
| npm-check-updates as primary | Medium | Medium | Second toolchain; pnpm is canonical here | 48 |
| Manual edit every package.json | Low | High drift | Error-prone | 35 |
| Upgrade without lint/test/knip | High | Unknown | Violates repo gates | unacceptable |
Default path: inventory → conservative → targeted → aggressive only with explicit user OK.
pnpm outdated -r. Optional: pnpm outdated -r --long if the installed pnpm supports it and the output helps triage.pnpm -r update — refreshes the lockfile within existing semver ranges in each package.json.pnpm -r update <pkg>@latest (e.g. pnpm -r update @aws-sdk/client-s3@latest) so every workspace that declares <pkg> moves to latest and package.json ranges update as pnpm applies. For a single workspace only: pnpm --filter <workspace-name> add <pkg>@latest (dev: pnpm --filter <ws> add -D <pkg>@latest).pnpm -r update --latest — may jump majors across the tree. State the risk; do not run without confirmation.After any meaningful dependency or lockfile change:
pnpm lint:reportpnpm coverage:reportpnpm knipAll three must exit 0. If SDKs, bundlers, TypeScript, or ESLint majors moved, also run pnpm build or full root build script. See AGENTS.md quality gates.
Full command notes, examples, and edge cases: references/pnpm-upgrade-workflow.md.