condition-based-waiting

SKILL.md

Flaky tests often guess at timing with arbitrary delays. This creates race conditions where tests pass on fast machines but fail under load or in CI.

Core principle: Wait for the actual condition you care about, not a guess about how long it takes.

| Wait for event | waitFor(() => events.find(e => e.type === 'DONE')) | | Wait for state | waitFor(() => machine.state === 'ready') | | Wait for count | waitFor(() => items.length >= 5) | | Wait for file | waitFor(() => fs.existsSync(path)) | | Complex condition | waitFor(() => obj.ready && obj.value > 10) |

テストに競合状態、タイミングの依存関係、または一貫性のない合否動作がある場合に使用します。任意のタイムアウトを条件ポーリングに置き換えて実際の状態の変化を待機し、タイミングの推測による不安定なテストを排除します。 ソース: nickcrew/claude-ctx-plugin。

原文を見る