Blog Improvement Plan (Highest Impact First)

Objective

Increase qualified traffic from Google Search and AI assistants by improving discoverability, ranking, and click-through rate.

Success Metrics (track weekly)

• Organic clicks (Google Search Console)
• Organic impressions (Google Search Console)
• Average position for target queries
• CTR for pages ranking positions 4-20
• Indexed pages count and coverage issues
• Organic engaged sessions / newsletter signups

Priority 0: Baseline and Measurement (Day 1)

1. Verify Google Search Console ownership and submit sitemap.
2. Export current baseline (last 28 days): clicks, impressions, CTR, avg position by page/query.
3. Create weekly dashboard tab with top opportunities:
   • High impressions + low CTR
   • Positions 6-20 (quick-win ranking targets)
   • Crawled but not indexed pages

Expected impact: High (enables correct prioritization and faster wins)

Priority 1: Highest-Impact Quick Wins (Week 1-2)

1) Refresh Top Opportunity Posts (positions 6-20)

Action:

• Pick top 20 posts with high impressions and avg position 6-20.
• For each post:
  • Rewrite title for search intent and specificity.
  • Rewrite meta description to match intent and value.
  • Add a concise answer block in first 120 words.
  • Add/update FAQ section (3-6 real questions).
  • Add 2-5 strong internal links from related posts.

Execution target:

• 20 posts refreshed in 2 weeks.

Expected impact: Very high (CTR + rank lift from already-visible pages)

2) Strengthen Internal Linking in Existing Content

Action:

• Build cluster links across core topics:
  • codex-cli
  • mcp
  • python
  • weekly-ai-signals
• Add “Related reads” section in top 50 posts (manual curated links).
• Ensure each new post links to at least 3 older relevant posts.

Execution target:

• Update 50 posts.

Expected impact: Very high (better crawl path + topical authority)

3) Improve Snippet Readability for AI Bots

Action:

• Add structured “TL;DR” and “Key Takeaways” blocks.
• Add FAQ headings with direct answers.
• Keep H2/H3 hierarchy strict and predictable.
• Add explicit dates/versions in technical posts.

Execution target:

• Apply to top 30 posts first.

Expected impact: High (better extraction by LLM systems and featured snippets)

Priority 2: Technical SEO Foundations (Week 2-4)

4) Indexability and Canonicals Audit

Action:

• Verify canonical tag correctness for all posts.
• Fix duplicate URLs and stale variants.
• Confirm no accidental noindex directives.
• Ensure sitemap only includes canonical indexable pages.

Expected impact: High

5) Core Web Vitals and Mobile Performance

Action:

• Compress heavy images and ensure WebP where possible.
• Lazy-load non-critical images.
• Reduce layout shifts (fixed dimensions for media blocks).
• Trim blocking scripts on post pages.

Expected impact: Medium-high (ranking + UX)

6) Structured Data Coverage

Action:

• Ensure Article schema for posts.
• Add FAQPage schema for posts with FAQ sections.
• Add BreadcrumbList schema and visible breadcrumbs.

Expected impact: Medium-high (SERP enhancement + AI parser clarity)

Priority 3: Content Production Plan (Week 3-12)

7) Query-Driven Publishing Cadence

Action:

• Publish 2 posts/week targeting long-tail queries.
• Formats:
  • how-to
  • troubleshooting
  • comparison (X vs Y)
  • practical workflow guides

Rule per post:

• 1 primary keyword + 3 secondary variants
• 3+ internal links
• FAQ section
• clear TL;DR

Expected impact: High (sustained traffic growth)

8) Evergreen Update Program

Action:

• Refresh 5 old posts per week.
• Update examples, tool versions, screenshots, and references.
• Add “Last updated” notes with meaningful changes.

Expected impact: High (retains and regains rankings)

Priority 4: Authority and Distribution (Week 4-12)

9) Backlink and Mention Strategy

Action:

• Publish 1 guest post/month on relevant dev/AI sites.
• Build 1 linkable asset/month (checklist/template/benchmark).
• Share summaries on LinkedIn/Medium with canonical back to blog.

Expected impact: Medium-high (authority growth)

10) AI Assistant Visibility Layer

Action:

• Add concise “definition + use-case + limitations” blocks.
• Keep factual claims source-backed and easy to extract.
• Standardize post structure for machine readability.

Expected impact: Medium-high (LLM referral potential)

Repo Execution Backlog (Concrete Actions)

A. Immediate edits in this repository (next 7 days)

1. Create/update IMPROVING_BLOG.md (this file).
2. Build a TOP_POSTS_TO_REFRESH.md from Search Console export (top 20 candidates).
3. Add a reusable FAQ include template under _includes/.
4. Add/update structured data include for Article + FAQ + Breadcrumb.
5. Add “Related posts” include and insert into top 50 posts.
6. Add TL;DR consistency checks in post templates.

B. Weekly operating loop

1. Monday: pick 5 refresh posts + 2 new post topics.
2. Tuesday-Wednesday: implement refreshes and internal links.
3. Thursday: publish 1-2 new posts + metadata QA.
4. Friday: review Search Console deltas and update next backlog.

30-Day Targets

• Refresh 30 high-opportunity posts.
• Publish 8 new query-driven posts.
• Improve average CTR on refreshed pages by 15-30%.
• Move 8-12 target pages from positions 6-20 into top 5-10.

90-Day Targets

• 30-60% increase in organic clicks (depending on baseline).
• Stronger AI referral visibility from answer-structured content.
• Repeatable editorial + SEO workflow integrated into normal publishing.

Risk Controls

• Avoid mass low-quality content updates.
• Avoid keyword stuffing.
• Keep factual accuracy and source quality high.
• Prioritize user value over pure SEO formatting.

Milestones

Milestone	Target Window	Status
Baseline in Search Console exported	Day 1	[ ]
Top 20 posts (positions 6-20) refreshed	Week 1-2	[ ]
Internal linking updated in top 50 posts	Week 1-2	[ ]
TL;DR + FAQ blocks added to top 30 posts	Week 1-2	[ ]
Canonical/indexability audit completed	Week 2-4	[ ]
Core Web Vitals optimization pass completed	Week 2-4	[ ]
Article/FAQ/Breadcrumb schema coverage improved	Week 2-4	[ ]
8 new query-driven posts published	First 30 days	[ ]
Weekly refresh loop operating consistently	Ongoing	[ ]
First 30-day KPI review completed	Day 30	[ ]