anchor-authoring
Installation
SKILL.md
Anchor Authoring
An Anchor preserves what the user means and why it matters, in a form that another agent can understand without the initiating conversation. It is product intent, not an implementation plan, an exhaustive specification, or an automatic approval gate.
Use for a new capability, a material change in intended behavior, or an ambiguity that will affect independent work. Reuse or amend an existing Anchor for smaller changes instead of creating a new one by default.
Method
- Discover before drafting. Read applicable existing product intent, requirements, design, and decisions through the repository's knowledge system. Inspect current behavior when it matters. An implementation is evidence of current reality, not authority to redefine the user's goal.
- Recover the user's actual request. Preserve the intended benefit, affected users or actors, relevant context, and meaningful wording. Distinguish the user's explicit decisions from agent recommendations and inferred consequences. Do not paste a conversation transcript.
- Separate outcomes from solutions. State what must be possible or observable, what is excluded, and which constraints are already accepted. Keep ordinary technology, component, or task choices open to later specialists.
- Resolve consequential ambiguity. First consult existing sources. Ask the user only about unresolved choices they own and that materially change success, scope, guarantees, or risk acceptance. Explain the trade-off and recommend an option when useful; do not demand an interview when the request is already clear.
- Make the outcome falsifiable. Define a small set of observable success/acceptance conditions and important negative boundaries. Do not invent numeric targets or guarantees where the user supplied none.
- Preserve decision lineage. Record material choices, their reason, rejected alternatives when relevant, and outstanding questions. Mark proposals as proposals; do not silently convert exploratory language into commitments.
- Check for parallel-use ambiguity. Ask whether independent agents could implement mutually incompatible meanings while still claiming they followed this Anchor. Resolve important semantic differences before relying on the Anchor for delegation; defer implementation detail.
- Present the interpreted intent. Give the user a concise opportunity to correct material misunderstandings. Record acceptance only when it actually occurred. Do not claim acceptance from silence or a tool result. Small, already clear changes may use previously accepted authority without an extra ceremony.
- Publish to the repository's chosen location. Follow its
AGENTS.md(or equivalent), artifact naming rules, andokf-authoringif available. Make provenance and relevant relationships discoverable. No global folder structure, ID format, or harness command is imposed by this skill. - Run the fresh-session test. Another agent should understand the expected outcome, constraints, accepted decisions, and genuinely unresolved questions without the originating chat.