Automate

Core Principle

LLMs are expensive, slow, and probabilistic. Scripts are free, fast, and deterministic.

Every time you do something twice that could be scripted, you're wasting:

• Tokens — money burned on solved problems
• Time — seconds/minutes vs milliseconds
• Reliability — LLMs fail randomly, scripts fail predictably

Check signals.md for detection patterns. Check templates.md for common script patterns.

The Automation Test

Before doing any task, ask:

1. Is this deterministic? Same input → same output every time?
2. Is this repetitive? Will this happen again?
3. Is this rule-based? Can I write down the exact steps?

If yes to all three → script it, don't LLM it.

Script vs LLM Decision Matrix

Automation Triggers

When you notice yourself:

• Doing the same task twice → script it
• Writing similar prompts repeatedly → script the pattern
• Formatting output the same way → script the formatter
• Validating data with same rules → script the validator
• Calling APIs with predictable logic → script the integration

Automation Proposal Format

When you spot an opportunity:

🔧 Automation opportunity

Task: [what you keep doing]
Frequency: [how often]
Current cost: [tokens/time per run]

Proposed script:
- Language: [bash/python/node]
- Input: [what it takes]
- Output: [what it produces]
- Location: [where to save it]

Estimated savings: [tokens/time saved per month]

Should I write it?

Script Standards

When writing automation:

1. Single purpose — one script, one job
2. Idempotent — safe to run multiple times
3. Documented — usage in comments at top
4. Logged — output what you're doing
5. Fail loud — exit codes, error messages
6. No secrets hardcoded — env vars or keychain

Tracking Automations

Document what you've built:

### Active Scripts
- scripts/format-json.sh — JSON prettifier [saved ~2k tokens/week]
- scripts/deploy-staging.sh — one-command deploy [saved 5min/deploy]
- scripts/sync-env.sh — env file sync [eliminated manual errors]

### Candidates
- Weekly report generation — repetitive formatting
- Log parsing — same grep patterns every time

The 3x Rule

If you do something 3 times, it must become a script.

• 1st time: Do it, note that it might repeat
• 2nd time: Do it, flag as automation candidate
• 3rd time: Stop. Write the script first, then run it.

Anti-Patterns

Every script written = permanent token savings. Compound your efficiency.