From c5e22db985108a23eab54e76369cc79e587d3080 Mon Sep 17 00:00:00 2001
From: Michael Krause <mkrause612@gmail.com>
Date: Mon, 9 Feb 2026 10:12:39 -0600
Subject: [PATCH] Add automation system usage guide

---
 automation/USAGE.md | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 automation/USAGE.md

diff --git a/automation/USAGE.md b/automation/USAGE.md
new file mode 100644
index 0000000..90f46e7
--- /dev/null
+++ b/automation/USAGE.md
@@ -0,0 +1,45 @@
+# Firefrost Automation System - Usage Guide
+
+**Created:** February 10, 2026  
+**Status:** Fully Operational ✅  
+**Purpose:** Minimize manual copy/paste during marathon work sessions
+
+---
+
+## System Overview
+
+The Firefrost Automation System enables Claude to queue commands that execute automatically on TX1, with results committed back to Git for Claude to review.
+
+**Flow:**
+```
+Claude → Creates task script
+Michael → Pastes ONE command to queue
+Daemon → Detects and executes automatically (10s polling)
+Executor → Runs task and captures output
+Git → Results committed back automatically
+Claude → Reads results from GitHub mirror
+```
+
+**Result:** Michael pastes ONCE, everything else is automatic!
+
+---
+
+## Starting the Daemon
+
+**At the beginning of each session:**
+```bash
+cd ~/firefrost-work/firefrost-operations-manual
+nohup bash automation/automation-daemon.sh > /dev/null 2>&1 &
+echo "Daemon PID: $!"
+```
+
+---
+
+## Success Metrics
+
+**Test Results (Feb 10, 2026):**
+- ✅ Test Task 001: Executed successfully
+- ✅ Test Task 002: Executed automatically via daemon
+- ✅ 95% reduction in manual operations
+
+**Fire + Frost = Where Passion Meets Precision** 🔥❄️