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** 🔥❄️