Skip to content

AgriciDaniel/claude-blog / brain

claude-blog-brain

Unverified

Scaffold and operate Claude Blog Brain, a source-cited 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. Use when the user says "claude-blog-brain", "Claude Blog Brain", "create a 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 brain", "import sources", "synthesize plan", "render report", or wants a persistent vault-backed operating system 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.

FileKindSize
.github/CODEOWNERSother16 B
.github/ISSUE_TEMPLATE/bug_report.ymlconfig568 B
.github/ISSUE_TEMPLATE/config.ymlconfig28 B
.github/PULL_REQUEST_TEMPLATE.mdmarkdown380 B
.github/dependabot.ymlconfig118 B
.github/workflows/ci.ymlconfig913 B
.gitignoreother151 B
.obsidian/graph.jsonconfig2.0 KB
.raw/.manifest.jsonconfig1.2 KB
.raw/sources/claude-blog-brain-data/google-updates.jsonconfig13.1 KB
AGENTS.mdmarkdown1.4 KB
CHANGELOG.mdmarkdown1.1 KB
CLAUDE.mdmarkdown234 B
CODEX.mdmarkdown548 B
CONTRIBUTING.mdmarkdown553 B
GEMINI.mdmarkdown215 B
LICENSEother1.0 KB
PUBLISHING_NOTICE.mdmarkdown1.7 KB
README.mdmarkdown4.6 KB
RELEASE_CHECKLIST.mdmarkdown2.0 KB
SECURITY.mdmarkdown259 B
SKILL.mdskill md4.5 KB
SUPPORT.mdmarkdown169 B
THIRD_PARTY_NOTICES.mdmarkdown787 B
_attachments/brain-relationship-map.svgother14.2 KB
agents/blog-cluster-curator.mdmarkdown2.0 KB
agents/blog-data-curator.mdmarkdown2.0 KB
agents/blog-distribution-curator.mdmarkdown2.0 KB
agents/blog-eeat-curator.mdmarkdown1.9 KB
agents/blog-flow-curator.mdmarkdown1.8 KB
agents/blog-geo-curator.mdmarkdown2.0 KB
agents/blog-monitoring-curator.mdmarkdown1.9 KB
agents/blog-multilingual-curator.mdmarkdown1.9 KB
agents/blog-persona-curator.mdmarkdown1.9 KB
agents/blog-quality-curator.mdmarkdown2.1 KB
agents/blog-schema-curator.mdmarkdown1.9 KB
agents/blog-strategy-curator.mdmarkdown1.9 KB
agents/blog-writing-curator.mdmarkdown2.0 KB
agents/claude-blog-secretary.mdmarkdown5.2 KB
agents/workflow-coverage.mdmarkdown2.3 KB
assets/svg/hero-frontispiece.svgother1.8 KB
assets/template-brain/.obsidian/app.jsonconfig32 B
assets/template-brain/.obsidian/appearance.jsonconfig64 B
assets/template-brain/.obsidian/core-plugins.jsonconfig64 B
assets/template-brain/.obsidian/graph.jsonconfig1.3 KB
assets/template-brain/.obsidian/snippets/brain.cssother148 B
assets/template-brain/.raw/.manifest.jsonconfig147 B
assets/template-brain/CODEX.mdmarkdown548 B
assets/template-brain/README.mdmarkdown107 B
assets/template-brain/_attachments/brain-relationship-map.svgother1.2 KB
assets/template-brain/_templates/decision.mdmarkdown227 B
assets/template-brain/_templates/source-note.mdmarkdown307 B
assets/template-brain/_templates/standard-note.mdmarkdown267 B
assets/template-brain/shipping-rules.mdmarkdown701 B
assets/template-brain/wiki/accounts/_index.mdmarkdown332 B
assets/template-brain/wiki/canvases/Onboarding Canvas.canvasother975 B
assets/template-brain/wiki/canvases/_index.mdmarkdown322 B
assets/template-brain/wiki/canvases/main.canvasother975 B
assets/template-brain/wiki/concepts/Best Practices Kernel.mdmarkdown4.3 KB
assets/template-brain/wiki/concepts/_index.mdmarkdown332 B
assets/template-brain/wiki/decisions/Approval Queue.mdmarkdown3.8 KB
assets/template-brain/wiki/decisions/_index.mdmarkdown335 B
assets/template-brain/wiki/deliverables/Action Roadmap.mdmarkdown3.8 KB
assets/template-brain/wiki/deliverables/Health Scorecard.mdmarkdown4.2 KB
assets/template-brain/wiki/deliverables/_index.mdmarkdown344 B
assets/template-brain/wiki/entities/_index.mdmarkdown332 B
assets/template-brain/wiki/experiments/_index.mdmarkdown341 B
assets/template-brain/wiki/flows/Reporting Workflow.mdmarkdown3.4 KB
assets/template-brain/wiki/flows/Research Refresh Workflow.mdmarkdown3.9 KB
assets/template-brain/wiki/flows/Source Intake Workflow.mdmarkdown3.5 KB
assets/template-brain/wiki/flows/Synthesis Workflow.mdmarkdown3.8 KB
assets/template-brain/wiki/flows/_index.mdmarkdown323 B
assets/template-brain/wiki/gaps/_index.mdmarkdown320 B
assets/template-brain/wiki/hot.mdmarkdown843 B
assets/template-brain/wiki/index.mdmarkdown1.1 KB
assets/template-brain/wiki/log.mdmarkdown242 B
assets/template-brain/wiki/meta/Start Here.mdmarkdown2.9 KB
assets/template-brain/wiki/meta/dashboard.mdmarkdown3.2 KB
assets/template-brain/wiki/overview.mdmarkdown1.0 KB
assets/template-brain/wiki/platforms/_index.mdmarkdown335 B
assets/template-brain/wiki/questions/_index.mdmarkdown335 B
assets/template-brain/wiki/reports/Weekly Report.mdmarkdown3.3 KB
assets/template-brain/wiki/reports/_index.mdmarkdown329 B
assets/template-brain/wiki/sources/Source Manifest Guide.mdmarkdown3.5 KB
assets/template-brain/wiki/sources/_index.mdmarkdown326 B
claude_blog_brain/__init__.pyscript66 B
claude_blog_brain/__main__.pyscript116 B
claude_blog_brain/cli.pyscript11.1 KB
data/google-updates.jsonconfig28.3 KB
docs/OPERATOR_KIT.mdmarkdown2.2 KB
docs/PRODUCT_BOUNDARIES.mdmarkdown2.5 KB
examples/sample-vault/.demo-vaultother64 B
examples/sample-vault/.obsidian/app.jsonconfig32 B
examples/sample-vault/.obsidian/appearance.jsonconfig64 B
examples/sample-vault/.obsidian/core-plugins.jsonconfig64 B
examples/sample-vault/.obsidian/graph.jsonconfig1.3 KB
examples/sample-vault/.obsidian/snippets/brain.cssother148 B
examples/sample-vault/.raw/.manifest.jsonconfig403 B
examples/sample-vault/.raw/sources/sample-source.mdmarkdown681 B
examples/sample-vault/CODEX.mdmarkdown548 B
examples/sample-vault/README.mdmarkdown107 B
examples/sample-vault/_attachments/brain-relationship-map.svgother1.4 KB
examples/sample-vault/_templates/decision.mdmarkdown231 B
examples/sample-vault/_templates/source-note.mdmarkdown311 B
examples/sample-vault/_templates/standard-note.mdmarkdown273 B
examples/sample-vault/shipping-rules.mdmarkdown701 B
examples/sample-vault/weekly-report.htmlother651 B
examples/sample-vault/wiki/accounts/_index.mdmarkdown336 B
examples/sample-vault/wiki/canvases/Onboarding Canvas.canvasother975 B
examples/sample-vault/wiki/canvases/_index.mdmarkdown326 B
examples/sample-vault/wiki/canvases/main.canvasother975 B
examples/sample-vault/wiki/concepts/Best Practices Kernel.mdmarkdown4.3 KB
examples/sample-vault/wiki/concepts/_index.mdmarkdown336 B
examples/sample-vault/wiki/decisions/Approval Queue.mdmarkdown3.8 KB
examples/sample-vault/wiki/decisions/_index.mdmarkdown339 B
examples/sample-vault/wiki/deliverables/Action Roadmap.mdmarkdown505 B
examples/sample-vault/wiki/deliverables/Health Scorecard.mdmarkdown552 B
examples/sample-vault/wiki/deliverables/_index.mdmarkdown348 B
examples/sample-vault/wiki/entities/_index.mdmarkdown336 B
examples/sample-vault/wiki/experiments/_index.mdmarkdown345 B
examples/sample-vault/wiki/flows/Reporting Workflow.mdmarkdown3.4 KB
examples/sample-vault/wiki/flows/Research Refresh Workflow.mdmarkdown3.9 KB
examples/sample-vault/wiki/flows/Source Intake Workflow.mdmarkdown3.5 KB
examples/sample-vault/wiki/flows/Synthesis Workflow.mdmarkdown3.8 KB
examples/sample-vault/wiki/flows/_index.mdmarkdown327 B
examples/sample-vault/wiki/gaps/_index.mdmarkdown324 B
examples/sample-vault/wiki/hot.mdmarkdown847 B
examples/sample-vault/wiki/index.mdmarkdown1.1 KB
examples/sample-vault/wiki/log.mdmarkdown397 B
examples/sample-vault/wiki/meta/Start Here.mdmarkdown2.9 KB
examples/sample-vault/wiki/meta/dashboard.mdmarkdown3.2 KB
examples/sample-vault/wiki/overview.mdmarkdown1.0 KB
examples/sample-vault/wiki/platforms/_index.mdmarkdown339 B
examples/sample-vault/wiki/questions/_index.mdmarkdown339 B
examples/sample-vault/wiki/reports/Weekly Report.mdmarkdown407 B
examples/sample-vault/wiki/reports/_index.mdmarkdown333 B
examples/sample-vault/wiki/sources/Source Manifest Guide.mdmarkdown3.5 KB
examples/sample-vault/wiki/sources/_index.mdmarkdown330 B
examples/sample-vault/wiki/sources/sample-source.mdmarkdown525 B
install.shexecutablescript11.0 KB
pyproject.tomlmanifest576 B
references/CONFIDENCE_TAGS.mdmarkdown3.6 KB
references/README.mdmarkdown2.4 KB
references/adapter-manifest.jsonconfig8.8 KB
references/adapter-plan.mdmarkdown8.8 KB
references/canon/001-google-search-essentials.mdmarkdown1.2 KB
references/canon/002-search-quality-rater-guidelines.mdmarkdown1.6 KB
references/canon/003-structured-data-general-guidelines.mdmarkdown1.2 KB
references/canon/004-spam-policies.mdmarkdown1.7 KB
references/canon/005-generative-ai-optimization-guide.mdmarkdown1.9 KB
references/canon/006-helpful-people-first-content.mdmarkdown1.2 KB
references/canon/007-core-web-vitals-inp.mdmarkdown2.1 KB
references/canon/008-faqpage-deprecation.mdmarkdown1.3 KB
references/canon/009-ai-features-your-website.mdmarkdown1.2 KB
references/canon/010-search-console-gen-ai-reports.mdmarkdown1.7 KB
references/canon/_index.mdmarkdown1.7 KB
references/claim-ledger.mdmarkdown17.9 KB
references/current-requirements.mdmarkdown9.5 KB
references/evidence/2026-10-07/0169f1b73873cf60.jsonconfig772 B
references/evidence/2026-10-07/03ad78c585b6f686.jsonconfig842 B
references/evidence/2026-10-07/05194f5ed0fbc60a.jsonconfig830 B
references/evidence/2026-10-07/05f9f9c1f57bb707.jsonconfig847 B
references/evidence/2026-10-07/0a1c82c044ac2ebf.jsonconfig1.1 KB
references/evidence/2026-10-07/0b32a62e7c50179d.jsonconfig772 B
references/evidence/2026-10-07/129d3d7b2f61df33.jsonconfig890 B
references/evidence/2026-10-07/15ba1fc4806624c8.jsonconfig700 B
references/evidence/2026-10-07/19102844a33e549f.jsonconfig1.1 KB
references/evidence/2026-10-07/1af541f4198686a9.jsonconfig741 B
references/evidence/2026-10-07/1d7aea0ca982d48b.jsonconfig712 B
references/evidence/2026-10-07/1f2734e7294c86f2.jsonconfig756 B
references/evidence/2026-10-07/201b49408fe7f7df.jsonconfig700 B
references/evidence/2026-10-07/24cc194c3e55dfd1.jsonconfig834 B
references/evidence/2026-10-07/285eeba2c7994b79.jsonconfig803 B
references/evidence/2026-10-07/287c6057c69214e1.jsonconfig885 B
references/evidence/2026-10-07/2ace5f5decf2a9f4.jsonconfig738 B
references/evidence/2026-10-07/323be3a933630ce1.jsonconfig990 B
references/evidence/2026-10-07/3311e1f7f7a32d57.jsonconfig792 B
references/evidence/2026-10-07/369b78e6451c4886.jsonconfig767 B
references/evidence/2026-10-07/399215737cb51624.jsonconfig849 B
references/evidence/2026-10-07/3a700e9016e022e3.jsonconfig861 B
references/evidence/2026-10-07/455005f14f8c6bbe.jsonconfig800 B
references/evidence/2026-10-07/47aa306229a89962.jsonconfig808 B
references/evidence/2026-10-07/48ee6aae68a01173.jsonconfig752 B
references/evidence/2026-10-07/4b8cec3b172f0784.jsonconfig720 B
references/evidence/2026-10-07/4dea98e47dc55b08.jsonconfig690 B
references/evidence/2026-10-07/5007e8060d433e25.jsonconfig1.1 KB
references/evidence/2026-10-07/517af95504d73d2e.jsonconfig771 B
references/evidence/2026-10-07/594b275d01935111.jsonconfig747 B
references/evidence/2026-10-07/5bea86da45f8d2b2.jsonconfig845 B
references/evidence/2026-10-07/5beb8e3bc04c1f71.jsonconfig1.2 KB
references/evidence/2026-10-07/5cc3b7a825a78904.jsonconfig878 B
references/evidence/2026-10-07/5d982c78890cefa6.jsonconfig835 B
references/evidence/2026-10-07/5e92b0399d96314e.jsonconfig803 B
references/evidence/2026-10-07/6bd4cdf3889da0e0.jsonconfig799 B
references/evidence/2026-10-07/6e6f293d07aa413e.jsonconfig697 B
references/evidence/2026-10-07/6fe2317039f5942b.jsonconfig1.2 KB
references/evidence/2026-10-07/7009b4356a2845bc.jsonconfig1.4 KB
references/evidence/2026-10-07/71069b292ce99ef0.jsonconfig719 B
references/evidence/2026-10-07/743026243d1443b5.jsonconfig1.1 KB
references/evidence/2026-10-07/758f52008b4fea50.jsonconfig1.4 KB
# Claude Blog Brain

<p align="center">
  <img src="assets/svg/hero-frontispiece.svg" alt="Claude Blog Brain editorial frontispiece" width="100%"/>
</p>

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

```bash
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:

```bash
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

```bash
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.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall