find-impacted-routes

Trace git diffs to identify impacted Next.js App Router routes.

11|3|Updated Aug 31, 2025
One-click install
npx skills add https://github.com/tonehq/tone --skill find-impacted-routes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: find-impacted-routes
Source: https://github.com/tonehq/tone/tree/main/frontend/.claude/skills/find-impacted-routes
Command: npx skills add https://github.com/tonehq/tone --skill find-impacted-routes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes git diffs between commits to identify which Next.js App Router routes (pages) are affected by code changes. Traces the full impact chain: service changes → Jotai atoms → components → page files → URL routes. Also detects layout changes (affecting all child routes) and middleware changes (affecting all protected routes). Use when the user asks "what routes changed", "which pages are impacted", "what did my diff affect", "find changed pages", "trace route impact", "what routes need testing", or "what pages were modified". Works with the Next.js App Router + Jotai + shadcn/ui frontend in this project.

Core Features & Use Cases

  • Traces impact across the dependency chain from API layer to route pages
  • Detects layout and middleware changes that affect multiple routes
  • Generates a structured report linking routes to source files and components
  • Ideal for code reviews, testing scope, and impact analysis after diffs

Quick Start

Run the tool against a frontend git diff to obtain an impact report detailing direct and transitive route changes.

Frequently Asked Questions about find-impacted-routes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find which Next.js App Router routes are impacted by a git diff?

Next.js route impact analysis traces code changes from services to page files by building a reverse import graph. It resolves URL routes affected by modified components, atoms, and tools, identifying which specific pages require testing after a commit or branch diff.

Can I trace transitive route impacts through components and Jotai atoms in Next.js?

Tracing transitive impacts involves parsing TypeScript project files to construct a reverse import graph. This maps how modifications to Jotai atoms and shared components propagate upward through the dependency chain to affect Next.js App Router pages and their URL routes.

Does this route impact analysis detect Next.js layout and middleware changes?

Yes, route impact analysis detects Next.js layout and middleware changes. Layout modifications are flagged as affecting all child routes within that directory segment, while middleware changes are identified as impacting all protected routes relying on that middleware logic.

What is the best way to determine what pages need testing after a frontend git diff?

The best way to determine what pages need testing is to generate a structured impact report from the git diff. This report links modified source files to Next.js App Router routes, tracing dependencies through components and atoms to isolate the exact testing scope.

Do I need a specific frontend stack to map git diffs to Next.js routes?

Yes, mapping git diffs to Next.js routes requires a specific frontend stack. The analysis is designed for projects using the Next.js App Router combined with Jotai for state management and shadcn/ui for components to accurately parse and trace the dependency chain.