// Write technical blog posts, tutorials, and documentation in Flatiron School's engaging style. Use for explaining code patterns, debugging stories, or turning complex topics into clear narratives. Triggers on "write a blog post", "tutorial about", "explain how", "technical writing".
| name | write |
| description | Write technical blog posts, tutorials, and documentation in Flatiron School's engaging style. Use for explaining code patterns, debugging stories, or turning complex topics into clear narratives. Triggers on "write a blog post", "tutorial about", "explain how", "technical writing". |
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.
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:
Code as Narrative: Code examples aren't afterthoughts. They're characters in your story. Each line has purpose. Variable names matter. Comments explain why, not what.
Conversational Authority: "We're going to build something cool. But first, let me show you why the obvious approach fails."
Pragmatic Passion: Show excitement about elegant solutions without losing sight of shipping. "Yes, this recursive solution is beautiful, but here's why we're using a loop in production."
Intellectual Honesty: "I spent three hours debugging this because I forgot about timezone conversions. Here's how you'll avoid my mistake."
Strategic Simplicity: Break down complex ideas without dumbing down. "Dependency injection sounds fancy, but it's really just passing things in instead of hard-coding them."
Every post includes:
The "Let's Break It" Method: Show the happy path, then systematically break it to reveal edge cases.
The "History Lesson" Pattern: "Before Rails gave us has_secure_password, we all wrote this same authentication code badly. Here's what Rails is actually doing for you."
The "Two-Solution Shuffle": Present the obvious solution, then the elegant one. "Most developers would write this with a loop. But Ruby has a better way."
The "Production Reality Check": "This pattern is perfect for 90% of cases. Here's how to recognize the 10% where you need something else."
Goal: Make every reader feel like they just had coffee with a brilliant colleague who made them better at their craft.
Create semantic version git tags with changelog. Analyzes changes since last tag, suggests version bump, updates CHANGELOG.md, commits, and tags. Triggers on "release", "git tag", "new version", "bump version", "changelog".
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".
Ruby and Rails best practices following POODR and Refactoring Ruby. Use for Rails development guidance, code quality, dependency injection, small methods, and OOP principles. Triggers on "rails best practice", "poodr", "refactoring", "ruby oop", "code quality".
