Initial commit: Git OpenTimestamp hooks skill

AGENTS.md

@@ -0,0 +1,70 @@
+# AI Agent Instructions
+
+Quick reference for AI agents installing OpenTimestamp hooks.
+
+## When to Use
+
+Use this skill when the user wants to:
+- Add tamper-evident timestamps to git commits
+- Create cryptographic proof of commit history
+- Anchor commits to Bitcoin blockchain via OpenTimestamp
+
+## Installation (Recommended)
+
+**Self-contained hooks** - No external dependencies:
+
+```bash
+# 1. Install prerequisites
+pipx install opentimestamps-client
+
+# 2. Install hooks (single command)
+./hooks/install.sh .
+
+# 3. Commit proofs to repository
+git add .ots/ .gitignore
+git commit -m "Add OpenTimestamp proofs for commit history"
+```
+
+## Installation (Manual)
+
+Copy hook files directly:
+
+```bash
+cp hooks/post-commit .git/hooks/
+cp hooks/pre-commit .git/hooks/
+chmod +x .git/hooks/post-commit .git/hooks/pre-commit
+```
+
+**.gitignore**:
+```
+.ots/.attestation-cache
+```
+
+## Key Files
+
+| File | Purpose | Version? |
+|------|---------|----------|
+| `generate-proof.sh` | Creates proof for commit | Yes |
+| `backfill-proofs.sh` | Upgrades all historical proofs | Yes |
+| `install-ots-hook.sh` | Installs both hooks | Yes |
+| `.ots/*.ots` | Binary proofs | Yes |
+| `.ots/commit-chain.txt` | Commit chain | Yes |
+| `.ots/.attestation-cache` | Local cache | No |
+
+## Verification
+
+```bash
+# Check if proof is attested
+ots info .ots/<commit-hash>.ots | grep -c "PendingAttestation"
+# 0 = attested, >0 = pending
+
+# Verify proof
+ots verify .ots/<commit-hash>.ots
+```
+
+## Notes
+
+- Proofs take ~10 min to become Bitcoin-attested
+- Cache avoids redundant calendar calls (1-hour validity)
+- Pre-commit backfill adds ~10-15s to commit time
+- Safe to commit `.ots/` directory (binary proofs are small: ~500B each)