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

docs/OPERATOR_KIT.md

View on GitHub
# Claude Blog Brain Operator Kit

## Five-Minute Path

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

Open `examples/sample-vault/` in Obsidian and read:

1. `CODEX.md`
2. `wiki/hot.md`
3. `wiki/index.md`
4. `wiki/meta/dashboard.md`

## 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 report --vault ~/claude-blog-brain-vaults/acme --html-only
```

## Research Rule

Refresh official or primary sources when their review windows expire or a
material claim changes. The local 2026-10-07 readiness audit passes at 98/100;
that result does not survive source expiry or later changes automatically.

Research evidence must be written into `references/source-ledger.json` with
source URL, source type, published or last-updated date, retrieved date, date
precision, refresh due date, confidence, evidence tier, limitations, and claim
coverage. Markdown research notes alone do not satisfy market-ready release.
Active records require a dated claim review, excerpt, rationale and normalized
content hash. Retired and unverified records cannot support current advice.
The offline ledger check requires contained, nonsymlinked reviewed excerpt
artifacts under `references/evidence/`. It checks their bytes, hashes, excerpt
agreement and source provenance. It does not recompute the retained
full-document hash or establish full-page availability or semantic entailment.
Retain and independently hash-check the separate full-capture evidence pack.
Secure descriptor-relative excerpt reads are verified on Linux; unsupported
platforms fail closed. See `references/source-map.md` for lifecycle and capture
conventions.

## Adapter Rule

Domain-adapted status requires `references/adapter-manifest.json` to name real
schemas, importer paths, synthesis modules, report renderers, fixtures, and
tests. Generic scaffold scripts are intentionally capped below market-ready.
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall