К основному содержанию
скилл CX Codex

click-path-audit — скилл для Claude Code: поиск конфликтов стейта

Скилл click-path-audit для Claude Code и Codex находит скрытые конфликты в обработчиках интерфейса. Проверяет последовательность изменений стейта, когда внешне функции работают, но сбрасывают результаты друг друга.

MIT 6 200 установок ★ 308 413 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add affaan-m/ECC --skill click-path-audit -a claude-code
Открыть на GitHub

Что делает click-path-audit

Аудит интерфейсных точек отслеживает цепочки вызовов от клика или отправки формы до финального состояния хранилища. Сначала процедура составляет карту мутаций стейта (например, в Zustand или React Context), фиксируя все побочные сбросы данных. Затем проверяется каждый обработчик: читает ли последующий вызов чужое состояние и не затирает ли его.

Проверка выявляет шесть типовых паттернов поломок. Среди них гонки асинхронных запросов, перехваты в useEffect, устаревшие замыкания и последовательное обнуление значений соседними сеттерами. Анализ глубокий, поэтому для крупных проектов предусмотрено разделение работы между несколькими субагентами под отдельные разделы приложения.

Какие задачи решает

  • найти причину неработающей кнопки при отсутствии ошибок в консоли
  • выявить неявный сброс глобального стейта после рефакторинга
  • обнаружить состояние гонки в асинхронных обработчиках клика
  • проверить соответствие финального состояния экрана действию пользователя

Примеры запросов агенту

  • Проверь через click-path-audit кнопку создания письма в ThreadList.tsx
  • Запусти аудит обработчиков клика после изменения действий в хранилище emailStore
  • Выполни click-path-audit для всех интерактивных элементов на странице проектов

Как установить click-path-audit

1Через Skills CLI (Vercel)

npx skills add affaan-m/ECC --skill click-path-audit -a claude-code

2Вручную: положить файлы

~/.claude/skills/click-path-audit/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/click-path-audit/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о click-path-audit

Как установить click-path-audit в Claude Code?

Выполните команду npx skills add affaan-m/ECC --skill click-path-audit -a claude-code в терминале.

Что делает click-path-audit?

Скилл пошагово разбирает логику обработчиков событий и выявляет сайд-эффекты, которые незаметно отменяют действия пользователя.

Когда стоит запускать этот аудит?

Инструмент предназначен для ситуаций, когда стандартная отладка не видит сбоев, но элементы интерфейса не реагируют, а также после правок общих хранилищ состояния.

Исходный текст

SKILL.md · MIT
---
name: click-path-audit
description: "Trace every user-facing button/touchpoint through its full state change sequence to find bugs where functions individually work but cancel each other out, produce wrong final state, or leave the UI in an inconsistent state. Use when: systematic debugging found no bugs but users report broken buttons, or after any major refactor touching shared state stores."
metadata:
  origin: community
---

# /click-path-audit — Behavioural Flow Audit

Find bugs that static code reading misses: state interaction side effects, race conditions between sequential calls, and handlers that silently undo each other.

## The Problem This Solves

Traditional debugging checks:
- Does the function exist? (missing wiring)
- Does it crash? (runtime errors)
- Does it return the right type? (data flow)

But it does NOT check:
- **Does the final UI state match what the button label promises?**
- **Does function B silently undo what function A just did?**
- **Does shared state (Zustand/Redux/context) have side effects that cancel the intended action?**

Real example: A "New Email" button called `setComposeMode(true)` then `selectThread(null)`. Both worked individually. But `selectThread` had a side effect resetting `composeMode: false`. The button did nothing. 54 bugs were found by systematic debugging — this one was missed.

---

## How It Works

For EVERY interactive touchpoint in the target area:

```
1. IDENTIFY the handler (onClick, onSubmit, onChange, etc.)
2. TRACE every function call in the handler, IN ORDER
3. For EACH function call:
   a. What state does it READ?
   b. What state does it WRITE?
   c. Does it have SIDE EFFECTS on shared state?
   d. Does it reset/clear any state as a side effect?
4. CHECK: Does any later call UNDO a state change from an earlier call?
5. CHECK: Is the FINAL state what the user expects from the button label?
6. CHECK: Are there race conditions (async calls that resolve in wrong order)?
```

---

## Execution Steps

### Step 1: Map State Stores

Before auditing any touchpoint, build a side-effect map of every state store action:

```
For each Zustand store / React context in scope:
  For each action/setter:
    - What fields does it set?
    - Does it RESET other fields as a side effect?
    - Document: actionName → {sets: [...], resets: [...]}
```

This is the critical reference. The "New Email" bug was invisible without knowing that `selectThread` resets `composeMode`.

**Output format:**
```
STORE: emailStore
  setComposeMode(bool) → sets: {composeMode}
  selectThread(thread|null) → sets: {selectedThread, selectedThreadId, messages, drafts, selectedDraft, summary} RESETS: {composeMode: false, composeData: null, redraftOpen: false}
  setDraftGenerating(bool) → sets: {draftGenerating}
  ...

DANGEROUS RESETS (actions that clear state they don't own):
  selectThread → resets composeMode (owned by setComposeMode)
  reset → resets everything
```

### Step 2: Audit Each Touchpoint

For each button/toggle/form submit in the target area:

```
TOUCHPOINT: [Button label] in [Component:line]
  HANDLER: onClick → {
    call 1: functionA() → sets {X: true}
    call 2: functionB() → sets {Y: null} RESETS {X: false}  ← CONFLICT
  }
  EXPECTED: User sees [description of what button label promises]
  ACTUAL: X is false because functionB reset it
  VERDICT: BUG — [description]
```

**Check each of these bug patterns:**

#### Pattern 1: Sequential Undo
```
handler() {
  setState_A(true)     // sets X = true
  setState_B(null)     // side effect: resets X = false
}
// Result: X is false. First call was pointless.
```

#### Pattern 2: Async Race
```
handler() {
  fetchA().then(() => setState({ loading: false }))
  fetchB().then(() => setState({ loading: true }))
}
// Result: final loading state depends on which resolves first
```

#### Pattern 3: Stale Closure
```
const [count, setCount] = useState(0)
const handler = useCallback(() => {
  setCount(count + 1)  // captures stale count
  setCount(count + 1)  // same stale count — increments by 1, not 2
}, [count])
```

#### Pattern 4: Missing State Transition
```
// Button says "Save" but handler only validates, never actually saves
// Button says "Delete" but handler sets a flag without calling the API
// Button says "Send" but the API endpoint is removed/broken
```

#### Pattern 5: Conditional Dead Path
```
handler() {
  if (someState) {        // someState is ALWAYS false at this point
    doTheActualThing()    // never reached
  }
}
```

#### Pattern 6: useEffect Interference
```
// Button sets stateX = true
// A useEffect watches stateX and resets it to false
// User sees nothing happen
```

### Step 3: Report

For each bug found:

```
CLICK-PATH-NNN: [severity: CRITICAL/HIGH/MEDIUM/LOW]
  Touchpoint: [Button label] in [file:line]
  Pattern: [Sequential Undo / Async Race / Stale Closure / Missing Transition / Dead Path / useEffect Interference]
  Handler: [function name or inline]
  Trace:
    1. [call] → sets {field: value}
    2. [call] → RESETS {field: value}  ← CONFLICT
  Expected: [what user expects]
  Actual: [what actually happens]
  Fix: [specific fix]
```

---

## Scope Control

This audit is expensive. Scope it appropriately:

- **Full app audit:** Use when launching or after major refactor. Launch parallel agents per page.
- **Single page audit:** Use after building a new page or after a user reports a broken button.
- **Store-focused audit:** Use after modifying a Zustand store — audit all consumers of the changed actions.

### Recommended agent split for full app:

```
Agent 1: Map ALL state stores (Step 1) — this is shared context for all other agents
Agent 2: Dashboard (Tasks, Notes, Journal, Ideas)
Agent 3: Chat (DanteChatColumn, JustChatPage)
Agent 4: Emails (ThreadList, DraftArea, EmailsPage)
Agent 5: Projects (ProjectsPage, ProjectOverviewTab, NewProjectWizard)
Agent 6: CRM (all sub-tabs)
Agent 7: Profile, Settings, Vault, Notifications
Agent 8: Management Suite (all pages)
```

Agent 1 MUST complete first. Its output is input for all other agents.

---

## When to Use

- After systematic debugging finds "no bugs" but users report broken UI
- After modifying any Zustand store action (check all callers)
- After any refactor that touches shared state
- Before release, on critical user flows
- When a button "does nothing" — this is THE tool for that

## When NOT to Use

- For API-level bugs (wrong response shape, missing endpoint) — use systematic-debugging
- For styling/layout issues — visual inspection
- For performance issues — profiling tools

---

## Integration with Other Skills

- Run AFTER `/superpowers:systematic-debugging` (which finds the other 54 bug types)
- Run BEFORE `/superpowers:verification-before-completion` (which verifies fixes work)
- Feeds into `/superpowers:test-driven-development` — every bug found here should get a test

---

## Example: The Bug That Inspired This Skill

