May 17, 2026, 11:40 PM

2026-05-18 06:40:19 +00:00
commit 64944cf004
896 changed files with 310709 additions and 0 deletions
@@ -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