Skip to content

Free, open source blog writer for Claude Code. Researches current sources, writes answer-first posts for Google and AI answers, has an independent reviewer score each one out of 100 and ships only after five delivery gates. 32 skills, 30 /blog commands, 5 agents. Active development at AI-Marketing-Hub/claude-blog; public releases ship here.

4.6 KB
Raw Blame

Claude Blog Brain

Claude Blog Brain editorial frontispiece

Claude Blog Brain is an evidence-gated Obsidian brain for blog content creation, optimization, and management dual-optimized for Google rankings (E-E-A-T, the 2026 core updates) and AI citations (GEO/AEO), spanning writing, rewriting and freshness, SERP-informed briefs and outlines, editorial calendars and strategy, semantic topic clusters, schema and internal linking, multilingual publishing, the FLOW framework, factchecking, personas, distribution, and the blog delivery contract, grounded in the claude-blog skill.

Current maturity: market-ready. The executable local audit on 2026-10-07 scores 98/100 with no critical failures or warnings after source review, adapter tests, vault lint, pipeline checks and disposable packaging checks. This is the Brain's internal readiness gate, not a ranking, API-operation or publication guarantee. The ledger contains 127 active reviewed records and three retired records excluded from current advice. Its historical global verification date remains unchanged; per-source review dates govern freshness. The separate adapter regression run passes 23 tests on Python 3.11. Rerun the executable gate when sources expire or maintained files change.

It ships two artifacts:

  • assets/template-brain/ - the distributable Obsidian vault.
  • SKILL.md plus scripts/ - the agent-facing operating layer.

Buyer

Content teams, bloggers, SEO content strategists, and operators who run the claude-blog skill and need a persistent, source-cited operating system for writing, optimizing, and auditing blog content that ranks on Google and gets cited by AI assistants.

Outputs

  • Blog quality score (5-category 100-point) synthesis playbook
  • SERP-informed content brief and outline
  • Semantic topic-cluster map with internal-link matrix
  • GEO and AI-citation readiness register
  • Schema stack and internal-linking reference library
  • Editorial calendar and content-strategy plan
  • Blog delivery-contract gate report
  • Approval queue for recommendations
  • Google algorithm-update memory and refresh log

Quick Start

python -m pip install -e .
claude-blog-brain demo
claude-blog-brain lint --vault examples/sample-vault
claude-blog-brain report --vault examples/sample-vault --html-only

To create a client vault:

claude-blog-brain new acme --client-name "Acme Co" --owner "Daniel Agrici" --out-dir ~/claude-blog-brain-vaults
claude-blog-brain ingest --vault ~/claude-blog-brain-vaults/acme --file tests/fixtures/sample-source.md
claude-blog-brain synthesize --vault ~/claude-blog-brain-vaults/acme
claude-blog-brain visuals --vault ~/claude-blog-brain-vaults/acme
claude-blog-brain report --vault ~/claude-blog-brain-vaults/acme --html-only
claude-blog-brain next --vault ~/claude-blog-brain-vaults/acme

Boundaries

V1 is advisory and read-only. It does not mutate accounts, systems, books, pipelines, publishing tools, customer records, or live production data.

Domain claims are release-blocked until references/current-requirements.md, references/market-research.md, references/source-map.md, and references/source-ledger.json contain dated source material from trustworthy sources.

Maturity Gates

  1. Scaffolded: product shell, vault, source pack, scripts, tests, and demo exist.
  2. Researched: dated trustworthy sources replace placeholder research.
  3. Domain-adapted: real domain importer, synthesis, reports, fixtures, and tests exist.
  4. Demo-verified: sample vault regenerates deterministically and reports cite sources.
  5. Market-ready: audit score is at least 90 with no critical failures.

Scores are capped by maturity. A scaffold cannot become market-ready by edited markdown alone.

Research Policy

Use official, primary, or vendor documentation first. Use market or practitioner sources only as supporting evidence. Do not treat blog roundups or AI summaries as primary truth. Record evidence in references/source-ledger.json; prose-only research notes do not satisfy the gate.

Release

python scripts/package_release.py --version 0.2.0
python scripts/package_release.py --version 0.2.0 --release-type market-ready

Release packaging scans for secrets, local paths, symlinks, untracked drift, and unsafe ZIP entries before writing dist/RELEASE_MANIFEST.json and dist/SHA256SUMS. Market-ready packaging also runs scripts/audit_brain.py.

Community

Use public project Discussions for questions and support: https://github.com/AgriciDaniel/claude-blog/discussions. Report reproducible defects through public Issues: https://github.com/AgriciDaniel/claude-blog/issues.