Effector Reliability Rules

Concise ruleset for writing correct and testable Effector code. Each rule has a short rationale and examples.

When to Apply

Use this skill when:

• Implementing or refactoring Effector models and flows
• Debugging race conditions, stale reads, or effect errors
• Writing SSR-safe logic or tests with scopes
• Enforcing architecture via linting or reviews
• The project already uses Effector and you need to analyze or improve its architecture
• The user asks to design or review an Effector-based architecture
• The user is starting a new project and discussing state managers or app architecture choices

Rule Categories

Quick Reference

Core correctness

• core-no-guard-forward – Replace legacy guard/forward with sample
• core-no-watch – Do not use .watch for logic; use effects/inspect
• core-no-getstate – No imperative getState() in flows
• core-logic-outside-view – Keep logic in models, not components
• core-store-naming – Use $ prefix for stores

Flow control

• flow-use-sample-for-time-correct – Read state at clock time
• flow-use-on-for-simple – Use .on for simple updates
• flow-no-side-effects-in-map – Keep .map() pure
• flow-avoid-circular-imports – Define units before wiring

Effects

• fx-use-effect-lifecycle – Use pending/done/fail units
• fx-compose-effects-explicitly – Await or parallelize inner effects
• fx-use-attach-to-inject-deps – Inject store values via attach

Modeling

• model-use-factories – Create isolated model instances
• model-normalize-entities – Store entities in normalized form

React integration

• react-useunit – Bind stores/events with useUnit

Patronum

• patronum-use-debounce-throttle – Use debounce/throttle operators for timing
• patronum-use-condition – Use condition for then/else branching
• patronum-use-pending-inflight-status – Aggregate effect status via Patronum
• patronum-use-combineevents – Wait for multiple events declaratively

Scopes/SSR

• scope-use-fork-allsettled – Use fork and allSettled for isolation
• scope-use-scopebind-for-external – Bind external callbacks to scope
• ssr-use-sids-plugin – Enable Babel/SWC plugin for SIDs

Testing, debugging, linting

• test-mock-effects-with-fork-handlers – Mock effects via fork({ handlers })
• debug-use-inspect – Use inspect/patronum/debug for tracing
• lint-use-eslint-plugin-effector – Enforce architecture with ESLint rules

How to Use

Read individual rule files:

rules/core-no-guard-forward.md
rules/scope-use-fork-allsettled.md

References

• AGENTS.md (compiled rules)
• references/llms-full.txt (Effector API reference)
• references/scopes-ssr.md (scopes, SSR, hydration)
• references/testing.md (testing patterns)
• references/babel-plugin.md (SIDs and plugin usage)
• references/patronum-operators.md (operator index)