Paweł Domański
827 lines
24 KiB
Markdown
827 lines
24 KiB
Markdown
SEO Machine — Dokumentacja architektury i workflow
|
||
1) Cel systemu (Problem → Rozwiązanie)
|
||
SEO Machine to wyspecjalizowany workspace Claude Code do produkcji i utrzymania treści long‑form, zoptymalizowanych pod SEO i pod konwersję, w oparciu o:
|
||
|
||
komendy workflow (np. /research, /write, /optimize, /publish-draft, itd.)
|
||
agentów specjalistycznych (analiza SEO, meta, linkowanie, CRO, nagłówki, performance)
|
||
moduły analityczne w Pythonie (intencja, keyword density, readability, SEO score, itp.)
|
||
integracje danych (GA4, Search Console, DataForSEO)
|
||
pliki kontekstu (brand voice, styl, guidelines, keywords, internal links map…)
|
||
|
||
|
||
2) Diagram systemu (logic + przepływ danych)
|
||
2.1 Diagram architektury (warstwy)
|
||
|
||
``` mermaid
|
||
flowchart TB
|
||
U[User / Operator] --> CC[Claude Code Workspace]
|
||
|
||
CC --> CMD[Custom Commands\n/research /write /rewrite /optimize\n/analyze-existing /priorities /publish-draft\n/landing-* /research-*]
|
||
CC --> CTX[Context Pack\nbrand-voice\nwriting-examples\nstyle-guide\nseo-guidelines\ninternal-links-map\ntarget-keywords\ncompetitor-analysis]
|
||
CC --> DIR[Workspace Directories\ntopics/\nresearch/\ndrafts/\nrewrites/\npublished/\nlanding-pages/\naudits/\nreview-required/]
|
||
|
||
CMD --> AG[Specialized Agents\nContent Analyzer\nSEO Optimizer\nMeta Creator\nInternal Linker\nKeyword Mapper\nEditor\nPerformance\nHeadline Generator\nCRO Analyst\nLanding Page Optimizer]
|
||
AG --> PY[Python Analysis Modules\nintent/keywords/readability/seo-score\ncontent-length comparator\nCRO analyzers\nopportunity scoring]
|
||
PY --> DATA[Data Integrations\nGA4\nGSC\nDataForSEO]
|
||
|
||
DATA --> PY
|
||
PY --> AG
|
||
AG --> OUT[Outputs\nbriefs\nreports\noptimized drafts\nmeta packs\nlink maps\npublish payloads]
|
||
OUT --> DIR
|
||
DIR --> CC
|
||
CC --> U
|
||
|
||
```
|
||
|
||
2.2 Diagram “happy path” dla nowego artykułu
|
||
``` mermaid
|
||
sequenceDiagram
|
||
participant U as User
|
||
participant C as Claude Code
|
||
participant R as /research
|
||
participant W as /write
|
||
participant A as Agents (auto)
|
||
participant O as /optimize
|
||
participant P as /publish-draft
|
||
participant FS as Workspace folders
|
||
|
||
U->>C: /research [topic]
|
||
C->>R: run research workflow
|
||
R->>FS: save research brief -> research/brief-*.md
|
||
|
||
U->>C: /write [topic|brief]
|
||
C->>W: generate 2000-3000+ word article
|
||
W->>FS: save draft -> drafts/*.md
|
||
W->>A: auto-run SEO/meta/link/keyword agents
|
||
A->>FS: save agent reports -> drafts/*-report.md
|
||
|
||
U->>C: /optimize [draft file]
|
||
C->>O: final audit + readiness score
|
||
O->>FS: save optimization report -> drafts/optimization-report-*.md
|
||
|
||
U->>C: /publish-draft [file]
|
||
C->>P: WordPress REST + Yoast metadata
|
||
P->>FS: move/copy -> published/*.md
|
||
```
|
||
|
||
|
||
1) Agenci (Specialized Agents) — zakres i odpowiedzialność
|
||
|
||
Reguła jakości: jeden agent = jedna odpowiedzialność + output jako raport/rekomendacje.
|
||
|
||
4.1 Content Analyzer (modułowy, data‑driven)
|
||
Daje “Executive summary” i plan działań:
|
||
|
||
intent (informational / navigational / transactional / commercial)
|
||
keyword density/clustering + stuffing risk
|
||
długość vs top SERP
|
||
readability (Flesch, FK grade, sentence complexity, passive voice)
|
||
SEO quality rating 0–100 + breakdown
|
||
|
||
Output: raport + metryki + benchmarki + priorytety zmian.
|
||
4.2 SEO Optimizer
|
||
|
||
struktura nagłówków, snippet chances, linki, meta, UX
|
||
wynik 0–100 + konkretne poprawki
|
||
|
||
4.3 Meta Creator
|
||
|
||
5 tytułów + 5 opisów + rekomendacje testowe + SERP preview
|
||
|
||
4.4 Internal Linker
|
||
|
||
3–5 linków wewnętrznych + anchor text + mapowanie ścieżki użytkownika
|
||
bazuje na context/internal-links-map.md
|
||
|
||
4.5 Keyword Mapper
|
||
|
||
rozmieszczenie keywords, checklist placementu, LSI coverage, cannibalization risk
|
||
|
||
4.6 Editor
|
||
|
||
“humanity score” + before/after rewrites + eliminacja patternów AI
|
||
|
||
4.7 Performance
|
||
|
||
GA4/GSC/DataForSEO → priorytety, quick wins (pozycje 11–20), low CTR, spadki
|
||
|
||
4.8 CRO / Landing Page Optimizer
|
||
|
||
above‑the‑fold, CTA, trust signals, friction points + scoring 0–100
|
||
A/B testing recommendations
|
||
|
||
|
||
5) Moduły Python — jak wchodzą w workflow
|
||
5.1 SEO Analysis (5 modułów “core”)
|
||
|
||
search_intent_analyzer.py
|
||
keyword_analyzer.py
|
||
content_length_comparator.py
|
||
readability_scorer.py
|
||
seo_quality_rater.py
|
||
|
||
Zasada: Agent “Content Analyzer” jest UI/orkiestratorem; Python moduły dają liczby i benchmarki.
|
||
5.2 CRO Analysis (landing pages)
|
||
|
||
above_fold_analyzer.py, cta_analyzer.py, trust_signal_analyzer.py
|
||
landing_page_scorer.py, landing_performance.py, cro_checker.py
|
||
|
||
5.3 Dodatkowe
|
||
|
||
opportunity scoring, engagement, competitor gaps, article planner, section writer, social research aggregator
|
||
|
||
|
||
6) Integracje danych (GA4/GSC/DataForSEO) — użycie
|
||
6.1 Jakie decyzje wspierają
|
||
|
||
wybór tematów i priorytetów
|
||
identyfikacja quick wins
|
||
ocena, czy rewrite ma sens (ROI)
|
||
walidacja trendu i sezonowości
|
||
wykrywanie spadków performance
|
||
|
||
6.2 Cache i rate‑limits
|
||
|
||
trzymanie cache w data_sources/cache/
|
||
rekomendacja: cache per zapytanie + TTL (np. 24h), żeby nie palić limitów i budżetu
|
||
|
||
|
||
7) Organizacja workspace (folders + “single source of truth”)
|
||
Proponowany kontrakt folderów:
|
||
|
||
topics/ — surowe pomysły + notatki
|
||
research/ — briefy i analizy istniejących treści
|
||
drafts/ — artykuły w toku + raporty agentów
|
||
review-required/ — do ręcznego review (editorial/SME/legal)
|
||
rewrites/ — zaktualizowane wersje + diff/changelog
|
||
published/ — final + gotowe pod WP
|
||
landing-pages/ — LP content
|
||
audits/ — CRO/SEO audyty
|
||
|
||
Reguła: każdy artifact powinien zawierać: topic, datę, wersję.
|
||
|
||
8) “Definition of Done” (DoD) dla artykułu
|
||
8.1 Content
|
||
|
||
2000+ słów (preferowane 2500–3000)
|
||
unikalna wartość vs competitors
|
||
konkretne przykłady, dane i źródła
|
||
CTA i logiczny flow
|
||
|
||
8.2 SEO
|
||
|
||
primary keyword: 1–2% + H1 + pierwsze 100 słów + 2–3 H2
|
||
3–5 internal links, 2–3 external authority links
|
||
meta title 50–60 chars, meta description 150–160 chars
|
||
poprawna hierarchia H1>H2>H3
|
||
wynik SEO score ≥ (np.) 85/100
|
||
|
||
8.3 Readability
|
||
|
||
8–10 grade
|
||
15–20 słów / zdanie (średnio)
|
||
akapity 2–4 zdania
|
||
heading co 300–400 słów
|
||
|
||
|
||
9) Getting Started (instalacja + first run)
|
||
9.1 Prereqs
|
||
|
||
Claude Code zainstalowany
|
||
Anthropic API account
|
||
Python + pip
|
||
|
||
9.2 Instalacja
|
||
Shellgit clone https://github.com/[your-username]/seomachine.gitcd seomachinepip install -r data_sources/requirements.txtclaude-code .``Show more lines
|
||
9.3 Uzupełnij context (najważniejsze)
|
||
Wypełnij szablony:
|
||
|
||
context/brand-voice.md
|
||
context/writing-examples.md
|
||
context/style-guide.md
|
||
context/seo-guidelines.md
|
||
context/target-keywords.md
|
||
context/internal-links-map.md
|
||
context/competitor-analysis.md
|
||
|
||
9.4 Quick Start
|
||
|
||
/research [topic]
|
||
/write [topic]
|
||
/optimize drafts/<file>.md
|
||
/publish-draft drafts/<file>.md (opcjonalnie)
|
||
|
||
|
||
10) Dodatkowy diagram: “moduły analizy” (SEO + CRO)
|
||
|
||
``` mermaid
|
||
flowchart LR
|
||
A[Content Analyzer Agent] --> SI[Search Intent Analyzer]
|
||
A --> KA[Keyword Analyzer\nDensity + Clustering + LSI]
|
||
A --> CL[Content Length Comparator\nSERP Benchmarks]
|
||
A --> RS[Readability Scorer]
|
||
A --> SQ[SEO Quality Rater\nScore 0-100 + breakdown]
|
||
|
||
LP[Landing Page Optimizer] --> AF[Above-the-fold Analyzer]
|
||
LP --> CTA[CTA Analyzer]
|
||
LP --> TS[Trust Signal Analyzer]
|
||
LP --> LPS[Landing Page Scorer]
|
||
LP --> LPP["Landing Performance (GA4/GSC)"]
|
||
```
|
||
|
||
Chcesz, żebym zrobił to “w wersji repo-ready”?
|
||
Mogę przygotować:
|
||
|
||
docs/architecture.md (ten tekst)
|
||
docs/workflows.md (same flowy i checklisty)
|
||
docs/commands.md (referencja komend + inputs/outputs)
|
||
docs/agents.md (agent responsibilities + output templates)
|
||
docs/data-integrations.md (GA4/GSC/DataForSEO + env vars)
|
||
|
||
Powiedz tylko: czy SEO Machine ma być stricte “Claude Code workspace” (jak w opisie), czy chcesz też wariant pod OpenClaw skill-suite (skill + sub-skille + slash dispatch)?
|
||
|
||
|
||
1) Diagram architektury (warstwy + przepływ danych)
|
||
|
||
|
||
``` mermaid
|
||
|
||
|
||
flowchart TB
|
||
%% =========================
|
||
%% GLOBAL ENTRYPOINT
|
||
%% =========================
|
||
U[User / Operator] --> CC[Claude Code Workspace\nSEO Machine Runtime]
|
||
%% CONTEXT PACK (STATIC)
|
||
%% =========================
|
||
subgraph CTX["Context & Guidelines (Single Source of Truth)"]
|
||
direction TB
|
||
BV[context/brand-voice.md\nVoice pillars • tone • messaging]
|
||
WE[context/writing-examples.md\n3–5 exemplary posts + notes]
|
||
SG[context/style-guide.md\nEditorial rules • formatting]
|
||
SEO[context/seo-guidelines.md\nLength • density • meta • links]
|
||
KW[context/target-keywords.md\nClusters • intent • long-tails]
|
||
IL[context/internal-links-map.md\nKey pages • anchors • journeys]
|
||
CA[context/competitor-analysis.md\nCompetitors • gaps • angles]
|
||
FT[context/features.md\nBenefits • differentiation]
|
||
end
|
||
|
||
%% =========================
|
||
%% WORKSPACE DIRECTORIES (ARTIFACTS)
|
||
%% =========================
|
||
subgraph FS["Workspace Directories (Artifacts)"]
|
||
direction TB
|
||
TOP[topics/\nRaw ideas]
|
||
RES[research/\nBriefs + analyses]
|
||
DRA[drafts/\nWIP articles + agent reports]
|
||
REV[review-required/\nHuman review queue]
|
||
REW[rewrites/\nUpdated posts + change summary]
|
||
PUB["published/\nFinal content (ready)"]
|
||
LP[landing-pages/\nLanding pages]
|
||
AUD[audits/\nSEO/CRO audits]
|
||
end
|
||
|
||
%% =========================
|
||
%% COMMANDS (ORCHESTRATION)
|
||
%% =========================
|
||
subgraph CMD["Custom Commands (Orchestration Layer)"]
|
||
direction TB
|
||
C1[research]
|
||
C2[write]
|
||
C3[optimize]
|
||
C4[analyze-existing]
|
||
C5[rewrite]
|
||
C6[performance-review]
|
||
C7[priorities]
|
||
C8[publish-draft]
|
||
C9["article (simplified flow)"]
|
||
C10["scrub (de-AI pattern cleanup)"]
|
||
|
||
subgraph RC["Research Commands"]
|
||
direction TB
|
||
R1[research-serp]
|
||
R2[research-gaps]
|
||
R3[research-trending]
|
||
R4[research-performance]
|
||
R5[research-topics]
|
||
end
|
||
|
||
subgraph LC["Landing Page Commands"]
|
||
direction TB
|
||
L1[landing-write]
|
||
L2[landing-audit]
|
||
L3[landing-research]
|
||
L4[landing-competitor]
|
||
L5[landing-publish]
|
||
end
|
||
end
|
||
|
||
%% =========================
|
||
%% SPECIALIZED AGENTS
|
||
%% =========================
|
||
subgraph AG["Specialized Agents (Expert Reviews)"]
|
||
direction TB
|
||
A1["Content Analyzer\n(Executive summary + metrics)"]
|
||
A2["SEO Optimizer\n(On-page score + fixes)"]
|
||
A3["Meta Creator\n(Title/desc variants + tests)"]
|
||
A4["Internal Linker\n(placements + anchors)"]
|
||
A5["Keyword Mapper\n(density + distribution)"]
|
||
A6["Editor\n(humanity score + rewrites)"]
|
||
A7["Performance\n(priorities + roadmap)"]
|
||
A8["Headline Generator\n(variants + A/B plan)"]
|
||
A9["CRO Analyst\n(CRO scoring + friction)"]
|
||
A10["Landing Page Optimizer\n(CRO + SEO for LP)"]
|
||
end
|
||
|
||
%% =========================
|
||
%% PYTHON MODULES (ANALYTICS ENGINE)
|
||
%% =========================
|
||
subgraph PY["Python Modules (Analysis Engine)"]
|
||
direction TB
|
||
|
||
subgraph SEO5["SEO Analysis Modules (Core 5)"]
|
||
direction TB
|
||
P1[search_intent_analyzer.py\nintent + confidence]
|
||
P2[keyword_analyzer.py\ndensity + clustering + LSI + heatmap]
|
||
P3[content_length_comparator.py\nSERP length benchmarks]
|
||
P4[readability_scorer.py\nFlesch/FK + passive voice + complexity]
|
||
P5[seo_quality_rater.py\nscore 0-100 + breakdown]
|
||
end
|
||
|
||
subgraph CRO6["CRO Modules (Landing Pages)"]
|
||
direction TB
|
||
CP1[above_fold_analyzer.py\nheadline/value prop/CTA/trust]
|
||
CP2[cta_analyzer.py\nCTA quality + distribution]
|
||
CP3[trust_signal_analyzer.py\nsocial proof + risk reversal]
|
||
CP4[landing_page_scorer.py\nscore 0-100 + categories]
|
||
CP5[landing_performance.py\nGA4/GSC performance trends]
|
||
CP6[cro_checker.py\nbest-practice checklist]
|
||
end
|
||
|
||
subgraph AUX["Additional Modules"]
|
||
direction TB
|
||
X1["opportunity_scorer.py\nimpact score (0-100)"]
|
||
X2[content_scorer.py\nhumanity/specificity/structure/SEO/readability]
|
||
X3[engagement_analyzer.py\npatterns + hooks]
|
||
X4[competitor_gap_analyzer.py\ngaps + opportunities]
|
||
X5[article_planner.py\nplan from data]
|
||
X6[section_writer.py\nsection-level guidance]
|
||
X7[social_research_aggregator.py\nsocial inputs]
|
||
X8[wordpress_publisher.py\npublish payload + Yoast fields]
|
||
end
|
||
end
|
||
|
||
%% =========================
|
||
%% DATA INTEGRATIONS
|
||
%% =========================
|
||
subgraph DATA["Data Integrations (Real-time Signals)"]
|
||
direction TB
|
||
GA4["(Google Analytics 4)"]
|
||
GSC["(Google Search Console)"]
|
||
DFS["(DataForSEO)"]
|
||
end
|
||
|
||
%% =========================
|
||
%% WORDPRESS PUBLISHING
|
||
%% =========================
|
||
subgraph WP["Publishing Target"]
|
||
direction TB
|
||
WPR["(WordPress REST API)"]
|
||
YO["(Yoast SEO Metadata\nvia MU-plugin bridge)"]
|
||
end
|
||
|
||
%% =========================
|
||
%% MARKETING SKILLS (26)
|
||
%% =========================
|
||
subgraph MS["Marketing Skills (26 slash skills)"]
|
||
direction TB
|
||
MS1[Copywriting\n/copywriting /copy-editing]
|
||
MS2[CRO\n/page-cro /form-cro /signup-flow-cro\n/onboarding-cro /popup-cro /paywall-upgrade-cro]
|
||
MS3[Strategy\n/content-strategy /pricing-strategy\n/launch-strategy /marketing-ideas]
|
||
MS4[Channels\n/email-sequence /social-content /paid-ads]
|
||
MS5[SEO\n/seo-audit /schema-markup /programmatic-seo\n/competitor-alternatives]
|
||
MS6[Analytics\n/analytics-tracking /ab-test-setup]
|
||
MS7[Other\n/referral-program /free-tool-strategy /marketing-psychology]
|
||
end
|
||
|
||
%% =========================
|
||
%% WORKFLOWS AS SUBGRAPHS
|
||
%% =========================
|
||
subgraph WF1["Workflow A — New Long-form Content"]
|
||
direction TB
|
||
WFA1[research topic] --> WFA2[Research Brief\nkeywords • SERP • gaps • outline]
|
||
WFA2 --> WFA3[write topic brief]
|
||
WFA3 --> WFA4[Draft Article\n2000–3000+ words\nH1/H2/H3 + links + meta]
|
||
WFA4 --> WFA5[Auto Agent Reviews\nSEO/meta/link/keyword/editor/headlines]
|
||
WFA5 --> WFA6[optimize draft]
|
||
WFA6 --> WFA7[Publishing Readiness Score\n+ final fix list]
|
||
WFA7 --> WFA8["/publish-draft (optional)"]
|
||
end
|
||
|
||
subgraph WF2["Workflow B — Update Existing Content"]
|
||
direction TB
|
||
WFB1[analyze-existing url file] --> WFB2[Content Health Score 0–100\n+ quick wins + strategic fixes]
|
||
WFB2 --> WFB3[rewrite topic analysis]
|
||
WFB3 --> WFB4[Updated Article + Change Summary\nstats refresh • gap fill • keep winners]
|
||
WFB4 --> WFB5[optimize rewrite]
|
||
WFB5 --> WFB6[Final SEO Audit + Readiness]
|
||
WFB6 --> WFB7["/publish-draft (optional)"]
|
||
end
|
||
|
||
subgraph WF3["Workflow C — Landing Pages (CRO-driven)"]
|
||
direction TB
|
||
WFC1[landing-research topic] --> WFC2[Positioning + competitor LP insights]
|
||
WFC2 --> WFC3[landing-write topic]
|
||
WFC3 --> WFC4[Landing Page Draft\nvalue prop • CTA • trust]
|
||
WFC4 --> WFC5[landing-audit file]
|
||
WFC5 --> WFC6[CRO Score 0–100\n+ A/B test plan + priority fixes]
|
||
WFC6 --> WFC7["landing-publish (optional)"]
|
||
end
|
||
|
||
%% =========================
|
||
%% CONNECTIONS (WHO USES WHAT)
|
||
%% =========================
|
||
CC --> CTX
|
||
CC --> CMD
|
||
CC --> AG
|
||
CC --> PY
|
||
CC --> FS
|
||
CC --> MS
|
||
|
||
%% Commands drive workflows
|
||
C1 --> WF1
|
||
C2 --> WF1
|
||
C3 --> WF1
|
||
C8 --> WF1
|
||
|
||
C4 --> WF2
|
||
C5 --> WF2
|
||
C3 --> WF2
|
||
C8 --> WF2
|
||
|
||
L3 --> WF3
|
||
L1 --> WF3
|
||
L2 --> WF3
|
||
L5 --> WF3
|
||
|
||
%% Agents consume context + produce artifacts
|
||
CTX --> AG
|
||
AG --> FS
|
||
|
||
%% Python modules power agents
|
||
AG --> PY
|
||
PY --> AG
|
||
|
||
%% Data feeds Python/Performance
|
||
DATA --> PY
|
||
GA4 --> DATA
|
||
GSC --> DATA
|
||
DFS --> DATA
|
||
|
||
%% Saving artifacts to folders
|
||
WFA2 --> RES
|
||
WFA4 --> DRA
|
||
WFA5 --> DRA
|
||
WFA7 --> DRA
|
||
WFB2 --> RES
|
||
WFB4 --> REW
|
||
WFC4 --> LP
|
||
WFC6 --> AUD
|
||
|
||
%% Review stage (optional)
|
||
DRA --> REV
|
||
REW --> REV
|
||
REV --> PUB
|
||
|
||
%% Publishing
|
||
C8 --> WP
|
||
WFA8 --> WP
|
||
WFB7 --> WP
|
||
WFC7 --> WP
|
||
|
||
FS --> WPR
|
||
WPR --> YO
|
||
YO --> PUB
|
||
|
||
%% Marketing skills feed drafts and landing pages
|
||
MS --> DRA
|
||
MS --> LP
|
||
```
|
||
|
||
|
||
2) Workflow: nowy artykuł (Research → Write → Optimize → Publish)
|
||
|
||
``` mermaid
|
||
sequenceDiagram
|
||
autonumber
|
||
participant U as User
|
||
participant C as Claude Code (SEO Machine)
|
||
participant R as /research
|
||
participant W as /write
|
||
participant A as Auto Agents
|
||
participant O as /optimize
|
||
participant P as /publish-draft
|
||
participant FS as Workspace (folders)
|
||
|
||
U->>C: /research [topic]
|
||
C->>R: Keyword + SERP + competitor analysis
|
||
R->>FS: research/brief-[topic]-[date].md
|
||
|
||
U->>C: /write [topic|brief]
|
||
C->>W: Generate long-form article (2000-3000+)
|
||
W->>FS: drafts/[topic]-[date].md
|
||
W->>A: Trigger SEO/meta/link/keyword agents
|
||
A->>FS: drafts/*-seo-report.md
|
||
A->>FS: drafts/*-meta-options.md
|
||
A->>FS: drafts/*-internal-links.md
|
||
A->>FS: drafts/*-keyword-map.md
|
||
|
||
U->>C: /optimize [draft file]
|
||
C->>O: Final audit + publishing readiness score
|
||
O->>FS: drafts/optimization-report-[topic]-[date].md
|
||
|
||
U->>C: /publish-draft [file]
|
||
C->>P: Publish to WP + Yoast fields
|
||
P->>FS: published/[topic]-[date].md
|
||
```
|
||
|
||
3) Workflow: aktualizacja istniejącej treści (Analyze → Rewrite → Optimize → Publish)
|
||
``` mermaid
|
||
sequenceDiagram
|
||
autonumber
|
||
participant U as User
|
||
participant C as Claude Code (SEO Machine)
|
||
participant AE as /analyze-existing
|
||
participant RW as /rewrite
|
||
participant O as /optimize
|
||
participant P as /publish-draft
|
||
participant FS as Workspace (folders)
|
||
|
||
U->>C: /analyze-existing [url|file]
|
||
C->>AE: Fetch + performance + content health scoring
|
||
AE->>FS: research/analysis-[topic]-[date].md
|
||
|
||
U->>C: /rewrite [topic|analysis file]
|
||
C->>RW: Update stats, gaps, SEO, keep what's working
|
||
RW->>FS: rewrites/[topic]-rewrite-[date].md
|
||
RW->>FS: rewrites/[topic]-change-summary-[date].md
|
||
|
||
U->>C: /optimize [rewrite file]
|
||
C->>O: Final polish + readiness score
|
||
O->>FS: drafts/optimization-report-[topic]-[date].md
|
||
|
||
U->>C: /publish-draft [file]
|
||
C->>P: Publish updated content to WP
|
||
P->>FS: published/[topic]-[date].md
|
||
```
|
||
4) Moduły SEO Analysis (5 modułów) + wynik “Content Analyzer”
|
||
``` mermaid
|
||
flowchart LR
|
||
CA[Content Analyzer Agent\nExecutive summary + action plan] --> SI["Search Intent Analyzer\n(intent + confidence)"]
|
||
CA --> KA["Keyword Analyzer\n(density + clustering + LSI + heatmap)"]
|
||
CA --> CL["Content Length Comparator\n(SERP benchmarks: median, p75, target)"]
|
||
CA --> RS["Readability Scorer\n(Flesch, FK grade, passive voice, complexity)"]
|
||
CA --> SQ["SEO Quality Rater\n(score 0-100 + category breakdown)"]
|
||
|
||
SI --> CA
|
||
KA --> CA
|
||
CL --> CA
|
||
RS --> CA
|
||
SQ --> CA
|
||
```
|
||
5) Landing Page / CRO pipeline (audit → rekomendacje → test plan)
|
||
``` mermaid
|
||
flowchart TB
|
||
LWC[/landing-write or /landing-audit/] --> CRO[CRO Analyst + Landing Page Optimizer]
|
||
CRO --> AF[above_fold_analyzer.py\nheadline/value prop/CTA/trust]
|
||
CRO --> CTA[cta_analyzer.py\nCTA quality + distribution]
|
||
CRO --> TS[trust_signal_analyzer.py\nsocial proof + risk reversal]
|
||
CRO --> LPS[landing_page_scorer.py\nscore 0-100 + breakdown]
|
||
CRO --> LPPerf[landing_performance.py\nGA4/GSC performance trends]
|
||
CRO --> CK[cro_checker.py\nbest-practices checklist]
|
||
|
||
CRO --> OUT[Outputs\nCRO score\npriority fixes\nA/B testing plan\ncopy suggestions\nwireframe notes]
|
||
OUT --> FS["(audits/ + landing-pages/)"]
|
||
```
|
||
|
||
``` mermaid
|
||
flowchart TB
|
||
|
||
U["User / Operator"] --> CC["Claude Code Workspace\nSEO Machine Runtime"]
|
||
|
||
subgraph CTX["Context & Guidelines\nSingle Source of Truth"]
|
||
direction TB
|
||
BV["context/brand-voice.md"]
|
||
WE["context/writing-examples.md"]
|
||
SG["context/style-guide.md"]
|
||
SEOG["context/seo-guidelines.md"]
|
||
KW["context/target-keywords.md"]
|
||
IL["context/internal-links-map.md"]
|
||
COMP["context/competitor-analysis.md"]
|
||
FT["context/features.md"]
|
||
end
|
||
|
||
subgraph FS["Workspace Directories\nArtifacts + Outputs"]
|
||
direction TB
|
||
TOP["topics/"]
|
||
RES["research/"]
|
||
DRA["drafts/"]
|
||
REV["review-required/"]
|
||
REW["rewrites/"]
|
||
PUB["published/"]
|
||
LP["landing-pages/"]
|
||
AUD["audits/"]
|
||
end
|
||
|
||
subgraph CMD["Custom Commands\nOrchestration Layer"]
|
||
direction TB
|
||
C1["/research"]
|
||
C2["/write"]
|
||
C3["/optimize"]
|
||
C4["/analyze-existing"]
|
||
C5["/rewrite"]
|
||
C6["/performance-review"]
|
||
C7["/priorities"]
|
||
C8["/publish-draft"]
|
||
C9["/article"]
|
||
C10["/scrub"]
|
||
|
||
subgraph RC["Research Commands"]
|
||
direction TB
|
||
R1["/research-serp"]
|
||
R2["/research-gaps"]
|
||
R3["/research-trending"]
|
||
R4["/research-performance"]
|
||
R5["/research-topics"]
|
||
end
|
||
|
||
subgraph LC["Landing Page Commands"]
|
||
direction TB
|
||
L1["/landing-write"]
|
||
L2["/landing-audit"]
|
||
L3["/landing-research"]
|
||
L4["/landing-competitor"]
|
||
L5["/landing-publish"]
|
||
end
|
||
end
|
||
|
||
subgraph AG["Specialized Agents\nExpert Reviews"]
|
||
direction TB
|
||
A1["Content Analyzer"]
|
||
A2["SEO Optimizer"]
|
||
A3["Meta Creator"]
|
||
A4["Internal Linker"]
|
||
A5["Keyword Mapper"]
|
||
A6["Editor"]
|
||
A7["Performance"]
|
||
A8["Headline Generator"]
|
||
A9["CRO Analyst"]
|
||
A10["Landing Page Optimizer"]
|
||
end
|
||
|
||
subgraph PY["Python Modules\nAnalysis Engine"]
|
||
direction TB
|
||
|
||
subgraph SEO5["SEO Analysis\nCore 5 Modules"]
|
||
direction TB
|
||
P1["search_intent_analyzer.py"]
|
||
P2["keyword_analyzer.py"]
|
||
P3["content_length_comparator.py"]
|
||
P4["readability_scorer.py"]
|
||
P5["seo_quality_rater.py"]
|
||
end
|
||
|
||
subgraph CRO6["CRO Modules\nLanding Pages"]
|
||
direction TB
|
||
CP1["above_fold_analyzer.py"]
|
||
CP2["cta_analyzer.py"]
|
||
CP3["trust_signal_analyzer.py"]
|
||
CP4["landing_page_scorer.py"]
|
||
CP5["landing_performance.py"]
|
||
CP6["cro_checker.py"]
|
||
end
|
||
|
||
subgraph AUX["Additional Modules"]
|
||
direction TB
|
||
X1["opportunity_scorer.py"]
|
||
X2["content_scorer.py"]
|
||
X3["engagement_analyzer.py"]
|
||
X4["competitor_gap_analyzer.py"]
|
||
X5["article_planner.py"]
|
||
X6["section_writer.py"]
|
||
X7["social_research_aggregator.py"]
|
||
X8["wordpress_publisher.py"]
|
||
end
|
||
end
|
||
|
||
subgraph DATA["Data Integrations\nSignals"]
|
||
direction TB
|
||
GA4["Google Analytics 4"]
|
||
GSC["Google Search Console"]
|
||
DFS["DataForSEO"]
|
||
end
|
||
|
||
subgraph WP["Publishing Target\nWordPress + Yoast"]
|
||
direction TB
|
||
WPR["WordPress REST API"]
|
||
YO["Yoast SEO fields\nMU-plugin bridge"]
|
||
end
|
||
|
||
subgraph MS["Marketing Skills\n26 slash skills"]
|
||
direction TB
|
||
MS1["Copywriting\n/copywriting\n/copy-editing"]
|
||
MS2["CRO skills\n/page-cro\n/form-cro\n/onboarding-cro"]
|
||
MS3["Strategy\n/content-strategy\n/pricing-strategy"]
|
||
MS4["Channels\n/email-sequence\n/social-content\n/paid-ads"]
|
||
MS5["SEO skills\n/seo-audit\n/schema-markup\n/programmatic-seo"]
|
||
MS6["Analytics\n/analytics-tracking\n/ab-test-setup"]
|
||
MS7["Other\n/referral-program\n/free-tool-strategy"]
|
||
end
|
||
|
||
subgraph WF1["Workflow A\nNew Long-form Content"]
|
||
direction TB
|
||
WF1a["/research topic"] --> WF1b["Research brief"]
|
||
WF1b --> WF1c["/write topic or brief"]
|
||
WF1c --> WF1d["Draft article\n2000–3000+ words"]
|
||
WF1d --> WF1e["Auto agent reviews"]
|
||
WF1e --> WF1f["/optimize draft"]
|
||
WF1f --> WF1g["Readiness score"]
|
||
WF1g --> WF1h["/publish-draft optional"]
|
||
end
|
||
|
||
subgraph WF2["Workflow B\nUpdate Existing Content"]
|
||
direction TB
|
||
WF2a["/analyze-existing url or file"] --> WF2b["Health score 0–100"]
|
||
WF2b --> WF2c["/rewrite topic or analysis"]
|
||
WF2c --> WF2d["Updated article\nChange summary"]
|
||
WF2d --> WF2e["/optimize rewrite"]
|
||
WF2e --> WF2f["Final audit\nReadiness"]
|
||
WF2f --> WF2g["/publish-draft optional"]
|
||
end
|
||
|
||
subgraph WF3["Workflow C\nLanding Pages (CRO)"]
|
||
direction TB
|
||
WF3a["/landing-research topic"] --> WF3b["Positioning insights"]
|
||
WF3b --> WF3c["/landing-write topic"]
|
||
WF3c --> WF3d["Landing page draft"]
|
||
WF3d --> WF3e["/landing-audit file"]
|
||
WF3e --> WF3f["CRO score 0–100\nA/B plan"]
|
||
WF3f --> WF3g["/landing-publish optional"]
|
||
end
|
||
|
||
%% Wiring
|
||
CC --> CTX
|
||
CC --> CMD
|
||
CC --> AG
|
||
CC --> PY
|
||
CC --> FS
|
||
CC --> MS
|
||
|
||
CTX --> AG
|
||
AG --> PY
|
||
PY --> AG
|
||
DATA --> PY
|
||
|
||
%% Commands to workflows
|
||
C1 --> WF1
|
||
C2 --> WF1
|
||
C3 --> WF1
|
||
C8 --> WF1
|
||
|
||
C4 --> WF2
|
||
C5 --> WF2
|
||
C3 --> WF2
|
||
C8 --> WF2
|
||
|
||
L3 --> WF3
|
||
L1 --> WF3
|
||
L2 --> WF3
|
||
L5 --> WF3
|
||
|
||
%% Artifacts to folders
|
||
WF1b --> RES
|
||
WF1d --> DRA
|
||
WF1e --> DRA
|
||
WF1g --> DRA
|
||
|
||
WF2b --> RES
|
||
WF2d --> REW
|
||
|
||
WF3d --> LP
|
||
WF3f --> AUD
|
||
|
||
%% Review handoff
|
||
DRA --> REV
|
||
REW --> REV
|
||
REV --> PUB
|
||
|
||
%% Publishing
|
||
C8 --> WP
|
||
WF1h --> WP
|
||
WF2g --> WP
|
||
WF3g --> WP
|
||
|
||
FS --> WPR
|
||
WPR --> YO
|
||
YO --> PUB
|
||
``` |