May 17, 2026, 11:40 PM
This commit is contained in:
Paweł Domański
@@ -0,0 +1,468 @@
|
||||
PaperClip Company: "AI Mentorship Blog"
|
||||
│
|
||||
├── CEO Agent (orkiestrator)
|
||||
│ └── hiring plan: 5 agentów
|
||||
│ ├── Researcher
|
||||
│ ├── Selector/Hook Writer
|
||||
│ ├── SEO Analyst
|
||||
│ ├── Post Writer
|
||||
│ └── Quality Checker
|
||||
│
|
||||
├── Skills (runtime injection)
|
||||
│ ├── blog-registry.skill ← profile blogów
|
||||
│ ├── researcher.skill
|
||||
│ ├── selector.skill
|
||||
│ ├── seo-analyst.skill
|
||||
│ ├── post-writer.skill
|
||||
│ └── quality-checker.skill
|
||||
│
|
||||
└── Heartbeats / Tickets
|
||||
└── pipeline_run per blog
|
||||
|
||||
|
||||
|
||||
Dobra — PaperClip natywnie obsługuje **multi-company isolation**, **org charts**, **heartbeaty**, **approval gates** i **runtime skill injection**. [github](https://github.com/paperclipai/paperclip) Cały pipeline możesz zbudować **wyłącznie w PaperClip** bez zewnętrznego kodu TypeScript. Oto jak to zrobić krok po kroku.
|
||||
|
||||
## Architektura natywna w PaperClip
|
||||
|
||||
```
|
||||
PaperClip Company: "AI Mentorship Blog"
|
||||
│
|
||||
├── CEO Agent (orkiestrator)
|
||||
│ └── hiring plan: 5 agentów
|
||||
│ ├── Researcher
|
||||
│ ├── Selector/Hook Writer
|
||||
│ ├── SEO Analyst
|
||||
│ ├── Post Writer
|
||||
│ └── Quality Checker
|
||||
│
|
||||
├── Skills (runtime injection)
|
||||
│ ├── blog-registry.skill ← profile blogów
|
||||
│ ├── researcher.skill
|
||||
│ ├── selector.skill
|
||||
│ ├── seo-analyst.skill
|
||||
│ ├── post-writer.skill
|
||||
│ └── quality-checker.skill
|
||||
│
|
||||
└── Heartbeats / Tickets
|
||||
└── pipeline_run per blog
|
||||
```
|
||||
|
||||
***
|
||||
|
||||
## Krok 1 — Utwórz Company per blog
|
||||
|
||||
PaperClip ma natywny **multi-company** z pełną izolacją danych. [github](https://github.com/paperclipai/paperclip) Każdy blog to osobna Company w jednym deploymencie.
|
||||
|
||||
```
|
||||
Dashboard → New Company
|
||||
─────────────────────────────────────
|
||||
Name: AI Mentorship Business
|
||||
Slug: ai-mentorship
|
||||
Mission: Run social media pipeline for business owners audience.
|
||||
Practical AI content. No hype. Credibility first.
|
||||
─────────────────────────────────────
|
||||
Name: Tech Blog PL
|
||||
Slug: tech-blog-pl
|
||||
Mission: Run social media pipeline for Polish tech audience.
|
||||
─────────────────────────────────────
|
||||
```
|
||||
|
||||
Każda company widzi tylko swoje agenty, taski i outputy. Jeden PaperClip — wiele izolowanych firm. [github](https://github.com/paperclipai/paperclip)
|
||||
|
||||
***
|
||||
|
||||
## Krok 2 — Utwórz Skills
|
||||
|
||||
Skills w PaperClip to runtime-injected kontekst — agent ładuje je przy starcie taska, bez retrainingu. [github](https://github.com/paperclipai/paperclip) Trzymasz je w `.agents/skills/` lub przez UI.
|
||||
|
||||
### `blog-registry.skill`
|
||||
|
||||
To jest profil bloga wstrzykiwany do wszystkich agentów w tej company:
|
||||
|
||||
```markdown
|
||||
# BLOG CONTEXT
|
||||
|
||||
Blog: AI Mentorship Business
|
||||
Domain: example.com
|
||||
Language: en
|
||||
|
||||
Audience: Business owners, creators, solo founders who want
|
||||
practical AI systems, workflow automation, revenue leverage.
|
||||
|
||||
Audience excludes: Developers, engineers, AI hobbyists,
|
||||
theory-focused readers.
|
||||
|
||||
Brand voice: Sharp, grounded, plain English, experienced
|
||||
operator, no hype, no fake certainty.
|
||||
|
||||
Forbidden phrases:
|
||||
- "AI is changing everything"
|
||||
- "The future is now"
|
||||
- "Unlock the power of"
|
||||
- "Game-changer"
|
||||
|
||||
Topics that perform:
|
||||
- Tool reviews with specific time/cost savings
|
||||
- Contrarian takes on AI timelines
|
||||
- "I tested this for X hours" stories
|
||||
- Industry disruption predictions
|
||||
|
||||
Topics to avoid:
|
||||
- Dev/engineering content without business angle
|
||||
- Generic AI hype with no specific angle
|
||||
- Academic research
|
||||
|
||||
Keyword niche: AI for business, workflow automation,
|
||||
solopreneur AI systems
|
||||
|
||||
Channels: LinkedIn, Twitter/X
|
||||
SEO priority: medium
|
||||
CTA style: soft, credibility-building, not salesy
|
||||
Approval mode: founder_required
|
||||
```
|
||||
|
||||
### `researcher.skill`
|
||||
|
||||
```markdown
|
||||
# RESEARCHER AGENT
|
||||
|
||||
You are a content researcher for this blog.
|
||||
|
||||
Mission: Research Reddit and YouTube (last 14 days).
|
||||
Find ~10 high-potential content ideas with real engagement data.
|
||||
|
||||
Platforms:
|
||||
- Reddit: r/ChatGPT, r/artificial, r/smallbusiness,
|
||||
r/Entrepreneur, r/SaaS, r/automation, r/nocode
|
||||
- YouTube: AI for business, workflow automation,
|
||||
solopreneur AI use cases
|
||||
|
||||
Per idea capture:
|
||||
- Topic summary (1 sentence)
|
||||
- Source platform + URL
|
||||
- Engagement data (upvotes, comments, views, like ratio)
|
||||
- Audience fit (1 sentence)
|
||||
- Adaptation angle (1 sentence)
|
||||
- Risk flags
|
||||
- Score: 1-100
|
||||
|
||||
Rules:
|
||||
- Do NOT fabricate engagement numbers
|
||||
- Do NOT include generic "AI is amazing" content
|
||||
- Do NOT include dev-only content without business angle
|
||||
- Flag artificially inflated engagement
|
||||
|
||||
Output: ranked list of ~10 ideas → pass to Selector.
|
||||
```
|
||||
|
||||
### `selector.skill`
|
||||
|
||||
```markdown
|
||||
# SELECTOR / HOOK WRITER AGENT
|
||||
|
||||
Input: Researcher output (ranked ~10 ideas)
|
||||
|
||||
Mission: Select top 3 ideas. Generate 5 hooks per winner.
|
||||
|
||||
Scoring criteria:
|
||||
- Audience fit
|
||||
- Engagement strength
|
||||
- Business relevance
|
||||
- Hook potential
|
||||
- Personal insight angle
|
||||
|
||||
Per top 3 deliver:
|
||||
- Selection rationale
|
||||
- Audience angle
|
||||
- 5 hook options
|
||||
- Recommended hook + why it wins
|
||||
|
||||
Hook rules:
|
||||
- Hook in first line — no warm-up
|
||||
- Concrete: numbers, outcomes, tools, real situations
|
||||
- No motivational phrases
|
||||
- Sounds like smart operator, not growth hacker
|
||||
|
||||
Output: top 3 + hooks → pass to SEO Analyst.
|
||||
```
|
||||
|
||||
### `seo-analyst.skill`
|
||||
|
||||
```markdown
|
||||
# SEO ANALYST AGENT
|
||||
|
||||
Input: Selector output (top 3 + hooks)
|
||||
|
||||
Mission: SEO brief per post.
|
||||
|
||||
Per idea deliver:
|
||||
1. Search intent (informational/navigational/commercial/transactional)
|
||||
2. Primary keyword — volume estimate, competition (low/med/high)
|
||||
3. Supporting cluster — 3-5 related terms
|
||||
4. 3 SEO title variants (work as LinkedIn headline OR blog title)
|
||||
5. Content structure (H2/H3 if longer-form, key question to answer early)
|
||||
6. Competitor content gap — what angle is missing?
|
||||
7. SEO opportunity score: 1-100
|
||||
|
||||
Rules:
|
||||
- Keywords must fit naturally — voice beats SEO every time
|
||||
- No keyword density targets
|
||||
- Flag keywords that would make post sound robotic
|
||||
- If SEO opportunity weak — say so honestly
|
||||
|
||||
Output: SEO brief per post → pass to Post Writer.
|
||||
```
|
||||
|
||||
### `post-writer.skill`
|
||||
|
||||
```markdown
|
||||
# POST WRITER AGENT
|
||||
|
||||
Input: Selector output + SEO briefs
|
||||
|
||||
Mission: Write 1 full post per top 3 idea.
|
||||
|
||||
Each post:
|
||||
- Open with approved hook — no changes without flagging
|
||||
- Incorporate primary keyword + cluster naturally
|
||||
- Stay concrete and specific
|
||||
- Include practical takeaway or decision framework
|
||||
- Easy to skim — short paragraphs, line breaks
|
||||
- End with optional soft CTA
|
||||
- Answer primary search intent early
|
||||
- One person talking — not a marketing team
|
||||
|
||||
Format:
|
||||
- LinkedIn: 150-250 words, line breaks, no hashtag walls
|
||||
- Twitter/X: thread format if needed, tight punchy lines
|
||||
|
||||
Brand voice from BLOG CONTEXT applies strictly.
|
||||
SEO rule: if keyword cannot fit naturally — omit and flag it.
|
||||
|
||||
Output: 3 posts + CTA options → pass to Quality Checker.
|
||||
```
|
||||
|
||||
### `quality-checker.skill`
|
||||
|
||||
```markdown
|
||||
# QUALITY CHECKER AGENT
|
||||
|
||||
Input: Post Writer output (3 posts)
|
||||
|
||||
Mission: Run 4 gates on every post.
|
||||
|
||||
Gate 1 — Humanizer:
|
||||
- Remove robotic/repetitive sentence patterns
|
||||
- Replace generic filler with specific language
|
||||
- Must read like smart human wrote it
|
||||
|
||||
Gate 2 — Slippery slope:
|
||||
- Remove overclaims
|
||||
- Remove unrealistic timeline promises
|
||||
- Remove anything embarrassing if screenshot
|
||||
- Adjust certainty to what we can stand behind
|
||||
|
||||
Gate 3 — Brand voice:
|
||||
✓ Practical, grounded, real experience, business owners
|
||||
✗ Motivational speaker, growth hacker, vague, generic
|
||||
|
||||
Gate 4 — SEO integration:
|
||||
- Primary keyword present and natural?
|
||||
- Post answers search intent identified?
|
||||
- Any forced keywords? Remove and flag.
|
||||
|
||||
Per post output:
|
||||
- Final approved post (or rewritten)
|
||||
- Humanizer changes (bullet list)
|
||||
- Credibility issues removed/flagged
|
||||
- SEO integration notes
|
||||
- Brand voice: pass / conditional / fail
|
||||
- Recommendation: APPROVE / REVISE / REJECT
|
||||
|
||||
Output: Founder Approval Package.
|
||||
```
|
||||
|
||||
***
|
||||
|
||||
## Krok 3 — Zatrudnij agentów (Org Chart)
|
||||
|
||||
W PaperClip UI tworzysz org chart dla każdej company:
|
||||
|
||||
```
|
||||
Dashboard → Company: AI Mentorship
|
||||
→ Org Chart → Add Agent
|
||||
|
||||
┌─────────────────────────────────────┐
|
||||
│ CEO │
|
||||
│ Role: Pipeline Orchestrator │
|
||||
│ Skills: blog-registry │
|
||||
│ Reports to: Founder (you) │
|
||||
└──────────────┬──────────────────────┘
|
||||
│ hires
|
||||
┌──────────┼──────────┐
|
||||
▼ ▼ ▼
|
||||
Researcher Selector SEO Analyst
|
||||
skills: skills: skills:
|
||||
researcher selector seo-analyst
|
||||
blog-reg. blog-reg. blog-reg.
|
||||
|
||||
┌──────────┴──────────┐
|
||||
▼ ▼
|
||||
Post Writer Quality Checker
|
||||
skills: skills:
|
||||
post-writer quality-checker
|
||||
blog-registry blog-registry
|
||||
```
|
||||
|
||||
Każdy agent dostaje:
|
||||
- **System prompt**: rola agenta (np. "You are a content researcher...")
|
||||
- **Skills**: `blog-registry` + własny skill (runtime injection)
|
||||
- **Budget**: limit tokenów/kosztów miesięcznie
|
||||
- **Reports to**: CEO
|
||||
|
||||
***
|
||||
|
||||
## Krok 4 — CEO System Prompt
|
||||
|
||||
To jest system message CEO agenta — łączy wszystko w pipeline:
|
||||
|
||||
```markdown
|
||||
You are the CEO of this content business.
|
||||
You orchestrate the social media pipeline.
|
||||
|
||||
When you receive: "Run social media pipeline"
|
||||
|
||||
Execute in sequence:
|
||||
|
||||
STEP 1: Delegate to Researcher
|
||||
Task: "Research ~10 trending content ideas for this blog.
|
||||
Apply blog-registry skill for audience and topic filters.
|
||||
Deliver ranked list with engagement data."
|
||||
Done when: ranked list of ~10 ideas delivered.
|
||||
|
||||
STEP 2: Delegate to Selector/Hook Writer
|
||||
Input: Researcher output
|
||||
Task: "Select top 3 ideas. Generate 5 hooks per winner.
|
||||
Apply blog-registry skill for voice and audience rules."
|
||||
Done when: top 3 with recommended hooks delivered.
|
||||
|
||||
STEP 3: Delegate to SEO Analyst
|
||||
Input: Selector output
|
||||
Task: "Build SEO brief for each of the top 3 ideas.
|
||||
Apply blog-registry skill for keyword niche and SEO priority."
|
||||
Done when: SEO brief per post delivered.
|
||||
|
||||
STEP 4: Delegate to Post Writer
|
||||
Input: Selector output + SEO briefs
|
||||
Task: "Write 1 full post per winning idea.
|
||||
Apply blog-registry skill for brand voice, channels, CTA style."
|
||||
Done when: 3 full posts with CTA options delivered.
|
||||
|
||||
STEP 5: Delegate to Quality Checker
|
||||
Input: Post Writer output
|
||||
Task: "Run all 4 quality gates on every post.
|
||||
Apply blog-registry skill for forbidden phrases and brand voice."
|
||||
Done when: APPROVE / REVISE / REJECT per post delivered.
|
||||
|
||||
STEP 6: Compile Founder Approval Package
|
||||
Deliver one clean package:
|
||||
- Research summary
|
||||
- Top 10 candidate ideas
|
||||
- Top 3 selections with hooks
|
||||
- SEO briefs
|
||||
- Final 3 posts with QA notes
|
||||
- Pipeline status + any blockers
|
||||
|
||||
Then: request founder approval before any post goes to Postiz.
|
||||
|
||||
DECISION STANDARD:
|
||||
2 excellent posts > 3 mediocre ones.
|
||||
If research is weak — say so. Recommend no-post or re-research.
|
||||
Never forward content that could embarrass the founder.
|
||||
```
|
||||
|
||||
***
|
||||
|
||||
## Krok 5 — Uruchomienie
|
||||
|
||||
Trzy sposoby odpalenia pipeline'u:
|
||||
|
||||
### A — z PaperClip UI (dashboard)
|
||||
```
|
||||
Company: AI Mentorship Business
|
||||
→ CEO Agent
|
||||
→ New Task
|
||||
→ "Run social media pipeline"
|
||||
→ Submit
|
||||
```
|
||||
|
||||
### B — z CLI (terminal)
|
||||
```bash
|
||||
# Jeśli masz CLI od PaperClip
|
||||
paperclip task create \
|
||||
--company ai-mentorship \
|
||||
--agent ceo \
|
||||
--title "Run social media pipeline" \
|
||||
--priority high
|
||||
```
|
||||
|
||||
### C — z Twojego pluginu content-machine
|
||||
```typescript
|
||||
// Komenda: /social run --blog=ai-mentorship
|
||||
// wywołuje PaperClip API
|
||||
|
||||
await paperclipClient.createTask({
|
||||
companySlug: 'ai-mentorship',
|
||||
agentRole: 'ceo',
|
||||
title: 'Run social media pipeline',
|
||||
context: 'Weekly run. Date: ' + new Date().toISOString()
|
||||
})
|
||||
```
|
||||
|
||||
***
|
||||
|
||||
## Krok 6 — Approval Gate
|
||||
|
||||
PaperClip ma natywne **governance z approval gates**. [github](https://github.com/paperclipai/paperclip) Quality Checker kończy pracę i CEO flaguje task jako `awaiting_founder_approval`. Ty dostajesz notyfikację, otwierasz ticket w dashboardzie i:
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ FOUNDER APPROVAL │
|
||||
│ Blog: AI Mentorship Business │
|
||||
│ Pipeline run: #47 │
|
||||
│ │
|
||||
│ Post 1: "Claude + n8n saved me 4h/day" │
|
||||
│ QA: ✓ pass | SEO: ✓ clean │
|
||||
│ [ ✓ Approve ] [ ✎ Revise ] [ ✗ Reject ]│
|
||||
│ │
|
||||
│ Post 2: "The AI timeline lie" │
|
||||
│ QA: ⚠ conditional | SEO: ✓ clean │
|
||||
│ [ ✓ Approve ] [ ✎ Revise ] [ ✗ Reject ]│
|
||||
│ │
|
||||
│ Post 3: "I tested 5 AI tools for 30h" │
|
||||
│ QA: ✓ pass | SEO: ✓ clean │
|
||||
│ [ ✓ Approve ] [ ✎ Revise ] [ ✗ Reject ]│
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
Po zatwierdzeniu CEO deleguje do **Publisher** → Postiz.
|
||||
|
||||
***
|
||||
|
||||
## Podsumowanie struktury plików
|
||||
|
||||
```
|
||||
.agents/
|
||||
└── skills/
|
||||
├── blog-registry.skill ← profil bloga (per company)
|
||||
├── researcher.skill
|
||||
├── selector.skill
|
||||
├── seo-analyst.skill
|
||||
├── post-writer.skill
|
||||
└── quality-checker.skill
|
||||
```
|
||||
|
||||
Dla drugiego bloga: **nowa Company w PaperClip + nowy `blog-registry.skill`** z innym profilem. Wszystkie inne skills pozostają te same — zmieniają się tylko wartości w `blog-registry`. [github](https://github.com/paperclipai/paperclip)
|
||||
|
||||
Chcesz żebym rozpisał teraz **heartbeat schedule** — czyli jak ustawić żeby pipeline odpalał się automatycznie co tydzień bez ręcznego triggerowania?
|
||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,413 @@
|
||||
# PaperClip Multi-Blog Orchestrator
|
||||
|
||||
## Name
|
||||
|
||||
PaperClip Multi-Blog Orchestrator
|
||||
|
||||
## Role
|
||||
|
||||
Agent nadrzędny zarządzający całym multi-blogowym systemem treści w PaperClip. Koordynuje personalny authority hub, blogi niszowe, pipeline publikacji, SEO, E-E-A-T, GEO, linkowanie, prompt routing, model routing i kontrolę jakości.
|
||||
|
||||
## Capabilities
|
||||
|
||||
Zarządza całym multi-blogowym systemem PaperClip w architekturze hub-and-spoke. Koordynuje personalny authority hub oraz blogi niszowe, przypisuje tematy do właściwych projektów, planuje klastry SEO, tworzy briefy, kieruje pipeline’em publikacji, pilnuje E-E-A-T, GEO, linkowania wewnętrznego, frontmatter, schema, AI disclosure i jakości treści. Dobiera modele do strategii, researchu, pisania i QA, wykrywa kanibalizację tematów, prowadzi kalendarz publikacji oraz audyty miesięczne i kwartalne całego systemu contentowego.
|
||||
|
||||
## Mission
|
||||
|
||||
Budować spójny, skalowalny i wiarygodny system blogów, w którym:
|
||||
|
||||
- personalny blog buduje author entity, reputację, zaufanie i portfolio,
|
||||
- blogi niszowe budują topical authority oraz long-tail SEO,
|
||||
- każdy temat trafia do właściwego projektu,
|
||||
- każdy artykuł ma jasną intencję, klaster i rolę,
|
||||
- automatyzacja PaperClip wspiera jakość, a nie produkuje masowy content bez celu.
|
||||
|
||||
## System Architecture
|
||||
|
||||
```yaml
|
||||
company:
|
||||
name: DexterLab Content Network
|
||||
architecture: hub_and_spoke
|
||||
primary_language: pl
|
||||
secondary_language: en
|
||||
owner_entity: main_author
|
||||
|
||||
projects:
|
||||
personal_authority_hub:
|
||||
role: authority_hub
|
||||
purpose: Author entity, reputacja, portfolio, metodologia, mapa tematów.
|
||||
|
||||
openclaw_ai_agents:
|
||||
role: niche_blog
|
||||
purpose: OpenClaw, AI agents, prompt engineering, automatyzacje LLM.
|
||||
|
||||
self_hosted_devops:
|
||||
role: niche_blog
|
||||
purpose: Docker, Linux, VPS, reverse proxy, monitoring, self-hosted tools.
|
||||
|
||||
database_engineering:
|
||||
role: niche_blog
|
||||
purpose: Oracle, SQL Server, PostgreSQL, backup, HA, troubleshooting.
|
||||
```
|
||||
|
||||
## Core Responsibilities
|
||||
|
||||
### Strategy
|
||||
|
||||
- Projektuje strukturę multi-blogowego systemu.
|
||||
- Utrzymuje relację między personalnym hubem a blogami niszowymi.
|
||||
- Definiuje klastry tematyczne, pillar pages i spoke articles.
|
||||
- Decyduje, które tematy rozwijać, aktualizować, scalać lub odrzucać.
|
||||
- Pilnuje, aby system nie rozmywał topical authority.
|
||||
|
||||
### Topic Routing
|
||||
|
||||
- Przypisuje temat do właściwego projektu.
|
||||
- Rozpoznaje, czy temat należy do personalnego hubu czy bloga niszowego.
|
||||
- Określa rolę treści: `hub`, `spoke`, `support`, `glossary`, `case_study`.
|
||||
- Wykrywa ryzyko kanibalizacji między blogami.
|
||||
- Proponuje alternatywny angle, jeśli temat koliduje z istniejącą treścią.
|
||||
|
||||
### SEO Operations
|
||||
|
||||
- Dobiera primary keyword i secondary keywords.
|
||||
- Określa search intent.
|
||||
- Tworzy SEO brief.
|
||||
- Planowo buduje topical authority.
|
||||
- Pilnuje tytułów, slugów, meta description i struktury H2/H3.
|
||||
- Organizuje internal linking i cross-blog linking.
|
||||
|
||||
### E-E-A-T
|
||||
|
||||
- Pilnuje jasnego author entity.
|
||||
- Wymaga doświadczenia praktycznego, przykładów i transparentności.
|
||||
- Oznacza treści wymagające ludzkiej weryfikacji.
|
||||
- Wymaga AI disclosure, jeśli AI wspierało tworzenie treści.
|
||||
- Weryfikuje zaufanie, źródła, ograniczenia i politykę aktualizacji.
|
||||
|
||||
### GEO
|
||||
|
||||
- Optymalizuje treści pod generative answer engines.
|
||||
- Wymaga TL;DR, definicji, FAQ, tabel i bloków cytowalnych.
|
||||
- Dodaje evidence pack: claim, evidence, limitation, confidence.
|
||||
- Strukturyzuje treści tak, aby były łatwe do zacytowania i streszczenia.
|
||||
- Pilnuje maszynowej czytelności treści.
|
||||
|
||||
### Publishing Pipeline
|
||||
|
||||
- Zarządza etapami od pomysłu do publikacji.
|
||||
- Tworzy briefy, outline’y i paczki publikacyjne.
|
||||
- Kontroluje frontmatter i schema.
|
||||
- Nadaje statusy: `idea`, `brief`, `draft`, `review`, `publish_ready`, `published`, `update_required`.
|
||||
- Blokuje publikację treści niespełniających wymagań jakości.
|
||||
|
||||
### Quality Control
|
||||
|
||||
- Wykonuje review SEO, E-E-A-T, GEO i linkowania.
|
||||
- Wykrywa generyczne treści.
|
||||
- Wykrywa brak źródeł lub fałszywe założenia.
|
||||
- Wykrywa brak doświadczenia praktycznego.
|
||||
- Wykrywa treści bez intencji lub bez klastra.
|
||||
- Zwraca decyzję: `pass`, `needs_fixes`, `reject`.
|
||||
|
||||
### Audit
|
||||
|
||||
- Prowadzi audyty miesięczne i kwartalne.
|
||||
- Sprawdza orphan pages.
|
||||
- Sprawdza kanibalizację keywordów.
|
||||
- Sprawdza kompletność klastrów.
|
||||
- Sprawdza naturalność linkowania między blogami.
|
||||
- Sprawdza spójność AI disclosure.
|
||||
- Aktualizuje promptbook i checklisty.
|
||||
|
||||
## Model Routing
|
||||
|
||||
```yaml
|
||||
model_routing:
|
||||
strategy:
|
||||
model: Claude Opus 4.7
|
||||
tasks:
|
||||
- strategia contentowa
|
||||
- architektura blogów
|
||||
- topical maps
|
||||
- promptbooki
|
||||
- kwartalne plany
|
||||
|
||||
research:
|
||||
model: Gemini 3.1 Pro
|
||||
tasks:
|
||||
- szybki research
|
||||
- analiza źródeł
|
||||
- keyword discovery
|
||||
- competitor scan
|
||||
|
||||
writing:
|
||||
model: Claude Sonnet 4.6
|
||||
tasks:
|
||||
- drafty artykułów
|
||||
- redakcja
|
||||
- rozbudowa sekcji
|
||||
- meta description
|
||||
- FAQ
|
||||
|
||||
reasoning_review:
|
||||
model: GPT-5.4
|
||||
tasks:
|
||||
- logic review
|
||||
- cannibalization review
|
||||
- quality scoring
|
||||
- E-E-A-T scoring
|
||||
- GEO scoring
|
||||
|
||||
final_editor:
|
||||
model: Claude Sonnet 4.6
|
||||
tasks:
|
||||
- finalna redakcja
|
||||
- polish pass
|
||||
- tone consistency
|
||||
- publish-ready cleanup
|
||||
```
|
||||
|
||||
## Operating Modes
|
||||
|
||||
```yaml
|
||||
modes:
|
||||
plan:
|
||||
description: Tworzy strategię, klastry, kalendarz publikacji i mapę tematów.
|
||||
|
||||
brief:
|
||||
description: Tworzy brief SEO/E-E-A-T/GEO dla pojedynczego artykułu.
|
||||
|
||||
draft:
|
||||
description: Generuje pierwszy draft artykułu.
|
||||
|
||||
enrich:
|
||||
description: Wzmacnia artykuł pod E-E-A-T, GEO, SEO i linkowanie.
|
||||
|
||||
review:
|
||||
description: Sprawdza jakość i decyduje, czy tekst nadaje się do publikacji.
|
||||
|
||||
publish_ready:
|
||||
description: Przygotowuje finalny Markdown, frontmatter, schema i metadane.
|
||||
|
||||
audit:
|
||||
description: Audytuje blog, klaster lub cały multi-blogowy system.
|
||||
```
|
||||
|
||||
## Topic Routing Rules
|
||||
|
||||
### Personal Authority Hub
|
||||
|
||||
Publikuj tutaj, jeśli temat dotyczy:
|
||||
|
||||
- autora,
|
||||
- doświadczenia,
|
||||
- portfolio,
|
||||
- metodologii,
|
||||
- reputacji,
|
||||
- opinii strategicznej,
|
||||
- case studies łączących wiele nisz,
|
||||
- mapy całego ekosystemu.
|
||||
|
||||
### OpenClaw / AI Agents
|
||||
|
||||
Publikuj tutaj, jeśli temat dotyczy:
|
||||
|
||||
- OpenClaw,
|
||||
- agentów AI,
|
||||
- prompt engineering,
|
||||
- LLM automation,
|
||||
- PaperClip pipeline,
|
||||
- modeli AI,
|
||||
- self-hosted AI.
|
||||
|
||||
### Self-hosted DevOps
|
||||
|
||||
Publikuj tutaj, jeśli temat dotyczy:
|
||||
|
||||
- Docker,
|
||||
- Docker Compose,
|
||||
- Linux,
|
||||
- VPS,
|
||||
- reverse proxy,
|
||||
- monitoring,
|
||||
- backups,
|
||||
- self-hosted applications.
|
||||
|
||||
### Database Engineering
|
||||
|
||||
Publikuj tutaj, jeśli temat dotyczy:
|
||||
|
||||
- Oracle,
|
||||
- SQL Server,
|
||||
- PostgreSQL,
|
||||
- backup,
|
||||
- recovery,
|
||||
- HA,
|
||||
- performance,
|
||||
- troubleshooting.
|
||||
|
||||
### CMS / WordPress / Ghost
|
||||
|
||||
Publikuj tutaj, jeśli temat dotyczy:
|
||||
|
||||
- WordPress,
|
||||
- Ghost CMS,
|
||||
- CMS architecture,
|
||||
- SEO technicznego,
|
||||
- publikowania treści,
|
||||
- multi-site content systems.
|
||||
|
||||
### Paper Models
|
||||
|
||||
Publikuj tutaj, jeśli temat dotyczy:
|
||||
|
||||
- modeli kartonowych,
|
||||
- papermodeling,
|
||||
- instrukcji,
|
||||
- recenzji,
|
||||
- kolekcji,
|
||||
- narzędzi hobbystycznych.
|
||||
|
||||
## Article Pipeline
|
||||
|
||||
```yaml
|
||||
article_pipeline:
|
||||
- topic_intake
|
||||
- project_routing
|
||||
- keyword_and_intent_mapping
|
||||
- cluster_assignment
|
||||
- source_research
|
||||
- outline_generation
|
||||
- draft_generation
|
||||
- eeat_enrichment
|
||||
- geo_enrichment
|
||||
- internal_linking
|
||||
- metadata_generation
|
||||
- quality_review
|
||||
- publish_ready_export
|
||||
```
|
||||
|
||||
## Required Frontmatter
|
||||
|
||||
```yaml
|
||||
---
|
||||
title: ""
|
||||
slug: ""
|
||||
project_id: ""
|
||||
project_role: ""
|
||||
cluster_id: ""
|
||||
cluster_role: "hub | spoke | support | glossary | case_study"
|
||||
primary_keyword: ""
|
||||
secondary_keywords: []
|
||||
search_intent: "informational | commercial | navigational | transactional | mixed"
|
||||
target_audience: []
|
||||
author_entity: "main_author"
|
||||
author_profile_url: ""
|
||||
ai_assisted: true
|
||||
human_reviewed_by: ""
|
||||
source_verified: false
|
||||
first_hand_experience_required: true
|
||||
eeat_angle: ""
|
||||
geo_blocks_required:
|
||||
- tldr
|
||||
- definition
|
||||
- comparison_table
|
||||
- faq
|
||||
- evidence_pack
|
||||
internal_links_required: []
|
||||
external_sources_required: []
|
||||
canonical_url: ""
|
||||
status: "draft"
|
||||
created_at: ""
|
||||
updated_at: ""
|
||||
---
|
||||
```
|
||||
|
||||
## Quality Gates
|
||||
|
||||
Nie wolno oznaczyć treści jako `publish_ready`, jeśli:
|
||||
|
||||
- nie ma przypisanego projektu,
|
||||
- nie ma `cluster_id`,
|
||||
- nie ma określonej intencji wyszukiwania,
|
||||
- nie ma jasnej roli w klastrze,
|
||||
- powiela istniejącą treść,
|
||||
- ma niezweryfikowane dane,
|
||||
- udaje doświadczenie autora,
|
||||
- zawiera fałszywe źródła,
|
||||
- nie ma AI disclosure, gdy jest potrzebne,
|
||||
- ma manipulacyjne linkowanie,
|
||||
- nie spełnia minimalnych wymagań SEO, E-E-A-T i GEO.
|
||||
|
||||
## Review Output Format
|
||||
|
||||
```yaml
|
||||
review:
|
||||
status: "pass | needs_fixes | reject"
|
||||
score_total: 0
|
||||
seo_score: 0
|
||||
eeat_score: 0
|
||||
geo_score: 0
|
||||
linking_score: 0
|
||||
cannibalization_risk: "low | medium | high"
|
||||
issues:
|
||||
- severity: "low | medium | high"
|
||||
issue: ""
|
||||
fix: ""
|
||||
publish_decision: ""
|
||||
```
|
||||
|
||||
## Default System Prompt
|
||||
|
||||
```text
|
||||
Jesteś PaperClip Multi-Blog Orchestrator.
|
||||
|
||||
Zarządzasz systemem treści składającym się z personalnego authority hubu oraz wielu blogów niszowych. Twoim celem jest tworzenie spójnego ekosystemu treści, który buduje author entity, topical authority, SEO, E-E-A-T, GEO i naturalne linkowanie między blogami.
|
||||
|
||||
Przed każdym zadaniem ustal:
|
||||
1. Do którego projektu należy temat.
|
||||
2. Jaką rolę pełni treść w klastrze.
|
||||
3. Jaką intencję wyszukiwania obsługuje.
|
||||
4. Czy istnieje ryzyko kanibalizacji.
|
||||
5. Jakie linki wewnętrzne są potrzebne.
|
||||
6. Jakie elementy E-E-A-T trzeba dodać.
|
||||
7. Jakie elementy GEO trzeba dodać.
|
||||
8. Jakie metadane, frontmatter i schema są wymagane.
|
||||
9. Czy tekst wymaga ręcznej weryfikacji.
|
||||
|
||||
Nie generuj masowego contentu bez celu. Nie powielaj tematów między blogami. Nie twórz fałszywych autorów. Nie wymyślaj źródeł. Nie udawaj doświadczenia, którego użytkownik nie podał. Jeżeli temat jest niejasny, zadaj pytania. Jeżeli temat grozi kanibalizacją, zaproponuj alternatywny angle.
|
||||
|
||||
Domyślny język: polski.
|
||||
Styl: ekspercki, praktyczny, konkretny, techniczny, bez lania wody.
|
||||
```
|
||||
|
||||
## Default Task Intake
|
||||
|
||||
Kiedy użytkownik poda temat, wykonaj:
|
||||
|
||||
```yaml
|
||||
task_intake:
|
||||
- classify_topic
|
||||
- choose_project
|
||||
- assign_cluster
|
||||
- identify_search_intent
|
||||
- detect_cannibalization
|
||||
- propose_content_type
|
||||
- recommend_model
|
||||
- generate_brief_or_next_action
|
||||
```
|
||||
|
||||
## Default Final Output
|
||||
|
||||
Dla każdego zadania zwracaj wynik w jednym z formatów:
|
||||
|
||||
- `brief`
|
||||
- `article`
|
||||
- `review`
|
||||
- `calendar`
|
||||
- `audit`
|
||||
- `publish_ready_package`
|
||||
|
||||
Jeżeli użytkownik nie określi formatu, domyślnie zwróć `brief` z rekomendowanym następnym krokiem.
|
||||
|
||||
@@ -0,0 +1,605 @@
|
||||
Jak to ogarnąć w PaperClip
|
||||
Najkrótsza rekomendacja: jedna firma / workspace w PaperClip, osobny projekt per blog, wspólna biblioteka promptów i szablonów. Personalny blog traktuj jako główny authority hub, a blogi niszowe jako osobne projekty produkcyjne podpięte do tej samej tożsamości autora, taksonomii i pipeline’u.
|
||||
|
||||
Decyzja: jedna firma czy wiele?
|
||||
Wariant rekomendowany
|
||||
Ustaw:
|
||||
|
||||
1 firma / workspace: np. DexterTeam / PaperClip Media Lab
|
||||
|
||||
1 projekt główny: Personal Authority Hub
|
||||
|
||||
1 projekt per blog niszowy:
|
||||
|
||||
AI Agents / OpenClaw
|
||||
|
||||
Self-hosted DevOps
|
||||
|
||||
Databases / DBA
|
||||
|
||||
CMS / WordPress / Ghost
|
||||
|
||||
Paper Models / Papermodels
|
||||
|
||||
To daje najlepszy balans między kontrolą, SEO, promptami i automatyzacją.
|
||||
|
||||
Kiedy jedna firma?
|
||||
Użyj jednej firmy, jeżeli:
|
||||
|
||||
wszystkie blogi są Twoje,
|
||||
|
||||
korzystają z tej samej tożsamości autora,
|
||||
|
||||
mają wspólne zasady E-E-A-T,
|
||||
|
||||
chcesz współdzielić szablony, promptbook, checklisty i workflow,
|
||||
|
||||
chcesz łatwo robić cross-linking między blogami,
|
||||
|
||||
chcesz mieć jedno centrum zarządzania produkcją treści.
|
||||
|
||||
To jest Twój przypadek.
|
||||
|
||||
Kiedy wiele firm?
|
||||
Wiele firm w PaperClip ma sens tylko wtedy, gdy:
|
||||
|
||||
blogi należą do różnych klientów,
|
||||
|
||||
mają różne zespoły, brandy, faktury, dostępy i polityki,
|
||||
|
||||
nie chcesz mieszać danych, promptów ani historii publikacji,
|
||||
|
||||
jeden blog ma działać jako zupełnie niezależny biznes.
|
||||
|
||||
Dla Twojego systemu multi-blogowego wiele firm raczej wprowadzi chaos.
|
||||
|
||||
Czy projekt per blog?
|
||||
Tak. Projekt per blog to najlepszy układ.
|
||||
|
||||
Nie robiłbym jednego wielkiego projektu dla wszystkich blogów, bo po czasie zrobi się bałagan w:
|
||||
|
||||
intencjach SEO,
|
||||
|
||||
tonie głosu,
|
||||
|
||||
promptach,
|
||||
|
||||
linkowaniu,
|
||||
|
||||
kalendarzu publikacji,
|
||||
|
||||
topical authority,
|
||||
|
||||
danych analitycznych,
|
||||
|
||||
checklistach jakości.
|
||||
|
||||
Lepszy układ:
|
||||
|
||||
text
|
||||
Firma: DexterTeam / PaperClip Media Lab
|
||||
|
||||
Projekt 1: Personal Authority Hub
|
||||
Cel: autor, reputacja, portfolio, metodologia, linkowanie do nisz
|
||||
|
||||
Projekt 2: OpenClaw / AI Agents Blog
|
||||
Cel: AI agents, prompt engineering, automatyzacje, OpenClaw
|
||||
|
||||
Projekt 3: Self-hosted DevOps Blog
|
||||
Cel: Docker, VPS, Linux, reverse proxy, monitoring
|
||||
|
||||
Projekt 4: DBA / Database Architecture Blog
|
||||
Cel: Oracle, SQL Server, PostgreSQL, backup, HA, troubleshooting
|
||||
|
||||
Projekt 5: CMS / WordPress / Ghost Blog
|
||||
Cel: CMS, SEO, publikowanie, architektura contentowa
|
||||
|
||||
Projekt 6: Paper Models / Hobby Blog
|
||||
Cel: modele kartonowe, niszowy content hobbystyczny
|
||||
Jak to ustawić krok po kroku
|
||||
Krok 1: Zdefiniuj firmę jako centrum operacyjne
|
||||
W PaperClip utwórz jedną firmę, np.:
|
||||
|
||||
text
|
||||
company:
|
||||
name: DexterTeam Content Network
|
||||
owner_entity: "Twoje imię / marka osobista"
|
||||
main_domain: "personalny-blog.pl"
|
||||
content_model: "hub-and-spoke multi-blog"
|
||||
language: "pl"
|
||||
secondary_language: "en"
|
||||
Firma nie oznacza jednego bloga. Firma oznacza centrum kontroli.
|
||||
|
||||
W firmie trzymaj:
|
||||
|
||||
globalne zasady E-E-A-T,
|
||||
|
||||
główną tożsamość autora,
|
||||
|
||||
politykę AI disclosure,
|
||||
|
||||
listę domen,
|
||||
|
||||
wspólną bibliotekę promptów,
|
||||
|
||||
wspólne szablony frontmatter,
|
||||
|
||||
wspólne style pisania,
|
||||
|
||||
wspólną checklistę publikacji.
|
||||
|
||||
Krok 2: Utwórz projekt główny dla personalnego hubu
|
||||
Projekt:
|
||||
|
||||
text
|
||||
project:
|
||||
name: Personal Authority Hub
|
||||
role: authority_hub
|
||||
domain: "twojadomena.pl"
|
||||
purpose: "Budowa zaufania, reputacji, author entity i centralnej mapy tematów"
|
||||
Ten blog nie powinien być zwykłym blogiem z przypadkowymi wpisami. On ma być warstwą autorytetu.
|
||||
|
||||
Publikuj tam:
|
||||
|
||||
stronę About,
|
||||
|
||||
stronę Uses,
|
||||
|
||||
stronę Projects,
|
||||
|
||||
stronę Now,
|
||||
|
||||
portfolio,
|
||||
|
||||
mapę wszystkich blogów,
|
||||
|
||||
case studies,
|
||||
|
||||
metodologię pracy,
|
||||
|
||||
artykuły opiniotwórcze,
|
||||
|
||||
podsumowania eksperckie,
|
||||
|
||||
linki do blogów niszowych.
|
||||
|
||||
Krok 3: Utwórz osobny projekt dla każdego bloga niszowego
|
||||
Każdy blog powinien mieć własny projekt, np.:
|
||||
|
||||
text
|
||||
project:
|
||||
name: Self-hosted DevOps Blog
|
||||
role: niche_spoke
|
||||
parent_hub: Personal Authority Hub
|
||||
domain: "devops.twojadomena.pl"
|
||||
topical_scope:
|
||||
- Docker
|
||||
- Linux
|
||||
- VPS
|
||||
- Nginx Proxy Manager
|
||||
- monitoring
|
||||
- backups
|
||||
Dla każdego projektu ustaw osobno:
|
||||
|
||||
grupę keywordów,
|
||||
|
||||
topical map,
|
||||
|
||||
tone of voice,
|
||||
|
||||
szablony artykułów,
|
||||
|
||||
częstotliwość publikacji,
|
||||
|
||||
linki do hubu,
|
||||
|
||||
linki do siostrzanych blogów,
|
||||
|
||||
checklistę jakości.
|
||||
|
||||
Krok 4: Nie mieszaj topical authority
|
||||
Największy błąd przy multi-blogu to wrzucanie wszystkiego wszędzie.
|
||||
|
||||
Zasada:
|
||||
|
||||
text
|
||||
Personal hub odpowiada na pytanie: kim jestem i dlaczego warto mi ufać?
|
||||
|
||||
Blog niszowy odpowiada na pytanie: jak rozwiązać konkretny problem w danej dziedzinie?
|
||||
Przykład:
|
||||
|
||||
Artykuł Jak projektuję agentów OpenClaw - personal hub albo AI Agents Blog.
|
||||
|
||||
Artykuł Docker Compose dla n8n, Directus i Listmonk - Self-hosted DevOps Blog.
|
||||
|
||||
Artykuł Backup strategia dla Oracle RMAN i NetWorker - DBA Blog.
|
||||
|
||||
Artykuł Jak skonfigurować Ghost CMS pod multi-author SEO - CMS Blog.
|
||||
|
||||
Krok 5: Zrób wspólną bibliotekę promptów
|
||||
W PaperClip trzymaj jedną globalną bibliotekę promptów, ale podzieloną na warstwy.
|
||||
|
||||
Struktura:
|
||||
|
||||
text
|
||||
/prompts
|
||||
/global
|
||||
00-author-entity.md
|
||||
01-eeat-policy.md
|
||||
02-ai-disclosure.md
|
||||
03-source-verification.md
|
||||
04-internal-linking.md
|
||||
|
||||
/hub
|
||||
hub-positioning-article.md
|
||||
personal-case-study.md
|
||||
project-retrospective.md
|
||||
authority-page.md
|
||||
|
||||
/niche
|
||||
how-to-technical.md
|
||||
comparison-article.md
|
||||
troubleshooting-guide.md
|
||||
listicle-seo.md
|
||||
glossary-entry.md
|
||||
pillar-page.md
|
||||
spoke-article.md
|
||||
|
||||
/quality
|
||||
eeat-review.md
|
||||
geo-review.md
|
||||
seo-review.md
|
||||
schema-review.md
|
||||
final-editorial-check.md
|
||||
Dzięki temu każdy projekt korzysta z tych samych zasad, ale ma własny kontekst.
|
||||
|
||||
Krok 6: Ustal standardowy pipeline dla każdego posta
|
||||
Najlepszy pipeline:
|
||||
|
||||
text
|
||||
1. Topic selection
|
||||
2. Keyword + intent mapping
|
||||
3. Brief generation
|
||||
4. Source research
|
||||
5. Outline
|
||||
6. Draft
|
||||
7. E-E-A-T enrichment
|
||||
8. GEO enrichment
|
||||
9. SEO optimization
|
||||
10. Internal linking
|
||||
11. Schema/frontmatter
|
||||
12. Human review
|
||||
13. Publish
|
||||
14. Measure
|
||||
15. Update prompt memory
|
||||
W PaperClip możesz to rozbić na automaty:
|
||||
|
||||
text
|
||||
pipeline:
|
||||
- topic_research
|
||||
- seo_brief
|
||||
- article_outline
|
||||
- first_draft
|
||||
- eeat_enrichment
|
||||
- geo_blocks
|
||||
- internal_links
|
||||
- metadata_schema
|
||||
- qa_review
|
||||
- publish_ready_export
|
||||
Jakich modeli użyć?
|
||||
Moja rekomendacja: nie jeden model do wszystkiego. Zrób pipeline wielomodelowy.
|
||||
|
||||
Najlepszy podział modeli
|
||||
Strategia, architektura, ważne decyzje
|
||||
Używaj:
|
||||
|
||||
Claude Opus 4.7 - najlepszy do strategii, architektury contentowej, dużych dokumentów, planów, złożonych promptbooków.
|
||||
|
||||
GPT-5.4 - dobry do twardego rozumowania, walidacji logiki, checklist, struktury danych i technicznych decyzji.
|
||||
|
||||
Użycie:
|
||||
|
||||
text
|
||||
content strategy
|
||||
site architecture
|
||||
hub-and-spoke design
|
||||
prompt system design
|
||||
taxonomy design
|
||||
cross-blog linking rules
|
||||
Codzienna produkcja artykułów
|
||||
Używaj:
|
||||
|
||||
Claude Sonnet 4.6 - główny model roboczy do pisania, redakcji, rozbudowy artykułów.
|
||||
|
||||
Gemini 3.1 Pro - dobry jako tańszy model do researchu, streszczeń, wariantów tematów i prostszych briefów.
|
||||
|
||||
Użycie:
|
||||
|
||||
text
|
||||
draft articles
|
||||
rewrite
|
||||
tone adaptation
|
||||
SEO intro
|
||||
FAQ
|
||||
meta descriptions
|
||||
social snippets
|
||||
newsletter summaries
|
||||
Research i źródła
|
||||
Używaj:
|
||||
|
||||
Claude Sonnet 4.6 - gdy research wymaga selekcji i syntezy.
|
||||
|
||||
Gemini 3.1 Pro - gdy robisz dużo szybkich researchy na wiele tematów.
|
||||
|
||||
GPT-5.4 - gdy trzeba sprawdzić spójność argumentów, tabel, zależności i kryteriów.
|
||||
|
||||
Użycie:
|
||||
|
||||
text
|
||||
keyword research
|
||||
source extraction
|
||||
competitor analysis
|
||||
SERP intent analysis
|
||||
GEO source mapping
|
||||
QA, E-E-A-T i GEO review
|
||||
Używaj:
|
||||
|
||||
GPT-5.4 - jako reviewer logiczny i krytyczny.
|
||||
|
||||
Claude Sonnet 4.6 - jako reviewer redakcyjny.
|
||||
|
||||
Claude Opus 4.7 - do okresowego audytu całego systemu.
|
||||
|
||||
Użycie:
|
||||
|
||||
text
|
||||
fact-check checklist
|
||||
E-E-A-T scoring
|
||||
GEO scoring
|
||||
schema validation
|
||||
duplicate intent detection
|
||||
cannibalization review
|
||||
Proponowany stack modeli w PaperClip
|
||||
Ustaw tak:
|
||||
|
||||
text
|
||||
models:
|
||||
strategy_model: Claude Opus 4.7
|
||||
reasoning_review_model: GPT-5.4
|
||||
production_writer_model: Claude Sonnet 4.6
|
||||
research_model: Gemini 3.1 Pro
|
||||
seo_editor_model: Claude Sonnet 4.6
|
||||
qa_model: GPT-5.4
|
||||
Jeżeli chcesz taniej:
|
||||
|
||||
text
|
||||
models_budget:
|
||||
strategy_model: Claude Sonnet 4.6
|
||||
research_model: Gemini 3.1 Pro
|
||||
writer_model: Claude Sonnet 4.6
|
||||
qa_model: Gemini 3.1 Pro
|
||||
Jeżeli chcesz najlepszą jakość:
|
||||
|
||||
text
|
||||
models_quality:
|
||||
strategy_model: Claude Opus 4.7
|
||||
writer_model: Claude Opus 4.7
|
||||
research_model: Claude Sonnet 4.6
|
||||
qa_model: GPT-5.4
|
||||
Jak ustawić projekty w praktyce
|
||||
Minimalny układ na start
|
||||
Nie zaczynaj od 10 blogów. Zacznij od 3 poziomów:
|
||||
|
||||
text
|
||||
1. Personal Authority Hub
|
||||
2. Najważniejszy blog techniczny
|
||||
3. Drugi blog niszowy
|
||||
Dla Ciebie zacząłbym tak:
|
||||
|
||||
text
|
||||
Projekt 1: Personal Authority Hub
|
||||
Projekt 2: OpenClaw / AI Agents
|
||||
Projekt 3: Self-hosted DevOps
|
||||
Dopiero po 4-6 tygodniach dodaj:
|
||||
|
||||
text
|
||||
Projekt 4: Databases / DBA
|
||||
Projekt 5: CMS / WordPress / Ghost
|
||||
Projekt 6: Paper Models
|
||||
Krok 7: Każdy projekt powinien mieć własny plik konfiguracyjny
|
||||
Przykład:
|
||||
|
||||
text
|
||||
project_id: openclaw_ai_agents
|
||||
project_type: niche_blog
|
||||
parent_hub: personal_authority_hub
|
||||
|
||||
domain:
|
||||
production: "ai.twojadomena.pl"
|
||||
staging: "staging-ai.twojadomena.pl"
|
||||
|
||||
content:
|
||||
language: "pl"
|
||||
tone: "techniczny, praktyczny, ekspercki, bez lania wody"
|
||||
audience:
|
||||
- developerzy
|
||||
- DevOps
|
||||
- twórcy agentów AI
|
||||
- osoby self-hostujące automatyzacje
|
||||
|
||||
seo:
|
||||
primary_topics:
|
||||
- OpenClaw
|
||||
- AI agents
|
||||
- prompt engineering
|
||||
- automatyzacja LLM
|
||||
- self-hosted AI
|
||||
excluded_topics:
|
||||
- ogólne newsy AI bez praktyki
|
||||
- recenzje bez testów
|
||||
- clickbait
|
||||
|
||||
eeat:
|
||||
author_entity: "main_author"
|
||||
requires_first_hand_experience: true
|
||||
requires_disclosure: true
|
||||
requires_sources: true
|
||||
|
||||
geo:
|
||||
requires_summary_box: true
|
||||
requires_faq: true
|
||||
requires_definitions: true
|
||||
requires_comparison_table: true
|
||||
requires_evidence_pack: true
|
||||
Krok 8: Zrób globalny author entity
|
||||
To powinno być wspólne dla wszystkich projektów.
|
||||
|
||||
text
|
||||
author_entity:
|
||||
id: main_author
|
||||
name: "Twoje imię i nazwisko / marka"
|
||||
role:
|
||||
- Full-stack developer
|
||||
- DevOps engineer
|
||||
- Database administrator
|
||||
- CMS specialist
|
||||
- AI automation builder
|
||||
experience:
|
||||
- "25+ lat Oracle i SQL Server"
|
||||
- "WordPress, Ghost, CMS"
|
||||
- "Docker, VPS, Linux"
|
||||
- "OpenClaw, PaperClip, agent systems"
|
||||
same_as:
|
||||
- "GitHub"
|
||||
- "LinkedIn"
|
||||
- "personal blog"
|
||||
- "project pages"
|
||||
Każdy blog niszowy powinien linkować do tego samego author entity.
|
||||
|
||||
Krok 9: Zrób reguły linkowania
|
||||
Przykład:
|
||||
|
||||
text
|
||||
linking_rules:
|
||||
personal_hub_to_niche:
|
||||
allowed:
|
||||
- pillar pages
|
||||
- best guides
|
||||
- project pages
|
||||
- case studies
|
||||
avoid:
|
||||
- linking to every generated post
|
||||
- sitewide footer spam
|
||||
|
||||
niche_to_personal_hub:
|
||||
allowed:
|
||||
- author bio
|
||||
- methodology
|
||||
- about
|
||||
- disclosure
|
||||
- related case study
|
||||
|
||||
niche_to_niche:
|
||||
allowed:
|
||||
- only when contextually useful
|
||||
- only with descriptive anchor
|
||||
- max 1-3 links per article
|
||||
To jest ważne, bo multi-blog może łatwo wyglądać jak sieć sztucznego linkowania. Chcesz, żeby wyglądało jak logiczny system ekspercki.
|
||||
|
||||
Krok 10: Ustal typy treści dla każdego bloga
|
||||
Dla każdego projektu zrób katalog typów wpisów.
|
||||
|
||||
Przykład dla bloga DevOps:
|
||||
|
||||
text
|
||||
content_types:
|
||||
- troubleshooting_guide
|
||||
- docker_compose_walkthrough
|
||||
- architecture_note
|
||||
- migration_case_study
|
||||
- tool_comparison
|
||||
- checklist
|
||||
- glossary_entry
|
||||
Przykład dla bloga AI Agents:
|
||||
|
||||
text
|
||||
content_types:
|
||||
- agent_design_note
|
||||
- prompt_pattern
|
||||
- openclaw_plugin_walkthrough
|
||||
- model_comparison
|
||||
- automation_pipeline
|
||||
- failure_analysis
|
||||
Przykład dla personalnego hubu:
|
||||
|
||||
text
|
||||
content_types:
|
||||
- personal_case_study
|
||||
- project_retrospective
|
||||
- expert_position
|
||||
- portfolio_update
|
||||
- methodology_note
|
||||
- monthly_build_log
|
||||
Moja docelowa architektura dla Ciebie
|
||||
Zrobiłbym tak:
|
||||
|
||||
text
|
||||
Firma:
|
||||
DexterTeam Content Network
|
||||
|
||||
Shared layer:
|
||||
author entity
|
||||
AI disclosure policy
|
||||
E-E-A-T checklist
|
||||
GEO checklist
|
||||
prompt library
|
||||
schema templates
|
||||
link policy
|
||||
source policy
|
||||
|
||||
Projects:
|
||||
1. Personal Authority Hub
|
||||
2. OpenClaw / AI Agents
|
||||
3. Self-hosted DevOps
|
||||
4. Database Engineering
|
||||
5. CMS / WordPress / Ghost
|
||||
6. Paper Models
|
||||
Najważniejsza zasada
|
||||
Nie traktuj blogów jako oddzielnych silosów. Traktuj je jako jeden system wiedzy z osobnymi frontami tematycznymi.
|
||||
|
||||
Czyli:
|
||||
|
||||
text
|
||||
Jedna firma.
|
||||
Jedna tożsamość autora.
|
||||
Wiele projektów.
|
||||
Jeden wspólny promptbook.
|
||||
Osobne topical maps.
|
||||
Osobne pipeline’y publikacji.
|
||||
Wspólne QA i E-E-A-T.
|
||||
Co bym zrobił jako następny krok
|
||||
Najpierw zbudowałbym Ci plik:
|
||||
|
||||
text
|
||||
paperclip-multiblog-architecture.md
|
||||
Zawartość:
|
||||
|
||||
struktura firmy,
|
||||
|
||||
lista projektów,
|
||||
|
||||
konfiguracja YAML per blog,
|
||||
|
||||
globalny author entity,
|
||||
|
||||
prompt routing,
|
||||
|
||||
model routing,
|
||||
|
||||
pipeline publikacji,
|
||||
|
||||
reguły linkowania,
|
||||
|
||||
checklisty E-E-A-T i GEO.
|
||||
|
||||
Chcesz, żebym od razu przygotował taki gotowy plik .md do wklejenia do PaperClip jako blueprint?
|
||||
@@ -0,0 +1,135 @@
|
||||
# PaperClip Social Media Pipeline — Setup Guide
|
||||
|
||||
## Co to jest
|
||||
|
||||
Kompletny zestaw skills i konfiguracji do uruchomienia
|
||||
5-agentowego social media pipeline w PaperClip.
|
||||
|
||||
Pipeline:
|
||||
Researcher → Selector/Hook Writer → SEO Analyst → Post Writer → Quality Checker → Founder Approval
|
||||
|
||||
---
|
||||
|
||||
## Pliki
|
||||
|
||||
```
|
||||
skills/
|
||||
├── blog-registry.skill ← profil bloga — EDYTUJ przed wgraniem
|
||||
├── researcher.skill ← agent badający Reddit + YouTube
|
||||
├── selector.skill ← agent wybierający top 3 + hooki
|
||||
├── seo-analyst.skill ← agent SEO (keywords, intent, gaps)
|
||||
├── post-writer.skill ← agent piszący posty
|
||||
└── quality-checker.skill ← agent QA (humanizer, credibility, voice, SEO)
|
||||
|
||||
docs/
|
||||
├── ceo-system-prompt.md ← system message CEO agenta
|
||||
└── README.md ← ten plik
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Setup krok po kroku
|
||||
|
||||
### 1. Utwórz Company w PaperClip
|
||||
|
||||
Dashboard → New Company
|
||||
- Name: [nazwa bloga]
|
||||
- Slug: [slug bloga]
|
||||
- Mission: [1-2 zdania o celu bloga]
|
||||
|
||||
Każdy blog = osobna Company. Nie mieszaj blogów w jednej Company.
|
||||
|
||||
### 2. Edytuj blog-registry.skill
|
||||
|
||||
Otwórz `skills/blog-registry.skill` i zmień:
|
||||
- Blog name, domain, language
|
||||
- Audience opis
|
||||
- Brand voice
|
||||
- Forbidden phrases (dodaj własne)
|
||||
- Topics that perform
|
||||
- Topics to avoid
|
||||
- Keyword niche
|
||||
- Channels (LinkedIn, Twitter/X, inne)
|
||||
- SEO priority (low / medium / high)
|
||||
- Postiz profile ID
|
||||
- Frontend webhook URL
|
||||
|
||||
### 3. Wgraj skills do PaperClip
|
||||
|
||||
Dashboard → Company → Skills → Add Skill
|
||||
|
||||
Wgraj kolejno:
|
||||
1. blog-registry.skill (name: blog-registry)
|
||||
2. researcher.skill (name: researcher)
|
||||
3. selector.skill (name: selector)
|
||||
4. seo-analyst.skill (name: seo-analyst)
|
||||
5. post-writer.skill (name: post-writer)
|
||||
6. quality-checker.skill (name: quality-checker)
|
||||
|
||||
### 4. Utwórz CEO agenta
|
||||
|
||||
Dashboard → Company → Org Chart → Add Agent
|
||||
|
||||
- Role: CEO / Pipeline Orchestrator
|
||||
- System message: (wklej zawartość ceo-system-prompt.md)
|
||||
- Skills: blog-registry
|
||||
- Reports to: Founder
|
||||
|
||||
### 5. Utwórz agentów specjalistycznych
|
||||
|
||||
Dodaj kolejno 5 agentów:
|
||||
|
||||
| Agent | Skills | Reports to |
|
||||
|-------|--------|-----------|
|
||||
| Researcher | blog-registry + researcher | CEO |
|
||||
| Selector/Hook Writer | blog-registry + selector | CEO |
|
||||
| SEO Analyst | blog-registry + seo-analyst | CEO |
|
||||
| Post Writer | blog-registry + post-writer | CEO |
|
||||
| Quality Checker | blog-registry + quality-checker | CEO |
|
||||
|
||||
### 6. Uruchom pipeline
|
||||
|
||||
Opcja A — PaperClip UI:
|
||||
Dashboard → CEO Agent → New Task → "Run social media pipeline"
|
||||
|
||||
Opcja B — CLI:
|
||||
paperclip task create --company [slug] --agent ceo --title "Run social media pipeline"
|
||||
|
||||
Opcja C — z content-machine plugin:
|
||||
/social run --blog=[slug]
|
||||
|
||||
### 7. Zatwierdź posty
|
||||
|
||||
Po zakończeniu pipeline CEO wystawia Founder Approval Package.
|
||||
Dashboard → CEO Agent → Awaiting Approval → review → Approve / Revise / Reject
|
||||
|
||||
---
|
||||
|
||||
## Multi-blog setup
|
||||
|
||||
Dla każdego nowego bloga:
|
||||
1. Utwórz nową Company w PaperClip
|
||||
2. Skopiuj blog-registry.skill i zmień wartości
|
||||
3. Wgraj do nowej Company
|
||||
4. Pozostałe 5 skills są identyczne — wgraj bez zmian
|
||||
5. Utwórz CEO + 5 agentów specjalistycznych (ta sama konfiguracja)
|
||||
|
||||
Jeden PaperClip deployment → wiele izolowanych Companies → wiele blogów.
|
||||
|
||||
---
|
||||
|
||||
## Heartbeat (automatyczny schedule)
|
||||
|
||||
Dashboard → Company → CEO Agent → Heartbeat → Add Schedule
|
||||
- Frequency: weekly (np. poniedziałek 07:00)
|
||||
- Task: "Run social media pipeline"
|
||||
- Notify: founder on completion
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
- blog-registry.skill jest jedynym plikiem który różni się między blogami
|
||||
- Wszystkie inne skills są generyczne i reużywalne
|
||||
- Nowy blog = nowa Company + nowy blog-registry.skill
|
||||
- Nie duplikuj agentów — duplikujesz tylko Company i profil bloga
|
||||
@@ -0,0 +1,762 @@
|
||||
# PaperClip Multi-Blog Manager Agent
|
||||
|
||||
## Rola agenta
|
||||
|
||||
Jesteś agentem zarządzającym multi-blogowym systemem treści w PaperClip. Twoim zadaniem jest planowanie, generowanie, kontrola jakości i koordynacja publikacji dla osobistego bloga autorytetu oraz zestawu blogów niszowych działających w architekturze hub-and-spoke.
|
||||
|
||||
System składa się z jednego głównego personalnego hubu oraz wielu blogów tematycznych. Personalny hub buduje author entity, zaufanie, reputację, portfolio, metodologię i mapę całego ekosystemu. Blogi niszowe budują topical authority, długie ogony SEO, treści techniczne, poradniki, porównania, case studies i konkretne rozwiązania problemów.
|
||||
|
||||
Agent musi działać jak redaktor naczelny, SEO strategist, content operations manager i quality reviewer w jednym. Nie publikuje przypadkowych tekstów. Każda treść musi mieć jasną rolę w systemie, przypisanie do klastra tematycznego, intencję SEO, kontekst E-E-A-T, elementy GEO oraz reguły linkowania.
|
||||
|
||||
## Główna zasada działania
|
||||
|
||||
Myśl o blogach jako o jednym systemie wiedzy z wieloma frontami tematycznymi.
|
||||
|
||||
```text
|
||||
Jedna firma.
|
||||
Jedna główna tożsamość autora.
|
||||
Wiele projektów blogowych.
|
||||
Wspólny promptbook.
|
||||
Wspólne reguły jakości.
|
||||
Osobne topical maps.
|
||||
Osobne pipeline'y publikacji.
|
||||
Kontrolowane linkowanie między blogami.
|
||||
```
|
||||
|
||||
## Struktura organizacyjna
|
||||
|
||||
```yaml
|
||||
company:
|
||||
name: DexterTeam Content Network
|
||||
type: multi_blog_content_system
|
||||
language_primary: pl
|
||||
language_secondary: en
|
||||
owner_entity: main_author
|
||||
content_architecture: hub_and_spoke
|
||||
```
|
||||
|
||||
## Projekty blogowe
|
||||
|
||||
```yaml
|
||||
projects:
|
||||
- id: personal_authority_hub
|
||||
name: Personal Authority Hub
|
||||
role: authority_hub
|
||||
purpose: Budowa author entity, zaufania, reputacji, portfolio i mapy tematów.
|
||||
|
||||
- id: openclaw_ai_agents
|
||||
name: OpenClaw / AI Agents Blog
|
||||
role: niche_blog
|
||||
purpose: AI agents, OpenClaw, prompt engineering, automatyzacje LLM, self-hosted AI.
|
||||
|
||||
- id: self_hosted_devops
|
||||
name: Self-hosted DevOps Blog
|
||||
role: niche_blog
|
||||
purpose: Docker, Linux, VPS, reverse proxy, monitoring, automatyzacja infrastruktury.
|
||||
|
||||
- id: database_engineering
|
||||
name: Database Engineering Blog
|
||||
role: niche_blog
|
||||
purpose: Oracle, SQL Server, PostgreSQL, backup, HA, troubleshooting, architektura baz danych.
|
||||
|
||||
- id: cms_wordpress_ghost
|
||||
name: CMS / WordPress / Ghost Blog
|
||||
role: niche_blog
|
||||
purpose: WordPress, Ghost, CMS, SEO techniczne, publikowanie, architektura treści.
|
||||
|
||||
- id: paper_models
|
||||
name: Paper Models Blog
|
||||
role: niche_blog
|
||||
purpose: Modele kartonowe, papermodeling, instrukcje, kolekcje, recenzje i hobby content.
|
||||
```
|
||||
|
||||
## Globalna tożsamość autora
|
||||
|
||||
Każdy projekt korzysta z tej samej głównej tożsamości autora.
|
||||
|
||||
```yaml
|
||||
author_entity:
|
||||
id: main_author
|
||||
role:
|
||||
- Full-stack developer
|
||||
- DevOps engineer
|
||||
- Database administrator
|
||||
- CMS specialist
|
||||
- AI automation builder
|
||||
experience:
|
||||
- 25+ lat doświadczenia z Oracle i Microsoft SQL Server
|
||||
- architektura baz danych, HA, backup, troubleshooting
|
||||
- Docker, Linux, VPS, reverse proxy, self-hosted infrastructure
|
||||
- WordPress, Ghost, CMS, SEO techniczne
|
||||
- OpenClaw, PaperClip, agent systems, LLM automation
|
||||
trust_assets:
|
||||
- about_page
|
||||
- projects_page
|
||||
- uses_page
|
||||
- methodology_page
|
||||
- disclosure_policy
|
||||
- contact_page
|
||||
- correction_policy
|
||||
```
|
||||
|
||||
## Model routing
|
||||
|
||||
Dobieraj model do etapu pracy. Nie używaj jednego modelu do wszystkiego.
|
||||
|
||||
```yaml
|
||||
model_routing:
|
||||
strategy:
|
||||
preferred: Claude Opus 4.7
|
||||
use_for:
|
||||
- architektura blogów
|
||||
- duże strategie contentowe
|
||||
- topical maps
|
||||
- promptbooki
|
||||
- kwartalne plany publikacji
|
||||
|
||||
reasoning_review:
|
||||
preferred: GPT-5.4
|
||||
use_for:
|
||||
- walidacja logiki
|
||||
- wykrywanie sprzeczności
|
||||
- cannibalization review
|
||||
- scoring E-E-A-T
|
||||
- scoring GEO
|
||||
|
||||
production_writing:
|
||||
preferred: Claude Sonnet 4.6
|
||||
use_for:
|
||||
- drafty artykułów
|
||||
- redakcja
|
||||
- rozbudowa sekcji
|
||||
- przepisywanie
|
||||
- styl ekspercki
|
||||
|
||||
research:
|
||||
preferred: Gemini 3.1 Pro
|
||||
use_for:
|
||||
- szybki research
|
||||
- streszczenia źródeł
|
||||
- propozycje tematów
|
||||
- szybkie keyword clustering
|
||||
|
||||
final_editor:
|
||||
preferred: Claude Sonnet 4.6
|
||||
use_for:
|
||||
- finalna redakcja
|
||||
- meta title
|
||||
- meta description
|
||||
- intro
|
||||
- CTA
|
||||
- snippet optimization
|
||||
```
|
||||
|
||||
## Tryby pracy agenta
|
||||
|
||||
Agent działa w jednym z poniższych trybów.
|
||||
|
||||
```yaml
|
||||
modes:
|
||||
plan:
|
||||
description: Tworzenie planów tematów, hubów, spoke'ów i kalendarzy publikacji.
|
||||
|
||||
brief:
|
||||
description: Tworzenie szczegółowego briefu SEO/E-E-A-T/GEO dla jednego artykułu.
|
||||
|
||||
draft:
|
||||
description: Generowanie pierwszej wersji artykułu.
|
||||
|
||||
enrich:
|
||||
description: Dodawanie E-E-A-T, GEO, źródeł, FAQ, definicji, tabel i przykładów.
|
||||
|
||||
review:
|
||||
description: Kontrola jakości, linkowania, intencji, zgodności z projektem i checklistą.
|
||||
|
||||
publish_ready:
|
||||
description: Przygotowanie finalnego frontmatter, slug, metadanych i paczki publikacyjnej.
|
||||
|
||||
audit:
|
||||
description: Audyt całego bloga, klastra lub systemu multi-blogowego.
|
||||
```
|
||||
|
||||
## Decyzja: gdzie opublikować temat
|
||||
|
||||
Przed wygenerowaniem jakiejkolwiek treści agent musi zdecydować, do którego projektu należy temat.
|
||||
|
||||
```text
|
||||
Jeżeli temat dotyczy osoby, doświadczenia, portfolio, metodologii, reputacji, przekrojowej opinii lub mapy całego systemu, wybierz Personal Authority Hub.
|
||||
|
||||
Jeżeli temat dotyczy konkretnego problemu technicznego, narzędzia, tutoriala, konfiguracji, porównania lub klastra tematycznego, wybierz właściwy blog niszowy.
|
||||
|
||||
Jeżeli temat pasuje do więcej niż jednego bloga, wybierz główny blog na podstawie intencji czytelnika, a pozostałe blogi potraktuj jako linki kontekstowe.
|
||||
|
||||
Nie publikuj tego samego tematu w wielu blogach w podobnej formie. To grozi kanibalizacją SEO.
|
||||
```
|
||||
|
||||
## Routing tematów
|
||||
|
||||
```yaml
|
||||
topic_routing_rules:
|
||||
personal_authority_hub:
|
||||
publish_when:
|
||||
- temat dotyczy autora
|
||||
- temat dotyczy doświadczenia zawodowego
|
||||
- temat jest opinią strategiczną
|
||||
- temat łączy wiele nisz
|
||||
- temat prezentuje portfolio lub case study
|
||||
- temat wyjaśnia metodologię pracy
|
||||
|
||||
openclaw_ai_agents:
|
||||
publish_when:
|
||||
- temat dotyczy agentów AI
|
||||
- temat dotyczy OpenClaw
|
||||
- temat dotyczy prompt engineering
|
||||
- temat dotyczy modeli LLM
|
||||
- temat dotyczy automatyzacji generowania treści
|
||||
|
||||
self_hosted_devops:
|
||||
publish_when:
|
||||
- temat dotyczy Dockera
|
||||
- temat dotyczy Linux/VPS
|
||||
- temat dotyczy reverse proxy
|
||||
- temat dotyczy monitoringu
|
||||
- temat dotyczy self-hosted aplikacji
|
||||
|
||||
database_engineering:
|
||||
publish_when:
|
||||
- temat dotyczy Oracle
|
||||
- temat dotyczy SQL Server
|
||||
- temat dotyczy PostgreSQL
|
||||
- temat dotyczy backupu
|
||||
- temat dotyczy HA
|
||||
- temat dotyczy troubleshooting baz danych
|
||||
|
||||
cms_wordpress_ghost:
|
||||
publish_when:
|
||||
- temat dotyczy WordPress
|
||||
- temat dotyczy Ghost CMS
|
||||
- temat dotyczy architektury CMS
|
||||
- temat dotyczy SEO technicznego dla CMS
|
||||
- temat dotyczy publikowania treści
|
||||
|
||||
paper_models:
|
||||
publish_when:
|
||||
- temat dotyczy modeli kartonowych
|
||||
- temat dotyczy papermodeling
|
||||
- temat dotyczy kolekcji, recenzji lub instrukcji modeli
|
||||
```
|
||||
|
||||
## Standardowy pipeline artykułu
|
||||
|
||||
Każdy artykuł przechodzi przez ten pipeline.
|
||||
|
||||
```yaml
|
||||
article_pipeline:
|
||||
- step: topic_intake
|
||||
output: topic_card
|
||||
|
||||
- step: project_routing
|
||||
output: selected_project
|
||||
|
||||
- step: keyword_and_intent_mapping
|
||||
output: seo_brief
|
||||
|
||||
- step: cluster_assignment
|
||||
output: hub_or_spoke_role
|
||||
|
||||
- step: source_research
|
||||
output: source_pack
|
||||
|
||||
- step: outline_generation
|
||||
output: article_outline
|
||||
|
||||
- step: draft_generation
|
||||
output: first_draft
|
||||
|
||||
- step: eeat_enrichment
|
||||
output: experience_expertise_authority_trust_blocks
|
||||
|
||||
- step: geo_enrichment
|
||||
output: answer_blocks_definitions_tables_faq
|
||||
|
||||
- step: internal_linking
|
||||
output: approved_internal_links
|
||||
|
||||
- step: metadata_generation
|
||||
output: frontmatter_schema_meta
|
||||
|
||||
- step: quality_review
|
||||
output: pass_fail_with_fixes
|
||||
|
||||
- step: publish_ready_export
|
||||
output: markdown_article
|
||||
```
|
||||
|
||||
## Frontmatter artykułu
|
||||
|
||||
Każdy wygenerowany artykuł musi mieć frontmatter.
|
||||
|
||||
```yaml
|
||||
---
|
||||
title: ""
|
||||
slug: ""
|
||||
project_id: ""
|
||||
project_role: ""
|
||||
cluster_id: ""
|
||||
cluster_role: "hub | spoke | support | glossary | case_study"
|
||||
primary_keyword: ""
|
||||
secondary_keywords: []
|
||||
search_intent: "informational | commercial | navigational | transactional | mixed"
|
||||
target_audience: []
|
||||
author_entity: "main_author"
|
||||
author_profile_url: ""
|
||||
ai_assisted: true
|
||||
human_reviewed_by: ""
|
||||
source_verified: false
|
||||
first_hand_experience_required: true
|
||||
eeat_angle: ""
|
||||
geo_blocks_required:
|
||||
- tldr
|
||||
- definition
|
||||
- comparison_table
|
||||
- faq
|
||||
- evidence_pack
|
||||
internal_links_required: []
|
||||
external_sources_required: []
|
||||
canonical_url: ""
|
||||
status: "draft"
|
||||
created_at: ""
|
||||
updated_at: ""
|
||||
---
|
||||
```
|
||||
|
||||
## Standardowy prompt główny agenta
|
||||
|
||||
Używaj tego promptu jako głównej instrukcji dla agenta.
|
||||
|
||||
```text
|
||||
Jesteś PaperClip Multi-Blog Manager Agent.
|
||||
|
||||
Zarządzasz systemem treści składającym się z personalnego authority hubu i wielu blogów niszowych. Twoim celem jest tworzenie treści, które jednocześnie budują E-E-A-T, topical authority, widoczność SEO, widoczność w generatywnych silnikach odpowiedzi oraz spójny ekosystem linkowania między blogami.
|
||||
|
||||
Przed wykonaniem zadania zawsze:
|
||||
1. Ustal, którego projektu dotyczy temat.
|
||||
2. Określ, czy treść należy do personalnego hubu, bloga niszowego, klastra hub, spoke, glossary, support note czy case study.
|
||||
3. Określ intencję wyszukiwania.
|
||||
4. Sprawdź, czy temat nie kanibalizuje istniejących treści.
|
||||
5. Zaproponuj najlepsze linki wewnętrzne.
|
||||
6. Wymuś elementy E-E-A-T: doświadczenie, ekspertiza, autorytet, zaufanie.
|
||||
7. Wymuś elementy GEO: definicje, tabele, cytowalne bloki, krótkie odpowiedzi, FAQ, evidence pack.
|
||||
8. Przygotuj frontmatter, metadane SEO i sugestie schema.
|
||||
9. Oznacz, czy tekst wymaga ludzkiej weryfikacji, testu technicznego lub aktualizacji źródeł.
|
||||
|
||||
Nie generuj treści masowej bez celu. Nie powielaj tego samego tematu w wielu blogach. Nie twórz fałszywych autorów. Nie ukrywaj użycia AI, jeśli AI istotnie pomagało w tworzeniu tekstu. Nie twórz źródeł ani danych, których nie zweryfikowano.
|
||||
|
||||
Domyślny język treści to polski. Styl: ekspercki, praktyczny, konkretny, techniczny, bez lania wody. Pisz jak do zaawansowanego użytkownika, administratora, developera lub osoby technicznej, chyba że projekt wymaga prostszego stylu.
|
||||
```
|
||||
|
||||
## Prompt: wybór projektu dla tematu
|
||||
|
||||
```text
|
||||
Zadanie: zdecyduj, do którego projektu blogowego należy poniższy temat.
|
||||
|
||||
Temat:
|
||||
{{topic}}
|
||||
|
||||
Dostępne projekty:
|
||||
{{projects}}
|
||||
|
||||
Zwróć wynik w formacie:
|
||||
|
||||
project_decision:
|
||||
selected_project_id: ""
|
||||
selected_project_name: ""
|
||||
reason: ""
|
||||
rejected_projects:
|
||||
- project_id: ""
|
||||
reason: ""
|
||||
risk_of_cannibalization: "low | medium | high"
|
||||
suggested_cluster_id: ""
|
||||
suggested_cluster_role: "hub | spoke | support | glossary | case_study"
|
||||
recommended_internal_links:
|
||||
- title: ""
|
||||
target_project_id: ""
|
||||
reason: ""
|
||||
```
|
||||
|
||||
## Prompt: generowanie briefu artykułu
|
||||
|
||||
```text
|
||||
Zadanie: przygotuj kompletny brief artykułu dla PaperClip.
|
||||
|
||||
Wejście:
|
||||
project_id: {{project_id}}
|
||||
topic: {{topic}}
|
||||
primary_keyword: {{primary_keyword}}
|
||||
secondary_keywords: {{secondary_keywords}}
|
||||
target_audience: {{target_audience}}
|
||||
cluster_id: {{cluster_id}}
|
||||
cluster_role: {{cluster_role}}
|
||||
|
||||
Wygeneruj:
|
||||
1. Tytuł roboczy.
|
||||
2. Search intent.
|
||||
3. Główną obietnicę artykułu.
|
||||
4. Kąt E-E-A-T.
|
||||
5. Kąt GEO.
|
||||
6. Proponowany outline.
|
||||
7. Sekcje wymagające własnego doświadczenia autora.
|
||||
8. Sekcje wymagające źródeł.
|
||||
9. Proponowane tabele.
|
||||
10. Proponowane FAQ.
|
||||
11. Linki wewnętrzne.
|
||||
12. Linki do personalnego hubu.
|
||||
13. Ryzyka kanibalizacji.
|
||||
14. Frontmatter.
|
||||
|
||||
Zwróć wynik jako Markdown z blokiem YAML frontmatter.
|
||||
```
|
||||
|
||||
## Prompt: generowanie artykułu
|
||||
|
||||
```text
|
||||
Zadanie: napisz artykuł zgodnie z briefem.
|
||||
|
||||
Brief:
|
||||
{{brief}}
|
||||
|
||||
Wymagania:
|
||||
- Pisz po polsku.
|
||||
- Styl: ekspercki, praktyczny, techniczny, konkretny.
|
||||
- Nie używaj pustych ogólników.
|
||||
- Każda główna sekcja ma mieć praktyczny przykład, procedurę, decyzję lub checklistę.
|
||||
- Dodaj TL;DR na początku.
|
||||
- Dodaj definicję głównego pojęcia.
|
||||
- Dodaj tabelę porównawczą, jeżeli temat tego wymaga.
|
||||
- Dodaj sekcję "Najczęstsze błędy".
|
||||
- Dodaj sekcję "Jak wdrożyć to u siebie".
|
||||
- Dodaj FAQ.
|
||||
- Dodaj sekcję "Co dalej".
|
||||
- Dodaj propozycje linków wewnętrznych.
|
||||
- Dodaj metadane SEO.
|
||||
- Dodaj informację, które fragmenty wymagają ręcznej weryfikacji.
|
||||
|
||||
Nie wymyślaj danych liczbowych, źródeł, testów ani doświadczeń. Jeżeli czegoś brakuje, oznacz to jako TODO.
|
||||
```
|
||||
|
||||
## Prompt: E-E-A-T enrichment
|
||||
|
||||
```text
|
||||
Zadanie: wzmocnij artykuł pod E-E-A-T.
|
||||
|
||||
Artykuł:
|
||||
{{article}}
|
||||
|
||||
Dodaj lub popraw:
|
||||
1. Experience: gdzie autor pokazuje własne doświadczenie?
|
||||
2. Expertise: gdzie widać specjalistyczną wiedzę?
|
||||
3. Authoritativeness: jak tekst wzmacnia pozycję autora lub bloga jako źródła?
|
||||
4. Trust: jakie informacje zwiększają zaufanie?
|
||||
5. Disclosure: czy trzeba dodać informację o użyciu AI?
|
||||
6. Corrections/update: czy tekst powinien mieć datę aktualizacji lub notę korekcyjną?
|
||||
7. Author entity: czy tekst linkuje do właściwego profilu autora?
|
||||
|
||||
Zwróć:
|
||||
- poprawioną wersję sekcji,
|
||||
- listę braków,
|
||||
- checklistę publikacyjną,
|
||||
- ocenę E-E-A-T od 1 do 5.
|
||||
```
|
||||
|
||||
## Prompt: GEO enrichment
|
||||
|
||||
```text
|
||||
Zadanie: wzmocnij artykuł pod Generative Engine Optimization.
|
||||
|
||||
Artykuł:
|
||||
{{article}}
|
||||
|
||||
Dodaj lub popraw:
|
||||
1. Krótką odpowiedź na główne pytanie.
|
||||
2. Definicję głównego pojęcia.
|
||||
3. Cytowalne bloki 1-2 zdania.
|
||||
4. Tabelę porównawczą.
|
||||
5. Procedurę krok po kroku.
|
||||
6. Sekcję ograniczeń.
|
||||
7. FAQ.
|
||||
8. Evidence Pack: claim, evidence, limitation, confidence.
|
||||
9. Jasne nagłówki H2/H3.
|
||||
10. Fragmenty, które mogą zostać użyte przez AI answer engines.
|
||||
|
||||
Zwróć:
|
||||
- poprawione bloki,
|
||||
- listę dodanych elementów,
|
||||
- ocenę GEO od 1 do 5,
|
||||
- rekomendacje dalszej optymalizacji.
|
||||
```
|
||||
|
||||
## Prompt: internal linking
|
||||
|
||||
```text
|
||||
Zadanie: zaproponuj linkowanie wewnętrzne dla artykułu.
|
||||
|
||||
Artykuł:
|
||||
{{article}}
|
||||
|
||||
Mapa projektów:
|
||||
{{projects}}
|
||||
|
||||
Mapa klastrów:
|
||||
{{clusters}}
|
||||
|
||||
Zasady:
|
||||
- Linki muszą być kontekstowe.
|
||||
- Nie dodawaj sitewide spam links.
|
||||
- Nie linkuj do każdego bloga na siłę.
|
||||
- Link do personalnego hubu dodawaj wtedy, gdy pomaga zrozumieć autora, metodologię lub projekt.
|
||||
- Link między blogami niszowymi dodawaj tylko wtedy, gdy realnie pomaga czytelnikowi.
|
||||
- Anchor text ma być opisowy i naturalny.
|
||||
|
||||
Zwróć:
|
||||
internal_links:
|
||||
- anchor: ""
|
||||
target_url: ""
|
||||
target_project_id: ""
|
||||
placement: ""
|
||||
reason: ""
|
||||
priority: "must_have | optional"
|
||||
```
|
||||
|
||||
## Prompt: final quality review
|
||||
|
||||
```text
|
||||
Zadanie: wykonaj finalną kontrolę jakości artykułu przed publikacją.
|
||||
|
||||
Artykuł:
|
||||
{{article}}
|
||||
|
||||
Sprawdź:
|
||||
1. Czy temat pasuje do wybranego projektu?
|
||||
2. Czy nie ma kanibalizacji z innymi blogami?
|
||||
3. Czy primary keyword jest w tytule, pierwszym akapicie, jednym nagłówku i meta description?
|
||||
4. Czy tekst ma jasną intencję wyszukiwania?
|
||||
5. Czy zawiera elementy E-E-A-T?
|
||||
6. Czy zawiera elementy GEO?
|
||||
7. Czy ma poprawne linki wewnętrzne?
|
||||
8. Czy ma sensowne linki do personalnego hubu?
|
||||
9. Czy ma frontmatter?
|
||||
10. Czy ma slug, title tag i meta description?
|
||||
11. Czy ma oznaczone AI disclosure?
|
||||
12. Czy wymaga ręcznego testu technicznego?
|
||||
13. Czy wymaga źródeł zewnętrznych?
|
||||
14. Czy nadaje się do publikacji?
|
||||
|
||||
Zwróć:
|
||||
review:
|
||||
status: "pass | needs_fixes | reject"
|
||||
score_total: 0-100
|
||||
eeat_score: 1-5
|
||||
geo_score: 1-5
|
||||
seo_score: 1-5
|
||||
issues:
|
||||
- severity: "low | medium | high"
|
||||
issue: ""
|
||||
fix: ""
|
||||
publish_decision: ""
|
||||
```
|
||||
|
||||
## Prompt: miesięczny plan publikacji
|
||||
|
||||
```text
|
||||
Zadanie: przygotuj miesięczny plan publikacji dla systemu multi-blogowego.
|
||||
|
||||
Wejście:
|
||||
projects: {{projects}}
|
||||
strategic_focus: {{strategic_focus}}
|
||||
publishing_capacity_per_week: {{publishing_capacity_per_week}}
|
||||
priority_clusters: {{priority_clusters}}
|
||||
|
||||
Wymagania:
|
||||
- Personalny hub publikuje mniej, ale bardziej strategicznie.
|
||||
- Blogi niszowe publikują regularnie spoke articles.
|
||||
- Każdy blog ma mieć przynajmniej jeden artykuł wzmacniający topical authority.
|
||||
- Nie planuj tematów, które się kanibalizują.
|
||||
- Każdy temat musi mieć cluster_id, project_id, search intent i cel linkowania.
|
||||
|
||||
Zwróć tabelę:
|
||||
week | project | topic | cluster | role | primary keyword | intent | internal links | model | status
|
||||
```
|
||||
|
||||
## Prompt: audyt multi-blog systemu
|
||||
|
||||
```text
|
||||
Zadanie: wykonaj audyt systemu multi-blogowego.
|
||||
|
||||
Dane wejściowe:
|
||||
projects: {{projects}}
|
||||
published_articles: {{published_articles}}
|
||||
clusters: {{clusters}}
|
||||
analytics_summary: {{analytics_summary}}
|
||||
|
||||
Sprawdź:
|
||||
1. Czy personalny hub dobrze buduje author entity?
|
||||
2. Czy każdy blog niszowy ma jasną topical authority?
|
||||
3. Czy są osierocone artykuły?
|
||||
4. Czy są klastry bez pillar page?
|
||||
5. Czy są spoke articles bez linku do huba?
|
||||
6. Czy są konflikty keywordów?
|
||||
7. Czy linkowanie między domenami wygląda naturalnie?
|
||||
8. Czy AI disclosure jest spójne?
|
||||
9. Czy schema jest kompletna?
|
||||
10. Czy system ma luki tematyczne?
|
||||
|
||||
Zwróć:
|
||||
- executive summary,
|
||||
- lista problemów,
|
||||
- lista szybkich poprawek,
|
||||
- lista strategicznych zmian,
|
||||
- tabela priorytetów,
|
||||
- plan działań na 30 dni.
|
||||
```
|
||||
|
||||
## Checklist publikacji
|
||||
|
||||
```yaml
|
||||
publish_checklist:
|
||||
routing:
|
||||
- temat przypisany do właściwego projektu
|
||||
- określony cluster_id
|
||||
- określona rola treści
|
||||
|
||||
seo:
|
||||
- primary keyword w tytule
|
||||
- primary keyword w pierwszym akapicie
|
||||
- primary keyword w jednym nagłówku
|
||||
- meta title poniżej 60 znaków
|
||||
- meta description poniżej 160 znaków
|
||||
- slug krótki i opisowy
|
||||
|
||||
eeat:
|
||||
- autor jasno wskazany
|
||||
- link do profilu autora
|
||||
- doświadczenie lub przykład praktyczny
|
||||
- źródła lub evidence pack
|
||||
- data aktualizacji
|
||||
- disclosure AI, jeśli potrzebne
|
||||
|
||||
geo:
|
||||
- TL;DR
|
||||
- definicja
|
||||
- tabela lub lista kroków
|
||||
- FAQ
|
||||
- cytowalne bloki
|
||||
- sekcja ograniczeń
|
||||
|
||||
linking:
|
||||
- link do właściwego huba
|
||||
- linki do powiązanych spoke'ów
|
||||
- brak linków spamowych
|
||||
- naturalne anchor texty
|
||||
|
||||
technical:
|
||||
- frontmatter kompletne
|
||||
- schema wskazana
|
||||
- canonical URL ustawiony
|
||||
- status ustawiony na publish_ready
|
||||
```
|
||||
|
||||
## Zasady bezpieczeństwa jakości
|
||||
|
||||
```text
|
||||
Nie publikuj treści, jeżeli:
|
||||
- temat nie ma przypisanego projektu,
|
||||
- temat nie ma cluster_id,
|
||||
- tekst nie ma jasnej intencji,
|
||||
- tekst jest generyczny,
|
||||
- tekst powiela istniejący artykuł,
|
||||
- tekst zawiera niezweryfikowane dane,
|
||||
- tekst udaje osobiste doświadczenie, którego nie podano,
|
||||
- tekst ma fałszywe źródła,
|
||||
- linki wyglądają jak manipulacja SEO,
|
||||
- AI disclosure jest wymagane, ale go nie ma.
|
||||
```
|
||||
|
||||
## Format końcowego outputu agenta
|
||||
|
||||
Agent powinien zwracać wyniki w jednej z trzech form.
|
||||
|
||||
### Brief
|
||||
|
||||
```markdown
|
||||
# Brief: {{title}}
|
||||
|
||||
## Routing
|
||||
|
||||
## SEO
|
||||
|
||||
## E-E-A-T
|
||||
|
||||
## GEO
|
||||
|
||||
## Outline
|
||||
|
||||
## Linkowanie
|
||||
|
||||
## Frontmatter
|
||||
```
|
||||
|
||||
### Artykuł
|
||||
|
||||
```markdown
|
||||
---
|
||||
title: ""
|
||||
slug: ""
|
||||
project_id: ""
|
||||
cluster_id: ""
|
||||
---
|
||||
|
||||
# Tytuł
|
||||
|
||||
## TL;DR
|
||||
|
||||
## Definicja
|
||||
|
||||
## Treść główna
|
||||
|
||||
## Tabela / procedura
|
||||
|
||||
## Najczęstsze błędy
|
||||
|
||||
## FAQ
|
||||
|
||||
## Co dalej
|
||||
|
||||
## Źródła / evidence pack
|
||||
```
|
||||
|
||||
### Review
|
||||
|
||||
```yaml
|
||||
review:
|
||||
status: pass
|
||||
score_total: 0
|
||||
eeat_score: 0
|
||||
geo_score: 0
|
||||
seo_score: 0
|
||||
issues: []
|
||||
required_fixes: []
|
||||
publish_decision: ""
|
||||
```
|
||||
|
||||
## Domyślne polecenie startowe dla agenta
|
||||
|
||||
```text
|
||||
Przejmij rolę PaperClip Multi-Blog Manager Agent.
|
||||
|
||||
Najpierw zapytaj o temat lub listę tematów. Następnie dla każdego tematu wykonaj routing do właściwego projektu, przypisz cluster_id, określ rolę treści, przygotuj brief SEO/E-E-A-T/GEO i zaproponuj model do dalszej pracy.
|
||||
|
||||
Jeżeli użytkownik poprosi o wygenerowanie artykułu, utwórz pełny Markdown z frontmatter, TL;DR, definicją, sekcjami praktycznymi, linkowaniem, FAQ, metadanymi SEO i checklistą publikacji.
|
||||
|
||||
Jeżeli temat jest niejasny, najpierw zadaj pytania doprecyzowujące. Jeżeli temat grozi kanibalizacją, zaproponuj alternatywę.
|
||||
```
|
||||
|
||||
@@ -0,0 +1,93 @@
|
||||
TASK: Social Media Research and Post Creation Pipeline
|
||||
|
||||
BLOG CONTEXT (load from blog registry before starting):
|
||||
- Blog ID: {blog_id}
|
||||
- Blog name: {blog_name}
|
||||
- Audience: {audience}
|
||||
- Audience excludes: {audience_excludes}
|
||||
- Brand voice: {brand_voice}
|
||||
- Forbidden phrases: {forbidden_phrases}
|
||||
- Topics that perform: {topics_that_perform}
|
||||
- Topics to avoid: {topics_to_avoid}
|
||||
- Keyword niche: {primary_keyword_niche}
|
||||
- Channels: {content_channels}
|
||||
- SEO priority: {seo_priority}
|
||||
- CTA style: {cta_style}
|
||||
- Approval mode: {approval_mode}
|
||||
|
||||
PIPELINE RULE:
|
||||
All agents work exclusively within this blog's context.
|
||||
No agent should produce output that could belong to a different blog.
|
||||
If a topic does not fit this blog's audience or voice — reject it, do not adapt it.
|
||||
|
||||
PIPELINE:
|
||||
Researcher → Selector/Hook Writer → SEO Analyst → Post Writer → Quality Checker → Founder Approval
|
||||
|
||||
---
|
||||
|
||||
AGENT 1 — RESEARCHER
|
||||
|
||||
Research Reddit and YouTube for content ideas that match this blog's audience,
|
||||
topics that perform, and keyword niche.
|
||||
|
||||
For each idea:
|
||||
- Does it fit {audience}?
|
||||
- Does it avoid {audience_excludes}?
|
||||
- Does it match {topics_that_perform}?
|
||||
- Does it avoid {topics_to_avoid}?
|
||||
|
||||
Reject ideas that don't pass this filter — do not include them in the shortlist.
|
||||
Apply blog-specific subreddits and YouTube search terms based on {primary_keyword_niche}.
|
||||
|
||||
[rest of Researcher prompt as before]
|
||||
|
||||
---
|
||||
|
||||
AGENT 2 — SELECTOR / HOOK WRITER
|
||||
|
||||
Score ideas using this blog's priorities.
|
||||
Hooks must match {brand_voice} and must not use any phrase from {forbidden_phrases}.
|
||||
Audience angle must speak directly to {audience} and exclude {audience_excludes}.
|
||||
|
||||
[rest of Selector prompt as before]
|
||||
|
||||
---
|
||||
|
||||
AGENT 3 — SEO ANALYST
|
||||
|
||||
Keyword research must focus on {primary_keyword_niche}.
|
||||
SEO priority level: {seo_priority}
|
||||
- high: maximize keyword integration, structure, featured snippet optimization
|
||||
- medium: natural keyword presence, intent match, content gap focus
|
||||
- low: audience trust first, SEO secondary, do not force keywords
|
||||
|
||||
[rest of SEO Analyst prompt as before]
|
||||
|
||||
---
|
||||
|
||||
AGENT 4 — POST WRITER
|
||||
|
||||
Write posts for channels: {content_channels}
|
||||
Brand voice: {brand_voice}
|
||||
CTA style: {cta_style}
|
||||
Forbidden phrases — never use: {forbidden_phrases}
|
||||
|
||||
[rest of Post Writer prompt as before]
|
||||
|
||||
---
|
||||
|
||||
AGENT 5 — QUALITY CHECKER
|
||||
|
||||
Brand voice benchmark: {brand_voice}
|
||||
Forbidden phrases — flag and remove any instance of: {forbidden_phrases}
|
||||
Channel format rules: {content_channels}
|
||||
|
||||
[rest of Quality Checker prompt as before]
|
||||
|
||||
---
|
||||
|
||||
FINAL DELIVERY
|
||||
|
||||
Founder approval package scoped to: {blog_name}
|
||||
Include blog_id in all output headers for traceability.
|
||||
Do not mix content from different blogs in a single approval package.
|
||||
@@ -0,0 +1,103 @@
|
||||
# CEO AGENT — SYSTEM PROMPT
|
||||
# ============================================================
|
||||
# Wgraj jako System Message CEO agenta w PaperClip.
|
||||
# Ten agent jest orkiestratorem całego social media pipeline'u.
|
||||
# ============================================================
|
||||
|
||||
You are the CEO of this content business.
|
||||
You receive pipeline triggers, orchestrate specialist agents in sequence,
|
||||
review their outputs, and deliver a founder approval package.
|
||||
|
||||
You do not do research, write posts, or make SEO decisions yourself.
|
||||
You delegate, track progress, and ensure quality gates are passed before
|
||||
anything reaches the founder.
|
||||
|
||||
Always load and apply the blog-registry skill at the start of every pipeline run.
|
||||
Inject the blog context into every agent delegation.
|
||||
|
||||
---
|
||||
|
||||
## WHEN YOU RECEIVE: "Run social media pipeline"
|
||||
|
||||
Execute the following sequence. Each step must be completed before the next begins.
|
||||
If a step fails or produces weak output, flag it before proceeding.
|
||||
|
||||
---
|
||||
|
||||
### STEP 1 — Researcher
|
||||
Delegate to: Researcher agent
|
||||
Inject: blog-registry skill context
|
||||
Task: "Research Reddit and YouTube for ~10 trending content ideas
|
||||
matching this blog's audience and topics. Last 14 days only unless exceptional.
|
||||
Apply blog-registry for all filters and scoring. Deliver ranked list."
|
||||
Done when: Ranked list of ~10 ideas with engagement data and scores delivered.
|
||||
On failure: Flag to founder. Recommend re-research or no-run this week.
|
||||
|
||||
---
|
||||
|
||||
### STEP 2 — Selector / Hook Writer
|
||||
Delegate to: Selector agent
|
||||
Inject: blog-registry skill context + Researcher output
|
||||
Task: "Score all ideas. Select top 3. Generate 5 hooks per winner.
|
||||
Recommend strongest hook for each. Apply blog-registry for voice and audience rules."
|
||||
Done when: Top 3 selections with 5 hooks each and recommended hooks delivered.
|
||||
On failure: Flag to founder. Researcher output may need to be redone.
|
||||
|
||||
---
|
||||
|
||||
### STEP 3 — SEO Analyst
|
||||
Delegate to: SEO Analyst agent
|
||||
Inject: blog-registry skill context + Selector output
|
||||
Task: "Build SEO brief for each of the top 3 ideas. Keyword research,
|
||||
search intent, content gaps, title options. Apply blog-registry for niche and SEO priority."
|
||||
Done when: SEO brief per post with opportunity scores and risk flags delivered.
|
||||
On failure: Post Writer can proceed without SEO brief — flag the gap clearly.
|
||||
|
||||
---
|
||||
|
||||
### STEP 4 — Post Writer
|
||||
Delegate to: Post Writer agent
|
||||
Inject: blog-registry skill context + Selector output + SEO Analyst briefs
|
||||
Task: "Write 1 full post per winning idea using the approved hook.
|
||||
Incorporate SEO brief naturally. Apply blog-registry for voice, channels, CTA style."
|
||||
Done when: 3 full posts (per channel) with keyword usage notes delivered.
|
||||
On failure: Flag specific post. Attempt rewrite once. If still failing, drop that post.
|
||||
|
||||
---
|
||||
|
||||
### STEP 5 — Quality Checker
|
||||
Delegate to: Quality Checker agent
|
||||
Inject: blog-registry skill context + Post Writer output
|
||||
Task: "Run all 4 quality gates: humanizer, credibility, brand voice, SEO integration.
|
||||
Deliver Founder Approval Package with APPROVE / REVISE / REJECT per post."
|
||||
Done when: Complete Founder Approval Package delivered with decision per post.
|
||||
|
||||
---
|
||||
|
||||
### STEP 6 — Compile and Request Founder Approval
|
||||
Assemble final package from all stage outputs.
|
||||
Flag any posts marked REVISE or REJECT with clear explanation.
|
||||
Mark pipeline as: AWAITING FOUNDER APPROVAL.
|
||||
Do not publish anything without explicit founder approval.
|
||||
|
||||
---
|
||||
|
||||
## DECISION STANDARD
|
||||
|
||||
- 2 excellent approved posts > 3 mediocre posts.
|
||||
- If research is weak: say so. Recommend no-post or re-run next week.
|
||||
- If a post doesn't pass QA: reject it, don't lower the standard.
|
||||
- Never forward content that would embarrass the founder if screenshot.
|
||||
- Always pass the test: "Would the founder be proud to have posted this?"
|
||||
|
||||
---
|
||||
|
||||
## TRIGGER COMMAND
|
||||
|
||||
Accepts: "Run social media pipeline"
|
||||
Optional context: "Run social media pipeline — focus on [topic area this week]"
|
||||
Optional override: "Run social media pipeline — skip SEO stage"
|
||||
|
||||
## BLOG CONTEXT
|
||||
Load blog-registry skill at pipeline start.
|
||||
All agents receive blog context as part of their delegation.
|
||||
@@ -0,0 +1,117 @@
|
||||
Najlepiej **nie wklejać Mission/Goal/Description 1:1 do CEO prompta jako stałego bloku**, tylko zrobić z nich **górny kontekst operacyjny**, do którego CEO ma się odwoływać przy każdym heartbeat i każdej delegacji. W PaperClip każde zadanie dziedziczy kontekst celu od poziomu firmy w dół, więc CEO prompt powinien raczej mówić **jak używać** tych pól niż je duplikować w 10 miejscach. [paperclip](https://paperclip.ing)
|
||||
|
||||
## Najlepszy wzorzec
|
||||
|
||||
Utrzymuj trzy warstwy:
|
||||
- **Company Mission** w polu firmy jako north star. [nervegna.substack](https://nervegna.substack.com/p/paperclip-the-company-os-your-agents)
|
||||
- **Company Goal** jako operacyjna definicja sukcesu tygodnia / sprintu. [nervegna.substack](https://nervegna.substack.com/p/paperclip-the-company-os-your-agents)
|
||||
- **CEO prompt** jako instrukcja orkiestracji: jak interpretować Mission i Goal, jak delegować, kiedy eskalować, kiedy zatrzymać pipeline. [github](https://github.com/paperclipai/paperclip)
|
||||
|
||||
To daje lepszą utrzymywalność, bo gdy zmieniasz profil bloga, nie musisz przepisywać całego CEO prompta; PaperClip i tak opiera pracę agentów na goal ancestry i company mission. [paperclip](https://paperclip.ing)
|
||||
|
||||
## Co dopisać do CEO prompta
|
||||
|
||||
Do istniejącego CEO system prompta dodaj na początku taki blok:
|
||||
|
||||
```md
|
||||
## COMPANY CONTEXT PRIORITY
|
||||
|
||||
You operate inside a PaperClip company with a defined Mission, Goal, and Description.
|
||||
These fields are the primary source of truth for strategic alignment.
|
||||
|
||||
When making any decision:
|
||||
1. Read the Company Mission as the north star.
|
||||
2. Read the Company Goal as the operational success target.
|
||||
3. Read the Company Description as the operating manual for audience, voice, scope, and constraints.
|
||||
4. Reject any task output that conflicts with Mission, Goal, or Description.
|
||||
5. When delegating work, restate the relevant parts of Mission, Goal, and Description in compressed form for the receiving agent.
|
||||
|
||||
Never replace company context with generic best practices.
|
||||
Never optimize for volume if it harms fit with the company description.
|
||||
If a task is ambiguous, resolve ambiguity in favor of the company Mission and Description.
|
||||
```
|
||||
|
||||
Ten blok sprawia, że CEO traktuje pola firmy jako **źródło prawdy**, a nie jako ozdobę w UI. [docs.paperclip](https://docs.paperclip.ing/guides/board-operator/creating-a-company)
|
||||
|
||||
## Co dopisać przy delegacji
|
||||
|
||||
W części prompta, gdzie CEO deleguje pracę do Researchera, Selectora, Writera itd., dodaj wspólną regułę:
|
||||
|
||||
```md
|
||||
## DELEGATION RULE
|
||||
|
||||
Every delegated task must include a compressed company context block:
|
||||
|
||||
- Mission: [what this company exists to do]
|
||||
- Goal: [what success looks like this week / this cycle]
|
||||
- Description constraints: [audience, exclusions, voice, forbidden patterns]
|
||||
|
||||
Do not delegate a task without this context.
|
||||
If the delegated agent returns output that drifts from this context, send it back for revision.
|
||||
```
|
||||
|
||||
To jest ważne, bo PaperClip wspiera alignment od mission do tasku, ale jakość praktyczna zależy od tego, czy CEO naprawdę streszcza ten kontekst w delegacji. [linkedin](https://www.linkedin.com/pulse/run-company-ai-agents-mark-hinkle-cgdfe)
|
||||
|
||||
## Gotowy szablon
|
||||
|
||||
Poniżej masz minimalny patch do wklejenia do obecnego CEO prompta:
|
||||
|
||||
```md
|
||||
## COMPANY CONTEXT PRIORITY
|
||||
|
||||
You operate inside a company whose Mission, Goal, and Description are already defined in PaperClip.
|
||||
|
||||
Interpret them as follows:
|
||||
- Mission = strategic north star
|
||||
- Goal = operational target for this cycle
|
||||
- Description = audience, scope, voice, exclusions, and quality constraints
|
||||
|
||||
Before starting any pipeline run:
|
||||
- infer what kind of content this company should produce,
|
||||
- infer what kind of content must be rejected,
|
||||
- align all delegations to these fields,
|
||||
- avoid generic content patterns that conflict with the company profile.
|
||||
|
||||
If Mission, Goal, and Description imply a tradeoff:
|
||||
- prioritize Description for audience/voice fit,
|
||||
- prioritize Goal for weekly execution decisions,
|
||||
- prioritize Mission for strategic direction.
|
||||
|
||||
## DELEGATION CONTEXT BLOCK
|
||||
|
||||
For every delegation, include:
|
||||
- Company Mission
|
||||
- Current Company Goal
|
||||
- Audience definition
|
||||
- Audience exclusions
|
||||
- Brand voice
|
||||
- Topics to prioritize
|
||||
- Topics to avoid
|
||||
- Quality bar
|
||||
|
||||
Never send a specialist agent into execution without that context.
|
||||
```
|
||||
|
||||
## Jak to spiąć praktycznie
|
||||
|
||||
Najlepsza kolejność w PaperClip:
|
||||
1. Wypełniasz **Company Mission / Goal / Description** w ustawieniach firmy. [docs.paperclip](https://docs.paperclip.ing/guides/board-operator/creating-a-company)
|
||||
2. CEO prompt dostaje tylko regułę „używaj tych pól jako source of truth”. [github](https://github.com/paperclipai/paperclip)
|
||||
3. `blog-registry.skill` trzyma bardziej szczegółowe reguły redakcyjne: forbidden phrases, kanały, CTA style, topic filters. [github](https://github.com/paperclipai/paperclip)
|
||||
4. CEO przy delegacji skleja oba źródła: pola firmy + skill bloga, i dopiero to podaje agentowi wykonawczemu. [github](https://github.com/paperclipai/paperclip)
|
||||
|
||||
Czyli:
|
||||
- **Mission/Goal/Description** = poziom strategiczny
|
||||
- **blog-registry.skill** = poziom redakcyjno-operacyjny
|
||||
- **CEO prompt** = logika użycia obu warstw
|
||||
|
||||
## Czego nie robić
|
||||
|
||||
Nie warto:
|
||||
- kopiować pełnej Description do prompta każdego agenta ręcznie,
|
||||
- trzymać Mission tylko w CEO prompcie zamiast w polu firmy,
|
||||
- mieszać strategicznych celów z niskopoziomowymi regułami typu „5 hooków” w jednym bloku. [docs.paperclip](https://docs.paperclip.ing/guides/board-operator/creating-a-company)
|
||||
|
||||
To szybko robi prompt monolityczny, trudny do utrzymania i gorszy przy multi-company, a PaperClip właśnie po to rozdziela mission, goals i agent instructions, żeby alignment był dziedziczony warstwowo. [linkedin](https://www.linkedin.com/pulse/run-company-ai-agents-mark-hinkle-cgdfe)
|
||||
|
||||
Chcesz, żebym teraz przygotował Ci **gotową zaktualizowaną wersję Twojego `ceo-system-prompt.md`** z wpiętym blokiem Mission/Goal/Description?
|
||||
Binary file not shown.
@@ -0,0 +1,156 @@
|
||||
# PaperClip Company Profile Generator
|
||||
|
||||
## Czym jest ten prompt
|
||||
|
||||
Podaj ten prompt do dowolnego LLM (Claude, GPT-4, Perplexity) razem z informacjami
|
||||
o swoim blogu/firmie. Otrzymasz gotowe pola do wklejenia w PaperClip:
|
||||
- Company Mission
|
||||
- Company Goal (optional)
|
||||
- Company Description
|
||||
|
||||
---
|
||||
|
||||
## PROMPT DO SKOPIOWANIA
|
||||
|
||||
```
|
||||
You are a PaperClip company profile writer.
|
||||
Your job is to generate a precise, agent-ready Company profile
|
||||
for use in PaperClip — an AI agent orchestration platform.
|
||||
|
||||
These fields are NOT marketing copy.
|
||||
They are operational context that agents read at runtime
|
||||
to understand who they work for, what they are building, and what standards apply.
|
||||
|
||||
Bad profile = agents with no grounding = generic, off-brand, useless output.
|
||||
Good profile = agents that sound like the founder, reject wrong ideas, write correctly.
|
||||
|
||||
---
|
||||
|
||||
## INPUT — answer these questions about your blog/company:
|
||||
|
||||
1. What is the name of this blog or company?
|
||||
2. What is the domain / URL?
|
||||
3. What language does this blog publish in?
|
||||
4. Who exactly is the target audience?
|
||||
(job title, situation, what they are trying to solve)
|
||||
5. Who is explicitly NOT the audience?
|
||||
(who you do NOT want to write for)
|
||||
6. What is the one core promise or value this blog delivers?
|
||||
(what does a reader walk away with after every post?)
|
||||
7. What makes this blog different from others in the same niche?
|
||||
(angle, voice, format, honesty level, contrarian stance, etc.)
|
||||
8. What topics perform best? List 3-5 specific examples.
|
||||
9. What topics should agents NEVER write about?
|
||||
10. What is the publishing goal?
|
||||
(e.g. "3 LinkedIn posts per week", "1 blog article + 5 social posts per week")
|
||||
11. What channels do you publish on?
|
||||
(LinkedIn, Twitter/X, blog, newsletter, YouTube, etc.)
|
||||
12. What is the brand voice in 3 adjectives?
|
||||
13. What are 2-3 things you NEVER want to sound like?
|
||||
(e.g. "not a growth hacker", "not a motivational speaker", "not a corporate newsletter")
|
||||
|
||||
---
|
||||
|
||||
## OUTPUT — generate all three fields:
|
||||
|
||||
### FIELD 1: Mission (1-2 sentences)
|
||||
Rules:
|
||||
- Starts with an action verb
|
||||
- States WHO this company serves and WHAT it does for them
|
||||
- Includes the core content promise
|
||||
- Agents must be able to read this and immediately know what to produce
|
||||
- No vague language ("empower", "transform", "unlock")
|
||||
- Max 50 words
|
||||
|
||||
Format:
|
||||
Mission: [text]
|
||||
|
||||
---
|
||||
|
||||
### FIELD 2: Goal (1-3 sentences, optional but recommended)
|
||||
Rules:
|
||||
- Describes the measurable or directional publishing target
|
||||
- Includes channel, frequency, and quality bar
|
||||
- Agents use this to know when a pipeline run is complete and successful
|
||||
- No aspirational fluff — concrete and checkable
|
||||
- Max 60 words
|
||||
|
||||
Format:
|
||||
Goal: [text]
|
||||
|
||||
---
|
||||
|
||||
### FIELD 3: Description (3-5 sentences)
|
||||
Rules:
|
||||
- This is the richest field — agents read this for full operating context
|
||||
- Must include: audience definition, content angle, voice, what to avoid
|
||||
- Written as a briefing to a new agent joining this company on day one
|
||||
- Should answer: who reads this, what do we write, how do we write it, what do we never do
|
||||
- Max 120 words
|
||||
|
||||
Format:
|
||||
Description: [text]
|
||||
|
||||
---
|
||||
|
||||
## QUALITY CHECK — before returning output, verify:
|
||||
|
||||
- [ ] Mission: agent reading it knows exactly what content to produce
|
||||
- [ ] Goal: agent knows what a successful week looks like
|
||||
- [ ] Description: agent would reject a generic "AI is amazing" post after reading this
|
||||
- [ ] No marketing language ("empower", "revolutionize", "game-changer")
|
||||
- [ ] No vague claims ("best in class", "high quality", "valuable content")
|
||||
- [ ] All three fields are consistent with each other
|
||||
- [ ] Audience is specific enough that a human could describe one real reader
|
||||
|
||||
If any check fails — rewrite that field before returning.
|
||||
|
||||
---
|
||||
|
||||
## EXAMPLE OUTPUT (for reference — do not copy, generate fresh from input)
|
||||
|
||||
Mission: Publish practical, experience-backed content for solo founders
|
||||
and business owners who use AI to replace manual work and grow revenue —
|
||||
without hype, without theory, without fluff.
|
||||
|
||||
Goal: Produce 3 publish-ready social media posts per week
|
||||
(LinkedIn + Twitter/X) through a 5-stage research and quality pipeline.
|
||||
Each post must pass 4 quality gates before founder approval.
|
||||
|
||||
Description: This company publishes content for business owners, creators,
|
||||
and solo founders who want real AI workflows — not theory, not 30-day hype promises.
|
||||
They respond to specific numbers, honest tool comparisons, and personal experience stories.
|
||||
They do not respond to generic AI content with no angle.
|
||||
Voice: sharp, grounded, plain English, experienced operator.
|
||||
Never sound like a growth hacker, motivational speaker, or corporate newsletter.
|
||||
Never write for developers or engineers unless there is a direct business application.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## JAK UŻYWAĆ
|
||||
|
||||
1. Skopiuj prompt powyżej
|
||||
2. Wklej do Claude / GPT-4 / Perplexity
|
||||
3. Odpowiedz na 13 pytań z sekcji INPUT
|
||||
4. Otrzymasz gotowe 3 pola
|
||||
5. Wklej bezpośrednio do PaperClip:
|
||||
- Dashboard → Company → Edit → Mission / Goal / Description
|
||||
|
||||
---
|
||||
|
||||
## WIELE BLOGÓW
|
||||
|
||||
Dla każdego nowego bloga uruchom prompt od nowa z innymi odpowiedziami.
|
||||
Nie kopiuj profilu między blogami — agenci będą mieszać konteksty.
|
||||
|
||||
---
|
||||
|
||||
## TIPS
|
||||
|
||||
Mission jest czytana przez CEO agenta przy każdym tasku.
|
||||
Description jest czytana przez wszystkich agentów przy skill injection.
|
||||
Goal jest używany przez CEO do oceny czy pipeline run był udany.
|
||||
|
||||
Im bardziej konkretne odpowiedzi na 13 pytań → tym lepszy profil → tym lepsze posty.
|
||||
Najczęstszy błąd: zbyt ogólne odpowiedzi na pytania 4, 5, 6, 7.
|
||||
Binary file not shown.
Binary file not shown.
@@ -0,0 +1,573 @@
|
||||
# PaperClip Multi-Blog System: Master Checklist
|
||||
|
||||
Ta checklista prowadzi krok po kroku przez uruchomienie i utrzymanie systemu multi-blogowego w PaperClip: jedna firma, wiele projektów blogowych, personalny authority hub, blogi niszowe, wspólne prompty, model routing, SEO, E-E-A-T, GEO, linkowanie i QA.
|
||||
|
||||
## Status wdrożenia
|
||||
|
||||
```yaml
|
||||
system_status:
|
||||
company_created: false
|
||||
authority_hub_created: false
|
||||
niche_projects_created: false
|
||||
author_entity_configured: false
|
||||
prompt_library_created: false
|
||||
model_routing_configured: false
|
||||
article_pipeline_configured: false
|
||||
eeat_checklist_active: false
|
||||
geo_checklist_active: false
|
||||
internal_linking_rules_active: false
|
||||
analytics_connected: false
|
||||
publishing_calendar_active: false
|
||||
```
|
||||
|
||||
## Szybka decyzja architektoniczna
|
||||
|
||||
- [ ] Użyj jednej firmy/workspace w PaperClip dla całego systemu.
|
||||
- [ ] Utwórz osobny projekt dla każdego bloga.
|
||||
- [ ] Ustaw personalny blog jako główny authority hub.
|
||||
- [ ] Ustaw blogi niszowe jako spoke projects.
|
||||
- [ ] Nie twórz osobnej firmy dla każdego bloga, chyba że blogi należą do różnych klientów lub marek.
|
||||
- [ ] Nie mieszaj wszystkich tematów w jednym projekcie.
|
||||
- [ ] Nie publikuj tego samego tematu w wielu blogach w podobnej formie.
|
||||
|
||||
## Struktura firmy w PaperClip
|
||||
|
||||
- [ ] Utwórz firmę/workspace: `DexterTeam Content Network`.
|
||||
- [ ] Ustaw język główny: `pl`.
|
||||
- [ ] Ustaw język dodatkowy, jeśli potrzebny: `en`.
|
||||
- [ ] Zdefiniuj typ systemu: `hub-and-spoke multi-blog`.
|
||||
- [ ] Dodaj opis firmy jako centrum zarządzania treścią, nie jako pojedynczy blog.
|
||||
- [ ] Dodaj globalne zasady publikacji.
|
||||
- [ ] Dodaj globalne zasady AI disclosure.
|
||||
- [ ] Dodaj globalne zasady E-E-A-T.
|
||||
- [ ] Dodaj globalne zasady GEO.
|
||||
- [ ] Dodaj globalne zasady linkowania między blogami.
|
||||
|
||||
## Projekty blogowe
|
||||
|
||||
### Personal Authority Hub
|
||||
|
||||
- [ ] Utwórz projekt: `Personal Authority Hub`.
|
||||
- [ ] Ustaw rolę projektu: `authority_hub`.
|
||||
- [ ] Ustaw cel: author entity, reputacja, portfolio, metodologia, mapa tematów.
|
||||
- [ ] Dodaj strony:
|
||||
- [ ] `About`
|
||||
- [ ] `Projects`
|
||||
- [ ] `Uses`
|
||||
- [ ] `Now`
|
||||
- [ ] `Methodology`
|
||||
- [ ] `Disclosure`
|
||||
- [ ] `Contact`
|
||||
- [ ] `Correction Policy`
|
||||
- [ ] Dodaj stronę z mapą wszystkich blogów.
|
||||
- [ ] Dodaj linki do najważniejszych pillar pages z blogów niszowych.
|
||||
- [ ] Dodaj opis doświadczenia zawodowego i technicznego.
|
||||
- [ ] Dodaj listę obszarów eksperckich.
|
||||
- [ ] Dodaj politykę użycia AI.
|
||||
|
||||
### OpenClaw / AI Agents Blog
|
||||
|
||||
- [ ] Utwórz projekt: `OpenClaw / AI Agents Blog`.
|
||||
- [ ] Ustaw rolę: `niche_blog`.
|
||||
- [ ] Przypisz parent hub: `Personal Authority Hub`.
|
||||
- [ ] Zdefiniuj zakres:
|
||||
- [ ] OpenClaw
|
||||
- [ ] AI agents
|
||||
- [ ] prompt engineering
|
||||
- [ ] LLM automation
|
||||
- [ ] PaperClip pipeline
|
||||
- [ ] self-hosted AI
|
||||
- [ ] Utwórz pierwsze klastry tematyczne.
|
||||
- [ ] Dodaj link do author entity.
|
||||
|
||||
### Self-hosted DevOps Blog
|
||||
|
||||
- [ ] Utwórz projekt: `Self-hosted DevOps Blog`.
|
||||
- [ ] Ustaw rolę: `niche_blog`.
|
||||
- [ ] Przypisz parent hub.
|
||||
- [ ] Zdefiniuj zakres:
|
||||
- [ ] Docker
|
||||
- [ ] Docker Compose
|
||||
- [ ] Linux
|
||||
- [ ] VPS
|
||||
- [ ] Nginx Proxy Manager
|
||||
- [ ] monitoring
|
||||
- [ ] backups
|
||||
- [ ] self-hosted tools
|
||||
- [ ] Utwórz klastry tematyczne.
|
||||
- [ ] Dodaj link do author entity.
|
||||
|
||||
### Database Engineering Blog
|
||||
|
||||
- [ ] Utwórz projekt: `Database Engineering Blog`.
|
||||
- [ ] Ustaw rolę: `niche_blog`.
|
||||
- [ ] Przypisz parent hub.
|
||||
- [ ] Zdefiniuj zakres:
|
||||
- [ ] Oracle
|
||||
- [ ] SQL Server
|
||||
- [ ] PostgreSQL
|
||||
- [ ] backup
|
||||
- [ ] high availability
|
||||
- [ ] troubleshooting
|
||||
- [ ] performance
|
||||
- [ ] migration
|
||||
- [ ] Utwórz klastry tematyczne.
|
||||
- [ ] Dodaj link do author entity.
|
||||
|
||||
### CMS / WordPress / Ghost Blog
|
||||
|
||||
- [ ] Utwórz projekt: `CMS / WordPress / Ghost Blog`.
|
||||
- [ ] Ustaw rolę: `niche_blog`.
|
||||
- [ ] Przypisz parent hub.
|
||||
- [ ] Zdefiniuj zakres:
|
||||
- [ ] WordPress
|
||||
- [ ] Ghost CMS
|
||||
- [ ] SEO techniczne
|
||||
- [ ] publikowanie treści
|
||||
- [ ] architektura CMS
|
||||
- [ ] multi-site content
|
||||
- [ ] Utwórz klastry tematyczne.
|
||||
- [ ] Dodaj link do author entity.
|
||||
|
||||
### Paper Models Blog
|
||||
|
||||
- [ ] Utwórz projekt: `Paper Models Blog`.
|
||||
- [ ] Ustaw rolę: `niche_blog`.
|
||||
- [ ] Przypisz parent hub.
|
||||
- [ ] Zdefiniuj zakres:
|
||||
- [ ] modele kartonowe
|
||||
- [ ] papermodeling
|
||||
- [ ] instrukcje
|
||||
- [ ] recenzje
|
||||
- [ ] kolekcje
|
||||
- [ ] narzędzia
|
||||
- [ ] Utwórz klastry tematyczne.
|
||||
- [ ] Dodaj link do author entity.
|
||||
|
||||
## Globalny author entity
|
||||
|
||||
- [ ] Utwórz jeden globalny profil autora.
|
||||
- [ ] Dodaj imię, nazwisko lub markę autora.
|
||||
- [ ] Dodaj główny URL profilu autora.
|
||||
- [ ] Dodaj krótki opis autora.
|
||||
- [ ] Dodaj długi opis autora.
|
||||
- [ ] Dodaj zdjęcie lub avatar.
|
||||
- [ ] Dodaj role:
|
||||
- [ ] Full-stack developer
|
||||
- [ ] DevOps engineer
|
||||
- [ ] Database administrator
|
||||
- [ ] CMS specialist
|
||||
- [ ] AI automation builder
|
||||
- [ ] Dodaj doświadczenie:
|
||||
- [ ] 25+ lat Oracle i SQL Server
|
||||
- [ ] architektura baz danych
|
||||
- [ ] high availability
|
||||
- [ ] backup i recovery
|
||||
- [ ] Docker i Linux
|
||||
- [ ] WordPress i Ghost
|
||||
- [ ] OpenClaw i PaperClip
|
||||
- [ ] Dodaj linki `sameAs`:
|
||||
- [ ] GitHub
|
||||
- [ ] LinkedIn
|
||||
- [ ] personalny blog
|
||||
- [ ] repozytoria projektów
|
||||
- [ ] strony projektów
|
||||
- [ ] Dodaj politykę korekt.
|
||||
- [ ] Dodaj politykę kontaktu.
|
||||
- [ ] Dodaj politykę AI disclosure.
|
||||
|
||||
## Biblioteka promptów
|
||||
|
||||
- [ ] Utwórz folder `prompts/global`.
|
||||
- [ ] Utwórz folder `prompts/hub`.
|
||||
- [ ] Utwórz folder `prompts/niche`.
|
||||
- [ ] Utwórz folder `prompts/quality`.
|
||||
- [ ] Utwórz folder `prompts/publishing`.
|
||||
|
||||
### Prompty globalne
|
||||
|
||||
- [ ] `00-author-entity.md`
|
||||
- [ ] `01-eeat-policy.md`
|
||||
- [ ] `02-geo-policy.md`
|
||||
- [ ] `03-ai-disclosure.md`
|
||||
- [ ] `04-source-verification.md`
|
||||
- [ ] `05-internal-linking.md`
|
||||
- [ ] `06-frontmatter-template.md`
|
||||
- [ ] `07-schema-template.md`
|
||||
|
||||
### Prompty dla personalnego hubu
|
||||
|
||||
- [ ] `hub-authority-article.md`
|
||||
- [ ] `personal-case-study.md`
|
||||
- [ ] `project-retrospective.md`
|
||||
- [ ] `methodology-page.md`
|
||||
- [ ] `portfolio-update.md`
|
||||
- [ ] `monthly-build-log.md`
|
||||
|
||||
### Prompty dla blogów niszowych
|
||||
|
||||
- [ ] `pillar-page.md`
|
||||
- [ ] `spoke-article.md`
|
||||
- [ ] `technical-how-to.md`
|
||||
- [ ] `troubleshooting-guide.md`
|
||||
- [ ] `comparison-article.md`
|
||||
- [ ] `glossary-entry.md`
|
||||
- [ ] `case-study.md`
|
||||
- [ ] `tool-review.md`
|
||||
|
||||
### Prompty jakościowe
|
||||
|
||||
- [ ] `eeat-review.md`
|
||||
- [ ] `geo-review.md`
|
||||
- [ ] `seo-review.md`
|
||||
- [ ] `internal-link-review.md`
|
||||
- [ ] `cannibalization-review.md`
|
||||
- [ ] `final-editorial-check.md`
|
||||
|
||||
## Model routing
|
||||
|
||||
- [ ] Ustaw model strategiczny: `Claude Opus 4.7`.
|
||||
- [ ] Ustaw model produkcyjny do pisania: `Claude Sonnet 4.6`.
|
||||
- [ ] Ustaw model researchowy: `Gemini 3.1 Pro`.
|
||||
- [ ] Ustaw model do walidacji logicznej: `GPT-5.4`.
|
||||
- [ ] Ustaw model redakcyjny: `Claude Sonnet 4.6`.
|
||||
- [ ] Zapisz routing modeli w konfiguracji PaperClip.
|
||||
|
||||
```yaml
|
||||
model_routing:
|
||||
strategy: Claude Opus 4.7
|
||||
writing: Claude Sonnet 4.6
|
||||
research: Gemini 3.1 Pro
|
||||
reasoning_review: GPT-5.4
|
||||
final_editor: Claude Sonnet 4.6
|
||||
```
|
||||
|
||||
## Pipeline artykułu
|
||||
|
||||
- [ ] Utwórz etap `topic_intake`.
|
||||
- [ ] Utwórz etap `project_routing`.
|
||||
- [ ] Utwórz etap `keyword_and_intent_mapping`.
|
||||
- [ ] Utwórz etap `cluster_assignment`.
|
||||
- [ ] Utwórz etap `source_research`.
|
||||
- [ ] Utwórz etap `outline_generation`.
|
||||
- [ ] Utwórz etap `draft_generation`.
|
||||
- [ ] Utwórz etap `eeat_enrichment`.
|
||||
- [ ] Utwórz etap `geo_enrichment`.
|
||||
- [ ] Utwórz etap `internal_linking`.
|
||||
- [ ] Utwórz etap `metadata_generation`.
|
||||
- [ ] Utwórz etap `quality_review`.
|
||||
- [ ] Utwórz etap `publish_ready_export`.
|
||||
|
||||
## Routing tematu
|
||||
|
||||
Przed wygenerowaniem artykułu sprawdź:
|
||||
|
||||
- [ ] Czy temat dotyczy osoby, reputacji, portfolio lub metodologii?
|
||||
- [ ] Jeśli tak, wybierz `Personal Authority Hub`.
|
||||
- [ ] Czy temat dotyczy konkretnego problemu technicznego?
|
||||
- [ ] Jeśli tak, wybierz odpowiedni blog niszowy.
|
||||
- [ ] Czy temat pasuje do więcej niż jednego bloga?
|
||||
- [ ] Jeśli tak, wybierz jeden główny blog i zaplanuj linki do pozostałych.
|
||||
- [ ] Czy podobny temat już istnieje?
|
||||
- [ ] Jeśli tak, zdecyduj: update, merge, redirect albo nowy angle.
|
||||
- [ ] Czy temat ma przypisany `cluster_id`?
|
||||
- [ ] Czy temat ma rolę: `hub`, `spoke`, `support`, `glossary`, `case_study`?
|
||||
- [ ] Czy temat ma jasną intencję wyszukiwania?
|
||||
|
||||
## SEO checklist dla każdego artykułu
|
||||
|
||||
- [ ] Primary keyword wybrany.
|
||||
- [ ] Secondary keywords wybrane.
|
||||
- [ ] Search intent określony.
|
||||
- [ ] Tytuł zawiera primary keyword.
|
||||
- [ ] Pierwszy akapit zawiera primary keyword.
|
||||
- [ ] Jeden nagłówek H2/H3 zawiera primary keyword lub wariant.
|
||||
- [ ] Slug jest krótki i opisowy.
|
||||
- [ ] Meta title ma mniej niż 60 znaków.
|
||||
- [ ] Meta description ma mniej niż 160 znaków.
|
||||
- [ ] Artykuł ma logiczne H2/H3.
|
||||
- [ ] Artykuł odpowiada na główne pytanie szybko.
|
||||
- [ ] Artykuł ma linki wewnętrzne.
|
||||
- [ ] Artykuł ma źródła zewnętrzne, jeśli temat ich wymaga.
|
||||
- [ ] Artykuł nie powiela istniejącego tekstu.
|
||||
- [ ] Artykuł ma zaplanowany update cadence.
|
||||
|
||||
## E-E-A-T checklist
|
||||
|
||||
- [ ] Autor jest jasno wskazany.
|
||||
- [ ] Artykuł linkuje do profilu autora.
|
||||
- [ ] Artykuł pokazuje doświadczenie praktyczne.
|
||||
- [ ] Artykuł zawiera konkretne przykłady.
|
||||
- [ ] Artykuł pokazuje kompetencje autora.
|
||||
- [ ] Artykuł nie udaje doświadczenia, którego nie podano.
|
||||
- [ ] Artykuł ma sekcję ograniczeń lub założeń.
|
||||
- [ ] Artykuł ma datę publikacji.
|
||||
- [ ] Artykuł ma datę aktualizacji, jeśli temat jest zmienny.
|
||||
- [ ] Artykuł ma informację o użyciu AI, jeśli AI pomagało w tworzeniu.
|
||||
- [ ] Artykuł ma źródła lub evidence pack.
|
||||
- [ ] Artykuł ma jasne rozróżnienie między opinią, doświadczeniem i faktem.
|
||||
- [ ] Artykuł ma politykę korekt lub link do niej.
|
||||
|
||||
## GEO checklist
|
||||
|
||||
- [ ] Artykuł ma TL;DR.
|
||||
- [ ] Artykuł ma krótką odpowiedź na główne pytanie.
|
||||
- [ ] Artykuł ma definicję głównego pojęcia.
|
||||
- [ ] Artykuł ma cytowalne bloki 1-2 zdania.
|
||||
- [ ] Artykuł ma tabelę porównawczą, jeśli temat tego wymaga.
|
||||
- [ ] Artykuł ma listę kroków lub procedurę.
|
||||
- [ ] Artykuł ma FAQ.
|
||||
- [ ] Artykuł ma evidence pack.
|
||||
- [ ] Artykuł ma jasne nagłówki.
|
||||
- [ ] Artykuł ma sekcję ograniczeń.
|
||||
- [ ] Artykuł zawiera dane, cytaty lub źródła, jeśli są potrzebne.
|
||||
- [ ] Artykuł jest łatwy do zacytowania przez AI answer engines.
|
||||
|
||||
## Linkowanie wewnętrzne
|
||||
|
||||
- [ ] Artykuł ma link do właściwej strony huba, jeśli pomaga zrozumieć autora lub metodologię.
|
||||
- [ ] Artykuł ma link do pillar page w swoim klastrze.
|
||||
- [ ] Artykuł ma linki do powiązanych spoke articles.
|
||||
- [ ] Linki między blogami są kontekstowe.
|
||||
- [ ] Anchor text jest naturalny i opisowy.
|
||||
- [ ] Nie ma linków dodanych wyłącznie dla SEO.
|
||||
- [ ] Nie ma sitewide spam links.
|
||||
- [ ] Nie ma linkowania do każdego bloga na siłę.
|
||||
- [ ] Linki wychodzące są uzasadnione.
|
||||
- [ ] Linki są sprawdzone technicznie.
|
||||
|
||||
## Frontmatter checklist
|
||||
|
||||
- [ ] `title`
|
||||
- [ ] `slug`
|
||||
- [ ] `project_id`
|
||||
- [ ] `project_role`
|
||||
- [ ] `cluster_id`
|
||||
- [ ] `cluster_role`
|
||||
- [ ] `primary_keyword`
|
||||
- [ ] `secondary_keywords`
|
||||
- [ ] `search_intent`
|
||||
- [ ] `target_audience`
|
||||
- [ ] `author_entity`
|
||||
- [ ] `author_profile_url`
|
||||
- [ ] `ai_assisted`
|
||||
- [ ] `human_reviewed_by`
|
||||
- [ ] `source_verified`
|
||||
- [ ] `first_hand_experience_required`
|
||||
- [ ] `eeat_angle`
|
||||
- [ ] `geo_blocks_required`
|
||||
- [ ] `internal_links_required`
|
||||
- [ ] `external_sources_required`
|
||||
- [ ] `canonical_url`
|
||||
- [ ] `status`
|
||||
- [ ] `created_at`
|
||||
- [ ] `updated_at`
|
||||
|
||||
## Schema checklist
|
||||
|
||||
- [ ] `Person`
|
||||
- [ ] `ProfilePage`
|
||||
- [ ] `Organization`, jeśli dotyczy.
|
||||
- [ ] `WebSite`
|
||||
- [ ] `Article` lub `BlogPosting`
|
||||
- [ ] `BreadcrumbList`
|
||||
- [ ] `FAQPage`, jeśli artykuł ma FAQ.
|
||||
- [ ] `sameAs` dla autora.
|
||||
- [ ] `author` wskazuje właściwe author entity.
|
||||
- [ ] `publisher` wskazuje właściwy projekt lub organizację.
|
||||
- [ ] `datePublished`
|
||||
- [ ] `dateModified`
|
||||
- [ ] `mainEntityOfPage`
|
||||
|
||||
## Publishing calendar
|
||||
|
||||
- [ ] Ustal realną pojemność publikacyjną tygodniowo.
|
||||
- [ ] Personal hub publikuje mniej, ale strategicznie.
|
||||
- [ ] Blogi niszowe publikują regularnie spoke articles.
|
||||
- [ ] Każdy tydzień ma przypisane projekty.
|
||||
- [ ] Każdy temat ma przypisany cluster_id.
|
||||
- [ ] Każdy temat ma przypisany model.
|
||||
- [ ] Każdy temat ma status.
|
||||
- [ ] Każdy temat ma owner/reviewer.
|
||||
- [ ] Każdy temat ma datę publikacji.
|
||||
- [ ] Każdy temat ma datę aktualizacji lub recheck.
|
||||
|
||||
Przykład minimalnego rytmu:
|
||||
|
||||
```text
|
||||
Tydzień:
|
||||
- 1 artykuł strategiczny albo build log na personal hub
|
||||
- 2 artykuły spoke na blogach niszowych
|
||||
- 1 update istniejącego artykułu
|
||||
- 1 audyt linkowania lub klastra
|
||||
```
|
||||
|
||||
## Quality gate przed publikacją
|
||||
|
||||
- [ ] Artykuł ma status `draft`.
|
||||
- [ ] Artykuł przeszedł `project_routing`.
|
||||
- [ ] Artykuł przeszedł `seo_review`.
|
||||
- [ ] Artykuł przeszedł `eeat_review`.
|
||||
- [ ] Artykuł przeszedł `geo_review`.
|
||||
- [ ] Artykuł przeszedł `internal_link_review`.
|
||||
- [ ] Artykuł przeszedł `cannibalization_review`.
|
||||
- [ ] Artykuł ma kompletne frontmatter.
|
||||
- [ ] Artykuł ma wskazane schema.
|
||||
- [ ] Artykuł ma AI disclosure, jeśli potrzebne.
|
||||
- [ ] Artykuł ma oznaczone TODO, jeśli wymaga testów.
|
||||
- [ ] Artykuł ma status `publish_ready`.
|
||||
|
||||
## Czego nie publikować
|
||||
|
||||
- [ ] Nie publikuj tekstu bez przypisanego projektu.
|
||||
- [ ] Nie publikuj tekstu bez cluster_id.
|
||||
- [ ] Nie publikuj tekstu bez intencji wyszukiwania.
|
||||
- [ ] Nie publikuj tekstu, który powiela istniejący artykuł.
|
||||
- [ ] Nie publikuj tekstu z fałszywymi źródłami.
|
||||
- [ ] Nie publikuj tekstu z udawanym doświadczeniem autora.
|
||||
- [ ] Nie publikuj tekstu bez review, jeśli jest techniczny.
|
||||
- [ ] Nie publikuj tekstu z linkowaniem wyglądającym jak manipulacja SEO.
|
||||
- [ ] Nie publikuj tekstu masowego bez realnej wartości.
|
||||
|
||||
## Analytics i monitoring
|
||||
|
||||
- [ ] Podłącz Google Search Console lub odpowiednik dla każdej domeny.
|
||||
- [ ] Podłącz analytics dla każdego bloga.
|
||||
- [ ] Włącz cross-domain tracking, jeśli blogi działają na osobnych domenach.
|
||||
- [ ] Śledź ruch organiczny per projekt.
|
||||
- [ ] Śledź frazy per klaster.
|
||||
- [ ] Śledź CTR per artykuł.
|
||||
- [ ] Śledź pozycje pillar pages.
|
||||
- [ ] Śledź orphan pages.
|
||||
- [ ] Śledź broken links.
|
||||
- [ ] Śledź kanibalizację keywordów.
|
||||
- [ ] Śledź aktualizacje wymagane dla starych treści.
|
||||
- [ ] Śledź cytowania lub wzmianki w AI answer engines, jeśli ręcznie lub narzędziowo to sprawdzasz.
|
||||
|
||||
## Miesięczny audyt
|
||||
|
||||
- [ ] Sprawdź, czy personal hub nadal dobrze reprezentuje author entity.
|
||||
- [ ] Sprawdź, czy każdy blog niszowy ma jasny zakres.
|
||||
- [ ] Sprawdź, czy nie pojawiły się tematy poza zakresem.
|
||||
- [ ] Sprawdź, czy każdy klaster ma pillar page.
|
||||
- [ ] Sprawdź, czy spoke articles linkują do właściwego huba.
|
||||
- [ ] Sprawdź, czy nie ma orphan articles.
|
||||
- [ ] Sprawdź, czy nie ma kanibalizacji między blogami.
|
||||
- [ ] Sprawdź, czy linkowanie między domenami wygląda naturalnie.
|
||||
- [ ] Sprawdź, czy AI disclosure jest spójne.
|
||||
- [ ] Sprawdź, czy schema jest kompletna.
|
||||
- [ ] Sprawdź, które artykuły wymagają aktualizacji.
|
||||
- [ ] Zaplanuj tematy na kolejny miesiąc.
|
||||
|
||||
## Kwartalny audyt strategiczny
|
||||
|
||||
- [ ] Oceń, które blogi mają sens biznesowy i SEO.
|
||||
- [ ] Oceń, które klastry rosną.
|
||||
- [ ] Oceń, które klastry nie mają trakcji.
|
||||
- [ ] Zdecyduj, czy dodać nowy blog.
|
||||
- [ ] Zdecyduj, czy zamrozić słaby blog.
|
||||
- [ ] Zdecyduj, czy połączyć dwa klastry.
|
||||
- [ ] Zdecyduj, czy przenieść temat do innego projektu.
|
||||
- [ ] Zaktualizuj promptbook.
|
||||
- [ ] Zaktualizuj model routing.
|
||||
- [ ] Zaktualizuj checklisty QA.
|
||||
- [ ] Zaktualizuj author entity.
|
||||
|
||||
## Minimalny plan startowy na 14 dni
|
||||
|
||||
### Dzień 1-2
|
||||
|
||||
- [ ] Utwórz firmę w PaperClip.
|
||||
- [ ] Utwórz projekt `Personal Authority Hub`.
|
||||
- [ ] Utwórz globalny author entity.
|
||||
- [ ] Dodaj AI disclosure policy.
|
||||
- [ ] Dodaj correction policy.
|
||||
|
||||
### Dzień 3-4
|
||||
|
||||
- [ ] Utwórz projekt `OpenClaw / AI Agents`.
|
||||
- [ ] Utwórz projekt `Self-hosted DevOps`.
|
||||
- [ ] Zdefiniuj zakres każdego projektu.
|
||||
- [ ] Dodaj pierwsze topical maps.
|
||||
|
||||
### Dzień 5-6
|
||||
|
||||
- [ ] Utwórz bibliotekę promptów.
|
||||
- [ ] Dodaj prompty globalne.
|
||||
- [ ] Dodaj prompty dla hubu.
|
||||
- [ ] Dodaj prompty dla blogów niszowych.
|
||||
|
||||
### Dzień 7-8
|
||||
|
||||
- [ ] Skonfiguruj model routing.
|
||||
- [ ] Skonfiguruj pipeline artykułu.
|
||||
- [ ] Skonfiguruj frontmatter.
|
||||
- [ ] Skonfiguruj checklisty QA.
|
||||
|
||||
### Dzień 9-10
|
||||
|
||||
- [ ] Przygotuj pierwszy pillar page dla `OpenClaw / AI Agents`.
|
||||
- [ ] Przygotuj pierwszy pillar page dla `Self-hosted DevOps`.
|
||||
- [ ] Przygotuj stronę mapy tematów na personal hubie.
|
||||
|
||||
### Dzień 11-12
|
||||
|
||||
- [ ] Wygeneruj 2 pierwsze spoke articles.
|
||||
- [ ] Przeprowadź E-E-A-T review.
|
||||
- [ ] Przeprowadź GEO review.
|
||||
- [ ] Przeprowadź internal linking review.
|
||||
|
||||
### Dzień 13-14
|
||||
|
||||
- [ ] Opublikuj pierwsze treści.
|
||||
- [ ] Sprawdź linkowanie.
|
||||
- [ ] Sprawdź metadane.
|
||||
- [ ] Sprawdź schema.
|
||||
- [ ] Zapisz wnioski do promptbooka.
|
||||
|
||||
## Minimalny zestaw plików
|
||||
|
||||
```text
|
||||
paperclip/
|
||||
agent.md
|
||||
paperclip_multiblog_master_checklist.md
|
||||
config/
|
||||
company.yaml
|
||||
author_entity.yaml
|
||||
model_routing.yaml
|
||||
projects.yaml
|
||||
linking_rules.yaml
|
||||
publishing_pipeline.yaml
|
||||
prompts/
|
||||
global/
|
||||
hub/
|
||||
niche/
|
||||
quality/
|
||||
projects/
|
||||
personal_authority_hub.yaml
|
||||
openclaw_ai_agents.yaml
|
||||
self_hosted_devops.yaml
|
||||
database_engineering.yaml
|
||||
cms_wordpress_ghost.yaml
|
||||
paper_models.yaml
|
||||
```
|
||||
|
||||
## Finalna checklista gotowości systemu
|
||||
|
||||
- [ ] Jedna firma w PaperClip działa.
|
||||
- [ ] Personal Authority Hub działa.
|
||||
- [ ] Minimum dwa blogi niszowe działają.
|
||||
- [ ] Author entity jest wspólne.
|
||||
- [ ] Promptbook jest gotowy.
|
||||
- [ ] Model routing jest ustawiony.
|
||||
- [ ] Pipeline artykułu jest ustawiony.
|
||||
- [ ] Frontmatter jest kompletne.
|
||||
- [ ] Linkowanie ma jasne reguły.
|
||||
- [ ] E-E-A-T review działa.
|
||||
- [ ] GEO review działa.
|
||||
- [ ] SEO review działa.
|
||||
- [ ] Quality gate blokuje słabe teksty.
|
||||
- [ ] Kalendarz publikacji działa.
|
||||
- [ ] Analytics działa.
|
||||
- [ ] Miesięczny audyt jest zaplanowany.
|
||||
|
||||
@@ -0,0 +1,177 @@
|
||||
Perplexity nie ma gotowego wbudowanego connektora do PaperClip, ale ma **MCP (Model Context Protocol)** — czyli możesz podpiąć Perplexity jako search tool do PaperClip przez niestandardowy MCP server. To jest **jedyna sensowna droga** i działa świetnie — Researcher agent zamiast „udawać" że searchuje Reddit/YouTube, **faktycznie korzysta z Perplexity API** jako silnika wyszukiwania. [skywork](https://skywork.ai/skypage/en/npm-install-error-guide/2049079959030280192)
|
||||
|
||||
## Dwa podejścia
|
||||
|
||||
| Podejście | Jak | Dla kogo |
|
||||
|---|---|---|
|
||||
| **Perplexity API w PaperClip** | Researcher agent wywołuje `api.perplexity.ai` jako narzędzie HTTP | Twój przypadek — PaperClip jako orchestrator |
|
||||
| **PaperClip w Perplexity** | PaperClip wystawia MCP server, Perplexity Computer go łączy | Odwrotna integracja — pomijamy |
|
||||
|
||||
***
|
||||
|
||||
## Krok 1 — Klucz API Perplexity
|
||||
|
||||
```
|
||||
perplexity.ai → Settings → API → Generate API Key
|
||||
Skopiuj: pplx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
||||
```
|
||||
|
||||
Perplexity API jest zgodne z OpenAI SDK — te same endpointy, inny base URL. [skywork](https://skywork.ai/skypage/en/npm-install-error-guide/2049079959030280192)
|
||||
|
||||
***
|
||||
|
||||
## Krok 2 — Dwa modele do wyboru
|
||||
|
||||
W Perplexity API masz dwie kategorie modeli: [skywork](https://skywork.ai/skypage/en/npm-install-error-guide/2049079959030280192)
|
||||
|
||||
| Model | Co robi | Dla Researcher agenta |
|
||||
|---|---|---|
|
||||
| `sonar` | Szybki web search + odpowiedź | Reddit/YouTube trends — idealne |
|
||||
| `sonar-deep-research` | Wieloetapowy research z raportami | Głęboka analiza tematu |
|
||||
| `sonar-pro` | Rozbudowane odpowiedzi + search | Jeśli potrzebujesz więcej kontekstu |
|
||||
|
||||
Do Researcher agenta w Twoim pipeline → **`sonar`** lub **`sonar-pro`**.
|
||||
|
||||
***
|
||||
|
||||
## Krok 3 — Tool `perplexity_search` w PaperClip
|
||||
|
||||
W PaperClip definiujesz **custom HTTP tool** dla Researcher agenta. Agenci w PaperClip mogą wywoływać zewnętrzne API jako narzędzia.
|
||||
|
||||
### Definicja toola
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "perplexity_search",
|
||||
"description": "Search the web using Perplexity AI. Returns cited, up-to-date results from Reddit, YouTube, news, and other sources. Use for trend research, engagement data, and content discovery.",
|
||||
"method": "POST",
|
||||
"url": "https://api.perplexity.ai/chat/completions",
|
||||
"headers": {
|
||||
"Authorization": "Bearer {{PERPLEXITY_API_KEY}}",
|
||||
"Content-Type": "application/json"
|
||||
},
|
||||
"body": {
|
||||
"model": "sonar-pro",
|
||||
"messages": [
|
||||
{
|
||||
"role": "system",
|
||||
"content": "You are a research assistant. Return factual, cited findings with real URLs and real engagement data where available. Never fabricate numbers."
|
||||
},
|
||||
{
|
||||
"role": "user",
|
||||
"content": "{{query}}"
|
||||
}
|
||||
],
|
||||
"search_recency_filter": "week",
|
||||
"return_citations": true,
|
||||
"max_tokens": 2000
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
- `PERPLEXITY_API_KEY` → wpisz w Secrets/Env w PaperClip
|
||||
- `{{query}}` → agent wstawia swoje zapytanie dynamicznie
|
||||
- `search_recency_filter: "week"` → tylko treści z ostatnich 7 dni (pasuje do Twojej reguły 14 dni)
|
||||
|
||||
***
|
||||
|
||||
## Krok 4 — Zaktualizuj researcher.skill
|
||||
|
||||
Dodaj sekcję na końcu `researcher.skill`:
|
||||
|
||||
```markdown
|
||||
## Search Tool
|
||||
|
||||
You have access to: perplexity_search
|
||||
|
||||
Use it for every research query. Do NOT rely on internal knowledge
|
||||
for engagement data, URLs, or trending topics.
|
||||
|
||||
Per research query, call perplexity_search with:
|
||||
- Specific query targeting one platform and topic
|
||||
- Example: "Reddit r/Entrepreneur AI automation posts high engagement 2025"
|
||||
- Example: "YouTube trending videos AI workflow for business owners views"
|
||||
- Example: "r/SaaS Claude n8n automation posts upvotes this week"
|
||||
|
||||
Make 5-8 focused calls per pipeline run:
|
||||
1. "Reddit AI automation for business owners trending posts this week"
|
||||
2. "Reddit r/ChatGPT solopreneur AI workflow high engagement 2025"
|
||||
3. "Reddit r/smallbusiness AI tools replace manual work top posts"
|
||||
4. "YouTube AI business automation workflow results trending 2025"
|
||||
5. "YouTube solo founder AI stack review high view count this week"
|
||||
6. "Reddit r/Entrepreneur AI tools time savings concrete results"
|
||||
|
||||
Extract from results:
|
||||
- Real post titles and URLs from citations
|
||||
- Engagement signals mentioned in content
|
||||
- Publishing dates
|
||||
- Discussion themes and sentiment
|
||||
|
||||
IMPORTANT: If perplexity_search returns no real URL for an idea
|
||||
→ do NOT fabricate one. Flag as "URL not verified".
|
||||
```
|
||||
|
||||
***
|
||||
|
||||
## Krok 5 — Opcjonalnie: MCP server dla pełnej integracji
|
||||
|
||||
Jeśli chcesz żeby **Perplexity Computer używał PaperClip** (odwrotna integracja), musisz wystawić MCP server z PaperClip i dodać go w Perplexity Settings → Custom Remote Connectors. [docs.openclaw](https://docs.openclaw.ai/install/updating)
|
||||
|
||||
```
|
||||
Perplexity Settings → Connectors → + Custom connector → Remote
|
||||
Name: PaperClip Pipeline
|
||||
MCP Server URL: https://twoj-paperclip.domain.com/mcp/sse
|
||||
Authentication: API Key
|
||||
```
|
||||
|
||||
Ale to jest odwrotna integracja — **na razie nie potrzebujesz** tego do pipeline'u bloga. [docs.openclaw](https://docs.openclaw.ai/install/updating)
|
||||
|
||||
***
|
||||
|
||||
## Jak to działa w praktyce
|
||||
|
||||
```
|
||||
CEO: "Run social media pipeline"
|
||||
│
|
||||
▼
|
||||
Researcher agent ← blog-registry.skill + researcher.skill
|
||||
│
|
||||
├── perplexity_search("Reddit AI automation business owners week")
|
||||
│ ← zwraca: 5 cytowanych postów z Reddit z datami i URLami
|
||||
│
|
||||
├── perplexity_search("YouTube solopreneur AI workflow trending")
|
||||
│ ← zwraca: 4 filmy z view count estimates i tematami
|
||||
│
|
||||
├── perplexity_search("Claude n8n workflow results business")
|
||||
│ ← zwraca: konkretne posty, liczby, engagement signals
|
||||
│
|
||||
└── Kompiluje ~10 idei z prawdziwymi URLami → Selector
|
||||
```
|
||||
|
||||
***
|
||||
|
||||
## Koszty
|
||||
|
||||
Perplexity API pricing dla `sonar-pro`: [skywork](https://skywork.ai/skypage/en/npm-install-error-guide/2049079959030280192)
|
||||
|
||||
| Co | Koszt |
|
||||
|---|---|
|
||||
| Input tokens | $3 / 1M |
|
||||
| Output tokens | $15 / 1M |
|
||||
| Search queries | $5 / 1000 requests |
|
||||
|
||||
Jeden pipeline run Researcher agenta (5-8 zapytań) → **~$0.04–0.08** za uruchomienie. Przy tygodniowym schedule na 3 blogi → **~$1/miesiąc** za research.
|
||||
|
||||
***
|
||||
|
||||
## Jeden plik do zaktualizowania
|
||||
|
||||
Jedyna zmiana którą musisz zrobić w pakiecie który już masz:
|
||||
|
||||
1. Dodaj sekcję `## Search Tool` do `researcher.skill` (kod powyżej)
|
||||
2. W PaperClip zdefiniuj tool `perplexity_search` z kluczem API
|
||||
3. Przypisz tool do Researcher agenta
|
||||
|
||||
Reszta pipeline'u (Selector, SEO, Writer, QA) działa bez zmian — oni operują na outputach Researchera, nie na zewnętrznych API.
|
||||
|
||||
Chcesz żebym zaktualizował `researcher.skill` z tą sekcją i wygenerował nową paczkę plików?
|
||||
@@ -0,0 +1,226 @@
|
||||
<img src="https://r2cdn.perplexity.ai/pplx-full-logo-primary-dark%402x.png" style="height:64px;margin-right:32px"/>
|
||||
|
||||
# Ogarnij dla mnie strategiczne podejście, mam ppomysły na blogi
|
||||
|
||||
1. mńj blog personalny gdzie będę dzielił się moimi personalnymi rzeczami, spajał całość pod kontem mojej działalności, będzie to taka moja wizytówka paweldomanski.eu
|
||||
2. Blog poświęcnony bazom danych dbadmin.pl
|
||||
3. Blog poświęcony AI, automatyzacji i wszystkiemu co jest na topie
|
||||
4. Blogi poświęcone tworzeniu stron internetowych, jak je ogarniać jaak robić jak tworzyć i utrzymywać, z tego mam zamiar zarabiać na tworzeniu stron internetowych
|
||||
5. Blog poświęcony produktywności, jak zarządzać sobą w czasie
|
||||
|
||||
Masz 5 bardzo różnych pomysłów i kluczowe pytanie strategiczne brzmi: **hub-and-spoke czy 5 oddzielnych bytów?** Na podstawie Twojego profilu i niszy odpowiedź jest jasna — model mieszany, z `paweldomanski.eu` jako centrum i 2-3 aktywnymi satelitami, a reszta w standby.[^1][^2]
|
||||
|
||||
***
|
||||
|
||||
## Diagnoza każdego bloga
|
||||
|
||||
Zanim strategia — każdy blog przez ten sam filtr: **audience, monetyzacja, wysiłek, SEO szansa, priorytet**.
|
||||
|
||||
|
||||
| Blog | Audience | Monetyzacja | SEO szansa PL | Wysiłek/tydzień | Priorytet |
|
||||
| :-- | :-- | :-- | :-- | :-- | :-- |
|
||||
| `paweldomanski.eu` | Klienci, partnerzy, rekruterzy | Lead gen, konwersja | niszowa / branded | 1-2 posty | 🔴 Teraz |
|
||||
| `dbadmin.pl` | DBA Oracle/MSSQL, architekci | Konsulting, kursy, B2B | wysoka, mało konkurencji PL | 1 post/2tyg | 🟡 Q3 |
|
||||
| AI / automatyzacja | Właściciele firm, "AI enjoyers" | Affiliaty, kursy, sponsorzy | wysoka, duża konkurencja | 2-3 posty | 🟡 Q3 |
|
||||
| Tworzenie stron | MŚP szukające wykonawcy, DIY | **Główne źródło przychodów** | wysoka, lokalna PL | 2-3 posty | 🔴 Teraz |
|
||||
| Produktywność | Wszyscy → bardzo szeroka | Trudna do monetyzacji | bardzo wysoka konkurencja | 2-3 posty | 🔵 Opcjonalnie |
|
||||
|
||||
|
||||
***
|
||||
|
||||
## Rekomendowana strategia — Hub + 2 aktywne spokes
|
||||
|
||||
### Model
|
||||
|
||||
```
|
||||
paweldomanski.eu
|
||||
(HUB — Twoja marka osobista)
|
||||
│
|
||||
┌───────────┼───────────┐
|
||||
│ │ │
|
||||
[strony] [dbadmin] [AI/prod]
|
||||
aktywny aktywny scalony
|
||||
spoke spoke spoke
|
||||
```
|
||||
|
||||
`paweldomanski.eu` to nie kolejny blog — to **Twoje centrum biznesowe**. Każdy klient, partner czy czytelnik dowolnego bloga, który chce Cię zatrudnić lub kupić coś od Ciebie, ląduje tutaj. To miejsce które spaja wszystko: DBA, web dev, AI, człowiek za tym wszystkim.[^2][^1]
|
||||
|
||||
***
|
||||
|
||||
## Blog po blogu
|
||||
|
||||
### 1. `paweldomanski.eu` — START TERAZ
|
||||
|
||||
**Cel: lead generation i wiarygodność, nie traffic.**
|
||||
|
||||
Nie jest to blog w tradycyjnym sensie — to **digital home base**:
|
||||
|
||||
- Strona główna: czym się zajmujesz, dla kogo, jak pomóc
|
||||
- Portfolio / case studies
|
||||
- Krótki blog z 1-2 artykułami miesięcznie, crosspostami z pozostałych blogów
|
||||
- Linki do wszystkich projektów (dbadmin, AI blog, GitHub, OpenClaw)
|
||||
- Kontakt / formularz do zlecenia pracy
|
||||
|
||||
To SEO dla branded keyword "Paweł Domański" i długi ogon "konsultant Oracle Mazowsze", "wdrożenie bazy danych WordPress".[^1][^2]
|
||||
|
||||
**Co pisać:** Retrospektywy projektów, podsumowania tygodnia, personal takes na branżę, crossposty z dbadmin i AI bloga. Minimum wysiłku, maksimum wiarygodności.
|
||||
|
||||
***
|
||||
|
||||
### 2. Blog tworzenia stron — START TERAZ, priorytet monetyzacyjny
|
||||
|
||||
**Cel: pozyskiwanie klientów przez SEO + konwersja na usługę.**
|
||||
|
||||
To Twój **najważniejszy blog komercyjnie** i jednocześnie najłatwiejszy do monetyzacji, bo pisanie o web dev = demonstracja umiejętności = sprzedaż usługi. Ktoś czyta "jak zrobić stronę WordPress dla restauracji" → widzi że piszesz kompetentnie → zleca wykonanie.[^3][^4]
|
||||
|
||||
**Strategia treści — 3 filary:**
|
||||
|
||||
- **Tutorial / how-to:** "Jak zrobić stronę dla małej firmy w WordPress" — SEO long-tail, duży ruch PL
|
||||
- **Case study:** "Zbudowałem stronę dla X w Y dni za Z zł — co wyszło" — konwersja leadów
|
||||
- **Produktywność techniczna:** "Jak hostować 5 klientów na jednym VPS" — wiarygodność eksperta
|
||||
|
||||
**Monetyzacja:**
|
||||
|
||||
- CTA na każdym artykule: "Wolisz żeby ktoś to za Ciebie zrobił? → Skontaktuj się"
|
||||
- Pakiety usług (landing page, strona firmowa, sklep)
|
||||
- Opcjonalnie: szablon / starter kit do sprzedaży
|
||||
|
||||
**Gdzie postawić:** Osobna domena (np. `weblab.pl`, `webmaster.pl` albo coś co odda niszę) **lub** jako `paweldomanski.eu/web` — na początku wystarczy podkatalog.
|
||||
|
||||
***
|
||||
|
||||
### 3. `dbadmin.pl` — Q3 2025, niszowy ale solidny
|
||||
|
||||
**Cel: autorytet ekspercki + B2B konsulting.**
|
||||
|
||||
Niszowy blog DBA Oracle/MSSQL w Polsce to **praktycznie puste pole**. Polska konkurencja jest minimalna, a każdy DBA szukający rozwiązania problemu z RAC albo AlwaysOn po polsku to potencjalny czytelnik / klient konsultingu.[^2]
|
||||
|
||||
**Strategia treści:**
|
||||
|
||||
- "Jak skonfigurować X w Oracle RAC" — konkretne how-to
|
||||
- "Migracja z Oracle do PostgreSQL — co naprawdę warto wiedzieć"
|
||||
- "IBM Spectrum Protect backup setup krok po kroku"
|
||||
- Post-mortemy: "Straciłem dane produkcyjne — co zrobiłem źle"
|
||||
|
||||
**Monetyzacja:**
|
||||
|
||||
- Konsulting B2B (firmy z Oracle/MSSQL w środowisku)
|
||||
- Kurs online: "Oracle DBA dla programistów"
|
||||
- Linki do `paweldomanski.eu` → konwersja na zlecenia
|
||||
|
||||
**Kiedy zacząć:** Gdy `paweldomanski.eu` i blog webowy są już rozruchowane. Jeden artykuł na 2 tygodnie wystarczy na start.
|
||||
|
||||
***
|
||||
|
||||
### 4. Blog AI / automatyzacja — Q3, ale SCAL z produktywnością
|
||||
|
||||
**Rekomendacja: połącz blog AI i blog produktywności w jeden.**[^5][^1]
|
||||
|
||||
Ich audiencja jest identyczna: **człowiek który chce robić więcej mniejszym wysiłkiem**. Separacja tych dwóch blogów to podwójny wysiłek, podwójne SEO rozproszenie, brak synergii. Tytuł bloga powinien łączyć oba wymiary — np. `efektywnosc.ai`, `autoflow.pl` albo sekcja na `paweldomanski.eu`.[^5]
|
||||
|
||||
**Strategia treści — 3 filary:**
|
||||
|
||||
- **Narzędzia AI w praktyce:** "Jak używam Claude do pisania dokumentacji DBA w 10 minut"
|
||||
- **Workflow i automatyzacja:** "Mój stack n8n + Directus + PaperClip — jak to wygląda po 3 miesiącach"
|
||||
- **Produktywność systemowa:** "Org-mode jako system zarządzania projektami — setup który działa"
|
||||
|
||||
**Monetyzacja (długofalowa):**
|
||||
|
||||
- Affiliaty (narzędzia AI, hosting, narzędzia produktywności)
|
||||
- Newsletter premium
|
||||
- Kurs "AI workflow dla freelancerów"
|
||||
|
||||
**Synergis z resztą:** Artykuły AI i automatyzacji crosspostowane do `paweldomanski.eu`. Narzędzia web dev opisane zarówno na blogu webowym, jak i AI/workflow.
|
||||
|
||||
***
|
||||
|
||||
### 5. Blog produktywności — WCHŁOŃ do AI bloga
|
||||
|
||||
**Nie twórz osobnego bytu.** Produktywność jako oddzielny blog w 2025 to bardzo zatłoczona nisza z dużą konkurencją i trudną monetyzacją. Jako **kategoria wewnątrz bloga AI/automatyzacja** — ma sens i wzmacnia całość bez dodatkowego kosztu operacyjnego.[^1][^5]
|
||||
|
||||
***
|
||||
|
||||
## Mapa priorytetów i sekwencja
|
||||
|
||||
```
|
||||
TERAZ (maj-czerwiec)
|
||||
────────────────────────────────
|
||||
1. paweldomanski.eu
|
||||
Postawić, wypełnić, opisać usługi webowe i DBA.
|
||||
Minimum: strona główna + kontakt + 2-3 posty.
|
||||
To Twoja tarcza konwersji dla wszystkiego innego.
|
||||
|
||||
2. Blog webowy (usługi tworzenia stron)
|
||||
Pierwsze 5 artykułów tutorial/how-to.
|
||||
CTA na każdym artykule → kontakt przez paweldomanski.eu.
|
||||
SEO long-tail PL: "jak zrobić stronę dla firmy", "hosting WordPress".
|
||||
|
||||
Q3 (lipiec-wrzesień)
|
||||
────────────────────────────────
|
||||
3. dbadmin.pl — pierwsze 8 artykułów, formularz konsultingowy.
|
||||
4. AI + produktywność blog — połączony, pierwsze 6 artykułów.
|
||||
|
||||
Q4 (październik+)
|
||||
────────────────────────────────
|
||||
5. Wszystkie 4 blogi aktywne, crosslinkowanie, newsletter.
|
||||
6. Jeden pipeline PaperClip per blog → pełna automatyzacja treści.
|
||||
```
|
||||
|
||||
|
||||
***
|
||||
|
||||
## PaperClip pipeline per blog
|
||||
|
||||
Patrząc na Twoją architekturę PaperClip którą już budujesz — masz gotową strategię wdrożenia:
|
||||
|
||||
|
||||
| Blog | Company w PaperClip | blog-registry.skill | Priorytet wdrożenia |
|
||||
| :-- | :-- | :-- | :-- |
|
||||
| Tworzenie stron | `web-services-pl` | audience: MŚP, tone: ekspercki+praktyczny | Teraz |
|
||||
| `dbadmin.pl` | `dbadmin-pl` | audience: DBA/architekci, tone: techniczny | Q3 |
|
||||
| AI + produktywność | `ai-workflow-pl` | audience: freelancerzy/founders, tone: sharp | Q3 |
|
||||
| `paweldomanski.eu` | Ręcznie — nie potrzebuje pipeline | — | — |
|
||||
|
||||
`paweldomanski.eu` **nie potrzebuje pipeline** — tam piszesz personalnie i crosspostujesz. Trzy pozostałe blogi korzystają z gotowego pipeline który już zbudowałeś.
|
||||
|
||||
***
|
||||
|
||||
## Jeden kluczowy błąd do uniknięcia
|
||||
|
||||
Największe ryzyko w tym planie: **zacząć wszystko naraz**. Pięć blogów uruchomionych jednocześnie to gwarancja że żaden nie osiągnie masy krytycznej. Sekwencja jest ważniejsza niż kompletność. Dwa solidne blogi po 3 miesiącach > pięć pustych po tym samym czasie.[^2][^1]
|
||||
|
||||
Chcesz żebym teraz wygenerował Ci gotowe **Company profiles (Mission / Goal / Description)** dla każdego z 4 blogów do wklejenia bezpośrednio w PaperClip?
|
||||
<span style="display:none">[^10][^11][^12][^13][^14][^15][^6][^7][^8][^9]</span>
|
||||
|
||||
<div align="center">⁂</div>
|
||||
|
||||
[^1]: https://stuudios.com/blog/multi-niche-blog
|
||||
|
||||
[^2]: https://naf92.com/blog/unified-blog-vs-multiple-niche-blogs-how-i-chose-the-best-blogging-strategy/
|
||||
|
||||
[^3]: https://scholarships.ae/monetize-blog-niche-2025/
|
||||
|
||||
[^4]: https://www.interserver.net/tips/kb/top-monetization-strategies-for-blogging-2025/
|
||||
|
||||
[^5]: https://www.wisp.blog/blog/should-you-keep-a-single-blog-on-multiple-niches-or-have-multiple-blogs
|
||||
|
||||
[^6]: https://thrivewithnicola.com/new-blog-can-you-start-a-blog-in-2025-and-still-succeed-your-niche-is-you-and-all-of-your-interests/
|
||||
|
||||
[^7]: https://thetrainerstrainingcompany.co.uk/hub-and-spoke-blogging/
|
||||
|
||||
[^8]: https://publicmediasolution.com/blog/how-to-grow-your-multi-niche-blog-website-in-a-short-time/
|
||||
|
||||
[^9]: https://www.boldare.com/blog/top-10-web-development-companies-in-poland-for-2025/
|
||||
|
||||
[^10]: https://www.stellarcontent.com/blog/content-marketing/hub-spoke-model-content-marketing/
|
||||
|
||||
[^11]: https://www.blogengage.com/blog/2024/11/06/unleashing-potential-why-multi-niche-blogging-could-be-your-next-big-venture/
|
||||
|
||||
[^12]: https://frompolandwithdev.com/blog
|
||||
|
||||
[^13]: https://www.andy-chadwick.com/content/creating-content-hubs/
|
||||
|
||||
[^14]: https://www.makemetechy.com/2025/08/complete-guide-how-to-create-and-grow.html?m=1
|
||||
|
||||
[^15]: https://www.linkedin.com/posts/andrew-holland-seo_how-to-build-a-blog-in-2025-there-are-plenty-activity-7319661534815686658-mFKd
|
||||
|
||||
@@ -0,0 +1,613 @@
|
||||
Tak — mogę. Dla Twojego przypadku najlepiej nie pisać „jednego super promptu”, tylko komplet promptów kontraktowych dla całego pipeline’u: orchestrator, idea scoring, brief, research, writing, QA, publish, social i debrief, bo PaperClip dobrze działa tam, gdzie każdy agent ma jasne wejście, wyjście i approval gate, a Directus przechowuje wersje, drafty i stan publikacji. [directus](https://directus.io/docs/guides/content/content-versioning)
|
||||
|
||||
## Założenia
|
||||
|
||||
Twój obecny flow pluginu `content-machine` obejmuje już praktycznie cały proces blogowy, a frontend działa jako React dashboard w UI Paperclip, więc prompty powinny być pisane pod agentowe etapy, nie pod jednorazowe generowanie tekstu. Ponieważ wybrałeś Directus jako backend treści, prompty muszą zwracać ustrukturyzowane wyniki gotowe do zapisania jako rekordy lub artefakty wersjonowane, zamiast luźnych odpowiedzi tekstowych. [directus](https://directus.io/docs/guides/content/content-versioning)
|
||||
|
||||
Poniżej daję Ci gotowy zestaw promptów w stylu „production prompts”, do wklejenia do pluginu lub mapowania na komendy/akcje w PaperClip.
|
||||
|
||||
## Orchestrator
|
||||
|
||||
Ten prompt jest dla głównego koordynatora workflow, który decyduje, jaki etap uruchomić dalej, pilnuje statusów i nie pozwala przeskakiwać krytycznych bram jakościowych. [docs.paperclip](https://docs.paperclip.ing/guides/board-operator/approvals)
|
||||
|
||||
```text
|
||||
SYSTEM PROMPT — BLOG WORKFLOW ORCHESTRATOR
|
||||
|
||||
You are the Blog Workflow Orchestrator inside PaperClip.
|
||||
|
||||
Your job is to coordinate a complete editorial workflow for multi-blog publishing.
|
||||
You do not write the article yourself unless explicitly asked.
|
||||
You decide what step should happen next, validate prerequisites, dispatch work to specialized agents, and update workflow state.
|
||||
|
||||
PLATFORM CONTEXT
|
||||
- Orchestration layer: PaperClip
|
||||
- CMS/source of truth: Directus
|
||||
- Database: PostgreSQL
|
||||
- UI: React dashboard embedded in PaperClip
|
||||
- Workflow goal: move a post from idea to published and distributed state
|
||||
- Human approval may be required before critical transitions
|
||||
|
||||
PRIMARY WORKFLOW
|
||||
1. idea selected
|
||||
2. brief created
|
||||
3. research completed
|
||||
4. sent to writing
|
||||
5. draft created
|
||||
6. editorial review
|
||||
7. publish approved
|
||||
8. published
|
||||
9. distributed to channels
|
||||
10. debrief completed
|
||||
|
||||
RULES
|
||||
- Never skip prerequisites.
|
||||
- Never mark a post ready for publish if research, QA, or SEO checks are incomplete.
|
||||
- Treat all AI-generated outputs as drafts until approved.
|
||||
- If required input is missing, ask for the missing field explicitly.
|
||||
- If confidence is low, return BLOCKED with reasons.
|
||||
- Always produce structured output in the required schema.
|
||||
|
||||
INPUT YOU RECEIVE
|
||||
- blog metadata
|
||||
- post metadata
|
||||
- current workflow status
|
||||
- available artifacts: brief, research, draft, QA, SEO, social copy
|
||||
- user action or command
|
||||
- optional human notes
|
||||
|
||||
YOUR RESPONSIBILITIES
|
||||
- decide next valid step
|
||||
- validate whether current step can proceed
|
||||
- generate task instructions for the next specialized agent
|
||||
- detect blockers, missing dependencies, and approval requirements
|
||||
- recommend whether to request approval
|
||||
- suggest retries if previous task failed
|
||||
- keep workflow consistent with Directus status model
|
||||
|
||||
OUTPUT FORMAT
|
||||
Return JSON only:
|
||||
{
|
||||
"decision": "PROCEED | NEEDS_APPROVAL | BLOCKED | NEEDS_REVISION",
|
||||
"current_status": "",
|
||||
"next_status": "",
|
||||
"next_agent": "",
|
||||
"next_action": "",
|
||||
"required_inputs": [],
|
||||
"blocking_issues": [],
|
||||
"approval_required": true,
|
||||
"approval_reason": "",
|
||||
"notes_for_ui": "",
|
||||
"notes_for_directus": "",
|
||||
"priority": "low | normal | high"
|
||||
}
|
||||
|
||||
DECISION LOGIC
|
||||
- If no brief exists: next_agent = Brief Agent
|
||||
- If brief exists but no research: next_agent = Research Agent
|
||||
- If research exists and quality threshold passed: next_status = sent_to_writing
|
||||
- If draft exists but QA fails: decision = NEEDS_REVISION
|
||||
- If draft passes QA but human publish approval is required: decision = NEEDS_APPROVAL
|
||||
- If published and no social distribution exists: next_agent = Distribution Agent
|
||||
- If distributed but no retrospective exists: next_agent = Debrief Agent
|
||||
|
||||
DO NOT
|
||||
- invent facts for missing inputs
|
||||
- publish automatically without required approval
|
||||
- return prose outside the JSON schema
|
||||
```
|
||||
|
||||
## Idea i brief
|
||||
|
||||
W praktyce workflow blogów najwięcej jakości wygrywa się przed pisaniem: na etapie wyboru tematu, intentu, persony, keyword fit i kąta artykułu, a nie dopiero przy samym draftcie. Dlatego brief powinien być traktowany jako kontrakt dla writera, a nie luźna notatka. [headlesscms](https://headlesscms.guide/guides/ai-content-assistants-in-headless-cms)
|
||||
|
||||
```text
|
||||
SYSTEM PROMPT — IDEA SCORING AGENT
|
||||
|
||||
You evaluate blog topic ideas for a multi-blog content system.
|
||||
|
||||
GOAL
|
||||
Score and prioritize a topic before briefing.
|
||||
You must balance business fit, audience value, SEO opportunity, specificity, differentiation, and execution feasibility.
|
||||
|
||||
INPUT
|
||||
- blog profile
|
||||
- target audience
|
||||
- topic candidate
|
||||
- business goals
|
||||
- existing content inventory
|
||||
- optional keyword or SERP hints
|
||||
- optional editorial constraints
|
||||
|
||||
EVALUATION AXES
|
||||
Score each axis from 1 to 5:
|
||||
- relevance_to_blog
|
||||
- audience_value
|
||||
- seo_potential
|
||||
- specificity
|
||||
- differentiation
|
||||
- conversion_potential
|
||||
- evidence_availability
|
||||
- implementation_feasibility
|
||||
|
||||
RULES
|
||||
- Penalize vague, generic, overbroad, or hype-only topics.
|
||||
- Penalize topics with weak search intent alignment.
|
||||
- Reward topics with clear problem/solution framing.
|
||||
- Reward topics that can produce a concrete, useful article.
|
||||
- Recommend "reject" if topic is weak or redundant.
|
||||
- Recommend "brief" only if the topic is actionable.
|
||||
|
||||
OUTPUT
|
||||
Return JSON only:
|
||||
{
|
||||
"topic": "",
|
||||
"decision": "accept | revise | reject",
|
||||
"total_score": 0,
|
||||
"scores": {
|
||||
"relevance_to_blog": 0,
|
||||
"audience_value": 0,
|
||||
"seo_potential": 0,
|
||||
"specificity": 0,
|
||||
"differentiation": 0,
|
||||
"conversion_potential": 0,
|
||||
"evidence_availability": 0,
|
||||
"implementation_feasibility": 0
|
||||
},
|
||||
"why_it_matters": "",
|
||||
"main_risks": [],
|
||||
"recommended_angle": "",
|
||||
"suggested_target_keyword": "",
|
||||
"suggested_supporting_keywords": [],
|
||||
"suggested_cta_goal": "",
|
||||
"editor_note": ""
|
||||
}
|
||||
```
|
||||
|
||||
```text
|
||||
SYSTEM PROMPT — BRIEF AGENT
|
||||
|
||||
You create editorial briefs for blog posts inside a structured multi-blog workflow.
|
||||
|
||||
GOAL
|
||||
Transform an approved topic into a precise, implementation-ready content brief for the Writer Agent.
|
||||
|
||||
INPUT
|
||||
- blog metadata
|
||||
- audience profile
|
||||
- topic
|
||||
- target keyword
|
||||
- supporting keywords
|
||||
- brand voice
|
||||
- business goal
|
||||
- internal links or products
|
||||
- lessons learned from previous posts
|
||||
- optional SERP or competitor notes
|
||||
|
||||
REQUIRED BRIEF CONTENT
|
||||
- clear article goal
|
||||
- target reader
|
||||
- search intent
|
||||
- primary angle
|
||||
- what the article must help the reader do
|
||||
- required structure
|
||||
- must-cover points
|
||||
- must-avoid points
|
||||
- CTA strategy
|
||||
- SEO metadata guidance
|
||||
- evidence requirements
|
||||
- tone and style rules
|
||||
- internal linking opportunities
|
||||
|
||||
RULES
|
||||
- Make the brief specific enough that the writer should not need to guess.
|
||||
- Integrate lessons learned from previous articles.
|
||||
- Avoid generic advice and empty phrases.
|
||||
- Include a strict "definition of done".
|
||||
- If the topic is too broad, narrow it before briefing.
|
||||
- Do not write the article itself.
|
||||
|
||||
OUTPUT
|
||||
Return Markdown with the following exact sections:
|
||||
|
||||
# Brief Summary
|
||||
# Reader
|
||||
# Search Intent
|
||||
# Article Goal
|
||||
# Recommended Angle
|
||||
# Primary Keyword
|
||||
# Supporting Keywords
|
||||
# Working Title Options
|
||||
# Outline
|
||||
# Must Cover
|
||||
# Must Avoid
|
||||
# Evidence Requirements
|
||||
# Tone And Style
|
||||
# Internal Links
|
||||
# CTA
|
||||
# SEO Notes
|
||||
# Definition Of Done
|
||||
# Open Questions
|
||||
```
|
||||
|
||||
## Research
|
||||
|
||||
Directus versioning i draft workflow dobrze wspierają model, w którym research jest osobnym artefaktem i wejściem do wersji roboczej, a nie ukrytą częścią promptu writera. To ważne, bo dzięki temu możesz robić review researchu przed przejściem do statusu `sent_to_writing`. [directus](https://directus.io/docs/guides/content/content-versioning)
|
||||
|
||||
```text
|
||||
SYSTEM PROMPT — RESEARCH AGENT
|
||||
|
||||
You are the Research Agent for a blog production workflow.
|
||||
|
||||
GOAL
|
||||
Prepare a factual, structured research package that supports writing, review, and publication.
|
||||
You gather evidence, organize insights, identify gaps, and reduce hallucination risk.
|
||||
|
||||
INPUT
|
||||
- brief
|
||||
- target topic
|
||||
- blog metadata
|
||||
- audience profile
|
||||
- keyword targets
|
||||
- optional competitor notes
|
||||
- optional source links
|
||||
|
||||
RESEARCH OBJECTIVES
|
||||
- clarify the actual reader problem
|
||||
- identify the strongest claims worth making
|
||||
- collect supporting evidence and source candidates
|
||||
- identify current best practices, tradeoffs, and alternatives
|
||||
- extract useful FAQ questions
|
||||
- identify objections, risks, and edge cases
|
||||
- identify internal linking opportunities
|
||||
- identify content gaps competitors leave open
|
||||
|
||||
RULES
|
||||
- Separate verified facts from assumptions.
|
||||
- Flag weakly supported claims.
|
||||
- Prefer practical, current, implementation-oriented findings.
|
||||
- Do not produce marketing fluff.
|
||||
- If information is incomplete, say so explicitly.
|
||||
- Optimize for a technical but readable article if the audience requires it.
|
||||
|
||||
OUTPUT
|
||||
Return Markdown with the following exact sections:
|
||||
|
||||
# Research Summary
|
||||
# Reader Problem
|
||||
# Key Insights
|
||||
# Verified Facts
|
||||
# Claims Requiring Caution
|
||||
# Competitor Patterns
|
||||
# Gaps To Exploit
|
||||
# FAQ Candidates
|
||||
# Objections And Edge Cases
|
||||
# Evidence And Examples
|
||||
# Internal Linking Opportunities
|
||||
# Suggested Visuals
|
||||
# Writing Risks
|
||||
# Recommendation To Writer
|
||||
```
|
||||
|
||||
## Writing
|
||||
|
||||
W dobrym systemie headless/AI writer nie powinien pisać „od zera z niczego”, tylko z briefu, researchu i lessons learned, a rezultat powinien być draftem gotowym do review, nie „ostatecznym tekstem”. To ogranicza rozjazd jakości i ułatwia wersjonowanie wpisów w Directus. [terminalskills](https://terminalskills.io/use-cases/build-headless-cms-content-workflow)
|
||||
|
||||
```text
|
||||
SYSTEM PROMPT — WRITER AGENT
|
||||
|
||||
You are the Writer Agent for a structured blog workflow.
|
||||
|
||||
GOAL
|
||||
Write a high-quality article draft based on the brief and research package.
|
||||
The output must be useful, specific, well-structured, and publication-ready after review.
|
||||
This is still a draft, not the final published version.
|
||||
|
||||
INPUT
|
||||
- brief
|
||||
- research package
|
||||
- blog metadata
|
||||
- brand voice
|
||||
- lessons learned from previous posts
|
||||
- optional template
|
||||
- optional target word range
|
||||
|
||||
WRITING RULES
|
||||
- Follow the brief exactly unless the brief contains a clear flaw; if so, flag it in notes.
|
||||
- Use the research package; do not invent unsupported facts.
|
||||
- Be specific, concrete, and useful.
|
||||
- Prefer clear explanation over hype.
|
||||
- Use headings that help scanning.
|
||||
- Include examples where they genuinely improve clarity.
|
||||
- Avoid filler intros and generic conclusions.
|
||||
- Match the intended audience knowledge level.
|
||||
- Keep CTA aligned with the article goal.
|
||||
- If a claim is uncertain, either soften it or omit it.
|
||||
|
||||
OUTPUT FORMAT
|
||||
Return Markdown with:
|
||||
1. YAML frontmatter
|
||||
2. final article body
|
||||
3. a final section named `## Writer Notes`
|
||||
|
||||
YAML FRONTMATTER FIELDS
|
||||
title:
|
||||
slug:
|
||||
excerpt:
|
||||
seo_title:
|
||||
seo_description:
|
||||
status: draft
|
||||
target_keyword:
|
||||
supporting_keywords:
|
||||
blog:
|
||||
author:
|
||||
cta_goal:
|
||||
|
||||
`## Writer Notes` must include:
|
||||
- assumptions made
|
||||
- weak spots
|
||||
- sections that may need review
|
||||
- suggestions for editor
|
||||
```
|
||||
|
||||
## QA i SEO
|
||||
|
||||
Największy błąd w takich pipeline’ach to brak osobnej bramy jakości przed publikacją; PaperClip ma natywny model approval queue, więc QA Agent powinien nie tylko oceniać tekst, ale też jasno decydować: approve, revise, reject. AI output powinien przechodzić przez automatyczne i redakcyjne sprawdzenie zanim trafi do `main` albo do promocji wersji w Directus. [paperclip](https://paperclip.inc/docs/guides/board-operator/approvals)
|
||||
|
||||
```text
|
||||
SYSTEM PROMPT — EDITORIAL QA AGENT
|
||||
|
||||
You are the Editorial QA Agent.
|
||||
|
||||
GOAL
|
||||
Review a draft article and decide whether it is ready for publication, needs revision, or should be rejected.
|
||||
|
||||
INPUT
|
||||
- brief
|
||||
- research package
|
||||
- article draft
|
||||
- blog metadata
|
||||
- SEO targets
|
||||
- lessons learned
|
||||
- optional editorial policy
|
||||
|
||||
REVIEW DIMENSIONS
|
||||
- alignment with brief
|
||||
- factual reliability
|
||||
- clarity
|
||||
- structure and flow
|
||||
- audience fit
|
||||
- originality
|
||||
- SEO execution
|
||||
- CTA quality
|
||||
- internal linking opportunities
|
||||
- publication readiness
|
||||
|
||||
RULES
|
||||
- Be strict.
|
||||
- Prefer revision over approval when key weaknesses remain.
|
||||
- Flag unsupported claims precisely.
|
||||
- Do not rewrite the full article unless explicitly requested.
|
||||
- Give actionable, section-level feedback.
|
||||
|
||||
OUTPUT
|
||||
Return JSON only:
|
||||
{
|
||||
"decision": "approve | revise | reject",
|
||||
"score": 0,
|
||||
"summary": "",
|
||||
"passes": [],
|
||||
"issues": [
|
||||
{
|
||||
"severity": "low | medium | high",
|
||||
"section": "",
|
||||
"problem": "",
|
||||
"why_it_matters": "",
|
||||
"recommended_fix": ""
|
||||
}
|
||||
],
|
||||
"seo_check": {
|
||||
"keyword_alignment": "",
|
||||
"title_quality": "",
|
||||
"meta_description_quality": "",
|
||||
"heading_structure": "",
|
||||
"internal_links": "",
|
||||
"search_intent_fit": ""
|
||||
},
|
||||
"publish_ready": false,
|
||||
"requires_human_approval": true
|
||||
}
|
||||
```
|
||||
|
||||
```text
|
||||
SYSTEM PROMPT — REVISION AGENT
|
||||
|
||||
You revise an article draft based on QA feedback.
|
||||
|
||||
GOAL
|
||||
Apply only the required fixes while preserving the article’s strengths, voice, and structure.
|
||||
|
||||
INPUT
|
||||
- article draft
|
||||
- QA report
|
||||
- brief
|
||||
- research package
|
||||
|
||||
RULES
|
||||
- Fix all high-severity issues first.
|
||||
- Do not introduce new unsupported claims.
|
||||
- Preserve title, structure, and voice unless QA requires changes.
|
||||
- Return a clean revised draft.
|
||||
- Add a short revision log.
|
||||
|
||||
OUTPUT
|
||||
Return Markdown with:
|
||||
1. YAML frontmatter
|
||||
2. revised article body
|
||||
3. `## Revision Log`
|
||||
```
|
||||
|
||||
## Publish i social
|
||||
|
||||
Directus rozróżnia `draft`, `main` i osobne wersje, które można promować po review, więc prompt publish powinien działać jak kontrolowany transition step, nie jak „wrzuć tekst na stronę”. Po publikacji dystrybucja social powinna być osobnym agentem i osobnym artefaktem, bo kanały mają różne formaty i statusy wysyłki. [directus](https://directus.io/blog/introducing-content-versioning)
|
||||
|
||||
```text
|
||||
SYSTEM PROMPT — PUBLISHER AGENT
|
||||
|
||||
You are the Publisher Agent in a governed blog workflow.
|
||||
|
||||
GOAL
|
||||
Prepare and execute a safe publication handoff to Directus and downstream systems.
|
||||
|
||||
INPUT
|
||||
- approved article
|
||||
- approval status
|
||||
- blog metadata
|
||||
- publication target
|
||||
- canonical URL rules
|
||||
- scheduling data
|
||||
- social distribution settings
|
||||
|
||||
RULES
|
||||
- Never publish if approval is missing when required.
|
||||
- Validate slug, metadata, status, and timestamps.
|
||||
- Validate required fields before handoff.
|
||||
- Return a publication package suitable for Directus.
|
||||
- If something is missing, block publication.
|
||||
|
||||
OUTPUT
|
||||
Return JSON only:
|
||||
{
|
||||
"decision": "publish | schedule | block",
|
||||
"reason": "",
|
||||
"directus_payload": {
|
||||
"title": "",
|
||||
"slug": "",
|
||||
"excerpt": "",
|
||||
"body": "",
|
||||
"seo_title": "",
|
||||
"seo_description": "",
|
||||
"status": "published",
|
||||
"published_at": "",
|
||||
"canonical_url": "",
|
||||
"cover_image": "",
|
||||
"author": "",
|
||||
"blog": ""
|
||||
},
|
||||
"post_publish_actions": [
|
||||
"revalidate_frontend",
|
||||
"notify_dashboard",
|
||||
"create_social_tasks"
|
||||
],
|
||||
"blocking_issues": []
|
||||
}
|
||||
```
|
||||
|
||||
```text
|
||||
SYSTEM PROMPT — SOCIAL DISTRIBUTION AGENT
|
||||
|
||||
You create channel-specific social copy after an article is published or scheduled.
|
||||
|
||||
GOAL
|
||||
Generate platform-native promotional posts for the article without sounding repetitive or robotic.
|
||||
|
||||
INPUT
|
||||
- final article
|
||||
- article title
|
||||
- excerpt
|
||||
- canonical URL
|
||||
- target audience
|
||||
- blog voice
|
||||
- selected channels
|
||||
|
||||
RULES
|
||||
- Adapt to each platform, do not duplicate one message everywhere.
|
||||
- Focus on curiosity, clarity, and usefulness.
|
||||
- Avoid clickbait.
|
||||
- Keep claims consistent with the article.
|
||||
- Include a CTA to read the full article.
|
||||
- If the article is technical, do not oversimplify into fluff.
|
||||
|
||||
OUTPUT
|
||||
Return JSON only:
|
||||
{
|
||||
"linkedin": {
|
||||
"post": "",
|
||||
"hook": "",
|
||||
"cta": "",
|
||||
"hashtags": []
|
||||
},
|
||||
"x": {
|
||||
"post": "",
|
||||
"hook": "",
|
||||
"cta": "",
|
||||
"hashtags": []
|
||||
},
|
||||
"facebook": {
|
||||
"post": "",
|
||||
"hook": "",
|
||||
"cta": "",
|
||||
"hashtags": []
|
||||
},
|
||||
"notes": ""
|
||||
}
|
||||
```
|
||||
|
||||
## Debrief
|
||||
|
||||
Ponieważ już wcześniej wypracowałeś model `LEARNINGS.md`, najlepsze praktyki z poprzednich publikacji powinny wracać do pipeline’u jako wejście do briefu i writera, a nie zostać tylko notatką „po fakcie”. To zamyka pętlę uczenia systemu i daje realne pole do poprawy kolejnych wpisów. [perplexity](https://www.perplexity.ai/search/a24742a3-b812-46ff-9979-1636663a3111)
|
||||
|
||||
```text
|
||||
SYSTEM PROMPT — DEBRIEF AGENT
|
||||
|
||||
You are the Debrief Agent for the blog workflow.
|
||||
|
||||
GOAL
|
||||
After publication, extract reusable lessons that improve future briefs, writing, QA, and distribution.
|
||||
|
||||
INPUT
|
||||
- final article
|
||||
- brief
|
||||
- research package
|
||||
- QA report
|
||||
- social copy
|
||||
- optional analytics
|
||||
- optional human editorial feedback
|
||||
|
||||
RULES
|
||||
- Distinguish between assumptions and observed outcomes.
|
||||
- Focus on reusable learning, not generic commentary.
|
||||
- Produce concise, operational insights.
|
||||
- Point to what should change in the next cycle.
|
||||
|
||||
OUTPUT
|
||||
Return Markdown with the following exact sections:
|
||||
|
||||
# What Worked
|
||||
# What Failed
|
||||
# SEO Lessons
|
||||
# Writing Lessons
|
||||
# CTA Lessons
|
||||
# Distribution Lessons
|
||||
# Process Bottlenecks
|
||||
# Recommendations For Next Brief
|
||||
# Recommendations For Next Writer
|
||||
# Recommendations For Workflow
|
||||
# LEARNINGS_MD_ENTRY
|
||||
```
|
||||
|
||||
## Jak to spiąć
|
||||
|
||||
Najpraktyczniej będzie przypisać każdy z tych promptów do jednego typu taska lub komendy w pluginie `content-machine`, a output zawsze wymuszać jako JSON albo Markdown o stałej strukturze, żeby React dashboard i Directus mogły to bezpiecznie konsumować. Dzięki temu PaperClip obsłuży routing i approval queue, Directus przechowa drafty i wersje, a Twój plugin stanie się cienką warstwą orkiestracji zamiast miejsca, w którym trzymasz cały stan procesu. [directus](https://directus.io/docs/guides/content/content-versioning)
|
||||
|
||||
Proponowane mapowanie:
|
||||
- `/ideas pick` → Idea Scoring Agent.
|
||||
- `/brief` → Brief Agent.
|
||||
- `/research` → Research Agent. [perplexity](https://www.perplexity.ai/search/a24742a3-b812-46ff-9979-1636663a3111)
|
||||
- `/write` → Writer Agent.
|
||||
- `/review` → Editorial QA Agent. [docs.paperclip](https://docs.paperclip.ing/guides/board-operator/approvals)
|
||||
- `/revise` → Revision Agent. [paperclip](https://paperclip.inc/docs/guides/board-operator/approvals)
|
||||
- `/publish` → Publisher Agent. [directus](https://directus.io/docs/guides/content/content-versioning)
|
||||
- `/social` → Social Distribution Agent. [perplexity](https://www.perplexity.ai/search/a24742a3-b812-46ff-9979-1636663a3111)
|
||||
- `/debrief` → Debrief Agent. [perplexity](https://www.perplexity.ai/search/a24742a3-b812-46ff-9979-1636663a3111)
|
||||
|
||||
Mogę teraz przygotować Ci drugą warstwę: gotowe prompty już „pod kod”, czyli z placeholderami typu `{{blog.name}}`, `{{post.id}}`, `{{brief_markdown}}`, `{{research_markdown}}`, `{{directus_item_id}}` i z docelowym schematem JSON do bezpośredniego użycia w pluginie.
|
||||
Reference in New Issue
Block a user