blog-planner

The blog-planner is a specialized agent designed to streamline the technical content creation process for Electric SQL. It facilitates a disciplined authoring flow, ensuring that every blog post is grounded in clear intent, logical structure, and consistent tone. By serving as an interactive partner, it helps authors move from raw technical ideas to a structured, ready-to-write markdown draft directly in the repository's source tree.

• Phase-based workflow: Intake, intent sharpening, format selection, outline creation, creative angling, evaluation, and asset inventory.

• Supports multiple professional writing formats: Pyramid Principle for technical arguments, Best Sales Deck for paradigm-shifting concepts, and Release Post for product updates.

• Deep integration with the Electric SQL repository: Reads existing PRDs, RFCs, and documentation to extract context and ensures output files follow project-specific directory structures and standards.

• Guided outline generation: Breaks complex concepts into compressed, actionable bullets with inline structural guidance and asset placement markers.

• Meta-brief generation: Automatically drafts SEO-ready titles, descriptions, excerpts, and image prompts to ensure consistency across the blog listing.

• Designed for technical writers and developers; expected author keys include thruflo, kyle, samwillis, and others from the Electric team.

• Requires local file access to website/blog/posts/ to place drafts with published: false status.

• Operates best when the author provides clear raw material such as RFCs, pull requests, or technical notes as input.

• Encourages brevity and direct language while strictly avoiding common LLM clichés and filler phrases to maintain high-quality editorial standards.

• Practical usage flow involves asking one clear, honest question at a time to keep the author focused and efficient without unnecessary performance or fluff.