Evidence review
Skill: Shared Write Law
--- name: shared-write-law description: Use when about to edit any shared file in miscsubjects-pages, .claude/skills, or .agents/skills. Prevents write collisions and overwritten work. ---
Shared Write Law — claim before edit
Overview
Shared files in this build are edited by multiple agents. Editing without a claim causes collisions, overwritten work, and repeated fixes. This skill makes the existing AGENTS.md WRITE LAW automatic.
When to Use
- Before editing any file under
miscsubjects-pages/,~/.claude/skills/, or~/.agents/skills/. - When resuming work on a file you edited earlier in the same session.
- When you see
FILE_CLAIMDENIED or the file is already claimed.
Core Pattern
Read file → FILE_CLAIM claim → Edit → FILE_CLAIM release- Read the file first. Never edit a file you have not read this session.
- Claim it with
FILE_CLAIM claim, passing the absolute path, agent holder, and 90-minute TTL. - Only if the response starts with
CLAIMED:— edit the file. - Release when done with
FILE_CLAIM release.
Rules
- DENIED means stop. Read the file fresh, find who holds the claim, coordinate. Do not edit.
- Claims are per-file. Editing five files requires five claims.
- Release after your last edit in the session. Do not hold claims you are not actively using.
- TTL is 90 minutes. If your session crashes, the claim expires automatically.
- Success prefix matters. A
FILE_CLAIMresult starting withCLAIMED:succeeded. Parse that prefix, not substring matches on the word "error" elsewhere in the response.
Red Flags — STOP and Claim
- "I'll just patch this quickly."
- "The file is probably free."
- "I'll check the claim after editing."
- Reading a file and immediately reaching for Edit/Write without FILE_CLAIM.
All of these cause the collisions the owner is tired of fixing.
Common Mistakes
- Editing before claiming → Claim first. If denied, do not proceed.
- Releasing with wrong holder string → Use the same
agent:session-prefixyou claimed with. - Assuming free because FILE_CLAIM check said FREE → Claim anyway; FREE can change between check and edit.
- Editing a file another agent changed since your read → Re-read, re-claim, merge changes.
Verify
Before every edit, confirm: Read ✓ → FILE_CLAIM claim returned CLAIMED: ✓ → Edit ✓ → FILE_CLAIM release ✓.
Ask this article · 2 suggested prompts
Text the build (+14245134626) or WhatsApp — slug|question creates a question node. Paste evidence with ingest slug|q:NODE_ID|your paste.
For my medical situation, what can you answer from your catalogue about Skill: Shared Write Law — and what would you need me to tell you first?
ask skill-shared-write-law condition gaps · paste includes §SELF
What good and bad outcomes are documented for Skill: Shared Write Law (studies vs anecdotes)?
ask skill-shared-write-law good bad experiences · paste includes §SELF