**ThreadList.tsx "New Email" button:**
```
onClick={() => {
  useEmailStore.getState().setComposeMode(true)   // ✓ sets composeMode = true
  useEmailStore.getState().selectThread(null)      // ✗ RESETS composeMode = false
}}
```

Store definition:
```
selectThread: (thread) => set({
  selectedThread: thread,
  selectedThreadId: thread?.id ?? null,
  messages: [],
  drafts: [],
  selectedDraft: null,
  summary: null,
  composeMode: false,     // ← THIS silent reset killed the button
  composeData: null,
  redraftOpen: false,
})
```

**Systematic debugging missed it** because:
- The button has an onClick handler (not dead)
- Both functions exist (no missing wiring)
- Neither function crashes (no runtime error)
- The data types are correct (no type mismatch)

**Click-path audit catches it** because:
- Step 1 maps `selectThread` resets `composeMode`
- Step 2 traces the handler: call 1 sets true, call 2 resets false
- Verdict: Sequential Undo — final state contradicts button intent

© affaan-m · MIT · affaan-m/ECC

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
zustand-state-management Mindrally Скилл zustand-state-management задаёт правила архитектуры сторов Zustand в React и TypeScript: от нарезки слайсов до SSR и тестов. Помогает избежать лишних ререндеров и ошибок гидратации. CX Codex +1 1 000установок zustand pproenca С 43 правилами по Zustand: архитектура сторов, селекторы, предотвращение лишних ре-рендеров. Подключается при написании или рефакторинге стора. CX Codex +1 463установок state-management statelyai Скилл state-management для Claude Code моделирует состояние приложения до выбора библиотеки. Проверяет и рефакторит модели, сокращает исходные данные и устраняет невозможные состояния. CX Codex +1 181установок react-zustand-cursorrules-prompt-file PatrickJS Правило react-zustand-cursorrules-prompt-file для Cursor задаёт работу с Zustand в React и TypeScript: структуру сторов, селекторы против лишних ререндеров и отделение серверного кэша от клиентских данных. CX Codex +1 ★ 41 178звёзд репо zustand-patterns OrchestKit Скилл zustand-patterns для Claude Code помогает проектировать хранилища на Zustand 5.x с типизацией в TypeScript. Подключается при настройке слайсов, селекторов useShallow и цепочек middleware. CX Codex +1 1 500установок zustand-5 prowler-cloud Скилл с паттернами управления состоянием в Zustand 5: базовые хранилища, селекторы, persist-middleware и разделение логики на слайсы. Помогает писать чистый реактивный код без лишних ре-рендеров. CX Codex +1 912установок

Из того же набора150

Весь набор →
data-scraper-agent Скилл data-scraper-agent для Claude Code собирает данные с публичных сайтов и API, обогащает их через Gemini Flash и складывает в Notion, Sheets или Supabase. Работает по расписанию через GitHub Actions без платного хостинга. CX Codex +1 6 300установок compose-multiplatform-patterns Скилл compose-multiplatform-patterns подсказывает паттерны Compose Multiplatform и Jetpack Compose для KMP-проектов: состояние, навигация, темы и UI под разные платформы. CX Codex +1 6 300установок hipaa-compliance Скилл hipaa-compliance работает в Claude Code и других платформах, обеспечивая соблюдение требований HIPAA при обработке персональных медицинских данных в ПО. CX Codex +1 6 200установок regex-vs-llm-structured-text Скилл regex-vs-llm-structured-text для Claude Code выбирает способ извлечения данных из структурированного текста. Для повторяющихся шаблонов он предлагает начать с regex, а LLM подключать к сомнительным результатам. CX Codex +1 6 200установок homelab-wireguard-vpn Скилл homelab-wireguard-vpn для Claude Code помогает настроить WireGuard для удалённого доступа к домашней сети. Он подключается при настройке VPN, генерации ключей и выборе split tunnel или full tunnel. CX Codex +1 6 200установок healthcare-emr-patterns Скилл healthcare-emr-patterns для Claude Code задаёт стандарты проектирования электронных медицинских карт с фокусом на безопасность пациентов и проверку лекарственных взаимодействий. CX Codex +1 6 200установок skill-comply Скилл skill-comply для Claude Code проверяет, соблюдает ли агент скиллы, правила и определения субагентов. Запускайте его после добавления правила или для регулярной проверки поведения агента. CX Codex +1 6 200установок terminal-ops Скилл terminal-ops для работы с репозиторием через терминал: запускает команды, читает состояние git, разбирает падения CI и делает точечные правки с доказательством того, что проверено. CX Codex +1 6 200установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой