Tether

---
name: tether
description: Tether (install/uninstall) itp-hooks (ASCII guard, ADR sync reminder, fake-data-guard) to ~/.claude/settings.json. Renamed from.
allowed-tools: Read, Bash, TodoWrite, TodoRead
argument-hint: "[install|uninstall|status|restore [latest|<n>]]"
model: haiku
disable-model-invocation: true
---

<!--
ADR: 2025-12-07-itp-hooks-settings-installer
-->

# ITP Hooks Manager

Manage itp-hooks installation in `~/.claude/settings.json`.

Claude Code only loads hooks from settings.json, not from plugin.json files. This command installs/uninstalls three itp-hooks:

- **PreToolUse guard** - Blocks ASCII diagrams without a source block
- **PostToolUse reminder** - Prompts ADR/spec sync after file modifications
- **Fake-data-guard** - Detects fake/synthetic data patterns (np.random, Faker, etc.) in new Python files

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## Actions

| Action           | Description                         |
| ---------------- | ----------------------------------- |
| `status`         | Show current installation state     |
| `install`        | Add itp-hooks to settings.json      |
| `uninstall`      | Remove itp-hooks from settings.json |
| `restore`        | List available backups with numbers |
| `restore latest` | Restore most recent backup          |
| `restore <n>`    | Restore backup by number            |

## Execution

Parse `$ARGUMENTS` and run the management script:

```bash
/usr/bin/env bash << 'HOOKS_SCRIPT_EOF'
PLUGIN_DIR="$(cc-plugin-root itp)"
ACTION="${ARGUMENTS:-status}"
bash "$PLUGIN_DIR/scripts/manage-hooks.sh" $ACTION
HOOKS_SCRIPT_EOF
```

## Post-Action Reminder

After install/uninstall/restore operations:

**IMPORTANT: Restart Claude Code session for changes to take effect.**

The hooks are loaded at session start. Modifications to settings.json require a restart.

## Examples

```bash
# Check current installation status
/itp:tether status

# Install all itp-hooks
/itp:tether install

# Uninstall hooks
/itp:tether uninstall

# List available backups
/itp:tether restore

# Restore most recent backup
/itp:tether restore latest
```

## Troubleshooting

| Issue             | Cause                    | Solution                           |
| ----------------- | ------------------------ | ---------------------------------- |
| jq not found      | jq not installed         | `brew install jq`                  |
| bun not found     | bun/node not installed   | `mise install bun`                 |
| Already installed | Hook already in settings | Run `uninstall` first to reinstall |
| Hooks not working | Session not restarted    | Restart Claude Code session        |
| Script not found  | Plugin not installed     | Re-install plugin via marketplace  |
| Invalid JSON      | Corrupted settings.json  | Use `restore latest` to recover    |

## Post-Execution Reflection

After this skill completes, check before closing:

1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.