Writing blog posts
Quick start
Collect or infer:
- •Post type (thought leadership, tutorial, announcement, listicle, opinion)
- •Target audience
- •Primary keyword or topic
- •Key takeaway or goal
- •Desired length (short: 500-800, standard: 1000-1500, long: 2000+)
- •Internal linking opportunities
Then produce output using TEMPLATES.md. Validate with RUBRIC.md.
Workflow
- •Identify post type and match structure from reference/blog-structure.md.
- •Research keyword and competitive posts for angle.
- •Write headline using proven patterns (and 2-3 variants).
- •Draft introduction with hook, context, and promise.
- •Structure body with scannable headers.
- •Write conclusion with key takeaway and CTA.
- •Add internal and external links per reference/linking-policy.md.
- •Run readability check with scripts/readability_score.py.
- •Run the rubric check. Revise until it passes.
Degrees of freedom
- •Low: Must have scannable structure, clear takeaway, and CTA.
- •Medium: Tone, headline style, section ordering, example depth.
- •Allowed variation: Voice, opening style, listicle vs. narrative—as long as rubric passes.
References
- •Templates: TEMPLATES.md
- •Rubric: RUBRIC.md
- •Examples: EXAMPLES.md
- •Blog structure: reference/blog-structure.md
- •Linking policy: reference/linking-policy.md
- •Readability check: scripts/readability_score.py