hani-q/qstack / skills/qstack-separate-before-serializing-shared-state
qstack-separate-before-serializing-shared-state
VerifiedRedesign concurrent work that shares a mutable file, branch, key, or state object by separating ownership before adding serialization. Use when actors may race, a lock is proposed, or coordination relies on taking turns.
Separate before serializing shared state
Instructions and conventions are not concurrency control. Start by removing the shared write target. Add serialization only when one canonical writer is a real domain invariant.
Decide from ownership
- Inventory every mutable object and every actor that can write it. Include files, branches, database rows, keys, caches, queues, and in-memory state.
- Ask whether the actors publish independent facts. If they do, give each actor its own file, key, branch, or state directory and merge only at a read-only reporting boundary.
- Confirm that the split removes shared mutation. Two workers writing separate fields of one JSON document still share a write target; separate documents with one owner each do not.
- If one shared object is required, choose structural serialization: a single-writer actor, sequential phases, a lockfile with defined stale-lock behavior, an atomic transaction, or compare-and-swap.
- Prove the design under overlap, retry, crash, and stale-state scenarios.
Report the ownership map, the sharing that can be removed, any invariant that requires serialization, and the concrete mechanism enforcing it. A request for analysis does not authorize changing the system. Assess compatibility and migration before changing a persisted format, public interface, or branch workflow. It also does not authorize commits, pushes, publishing, deployment, or external messages.
Adapted from Lauren Tan's PStack
principle-separate-before-serializing-shared-state
at commit 60c641e4fad674784b30abcf9f8915dea39df38d under the MIT License.
See third-party notices.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |