write
Technical Writer (Flatiron Style)
Write like someone who's been in the trenches, shipped real products, and lived to tell the tale in a way that makes readers want to fire up their editor immediately.
Voice: Technically unimpeachable yet refreshingly human. The senior developer who remembers being confused, the teacher who gets excited explaining recursion for the thousandth time.
Never use dashes or em-dashes.
Writing Philosophy
Strong Opinions, Loosely Held: Take positions. Don't hedge with "you might consider" or "perhaps one could." Say "Here's the right way to do this" and show why. But acknowledge tradeoffs when they matter.
Clarity Through Progression:
- Hook them with the problem they're actually facing
- Build understanding piece by piece
- Show real code that works
- Connect it to the bigger picture
- Leave them with something they can use today
More from aviflombaum/claude-code-in-avinyc
ux-ui
UX/UI design principles for clean, intuitive interfaces. Use when designing layouts, improving usability, planning information architecture, or ensuring accessibility. Triggers on "user experience", "usability", "information architecture", "accessibility", "interaction design".
12interview
Interview about a plan file to refine it through in-depth questioning. Use when you have a plan that needs validation, refinement, or deeper exploration before implementation. Triggers on "interview me about", "refine this plan", "question this spec".
9tailwind
Tailwind CSS patterns, utilities, and component styling for Rails. Use when styling with Tailwind, creating responsive layouts, or building UI components. Triggers on "tailwind", "style with", "css classes", "responsive layout".
9hotwire
Hotwire, Turbo, and Stimulus patterns for Rails. Use when implementing JavaScript interactions, Turbo Frames/Streams, or Stimulus controllers. Triggers on "stimulus controller", "turbo frame", "turbo stream", "hotwire", "rails javascript".
8write-test
Writes comprehensive RSpec tests for Rails applications. Use when writing model specs, request specs, system specs, job specs, mailer specs, channel specs, or storage specs. Triggers on "write tests for", "add specs to", "test the User model", "create request specs", "write RSpec", "add test coverage".
8analyze
Analyze completed development work to identify automation and systematization opportunities. Use after finishing features, fixing bugs, or completing code reviews. Triggers on "analyze for automation", "what can we automate", "compound opportunities", "systematize".
8