@augmentcode/ag-redux-toolkit
Version:
Redux + Saga state management for Svelte apps — designed for AI agents. Includes runtime TypeScript source, AI skills, and reference documentation for robust, observable, high-performance state management.
94 lines (83 loc) • 5.07 kB
Markdown
---
name: core
description: >-
Root routing index for framework-independent Redux and redux-saga guidance in
ag-redux-toolkit. Use for canonical Redux state policy, action/reducer
primitives, normalized state helpers, typed-redux-saga patterns, saga manager
behavior, saga channel/effect helpers, explicit store pruning, serialization,
testing, debugging, and verifier handoff. Use Svelte or Streaming skills for framework-specific Store
selector/component behavior, choosing only one concrete Store family per app.
type: core
triggers:
- redux core
- core redux
- shared state
- canonical state
- createAction
- createReducer
- typed-redux-saga
- saga manager
- saga channels
- store pruning
- state serialization
- redux testing
- verifier
---
# Core Redux and saga routing
Use this skill for framework-independent Redux/redux-saga work in the
`ag-redux-toolkit` package. It routes to the core skills that are not owned
by the Svelte-specific or Streaming-specific taxonomy waves.
> This package uses a CUSTOM Redux setup — not Redux Toolkit (RTK). Do not use
> `createSlice`, `configureStore`, `createAsyncThunk`, or any RTK API.
## Preflight
- Read this skill plus every linked core leaf that applies to touched files.
- Cite the applicable skills and docs in implementation plans and handoffs.
- Include verifier-ready evidence: owner searches, focused tests, validation
scripts, or `git diff --check` depending on the change.
- Stop and ask if a request crosses into Svelte-specific selector/component
behavior or Streaming/Kefir-specific behavior.
- Pair core with at most one concrete Store family for a given app/code path;
core is shared Redux/redux-saga guidance and is not permission to integrate
both Svelte and Streaming Store patterns in one app.
## Core routing workflow
1. Start with `./core-policy/SKILL.md` for shared-state or architecture decisions.
2. Add `./state-integrity/SKILL.md` before adding/changing Redux state, actions,
selectors, watchers, or saga registration.
3. If and only if the user explicitly asks to prune unused Redux store surface
area, add `./store-pruning/SKILL.md` before deleting selectors, actions,
reducers, sagas, exports, tests, or orphaned helpers.
4. Add domain leaves that match the behavior being changed.
5. Add `./testing/SKILL.md` for reducer, saga, or verification changes.
6. Add `./verifier/SKILL.md` before handoff for reliability-sensitive reviews.
## Core leaf routes
| Route | Use when |
| --- | --- |
| `./core-policy/SKILL.md` | Redux ownership, side-effect boundaries, serializability, and utility reuse rules. |
| `./state-integrity/SKILL.md` | Preventing derived/duplicated Redux state and duplicate action/selector/saga ownership. |
| `./store-pruning/SKILL.md` | Explicit-only pruning of unused Redux selectors, actions, handlers, sagas, and orphaned store logic when the user asks for pruning. |
| `./import-boundaries/SKILL.md` | Public package imports, saga import boundaries, and Store-first public subpackages. |
| `./file-structure/SKILL.md` | Slice file layout, type modules, sagas, and Store registration patterns. |
| `./state-serialization/SKILL.md` | Structured-clone-safe Redux state values. |
| `./actions/SKILL.md` | `createAction` and `createAsyncAction` action creators. |
| `./reducers/SKILL.md` | Immutable chained reducers and no-op reference equality behavior. |
| `./sagas/SKILL.md` | typed-redux-saga flows, watchers, debounce, retry/timeout, and side-effect orchestration. |
| `./saga-manager/SKILL.md` | Package-owned saga crash tracking, lifecycle, restart, and backoff mechanics. |
| `./channel-effects/SKILL.md` | Generic EventChannel consumers for IPC, websocket, or DOM channels. |
| `./selector-channels/SKILL.md` | Saga reactions to selector value changes. |
| `./wait-for/SKILL.md` | One-shot saga waits for selector predicates. |
| `./local-storage/SKILL.md` | Safe app-local localStorage persistence from sagas. |
| `./collections/SKILL.md` | Normalized `Collection<T, K>` entity state. |
| `./domain-scoped-state/SKILL.md` | State keyed by workspace, project, tenant, or domain id. |
| `./boolean-preference/SKILL.md` | Boolean set/toggle preference helper registration. |
| `./testing/SKILL.md` | Reducer/saga testing, typed-redux-saga mocks, and reference equality assertions. |
| `./debugging/SKILL.md` | Runtime inspection and reducer reference-equality diagnostics. |
| `./verifier/SKILL.md` | Review quality gates for instruction drift, duplicate owners, and evidence. |
| `./redux-saga/SKILL.md` | Generic upstream redux-saga API reference. |
## Related non-core routes
- Svelte Store/component/selector lifecycle guidance lives under `../svelte/`.
- StreamingStore and Kefir/observable selector guidance lives under
`../streaming/`.
- These concrete Store families are mutually exclusive per app. Mixed
repositories may use different families in separate apps/packages/code paths,
but one app must not combine both.
- Migration lifecycle skills remain under `../svelte/migration/`.