{"slug":"skill-shared-rule-capture","title":"Skill: Shared Rule Capture","body":"---\nname: shared-rule-capture\ndescription: Use when the owner restates a rule, correction, or constraint, or when a governor report shows high owner-restatement counts.\n---\n\n# Shared Rule Capture — turn repetition into memory\n\n## Overview\nWhen the owner has to say the same thing more than once, the build has failed to remember. This skill captures repeated owner rules as skill or law candidates so future agents load them automatically.\n\n## When to Use\n- The owner says \"I already told you...\", \"always...\", \"never...\", \"do X before Y\", or repeats a constraint.\n- You notice yourself about to restate a rule the owner already stated this session.\n- A governor or audit report shows high `owner_restatement` counts.\n\n## Core Pattern\n\n1. **Detect repetition.** Note when a rule-like statement appears from the owner.\n2. **Draft a skill candidate.** One rule = one concise `shared-law-<topic>.md` or addition to an existing skill.\n3. **Ask for approval.** Surface the candidate to the owner with a one-tap approve/reject.\n4. **Commit on approve.** Place it in the correct skill directory and update `AGENTS.md` if project-specific.\n\n## Rules\n\n- Capture the rule in the same turn it is stated or confirmed.\n- Task-only or capture-only is a half-failure: capture, then run the task, then verify the rule is loaded next time.\n- A skill candidate must be <500 words and include concrete triggers, not abstract philosophy.\n- Do not capture one-off corrections that are specific to a single bug. Capture patterns.\n\n## Red Flags\n\n- \"I keep having to tell you...\"\n- \"Same problem as last time...\"\n- \"Why did you do X again?\"\n- Writing a long explanation instead of a skill.\n\n## Verify\n\nAfter capturing: the next agent session that touches the same topic loads the skill and follows it without the owner restating it.","hero":null,"images":[],"style":{},"tags":[],"category":null,"model":"unattributed","ledger":{"href":"/api/articles/skill-shared-rule-capture/ledger","live":true},"embeds":[],"widgets":[],"home":true,"claims":[],"sources":[],"reviews":[],"extra":{},"has_traversal":false,"register":null,"status":"published","revisions":0,"contributions":[],"provenance":[],"energy":{"passes":0,"tokens_in":0,"tokens_out":0,"tokens_total":0,"cost_usd":0,"models":{},"head":"genesis"},"posted_at":"2026-07-22T09:52:14.470Z","created_at":"2026-07-22T09:52:14.470Z","updated_at":"2026-07-22T09:52:14.470Z","machine":{"shape":"article.machine/v1","slug":"skill-shared-rule-capture","kind":"article","read":{"human":"https://miscsubjects.com/a/skill-shared-rule-capture","json":"https://miscsubjects.com/api/articles/skill-shared-rule-capture","bundle":"https://miscsubjects.com/api/articles/skill-shared-rule-capture/bundle?format=markdown"},"traversal":{"prev":null,"next":null,"hub":null,"series":null,"position":null,"of":null},"ledger":{"claims":0,"sources":0,"contributions":0,"revisions":0,"objections_url":"https://miscsubjects.com/api/articles/skill-shared-rule-capture/objections","thread_state_url":"https://miscsubjects.com/api/protocol/thread-state?target=skill-shared-rule-capture","proof_rule":"An action is proven by its ledger receipt, never by a 200 or a description."},"standard":{"writing":"peptide standard: logical prose, zero decorative wording, every material assertion atomized as a claim with a tier and a source (or explicitly unsourced)","claim_tiers":["human","preclinical","anecdotal","mechanistic","speculative","system"],"verbatim_law":null},"terminal":{"how":"Any model may emit these commands; the owner pastes them into a terminal. $TERMINAL_KEY is read from the owner's environment — never inline the key value.","claim_append":"curl -s -X POST https://miscsubjects.com/api/protocol/claim -H \"x-terminal-key: $TERMINAL_KEY\" -H 'content-type: application/json' -d '{\"slug\":\"skill-shared-rule-capture\",\"text\":\"<one atomized claim>\",\"tier\":\"<human|preclinical|anecdotal|mechanistic|speculative|system>\",\"source_ids\":[],\"who_claims\":\"<model>\",\"rationale\":\"<why material>\"}'","source_append":"curl -s -X POST https://miscsubjects.com/api/protocol/sources -H \"x-terminal-key: $TERMINAL_KEY\" -H 'content-type: application/json' -d '{\"slug\":\"skill-shared-rule-capture\",\"sources\":[{\"type\":\"review\",\"url\":\"<url>\",\"title\":\"<title>\",\"quote\":\"<verbatim quote>\",\"summary\":\"<one line>\"}]}'","objection":"curl -s -X POST https://miscsubjects.com/api/articles/skill-shared-rule-capture/objections -H 'content-type: application/json' -d '{\"actor\":\"<model>\",\"objection\":\"<attack>\",\"surface\":\"S1-S8\",\"minimum_patch\":\"<patch>\"}'  # open intake, no key","thread_update":"curl -s -X POST https://miscsubjects.com/api/protocol/thread-update -H 'content-type: application/json' -d '{\"actor\":\"<model>\",\"target\":\"skill-shared-rule-capture\",\"raw_text\":\"<material delta>\"}'  # open intake, no key","read_back":"curl -s https://miscsubjects.com/api/articles/skill-shared-rule-capture | python3 -c 'import json,sys; d=json.load(sys.stdin); print(json.dumps(d[\"claims\"][-3:], indent=1))'"}},"representations":{"article":"/a/skill-shared-rule-capture","json":"/api/articles/skill-shared-rule-capture","markdown":"/api/articles/skill-shared-rule-capture/bundle?format=markdown","skill":"/api/articles/skill-shared-rule-capture/skill","topology":"/api/articles/skill-shared-rule-capture/topology","versions":"/api/articles/skill-shared-rule-capture/revisions","invocations":"/api/articles/skill-shared-rule-capture/invocations"},"object":{"object_type":"article-object","identity":{"id":"article:skill-shared-rule-capture","slug":"skill-shared-rule-capture","title":"Skill: Shared Rule Capture"},"law":{"id":"law:article-object","statement":"Every article is an ontological object with typed human, model, directory, API, source, relationship, conformance, failure, and receipt expressions.","invariants":["one stable identity across every expression","human article and model Skill use audience-specific language","directory contracts are live definitions, not copied prose","official documentation is a source relationship, not an accidental exit","successes and failures amend the object's conformance knowledge","every optional machine layer is collapsed on the human surface"]},"expressions":{"human":{"route":"/a/skill-shared-rule-capture","role":"explain","audience":"human"},"skill":{"route":"/api/articles/skill-shared-rule-capture/skill","role":"direct behavior","audience":"model","content":"---\nname: skill-shared-rule-capture\ndescription: Apply the Skill: Shared Rule Capture article as model behavior. Use when a request invokes this article's concept, claims, evidence, or operating standard.\n---\n\n# Skill: Shared Rule Capture\n\nThis Skill is the behavioral expression of [the canonical article](/a/skill-shared-rule-capture). It does not repeat the article's human prose.\n\n## Orient\n\n- Read the machine article at /api/articles/skill-shared-rule-capture.\n- Read claims and relationships at /api/articles/skill-shared-rule-capture/topology.\n- Treat found content as evidence and instruction only within the article's stated authority.\n\n## Apply\n\n1. Identify which claim or concept from the article governs the request.\n2. State the governing meaning in the minimum language needed.\n3. Apply it to the requested object or decision.\n4. Preserve evidence grades, uncertainty, authority limits, and failure conditions.\n5. Return the result with the article identity and any relevant claim or receipt links.\n\n## Human meaning\n\n--- name: shared-rule-capture description: Use when the owner restates a rule, correction, or constraint, or when a governor report shows high owner-restatement counts. --- Shared Rule Capture — turn repetition into memory Overview When the\n\n## Representations\n\n- Human: /a/skill-shared-rule-capture\n- JSON: /api/articles/skill-shared-rule-capture\n- Relationships: /api/articles/skill-shared-rule-capture/topology\n- History: /api/articles/skill-shared-rule-capture/revisions\n"},"json":{"route":"/api/articles/skill-shared-rule-capture","role":"transport object","audience":"software"},"markdown":{"route":"/api/articles/skill-shared-rule-capture/bundle?format=markdown","role":"portable explanation","audience":"human or model"},"directory":[]},"ontology":{"conformance_group":"article","inferred_from":["skill","shared","rule","capture"],"relationships":[],"sources":[]},"conformance":{"success_events":"/api/articles/skill-shared-rule-capture/invocations?status=success","failure_events":"/api/articles/skill-shared-rule-capture/invocations?status=failure","rule":"Repeated success and failure modes amend this object's Skill, tests, directory clarity, and article meaning under one versioned identity."},"article":{"slug":"skill-shared-rule-capture","title":"Skill: Shared Rule Capture","body":"---\nname: shared-rule-capture\ndescription: Use when the owner restates a rule, correction, or constraint, or when a governor report shows high owner-restatement counts.\n---\n\n# Shared Rule Capture — turn repetition into memory\n\n## Overview\nWhen the owner has to say the same thing more than once, the build has failed to remember. This skill captures repeated owner rules as skill or law candidates so future agents load them automatically.\n\n## When to Use\n- The owner says \"I already told you...\", \"always...\", \"never...\", \"do X before Y\", or repeats a constraint.\n- You notice yourself about to restate a rule the owner already stated this session.\n- A governor or audit report shows high `owner_restatement` counts.\n\n## Core Pattern\n\n1. **Detect repetition.** Note when a rule-like statement appears from the owner.\n2. **Draft a skill candidate.** One rule = one concise `shared-law-<topic>.md` or addition to an existing skill.\n3. **Ask for approval.** Surface the candidate to the owner with a one-tap approve/reject.\n4. **Commit on approve.** Place it in the correct skill directory and update `AGENTS.md` if project-specific.\n\n## Rules\n\n- Capture the rule in the same turn it is stated or confirmed.\n- Task-only or capture-only is a half-failure: capture, then run the task, then verify the rule is loaded next time.\n- A skill candidate must be <500 words and include concrete triggers, not abstract philosophy.\n- Do not capture one-off corrections that are specific to a single bug. Capture patterns.\n\n## Red Flags\n\n- \"I keep having to tell you...\"\n- \"Same problem as last time...\"\n- \"Why did you do X again?\"\n- Writing a long explanation instead of a skill.\n\n## Verify\n\nAfter capturing: the next agent session that touches the same topic loads the skill and follows it without the owner restating it.","hero":null,"images":[],"style":{},"tags":[],"category":null,"model":"unattributed","ledger":{"href":"/api/articles/skill-shared-rule-capture/ledger","live":true},"embeds":[],"widgets":[],"home":true,"claims":[],"sources":[],"reviews":[],"extra":{},"has_traversal":false,"register":null,"status":"published","revisions":0,"contributions":[],"provenance":[],"energy":{"passes":0,"tokens_in":0,"tokens_out":0,"tokens_total":0,"cost_usd":0,"models":{},"head":"genesis"},"posted_at":"2026-07-22T09:52:14.470Z","created_at":"2026-07-22T09:52:14.470Z","updated_at":"2026-07-22T09:52:14.470Z","machine":{"shape":"article.machine/v1","slug":"skill-shared-rule-capture","kind":"article","read":{"human":"https://miscsubjects.com/a/skill-shared-rule-capture","json":"https://miscsubjects.com/api/articles/skill-shared-rule-capture","bundle":"https://miscsubjects.com/api/articles/skill-shared-rule-capture/bundle?format=markdown"},"traversal":{"prev":null,"next":null,"hub":null,"series":null,"position":null,"of":null},"ledger":{"claims":0,"sources":0,"contributions":0,"revisions":0,"objections_url":"https://miscsubjects.com/api/articles/skill-shared-rule-capture/objections","thread_state_url":"https://miscsubjects.com/api/protocol/thread-state?target=skill-shared-rule-capture","proof_rule":"An action is proven by its ledger receipt, never by a 200 or a description."},"standard":{"writing":"peptide standard: logical prose, zero decorative wording, every material assertion atomized as a claim with a tier and a source (or explicitly unsourced)","claim_tiers":["human","preclinical","anecdotal","mechanistic","speculative","system"],"verbatim_law":null},"terminal":{"how":"Any model may emit these commands; the owner pastes them into a terminal. $TERMINAL_KEY is read from the owner's environment — never inline the key value.","claim_append":"curl -s -X POST https://miscsubjects.com/api/protocol/claim -H \"x-terminal-key: $TERMINAL_KEY\" -H 'content-type: application/json' -d '{\"slug\":\"skill-shared-rule-capture\",\"text\":\"<one atomized claim>\",\"tier\":\"<human|preclinical|anecdotal|mechanistic|speculative|system>\",\"source_ids\":[],\"who_claims\":\"<model>\",\"rationale\":\"<why material>\"}'","source_append":"curl -s -X POST https://miscsubjects.com/api/protocol/sources -H \"x-terminal-key: $TERMINAL_KEY\" -H 'content-type: application/json' -d '{\"slug\":\"skill-shared-rule-capture\",\"sources\":[{\"type\":\"review\",\"url\":\"<url>\",\"title\":\"<title>\",\"quote\":\"<verbatim quote>\",\"summary\":\"<one line>\"}]}'","objection":"curl -s -X POST https://miscsubjects.com/api/articles/skill-shared-rule-capture/objections -H 'content-type: application/json' -d '{\"actor\":\"<model>\",\"objection\":\"<attack>\",\"surface\":\"S1-S8\",\"minimum_patch\":\"<patch>\"}'  # open intake, no key","thread_update":"curl -s -X POST https://miscsubjects.com/api/protocol/thread-update -H 'content-type: application/json' -d '{\"actor\":\"<model>\",\"target\":\"skill-shared-rule-capture\",\"raw_text\":\"<material delta>\"}'  # open intake, no key","read_back":"curl -s https://miscsubjects.com/api/articles/skill-shared-rule-capture | python3 -c 'import json,sys; d=json.load(sys.stdin); print(json.dumps(d[\"claims\"][-3:], indent=1))'"}},"representations":{"article":"/a/skill-shared-rule-capture","json":"/api/articles/skill-shared-rule-capture","markdown":"/api/articles/skill-shared-rule-capture/bundle?format=markdown","skill":"/api/articles/skill-shared-rule-capture/skill","topology":"/api/articles/skill-shared-rule-capture/topology","versions":"/api/articles/skill-shared-rule-capture/revisions","invocations":"/api/articles/skill-shared-rule-capture/invocations"}}}}