# 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