theme-creation

Spinner Verb Theme Creation

Guide for creating effective, entertaining spinner verb themes with optional humor modifiers.

Spinner Verb Basics

Spinner verbs are status messages displayed while Claude Code works. They appear randomly from a flat array of strings. Good spinner verbs are:

• Short to medium length (1-8 words ideal)
• Action-oriented or situational
• Thematically consistent
• Entertaining without being distracting

Theme Creation Process

1. Identify Theme Elements

For any theme, identify:

• Iconic catchphrases - Well-known quotes
• Character-specific lines - Memorable character dialogue
• Action verbs - What characters do in that universe
• Situational phrases - Common scenarios
• Technical jargon - Universe-specific terminology

2. Generate Base Phrases (20-30)

Create a mix of:

• Direct quotes (most recognizable)
• Paraphrased actions ("Engaging warp drive")
• Situational states ("Red alert!")
• Character voice lines ("I have spoken")

3. Apply Modifiers

See references/claude-code-terms.md for --parody mode vocabulary. See references/cynic-patterns.md for --cynic mode patterns.

--parody Mode: Claude Code Parody

Transform phrases by incorporating AI/LLM/Claude Code references:

Original	With --parody
"Beam me up"	"Beam me up, the context window is full"
"Engage!"	"Spawning sub-agent. Engage!"
"He's dead, Jim"	"The sub-agent is dead, Jim"
"I have spoken"	"I have spoken... to the MCP server"
"Winter is coming"	"Winter is coming... along with more tokens"

Key substitutions:

• Ship/vessel → context window, token buffer
• Crew/team → sub-agents, tools
• Communications → MCP servers, API calls
• Weapons → tool calls, parallel execution
• Shields → rate limits, guardrails
• Engineering → prompt engineering, refactoring

--cynic Mode: Pessimistic Twist

Transform phrases by adding world-weary, Murphy's Law humor:

Original	With --cynic
"Engage!"	"Engaging... reluctantly"
"This is the way"	"This is the way... unfortunately"
"I shall return"	"I shall return... to fix this again"
"Winter is coming"	"Winter is coming... along with more bugs"
"Measuring GFA"	"Measuring GFA for the third time (sigh)"

Cynic patterns:

• Add "(sigh)" suffix
• Add "...again" or "...unfortunately"
• Reference things taking longer than expected
• Self-deprecating about the task
• Murphy's Law observations
• Resigned acceptance

Combined Mode (--parody --cynic)

When both modifiers are used:

Merge mode: Include phrases from both styles separately (40-50 total)

Combine mode: Each phrase has BOTH tech parody AND cynicism:

• "The sub-agent is dead, Jim... again"
• "Resistance is futile. So is debugging."
• "Spawning sub-agent... it'll probably timeout"
• "Context window at 20%... as usual"

Quality Checklist

Before finalizing a theme:

• 20-30 phrases minimum
• Mix of quotes, actions, and situations
• Recognizable to fans of the theme
• Humor is clever, not forced
• No offensive or inappropriate content
• Varied length (some short, some medium)
• Grammatically correct