click-path-audit

Map state-change paths for interactive elements to detect race and stale-closure bugs.

Updated Nov 7, 2025
One-click install
npx skills add https://github.com/phoenicisf/forex-analyzer --skill click-path-audit-phoenicisf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: click-path-audit
Source: https://github.com/phoenicisf/forex-analyzer/tree/main/.agents/skills/click-path-audit
Command: npx skills add https://github.com/phoenicisf/forex-analyzer --skill click-path-audit-phoenicisf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Trace and validate that user actions produce the intended UI state by mapping interdependent state changes, detecting where sequential calls, race conditions, or stale closures cause final state to diverge from expectations.

Core Features & Use Cases

  • Map and analyze state-change paths across interactive elements and stores.
  • Detect patterns like Sequential Undo, Async Race, and Stale Closure that hide bugs in manual reviews.
  • Use after major refactors or shared-state changes to prevent regressions and improve UI reliability.

Quick Start

Run a click-path audit on the target UI page to map handlers and their state changes.

Frequently Asked Questions about click-path-audit

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

FAQPage Schema
How do I detect stale closures and race conditions in React state management?

Trace state bugs by mapping the full state-change path for every interactive element. This audit analyzes handler calls and side effects to uncover sequential undo, race, or stale-closure bugs in React components.

How do I trace UI state changes after a major frontend refactor?

Trace UI state changes after refactors by running a click-path audit to map handlers and their interdependent state changes. This validates that the final UI state matches button label promises by analyzing side effects.

Why does my Zustand dynamic state store cause sequential undo bugs?

Zustand dynamic state stores cause sequential undo bugs when multiple handlers interact and interdependent state changes diverge from expectations. Mapping the full state-change path uncovers these hidden sequential call patterns.

What is the best way to validate UI state matches button label promises in React?

Validate UI state matches button label promises by mapping interdependent state changes and analyzing handler calls and side effects. This click-path audit detects where sequential calls, race conditions, or stale closures cause divergence.

Can I use click-path auditing for frontend debugging across multiple state stores?

Yes, you can use click-path auditing for frontend debugging across multiple state stores. The audit is specifically designed for frontend components where multiple stores or handlers interact to uncover hidden bugs.