repo-modernizer git:20260726.b67ae30A

Immutable. This exact content is served forever at /api/v1/blob/11dfe0a04b5b8037.

---
name: repo-modernizer
description: "Repo/monorepo modernization: dependency upgrades, security fixes, deprecation cleanup, framework migrations, dependency-native refactors, and verified hard-cut simplification."
---

# Repo Modernizer

Use this skill when you need to audit, upgrade, refactor, and simplify a repo
or monorepo end-to-end around dependencies, security findings, deprecations,
and framework migrations.

## Variant References

Use the base prompt below by default. If the repo shape or workflow calls for a
specialized operating mode, load the matching reference first:

- `references/00-variant-index.md`
- `references/framework-lane-selection.md`
- `references/dependency-decision-matrix.md`
- `references/verification-matrix.md`
- `references/report-template.md`
- `references/bun-first.md`
- `references/pnpm-turbo-monorepo.md`
- `references/plan-first.md`
- `references/gh-deps-workflow.md`
- `references/gh-deps-report-spec.md`

Selection guidance:

- Bun-managed repos: start with `references/bun-first.md`
- pnpm + Turbo monorepos: start with `references/pnpm-turbo-monorepo.md`
- review-heavy or approval-gated work: start with `references/plan-first.md`
- GitHub release/changelog dependency intel: use the scripts in `scripts/` and
  load `references/gh-deps-workflow.md`
- framework-heavy repos: also read `references/framework-lane-selection.md`
- during package triage: read `references/dependency-decision-matrix.md`
- before execution wrap-up: read `references/verification-matrix.md`
- for final delivery: read `references/report-template.md`
- if unclear: read `references/00-variant-index.md` first

## Intent

- Find every vulnerable dependency, outdated dependency, deprecated API,
  obsolete custom abstraction, and dependency-driven cleanup opportunity.
- Deeply research the latest official docs, changelogs, migration guides,
  release notes, GitHub releases, advisories, and upstream issues.
- Upgrade dependencies to the latest safe and supportable versions.
- Refactor the codebase to adopt modern dependency-native APIs and delete
  obsolete wrappers, shims, fallbacks, and duplicate implementations.
- Leave the repo in a verified, production-ready, simplified state.

## Required Skills and Tools

Use these throughout the task:

- `$bun-dev`
- `$hard-cut`
- `$github`
- `context7`
- `web.run`

Use `$opensrc` conditionally as an escalation path for package upgrades
that need source-level proof.

Framework-specific routing is defined in the execution prompt below and refined
further in `references/framework-lane-selection.md`.

## GitHub Dependency Intel Lane

Resolve `skill_dir` as the directory containing this skill before running the
bundled dependency-intel scripts.

- Full dependency report:
  - `python3 "$skill_dir/scripts/gh_deps_intel.py" full --repo . --out reports --mode safe`
- Single dependency migration plan:
  - `python3 "$skill_dir/scripts/gh_deps_intel.py" package --repo . --out reports --mode safe --dependency <name>`
- Stage-level debugging:
  - `python3 "$skill_dir/scripts/gh_deps_intel.py" scan --repo . --out reports`
  - `python3 "$skill_dir/scripts/gh_deps_intel.py" enrich --repo . --out reports --mode safe`
  - `python3 "$skill_dir/scripts/gh_deps_intel.py" analyze --repo . --out reports --mode safe`
- Direct GitHub helpers:
  - `python3 "$skill_dir/scripts/gh_release_diff.py" owner/repo --current <version> --target <version>`
  - `python3 "$skill_dir/scripts/gh_compare_notes.py" owner/repo <old-ref> <new-ref>`
  - `python3 "$skill_dir/scripts/gh_rate_limit_diag.py"`

Default to `--mode safe`. Use `--mode fast` only when the user accepts bounded
parallel API calls. Produce both Markdown and JSON reports.

Load these references when using this lane:

- `references/gh-deps-workflow.md`
- `references/gh-deps-command-mapping.md`
- `references/gh-deps-github-api-endpoints.md`
- `references/gh-deps-compatibility-policy.md`
- `references/gh-deps-report-spec.md`
- `references/gh-deps-troubleshooting.md`

## Execution Prompt

For full execution mode, load [references/execution-prompt.md](references/execution-prompt.md). It contains the complete modernization prompt, research requirements, dependency audit workflow, framework lanes, upgrade strategy, verification expectations, and final report contract.

Keep this entrypoint focused on routing and reference selection. Do not duplicate framework-specific playbooks here; use the variant references above.