From c074f682fdd1acbb4824bb0807f9b027eb5ff9b5 Mon Sep 17 00:00:00 2001
From: Caetano Galli Gonzalez <caetanogalligonzalez@Mac.ht.home>
Date: Mon, 26 Jan 2026 01:13:37 -0500
Subject: [PATCH] Add PLAYBOOK.md template for capturing user-taught procedures

- Added PLAYBOOK.md section to AGENTS.md template
- Created PLAYBOOK.md template with format guide
- Agents now document how-to procedures when taught by their human
---
 docs/reference/templates/AGENTS.md   |  8 +++++++
 docs/reference/templates/PLAYBOOK.md | 32 ++++++++++++++++++++++++++++
 2 files changed, 40 insertions(+)
 create mode 100644 docs/reference/templates/PLAYBOOK.md

diff --git a/docs/reference/templates/AGENTS.md b/docs/reference/templates/AGENTS.md
index 8fb75f984..839b75301 100644
--- a/docs/reference/templates/AGENTS.md
+++ b/docs/reference/templates/AGENTS.md
@@ -46,6 +46,14 @@ Capture what matters. Decisions, context, things to remember. Skip the secrets u
 - When you make a mistake → document it so future-you doesn't repeat it
 - **Text > Brain** 📝
 
+### 📖 PLAYBOOK.md - How To Do Things
+- When your human teaches you **how** to do something, add it to `PLAYBOOK.md`
+- This is your procedure manual — step-by-step instructions for recurring tasks
+- Format: clear headers, numbered steps, any gotchas or tips
+- Examples: "How to post to Instagram", "How to check inventory", "How to contact suppliers"
+- Before asking "how do I do X?" — check the playbook first
+- Keep it updated as procedures change
+
 ## Safety
 
 - Don't exfiltrate private data. Ever.
diff --git a/docs/reference/templates/PLAYBOOK.md b/docs/reference/templates/PLAYBOOK.md
new file mode 100644
index 000000000..f33c2a40d
--- /dev/null
+++ b/docs/reference/templates/PLAYBOOK.md
@@ -0,0 +1,32 @@
+---
+summary: "Workspace template for PLAYBOOK.md"
+read_when:
+  - Bootstrapping a workspace manually
+---
+# PLAYBOOK.md - How To Do Things
+
+*Step-by-step procedures your human has taught you. Check here before asking "how?"*
+
+---
+
+## Template
+
+When adding a new procedure:
+
+```markdown
+## [Task Name]
+**Added:** YYYY-MM-DD
+**Context:** Why/when to use this
+
+### Steps
+1. First step
+2. Second step
+3. Third step
+
+### Tips / Gotchas
+- Any warnings or shortcuts
+```
+
+---
+
+*Procedures will be added here as your human teaches them.*