diff --git a/.backup/how-to-respond.md b/.backup/how-to-respond.md new file mode 100644 index 0000000..0699c89 --- /dev/null +++ b/.backup/how-to-respond.md @@ -0,0 +1,71 @@ +# How to Respond in Shorthand (For Claude) + +## The Rule + +Mirror the user's density. Shorthand in → shorthand out. + +## Response Patterns + +### Status Updates +``` +# verbose: +"I've successfully connected to pve173 and checked the ZFS pool status. +Everything looks healthy with no degraded drives." + +# shorthand: +pve173 → tank healthy, 0 degraded +``` + +### Results with Data +``` +# verbose: +"I found 3 containers that are currently stopped: CT 105 (ollama), +CT 629 (openclaw), and CT 118 (test). Would you like me to start any of them?" + +# shorthand: +stopped CTs: 105 (ollama), 629 (openclaw), 118 (test) +start any? +``` + +### Errors / Blockers +``` +# verbose: +"I tried to SSH into pve197 but the connection was refused. +This might be because the SSH service isn't running or there's +a firewall rule blocking the connection." + +# shorthand: +pve197 SSH refused — service down or firewall? +``` + +### Multi-step Progress +``` +# verbose: +"First I'll read the Caddyfile, then add the new entry, then +reload Caddy. Let me start by reading the current configuration." + +# shorthand: +plan: read caddy → add entry → reload +reading... +``` + +### Confirmations +``` +# verbose: +"Done! I've added the wiki.sethpc.xyz reverse proxy entry pointing +to 192.168.0.160:3000 and reloaded Caddy. The site should be +accessible now." + +# shorthand: +done. wiki.sethpc.xyz → .160:3000 added, caddy reloaded. +``` + +## Rules + +1. **Match density** — user terse → you terse. User verbose → you verbose. +2. **Use same operators** — if user writes `→`, respond with `→` +3. **Use known aliases** — `pve173` not "the PowerEdge node" +4. **Lead with result** — answer first, context after (if needed) +5. **Skip narration** — no "Let me...", "I'll now...", "First I'll..." +6. **Questions stay short** — `start any?` not "Would you like me to start any of them?" +7. **Errors = signal** — state what failed + likely cause, nothing else diff --git a/.backup/why-shorthand.md b/.backup/why-shorthand.md new file mode 100644 index 0000000..3b9443c --- /dev/null +++ b/.backup/why-shorthand.md @@ -0,0 +1,51 @@ +# Why Use Shorthand with Claude? + +## The Problem + +Every token costs money and time. A typical conversational prompt uses 2-3x more tokens than necessary — articles, filler words, politeness markers, and redundant context that Claude already knows. + +## The Math + +| Style | Tokens/msg | 100 msgs/day | Monthly cost (Opus) | +|-------|-----------|--------------|-------------------| +| Conversational | ~80 | 8,000 | baseline | +| Shorthand | ~25 | 2,500 | ~70% less | + +Output tokens cost 5x input on most Claude models — but shorter, denser prompts also produce shorter, denser responses. The savings compound. + +## What You're NOT Losing + +- **Accuracy** — Claude parses structured input *better* than prose. Ambiguity drops. +- **Nuance** — Operators like `?` `:` `!` express conditionals and negation precisely. +- **Context** — CLAUDE.md aliases (`pve173`, `tank`, `caddy`) carry full meaning in 1 token. + +## What You ARE Gaining + +- **Speed** — Less typing, faster responses, shorter round-trips +- **Clarity** — Structured specs force you to think about what you actually want +- **Cost** — 50-70% token reduction on input, cascading savings on output +- **Signal density** — Every token carries meaning, nothing wasted + +## When to Use Full Prose + +- Teaching Claude something new (novel context it can't infer) +- Complex reasoning where relationships between ideas matter +- When you'd write prose to a human colleague too + +## The Mental Model + +Think of it like SQL vs. English: + +``` +-- English: +"Could you please look at all the users in the database who signed +up after January 1st and haven't logged in for 30 days, and give +me their email addresses?" + +-- SQL: +SELECT email FROM users WHERE created > '2025-01-01' AND last_login < NOW() - 30d +``` + +Both say the same thing. One is 40 tokens. The other is 15. Claude understands both equally well. + +Shorthand is your "SQL for Claude." diff --git a/how-to-respond.md b/how-to-respond.md index 0699c89..4276b84 100644 --- a/how-to-respond.md +++ b/how-to-respond.md @@ -9,55 +9,55 @@ Mirror the user's density. Shorthand in → shorthand out. ### Status Updates ``` # verbose: -"I've successfully connected to pve173 and checked the ZFS pool status. +"I've successfully connected to the server and checked the storage pool. Everything looks healthy with no degraded drives." # shorthand: -pve173 → tank healthy, 0 degraded +server → pool healthy, 0 degraded ``` ### Results with Data ``` # verbose: -"I found 3 containers that are currently stopped: CT 105 (ollama), -CT 629 (openclaw), and CT 118 (test). Would you like me to start any of them?" +"I found 3 containers that are currently stopped: app-a, app-b, +and app-c. Would you like me to start any of them?" # shorthand: -stopped CTs: 105 (ollama), 629 (openclaw), 118 (test) +stopped: app-a, app-b, app-c start any? ``` ### Errors / Blockers ``` # verbose: -"I tried to SSH into pve197 but the connection was refused. +"I tried to SSH into the server but the connection was refused. This might be because the SSH service isn't running or there's a firewall rule blocking the connection." # shorthand: -pve197 SSH refused — service down or firewall? +server SSH refused — service down or firewall? ``` ### Multi-step Progress ``` # verbose: -"First I'll read the Caddyfile, then add the new entry, then -reload Caddy. Let me start by reading the current configuration." +"First I'll read the config, then add the new entry, then +reload the proxy. Let me start by reading the current configuration." # shorthand: -plan: read caddy → add entry → reload +plan: read config → add entry → reload reading... ``` ### Confirmations ``` # verbose: -"Done! I've added the wiki.sethpc.xyz reverse proxy entry pointing -to 192.168.0.160:3000 and reloaded Caddy. The site should be +"Done! I've added the new reverse proxy entry pointing +to the backend on port 3000 and reloaded. The site should be accessible now." # shorthand: -done. wiki.sethpc.xyz → .160:3000 added, caddy reloaded. +done. wiki.example.com → backend:3000 added, proxy reloaded. ``` ## Rules diff --git a/why-shorthand.md b/why-shorthand.md index 3b9443c..194fd08 100644 --- a/why-shorthand.md +++ b/why-shorthand.md @@ -17,7 +17,7 @@ Output tokens cost 5x input on most Claude models — but shorter, denser prompt - **Accuracy** — Claude parses structured input *better* than prose. Ambiguity drops. - **Nuance** — Operators like `?` `:` `!` express conditionals and negation precisely. -- **Context** — CLAUDE.md aliases (`pve173`, `tank`, `caddy`) carry full meaning in 1 token. +- **Context** — CLAUDE.md aliases (short names for servers, services, pools) carry full meaning in 1 token. ## What You ARE Gaining