diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..296820f
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,24 @@
+# Agent Instructions
+
+This project uses **bd** (beads) for issue tracking.
+
+Run `bd prime` for workflow context, or install hooks (`bd hooks install`) for auto-injection.
+
+## Quick Reference
+
+- `bd ready` - Find unblocked work
+- `bd create "Title" --type task --priority 2` - Create issue
+- `bd update <id> --status in_progress` # Claim work
+- `bd close <id>` - Complete work
+- `bd sync` - Sync with git (run at session end)
+
+## Landing the Plane (Session Completion)
+
+**When ending a work session**, you MUST complete ALL steps below.
+
+**MANDATORY WORKFLOW:**
+
+1. **File issues for remaining work** - Create issues for anything that needs follow-up
+2. **Run quality gates** (if code changed) - Tests, linters, builds
+3. **Update issue status** - Close finished work, update in-progress items
+4. **Hand off** - Provide context for next session
diff --git a/doc/ai/history/beads.md b/doc/ai/history/beads.md
new file mode 100644
index 0000000..dad9923
--- /dev/null
+++ b/doc/ai/history/beads.md
@@ -0,0 +1,24 @@
+```sh
+❯ bd init
+  Repository ID: d5459d4d
+  Clone ID: 73ab432945c43882
+  ✓ Created AGENTS.md with landing-the-plane instructions
+
+✓ bd initialized successfully!
+
+  Database: .beads/beads.db
+  Issue prefix: trictrac
+  Issues will be named: trictrac-<hash> (e.g., trictrac-a3f2dd)
+
+Run bd quickstart to get started.
+
+⚠ Setup incomplete. Some issues were detected:
+  • Git Hooks: Missing 1 recommended hook(s)
+  • Sync Divergence: 1 sync divergence issue(s) detected
+  • Claude Integration: Not configured
+  • Git Working Tree: Uncommitted changes present
+  • Version Tracking: Version tracking not initialized
+  • Sync Branch Config: sync-branch not configured
+
+Run bd doctor --fix to see details and fix these issues.
+```