Skip to content

/upfront:upgrade

/upfront:upgrade runs a health check on everything: plugin version, installed guardrails, instruction file quality, and architecture doc freshness. Reports what’s current, what’s missing, and offers to fix it.

  • Start of a new project — verify tooling is set up
  • Periodically — make sure nothing has drifted
  • After an update notification — check what changed
CheckWhat it does
Plugin versionCompares installed version against latest GitHub release
sloppy-joeSupply chain protection — blocks hallucinated package names
gitleaksSecret detection — catches API keys in commits
Test runnerDetects and verifies the project’s test runner works
Linter / formatterChecks they’re configured and running
Pre-commit hooksVerifies hooks are installed
CLAUDE.md / AGENTS.mdQuick audit — commands, boundaries, examples, references
ARCHITECTURE.mdChecks freshness — flags if stale

A clean summary with status indicators and specific actions for anything that needs fixing. Offers to install missing tools directly.