> ## Documentation Index
> Fetch the complete documentation index at: https://docs.selftune.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent playbooks

> Use SelfTune safely on a user's behalf with explicit previews, approvals, and verification.

These playbooks are written for coding agents and agent harnesses. Human-facing
guides explain outcomes and product concepts; this section defines operating
contracts, mutation boundaries, expected evidence, and stop conditions.

## Default operating contract

1. Inspect the installed SelfTune version, supported harnesses, project root,
   and current skill locations before changing anything.
2. Prefer read-only inventory, audit, preview, and plan operations first.
3. Separate local file changes, hook installation, history import, background
   services, credentials, remote uploads, and publication into distinct consent
   decisions.
4. Show the exact package revision, destination, conflicts, and files affected
   before a mutation.
5. Preserve receipts and rollback information.
6. Verify the resulting state instead of assuming a command succeeded.

<Warning>
  Never infer permission to upload, publish, replace a skill, connect an
  account, install hooks, or delete data from permission to inspect the local
  library.
</Warning>

## Choose a playbook

<CardGroup cols={2}>
  <Card title="Set up and inventory" icon="radar" href="/setup-with-your-agent">
    Install or reuse SelfTune and return a verified inventory.
  </Card>

  <Card title="Manage the Library" icon="boxes-stacked" href="/agents/manage-the-library">
    Review duplicates, consolidation, quarantine, and restoration.
  </Card>

  <Card title="Scope Skill Sets" icon="folder-tree" href="/agents/scope-skill-sets">
    Capture or create a Set, plan project changes, and apply only after approval.
  </Card>

  <Card title="Share and distribute" icon="share-nodes" href="/agents/share-and-distribute">
    Verify the sealed revision and stop before each remote write.
  </Card>

  <Card title="Improve and validate" icon="flask" href="/agents/improve-and-validate">
    Turn an observed problem into a bounded, evidence-backed proposal.
  </Card>
</CardGroup>

The installed SelfTune `SKILL.md` remains the version-matched authority for
exact commands and platform-specific behavior. Use `selftune --help` when these
docs and the installed version disagree.