User Input
$ARGUMENTS
User should provide:
- •Topic: The main concept or theme
- •Resources: URLs, files, or references (optional)
- •Audience/Tone: Who it's for and style preference (optional)
For existing posts: If updating an existing draft, skip to the Iteration section.
Workflow
1. Setup & Research
- •Create project folder:
blog-posts/YYYY-MM-DD-topic-slug/ - •For each resource, fetch/read and save summaries to
resources/source-N-name.md - •Present research summary to user
2. Brainstorm & Clarify
Present findings and ask:
- •Main takeaway for readers?
- •Target length? (short: 500-800, medium: 1000-1500, long: 2000+)
- •Points to emphasize or exclude?
Wait for user response.
3. Title & Outline
Generate SEO-Optimized Title
Follow references/seo-title-guide.md to create click-worthy titles:
- •Identify primary keyword from topic
- •Generate 5 title options using these patterns:
- •Keyword + Benefit: "SEO Title Tags: Master Optimization in 5 Steps"
- •Number + Keyword + Outcome: "7 Proven Tips to Boost Your Blog Traffic"
- •How to + Keyword + Outcome: "How to Write Headlines That Get Clicks"
- •Keyword + Audience + Year: "React Hooks for Beginners (2026 Guide)"
- •Validate: 45-65 characters, keyword near start, specific benefit included
- •Present options to user for selection
Create Outline
Include:
- •Selected title and 2-3 alternates for A/B testing
- •Meta info (audience, tone, length, main takeaway, primary keyword)
- •Section structure with key points and supporting evidence
- •Sources to cite
Get user approval, then save as OUTLINE.md and commit.
4. Draft
Write the full post following the outline. Use assets/draft-template.md for structure.
Citation requirement: Every statistic, comparison, or factual claim must cite its source using inline references [1] linked to a References section.
Save as draft-v0.1.md and commit.
5. SEO Content Optimization
Before review, optimize content for search engines. See references/seo-content-guide.md for details.
Checklist
- • Primary keyword in first 100 words
- • Keyword density 1-2% (natural usage, no stuffing)
- • H2/H3 headings include keyword variations
- • Meta description written (150-160 chars, includes keyword + CTA)
- • URL slug is short, keyword-rich, hyphenated
- • Internal links to related content (2-3 minimum)
- • External links to authoritative sources
- • Image alt text descriptive with keywords where natural
- • Readability short paragraphs (2-4 sentences), bullet points, scannable
- • Featured snippet optimization direct answers, lists, or tables for key questions
Save SEO-optimized version and commit.
6. Review & Iterate
Present draft and ask for feedback on:
- •Overall impression
- •Sections needing changes
- •Tone adjustments
- •Missing information
If changes requested: Increment version (v0.2, v0.3...), incorporate feedback, repeat review.
If approved: Optionally rename to final.md and summarize the creation process.
Output Structure
blog-posts/YYYY-MM-DD-topic-name/ ├── resources/ │ ├── source-1-name.md │ └── source-2-name.md ├── OUTLINE.md ├── draft-v0.1.md └── draft-v0.2.md (if iterated)
Resources
- •
references/seo-title-guide.md- SEO title optimization patterns and checklist - •
references/seo-content-guide.md- SEO content optimization (keywords, meta, links, readability) - •
assets/draft-template.md- Blog post structure template - •
assets/outline-template.md- Outline structure template