Jul 10, 2026, 9:27 AM

agent.md

@@ -654,3 +654,284 @@ Coordinator
 ```
 
 Jest to już pełnoprawna architektura **hub-and-spoke + domain specialists + aggregation layer**.
+
+
+
+To już zaczyna przypominać **operacyjny system agentowy**, więc zamiast samych strzałek warto opisać **jakie artefakty przepływają pomiędzy domenami**.
+
+Poniższy diagram pokazuje zarówno hierarchię, jak i semantykę przepływów.
+
+```mermaid
+flowchart TB
+
+    Coordinator["Coordinator
+    Routing • Context • Error Handling • Aggregation"]
+
+%% ==================================================
+%% DOMAIN OWNERS
+%% ==================================================
+
+    Coordinator --> Research["Research Oracle (CRO)"]
+    Coordinator --> Growth["Growth Analyst (CGO)"]
+    Coordinator --> Marketing["Marketing Mouse (CMO)"]
+    Coordinator --> Engineering["Engineering Architect (CTO)"]
+
+%% ==================================================
+%% RESEARCH
+%% ==================================================
+
+    Research --> Signals["Signals"]
+    Research --> CustomerResearch["Customer Research"]
+    Research --> ProductResearch["Product Research"]
+    Research --> Competitive["Competitive Analysis"]
+    Research --> Synthesis["Synthesis"]
+
+%% ==================================================
+%% GROWTH
+%% ==================================================
+
+    Growth --> Funnels["Funnels"]
+    Growth --> Pricing["Pricing"]
+    Growth --> Retention["Retention"]
+    Growth --> Analytics["Analytics"]
+    Growth --> Partnerships["Partnerships"]
+
+%% ==================================================
+%% MARKETING
+%% ==================================================
+
+    Marketing --> Content["Content"]
+    Marketing --> Scriptwriter["Scriptwriter"]
+    Marketing --> Designer["Designer"]
+    Marketing --> VideoDirector["Video Director"]
+    Marketing --> VideoEditor["Video Editor"]
+    Marketing --> AssetProducer["Asset Producer"]
+
+%% ==================================================
+%% ENGINEERING
+%% ==================================================
+
+    Engineering --> Frontend["Frontend"]
+    Engineering --> Backend["Backend"]
+    Engineering --> Security["Security"]
+    Engineering --> QA["QA"]
+    Engineering --> Release["Release"]
+    Engineering --> Implementation["Implementation"]
+
+%% ==================================================
+%% DOMAIN FLOWS
+%% ==================================================
+
+    Research -. Customer pain points,
+    market opportunities,
+    competitor insights .-> Growth
+
+    Research -. Product validation,
+    user feedback,
+    feature requests .-> Engineering
+
+    Research -. Audience insights,
+    positioning,
+    messaging hooks .-> Marketing
+
+    Growth -. Conversion metrics,
+    funnel bottlenecks,
+    winning experiments .-> Marketing
+
+    Growth -. Usage analytics,
+    retention signals,
+    monetization opportunities .-> Engineering
+
+    Marketing -. Campaign goals,
+    content requirements,
+    landing page needs .-> Engineering
+
+    Marketing -. Messaging tests,
+    campaign outcomes,
+    audience responses .-> Growth
+
+    Engineering -. Product capabilities,
+    release schedules,
+    technical constraints .-> Marketing
+
+    Engineering -. Product telemetry,
+    feature adoption,
+    event tracking .-> Growth
+
+    Engineering -. Technical feasibility,
+    implementation feedback .-> Research
+
+%% ==================================================
+%% FEEDBACK LOOP
+%% ==================================================
+
+    Research --> Coordinator
+    Growth --> Coordinator
+    Marketing --> Coordinator
+    Engineering --> Coordinator
+```
+
+***
+
+## Co dokładnie płynie między agentami?
+
+### Research → Growth
+
+**Artefakty**
+
+* trendy rynkowe
+* sygnały zakupowe
+* segmentacja klientów
+* konkurencja
+* opportunity discovery
+
+Przykład:
+
+```text
+Klienci SMB mają problem z onboardingiem.
+Największy odpływ następuje w ciągu pierwszych 7 dni.
+```
+
+***
+
+### Research → Marketing
+
+**Artefakty**
+
+* ICP (Ideal Customer Profile)
+* pain points
+* messaging angles
+* value propositions
+* objections
+
+Przykład:
+
+```text
+Najczęstszy problem:
+„Konfiguracja trwa za długo”
+
+Najlepszy komunikat:
+„Uruchomienie w 15 minut”
+```
+
+***
+
+### Research → Engineering
+
+**Artefakty**
+
+* feature requests
+* customer complaints
+* usability issues
+* unmet needs
+
+Przykład:
+
+```text
+62% klientów oczekuje eksportu do Excela.
+```
+
+***
+
+### Growth → Marketing
+
+**Artefakty**
+
+* wyniki A/B testów
+* CTR
+* konwersje
+* skuteczne nagłówki
+
+Przykład:
+
+```text
+Wariant B zwiększył konwersję o 17%.
+```
+
+***
+
+### Marketing → Engineering
+
+**Artefakty**
+
+* landing page requirements
+* tracking requirements
+* content blocks
+* CTA requirements
+
+Przykład:
+
+```text
+Potrzebujemy kalkulator ROI na stronie produktu.
+```
+
+***
+
+### Engineering → Growth
+
+**Artefakty**
+
+* telemetry
+* events
+* feature usage
+* retention data
+
+Przykład:
+
+```text
+78% użytkowników używa funkcji X
+mniej niż raz tygodniowo.
+```
+
+***
+
+### Engineering → Marketing
+
+**Artefakty**
+
+* roadmap
+* release notes
+* capabilities
+* differentiators
+
+Przykład:
+
+```text
+Nowa funkcja AI zostanie wydana w wersji 2.4.
+```
+
+***
+
+## Rola Coordinatora
+
+Coordinator nie tworzy treści.
+
+Coordinator:
+
+```text
+Receive task
+    ↓
+Decompose
+    ↓
+Route to domain owners
+    ↓
+Collect outputs
+    ↓
+Resolve conflicts
+    ↓
+Aggregate
+    ↓
+Final response
+```
+
+Czyli w Twojej architekturze:
+
+```text
+Research = odkrywa wiedzę
+Growth = optymalizuje biznes
+Marketing = komunikuje wartość
+Engineering = buduje rozwiązanie
+Coordinator = zarządza przepływem pracy
+```
+
+To jest już pełny model **Hub-and-Spoke Multi-Agent Organization** z przepływami wiedzy, decyzji i artefaktów między domenami.