AGENT SKILL

principle-separate-before-serializing-shared-state

Separate before serializing shared state. Apply when concurrent actors might write to the same file, branch, key or state object.

License 许可
MIT
最近更新
2026-11-15
Stars
★ 2
Forks
0

01 前言 Front Matter

name
principle-separate-before-serializing-shared-state
license
MIT
metadata
{ "source": "pstack principle-separate-before-serializing-shared-state, MIT, Copyright (c) 2026 Lauren Tan, github.com/cursor/plugins, adapted; checked against pstack 0.15.36 at commit 0bb6f37" }
description
Separate before serializing shared state. Apply when concurrent actors might write to the same file, branch, key or state object.

03 SKILL.md 正文

<!-- Generated by scripts/build.mjs from the sources; edit the source, then run npm run build. -->

Separate before serializing shared state

When concurrent actors might share state that changes, first ask whether they need the same object. If not, remove the sharing. When the sharing is real, enforce one writer at a time by structure: lock files, sequential phases or exclusive ownership. Instructions and conventions are not concurrency control.

Why. Concurrent writes to shared state cause race conditions. They are intermittent, hard to reproduce and expensive to debug.

What to do.

  1. Find the shared state that changes: files that both read and write, branches that both push to, APIs that both define and consume.
  2. By default, remove the shared write target. Ask: do these actors need one canonical object, or do they publish independent facts? Give each actor its own file, key, branch or state folder. Merge the results only where they are read or reported. Two actors that each write their own lastX field into one state.json still share it; indexer-state.json and metrics-state.json do not.
  3. Only when one shared write target is a real invariant, serialise access by structure: lock files, sequential phases, a single writer or an atomic compare-and-swap. Treat "we need a lock" as a design smell to check, not as the default answer.

04 同仓库更多 Skills

erickb336
erickb336/sage-stack

writing-standard

Write at 80% of Simplified Technical English. Apply to any text an agent writes for a person: messages, reports, specs, findings, reviews, plans.

★ 2
erickb336
erickb336/sage-stack

sage

The state tool of sage mode: records tasks, routes, agent runs, findings, verdicts by head SHA and the user's gates in ~/.claude/sage/<project>/. Use in sage mode for every change of a task's state, and before any merge. Claude Code only.

★ 2
erickb336
erickb336/sage-stack

sage-help

Help with sage: how to set it up, switch sage mode and autopilot, read the board, answer the chief's questions, pick a skill or a principle, fix a run that went wrong, and find where sage keeps its files. The user types /sage:sage-help (or /sage-help) with a question. Load it only when the user types it; do not load it on your own. Claude Code only.

★ 2
erickb336
erickb336/sage-stack

report

The report that every sage agent ends with: STATUS, RESULT, EVIDENCE, FINDINGS, QUESTIONS, NOT VERIFIED, BRANCH. Use at the end of any task that the sage chief of staff gave you. Claude Code only.

★ 2
erickb336
erickb336/sage-stack

remote-control

Set up Remote Control, so that the user can follow, steer and start Claude Code sessions from the Claude app on a phone. It turns Remote Control on for every new session, and it can run a server in a folder (such as ~/workspace) that starts at each login. Use when the user asks to reach sessions or start new ones from a phone, or to set up, check or undo Remote Control. Claude Code only.

★ 2
erickb336
erickb336/sage-stack

readme-guide

Write a project README. Apply when you write, change or review a README of any project, in any language.

★ 2