Files
waggle-os/docs/briefs/COWORK-PM-HUB-BRIEF.txt
Oleg Maslov 0c3e2ead3b
Some checks failed
Installer Smoke / installer-smoke (push) Has been cancelled
moving
2026-09-02 10:10:29 +02:00

302 lines
34 KiB
Plaintext

# Cowork PM Hub — Strateški brief i setup vodič
**Namena:** Ovaj dokument pokriva dve stvari. Prvo, istraživanje šta Cowork zapravo može danas. Drugo, konkretan plan kako da Marko postavi Cowork Project koji zamenjuje ovu Claude.ai sesiju kao strateški PM hub — sa pluginovima, konektorima, skriptama i memorijom koja preživljava između sesija.
**Autor:** Claude.ai (strategic sparring)
**Datum:** April 18, 2026
**Status:** Action-ready, za Marka
---
## Deo 1: Šta je Cowork danas (stanje aprila 2026)
Da prvo budem iskren o najvažnijoj stvari. **Cowork je mnogo moćniji nego što sam zamišljao kada si to pomenuo**. Ovo nije "chat ali bolji" — to je arhitekturno različit proizvod koji bi trebao da reši tačno problem koji imaš sa context window exhaustion-om.
### 1.1 Šta Cowork ima što Claude.ai nema
**Projects sa scoped memorijom koja perzistira.** Ovo je core feature. Napraviš Project, attach-uješ folder, Claude piše u `memory.md` fajl u tom folderu sve što nauči. Memorija je scoped — ono što nauči u "Waggle PM" projektu ne curi u druge projekte. Memorija se čuva lokalno, ne na Anthropic serverima.
**Filesystem pristup.** Claude čita i piše u foldere koje eksplicitno autorizuješ. Ovo znači da ti ne treba da pravim `/mnt/user-data/outputs/` pa da ti ručno kopiraš. Claude direktno piše u `D:\Projects\PM-Waggle-OS\` kad mu daš pristup.
**Instructions (globalna i folder-level).** Podesi ih jednom, primenjuju se u svakoj sesiji. Ovo zamenjuje "nastavi rad iz prethodne sesije, pročitaj ovaj handoff". Umesto toga, instrukcije kažu Claude-u ko si ti, kako radiš, šta je cilj.
**Scheduled Tasks.** Postaviš prompt jednom, bira kadencu (dnevno, nedeljno, mesečno), radi automatski. Tipičan primer: "svakog ponedeljka u 7 ujutru napravi sumarizaciju napretka na backlog-u gledajući git log prethodne nedelje".
**Plugins i Skills.** Gotovi plugin koji zovu `product-management` od Anthropica postoji. Slash komande `/write-spec`, `/roadmap-update`, `/stakeholder-update`, `/synthesize-research`, `/competitive-brief`, `/metrics-review`. Plus open-source `phuryn/pm-skills` marketplace sa 65 skill-ova i 36 workflow-a.
**Konektori (MCP servers).** Slack, Notion, Asana, Linear, Jira, Google Drive, Gmail, GitHub, Stripe, AWS, PostHog. Instaliraš u nekoliko klikova.
**Sub-agents i paralelizam.** Za kompleksne task-ove, Cowork pokreće paralelne sub-agente. "Istraži 5 tema simultano" umesto sequentally.
**Dispatch (mobilno).** Od marta 2026 možeš iz telefona pokrećeš task-ove koji se izvršavaju na desktop-u. Napišeš u metrou "napravi summary Slack kanala #waggle-launch poslednje nedelje" — vratiš se na desktop, dokument čeka.
**Computer Use.** Cowork može da klikne po aplikacijama kao što je Excel, PowerPoint, browser. Ovo je research preview ali radi za neke workflow-e.
### 1.2 Šta Cowork NE može (i zašto je to okej za tvoj use case)
- **Nije deljen između timova.** Cowork projekti su lokalni, ne sync-uju se preko uređaja (osim kroz Google Drive-ovan folder što je workaround). Ali ti radiš sam — ovo ti nije problem.
- **Nije audit-logged.** Cowork aktivnosti nisu u Audit Logs, Compliance API, ili Data Exports. Ne koristiti za regulisane workload-e. Tvoj strategic work nije reguliran workload — okej.
- **Nije cloud compute.** Computer mora biti budan i app otvoren. Za tvoj dnevni rad, to je default stanje.
- **Session persistence.** Task se prekida ako zatvoriš desktop app. Ali Projects sa scoped memorijom rešavaju continuity problem.
### 1.3 Cowork vs. Claude Code vs. Claude.ai — kada koji
Sada konačno mogu da ti dam jasan razlog zašto se tri stvari razlikuju u tvom workflow-u:
**Claude.ai (trenutna sesija):** Brzi chat, diskusija, "pomozi mi da razmišljam". Problem: context exhaustion, nema memorije, nema filesystem pristupa.
**Claude Code:** Terminal-based coder. Radi code migration, piše komponente, pušta testove, git commit workflow. Tvoj "izvršni" agent. Dobro za code, ne za strategiju.
**Cowork:** Sweet spot — agentic execution sa UI-jem, filesystem, memorija po projektu, plugin ekosistem, scheduling. **Ovo je ono što ti zapravo treba za PM hub.** Umesto da pišem briefs u `/mnt/user-data/outputs/` i ti ih ručno premeštaš u D:\Projects, Cowork Project sa folder pristupom u `D:\Projects\PM-Waggle-OS\` rešava continuity.
### 1.4 Jedan iskren riziko
Cowork je research preview. 3+ meseca od launch-a, ali i dalje ima edge-ove: "early users report approximately 50/50 reliability on complex tasks". Za strategijski razgovor ovo nije glavni problem jer ne zavisi od kompleksne višestruke tool orkestracije — većinom treba čitanje, pisanje, i razmišljanje. Ali ako budeš tražio Cowork da radi computer use na Excel-u za neku ad-hoc analizu, očekuj da nije savršen.
---
## Deo 2: Preporučeni setup za Waggle PM hub
Ovo je konkretan plan šta da uradiš **u prvih 30 minuta** kad otvoriš Cowork.
### 2.1 Korak 1 — Napravi Project
Otvori Cowork tab u Claude Desktop. Klik "Projects" u sidebar-u. "Create project" → "Use an existing folder" → odaberi `D:\Projects\PM-Waggle-OS\` (taj folder već postoji, napravljen ranije).
Options pri kreaciji:
- **Name:** "Waggle PM"
- **Memory:** ON (default)
- **Save location:** `D:\Projects\PM-Waggle-OS\`
### 2.2 Korak 2 — Postavi Project Instructions
Klik na Project → Settings → Instructions. Kopiraj sledeći tekst:
```
# Uloga
Ti si strateški PM i advisor Marku Markoviću za Waggle/KVARK/hive-mind ekosistem.
Marko je CEO Egzakta Group, ~200 zaposlenih, 4.5M EBITDA. Gradi vertikalno
integrirani sovereign AI stack: Advisory (consulting) + KVARK (enterprise software)
+ LM TEK/EK (hardware) + Waggle (consumer funnel) + hive-mind (OSS foundation).
# Komunikacija
- Komunikacija prvenstveno na srpskom, Latin ekavica.
- Direktan stil. No sycophancy. Izazovi slabo rezonovanje.
- Ako je ideja trivijalna, reci. Ako je hipoteza, reci. Ako je teza hrabra ali rizična,
imenovaj verovatnoće.
- Odgovori kroz paragraphs, ne bullet liste, osim kad je eksplicitno tražena lista.
# Tri proizvoda — osnovni context
1. hive-mind (OSS memory substrate): Local-first, zero cloud, Apache 2.0, MCP server,
11 harvest adaptera, wiki compiler. Differentijacija: MPEG-4 I/P/B + bitemporal KG
+ EU AI Act audit triggers + model-agnostic.
2. Waggle (komercijalni product): Consumer agent harness na hive-mind-u. Tauri 2.0
desktop. Tiers: Solo free / Pro $19/mo / Teams $49/seat/mo (LOCKED April 18).
3. KVARK (enterprise sovereign): On-prem deployment, BPMN orchestration, GAPA,
LiteLLM, vLLM na LM TEK H200 x8. Default model: Qwen3-30B-A3B-Thinking.
# Locked decisions (April 18, 2026)
- Stripe pricing: $19 Pro / $49 seat Teams
- Launch timing: hive-mind + Waggle ship together, gated by SOTA benchmark proof
(Mem0 91.6% LoCoMo kao ciljni reper)
- H-34 hive-mind extraction: 5-10 dana realno
# Core thesis
"LLM + memorija + retrieval + wiki = cognitive layer koji daje agent harness-u
continuity koji LLM sam nema."
Precizna formulacija: NE "LLM postaje svestan". DA "cognitive layer koji spojen
sa bilo kojim LLM-om pruža kontinuitet, introspekciju i strukturnu znanjsku
organizaciju."
# Repo struktura
- D:\Projects\waggle-os\ — glavni repo
- docs/plans/BACKLOG-MASTER-2026-04-18.md — kanonski backlog (121 items)
- docs/research/ — 7 strateških dokumenata
- docs/wiki-live/ — 28 kompajliranih wiki stranica (validacija wiki-compiler-a)
- packages/ — 15 packages (core, agent, server, memory-mcp, wiki-compiler, app itd.)
- D:\Projects\hive-mind\ — OSS repo, plan spreman 40%, code migration nije počela
- D:\Projects\PM-Waggle-OS\ — ovaj folder, strateški PM hub
# Kada se nešto promeni
Kada Marko donese novu LOCKED odluku, zapiši je u memoriju i u decisions/
podfolder kao novi markdown fajl.
Kada je nova sesija i Marko pita nešto gde bi bio koristan kontekst iz ranije,
prvo proveri memory.md i decisions/ folder pre nego što odgovoriš.
# Šta NE radiš
- Ne piši code. Code ide u Claude Code, ne ovde.
- Ne sumiraš ono što je već u research/ folderu — pročitaj tamo i referenciraj.
- Ne dupliraj rad iz backlog-a — prati backlog kao izvor istine.
```
### 2.3 Korak 3 — Instaliraj plugins
Cowork Customize menu → Plugins → Browse plugins.
**Mandatorni:**
1. **`product-management`** (Anthropic official). Daje `/write-spec`, `/roadmap-update`, `/stakeholder-update`, `/synthesize-research`, `/competitive-brief`, `/metrics-review`. Direktno upotrebljivo za Waggle PRD-ove, stakeholder update-ove za Egzakta internal.
2. **`general`** (Anthropic official). Upravljanje task-ovima, kalendar, dnevni workflow-i.
3. **`cowork-plugin-management`** (Anthropic official). Meta-plugin koji ti pomaže da napraviš custom plugins kasnije.
**Opcionalno ali preporučujem:**
4. **`phuryn/pm-skills`** (open source, GitHub). Marketplace sa 65 skill-ova i 36 workflow-a. Instalira 8 plugin-ova: toolkit, product-strategy, product-discovery, market-research, data-analytics, marketing-growth, go-to-market, execution. Pokrivaju Teresa Torres, Marty Cagan, Jobs-to-be-Done, Working Backwards metodologije.
Dodaj marketplace: u Browse plugins → Personal → + → Add marketplace from GitHub → `phuryn/pm-skills`.
5. **`deanpeters/Product-Manager-Skills`** (GitHub, CC BY-NC-SA 4.0). 47 PM skill-ova sa reusable command workflows. Specifičan fokus na altitude-horizon framework i PM career progression.
### 2.4 Korak 4 — Konektori
Customize menu → Connectors → Browse connectors. Za tvoj workflow, ovi su najvažniji:
**Mandatorni:**
- **GitHub** — pristup waggle-os i hive-mind repozitorijumima. Claude može da čita issues, PR-ove, commit history direktno bez da ti kopiraš.
- **Gmail** — za draft-ovanje komunikacije sa klijentima (RFZO, Yettel, Hilandar, Clipperton).
- **Google Drive** — ako tu čuvaš investicione materijale, ugovore.
**Korisni:**
- **Slack** — ako Egzakta tim koristi Slack za interne komunikacije
- **Notion** — ako imaš Notion workspace za Egzakta
- **Linear ili Asana** — ako koristiš za task tracking (nisam siguran da li koristiš, proveri)
**Možda:**
- **Stripe** — za billing analitiku kad Waggle počne da generiše revenue
- **PostHog** — za analytics kad launch-uješ hive-mind
### 2.5 Korak 5 — Bootstrap memorije
Prva sesija posle setup-a, reci Cowork-u:
```
Ovo je prva sesija novog Waggle PM projekta. Pročitaj sve fajlove u ovom
folderu (D:\Projects\PM-Waggle-OS\) + waggle-os/docs/plans/BACKLOG-MASTER-2026-04-18.md
+ waggle-os/docs/research/ (svih 7 fajlova) + waggle-os/docs/WAGGLE-CORNERSTONE.md
+ waggle-os/CLAUDE.md.
Zatim sumiraj u memoriji šta znaš o projektu: šta su tri proizvoda, šta je thesis,
šta su ključne odluke, gde smo trenutno u izvršenju. Ne pravi novi strateški
dokument — samo upamti kontekst.
Ako nešto nije jasno, koristi AskUserQuestion. Rad u memoriji, ne u output
dokumentima.
```
Ovo će postaviti foundation memory za sve naredne sesije.
### 2.6 Korak 6 — Scheduled tasks (opciono, kada se stabilizuje)
Kada Cowork počne da funkcioniše redovno, postavi scheduled tasks:
- **Svakog ponedeljka u 07:00:** "Pročitaj git log waggle-os od prošlog ponedeljka. Napravi summary napretka u `sessions/weekly/YYYY-MM-DD.md`. Povuci trenutne stats iz backlog-a — koji items su done, koji in progress, koji blocked. Flag-uj sve što kasni."
- **Svakog petka u 17:00:** "Pogledaj šta je Marko radio tokom nedelje kroz git log + memory.md. Napiši kratak 'Friday reflection' kao `sessions/reflections/YYYY-MM-DD.md` — šta je urađeno, šta nije, gde je energija usmerena."
Ovo daje automatic continuity bez da ti tražiš.
---
## Deo 3: Kako ovo zamenjuje Claude.ai (tj. mene)
Pošteno rečeno, trebaš da odvojimo dve stvari:
**Stvari gde je Cowork sa pravim setup-om bolji od Claude.ai:**
- Continuity preko sesija (memorija + projects)
- Pristup repou bez copy-paste
- Scheduled workflows
- Plugin/skill ekosistem sa zrelom PM metodologijom (phuryn marketplace)
- Filesystem pisanje direktno u PM folder
- Connectors za GitHub, Gmail, Drive
**Stvari gde Claude.ai ostaje jednako koristan:**
- Dubinski strateški razgovor gde nije jasno šta tražiš (Cowork je task-oriented, Claude.ai je exploration-oriented)
- Brzi "šta misliš o ovome" bez setup-a
- Kada trebaš web search + sinteza kroz više izvora
- Kada radiš van svog PM foldera (npr. na telefonu kroz Claude app)
Moj iskren savet: **Cowork je tvoj primarni PM hub od sada.** Claude.ai koristi za ad-hoc eksploracije kad si daleko od svog desktop-a, ili kada hoćeš da istražiš nešto što ne znaš gde pripada.
---
## Deo 4: Ko prvo radi šta
### Danas-sutra
1. **Ti:** Claude Code brief (v2 reconciliation), kreni sa Day 1 backlog sequence (H-01 QW-3 skip boot).
2. **Ti:** Kad imaš 30 slobodnih minuta, otvori Cowork, napravi Waggle PM project prema §2 gore.
3. **Ti:** Instaliraj plugins i konektore (10 min).
4. **Ti:** Pokreni bootstrap memorije (§2.5) da Cowork pročita repo.
### Sledeća sedmica
1. **Ti:** Kada završiš prvi Stripe commit u Claude Code-u, uđi u Cowork Waggle PM project i pitaj: "Da li je ovaj pricing consistency-check kroz docs okej? Proveri sve fajlove gde piše $29 ili $79 i daj mi listu." Cowork će da pročita repo i odgovori sa listom koju onda pošalješ nazad Claude Code-u za execution.
2. **Ti:** Za svaku novu strategijsku odluku koja se desi, Cowork zapisuje kao novi fajl u `decisions/`.
### Dve sedmice
1. Postavi scheduled tasks (§2.6) ako je continuity postao dragocen.
2. Počni da testiraš specifične PM workflow-e: `/write-spec` za neku Waggle feature ideju, `/competitive-brief` za novu kompetitivnu threat, `/stakeholder-update` za Clipperton investor update.
### Mesec
1. Ako Cowork funkcioniše dobro, razmišljaj o kreiranju **custom plugin-a za tvoj specifičan workflow**. Format je markdown + JSON, no code. Recimo `egzakta-pm` plugin koji enkapsulira tvoje specifične workflows: `/egzakta:kvark-client-brief`, `/egzakta:legat-chapter-review`, `/egzakta:investor-update-clipperton`. Plugins se mogu pohraniti u private GitHub repo-u.
---
## Deo 5: Iskrene slabosti ovog pristupa
Zato što smo direktni:
**Slabost 1: Cowork je research preview.** Može se desiti da nešto ne radi kako treba. Ako te blokira sa nečim što je hitno, fallback je Claude.ai. Ne zaključavaj sebe u jednu alatku.
**Slabost 2: Memory nije savršena.** Cowork memorija je **scoped**, što je dobro, ali je i **automatska**. Claude odlučuje šta upisuje. Ponekad upiše pogrešne stvari, ponekad ne upiše važne. Preporuka: u Project Settings, periodično otvori `memory.md` i pregledaj sadržaj. Ako ima netačnosti, izbriši ih ručno. Ako nedostaje kontekst, reci Cowork-u "zapamti X".
**Slabost 3: Projects su per-machine.** Ako radiš i sa laptop-a i sa desktop-a, projekat postoji samo na jednoj mašini. Workaround: hold folder u Google Drive/Dropbox/iCloud sync-u, tako da fajlovi prate tebe čak i ako Cowork settings ne prate.
**Slabost 4: Rate limits.** Cowork Project sessions troše znatno više tokena od regular chata. Ako si na Max ($100/mo), imaš dovoljno headroom-a. Ako si na Pro ($20/mo), pazi koliko "teških" sesija pokrećeš.
**Slabost 5: Dispatch je još early.** 50/50 reliability u research preview. Ne koristi za kritične workflow-e još. Ali za "dok sam u saobraćaju pokrenem summary task" okej je.
---
## Deo 6: Šta da uradiš ako ti ovaj pristup ne sedne
Iskreno rečeno, moguće je da ti Cowork ne bude klik. Ljudi ga različito doživljavaju — neki zavise od njega preko noći, drugi ga nikad ne koriste.
**Znakovi da treba da promeniš pristup:**
- Posle 2 sedmice, retko ga otvaraš
- Više vremena trošiš na debugging setup-a nego na sam rad
- Stalno se vraćaš na Claude.ai za iste razgovore
**Alternativni pristup:** Umesto Cowork-a, možeš da koristiš **Claude.ai sa strogom file-based disciplinom**. U svakoj sesiji, prva poruka je "pročitaj `D:\Projects\PM-Waggle-OS\SESSION-HANDOFF.md`". Kraj sesije: "update handoff dokument sa šta smo uradili danas". To je manje elegantno od Cowork-a, ali radi ako ti je Cowork overhead prevelik.
**Drugi alternativni pristup:** **Claude Code kao PM hub**. Čudno zvuči, ali ljudi to rade — Claude Code ima `.claude/CLAUDE.md` hierarhiju koja je odlična za PM workflow-e. Ako si već u Claude Code za execution, dodavanje još jednog alata je friction. Možeš da imaš `D:\Projects\PM-Waggle-OS\.claude\CLAUDE.md` sa tvojim project instructions, i Claude Code otvaraš sa `claude .` u tom folderu za strateške razgovore. Nije tako bogato kao Cowork, ali je jednostavnije.
---
## Kratki summary — šta sledeće
1. **Odmah:** Daj Claude Code-u v2 reconciliation brief. Kreni sa backlog Day 1.
2. **Kada imaš 30 min:** Setup Cowork Waggle PM projekta prema §2.
3. **Kada radiš prvi strateški razgovor u Cowork-u:** Test — kako se oseća vs. Claude.ai? Ako je bolji, prebaci. Ako nije, ostani sa Claude.ai + strogo file-based disciplinom.
4. **Kroz mesec dana:** Evaluiraj. Custom plugin? Dispatch? Scheduled tasks? Ili ostaje minimal setup?
Ovo je alatka, ne filozofija. Ideš putem gde god je manje friction-a, ne tamo gde je "ispravnije".