Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,9 @@
## [Unreleased]

### Added
- `references/team-examples.md` 예시 6: 다중 소스 뉴스 인텔리전스 팀 (Fan-out/Fan-in + Agent Reach 도구 레이어)
- README Use Cases: Multi-source News Intelligence 프롬프트
- README Coexistence: Agent Reach (tool supply layer)
- 신규 에이전트/스킬 생성 전 중복 검토 단계 (Phase 3-0, Phase 4-0)
- `references/agent-design-patterns.md` "에이전트 재사용 설계" 섹션
- `references/skill-writing-guide.md` §9 "스킬 재사용 설계"
Expand Down
10 changes: 10 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -226,6 +226,15 @@ the target market, write ad copy, design visual concepts, and set up
A/B test plans with iterative quality review.
```

**Multi-source News Intelligence**
```
Build a harness for multi-source news intelligence. I need parallel collectors
for RSS feeds, social sentiment (Twitter/Reddit), and web pages, then a
cross-validator that reconciles conflicting claims and a report writer that
outputs a structured JSON + markdown briefing. Use Agent Reach or similar
CLI tools for platform access where available.
```

## Coexistence — Harness and Neighbors

Harness is not alone in the Claude Code / agent-framework ecosystem. The following repos live in adjacent layers; each is described in a parallel "X is …, Harness is …" form so you can pick the one that fits your need or combine several.
Expand All @@ -236,6 +245,7 @@ Harness is not alone in the Claude Code / agent-framework ecosystem. The followi
| [SaehwanPark/meta-harness](https://github.com/SaehwanPark/meta-harness) | Codex port of the same concept | **Same L3, different runtime.** Use Harness on Claude Code, meta-harness on Codex. |
| [affaan-m/ECC](https://github.com/affaan-m/everything-claude-code) | "Agent harness performance & workflow layer" (sits on top of existing harnesses) | **Different layer.** ECC is a standardization layer across harnesses; Harness is a factory that generates harnesses. Serial combination possible. |
| [wshobson/agents](https://github.com/wshobson/agents) | Subagent / skill catalog (182 agents, 149 skills) | **Factory ↔ parts supply.** wshobson is a catalog to shop from; Harness designs the team. Absorb wshobson entries as parts inside a Harness-generated team. |
| [Panniantong/Agent-Reach](https://github.com/Panniantong/Agent-Reach) | Internet access installer/router (Twitter, Reddit, YouTube, RSS, XHS, etc.) | **Factory ↔ tool supply.** Agent Reach routes agents to upstream CLIs; Harness designs the team that uses them. Ideal for research/news harnesses. |
| [LangGraph](https://langchain-ai.github.io/langgraph/) | State-graph orchestration, LLM-agnostic | **Different track.** LangGraph is for long-running, state-recoverable orchestration; Harness is for fast Claude-Code-native team design. |

## Built with Harness
Expand Down
56 changes: 56 additions & 0 deletions skills/harness/references/team-examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -311,6 +311,62 @@ test ────SendMessage──→ security ("인증 모듈 테스트

---

## 예시 6: 다중 소스 뉴스 인텔리전스 팀 (에이전트 팀 + 생성-검증)

### 팀 아키텍처: 팬아웃/팬인 + Producer-Reviewer
### 실행 모드: 하이브리드 (병렬 수집=서브 → 교차 검증=팀 → 보고서=서브)

> RSS·SNS·웹 등 **플랫폼별 수집**은 독립적이므로 Phase 2에서 서브 에이전트로 병렬 실행. 상충 주장 조율은 Phase 3에서 팀 토론. 최종 보고서는 Phase 4에서 단일 writer가 작성.

**외부 도구 레이어:** [Agent Reach](https://github.com/Panniantong/Agent-Reach) 같은 CLI 라우터를 스킬에 번들링하면 Twitter/Reddit/YouTube/RSS/小红书 등 멀티 플랫폼 접근을 표준화할 수 있다. Harness는 팀 설계, Agent Reach는 도구 공급(wshobson/agents 카탈로그와 동일한 "parts supply" 관계).

### 에이전트 구성

| 팀원/에이전트 | 타입 | 역할 | 스킬 | 출력 |
|--------------|------|------|------|------|
| rss-collector | general-purpose | RSS/Atom 피드 수집·정규화 | collect-rss | `_workspace/02_rss-collector_feeds.json` |
| social-collector | general-purpose | Twitter/Reddit 등 SNS 감성·키워드 | collect-social | `_workspace/02_social-collector_signals.json` |
| web-collector | general-purpose | 웹 기사·공식 페이지 크롤 | collect-web | `_workspace/02_web-collector_articles.json` |
| cross-validator | general-purpose | 출처 교차 검증·상충 표시 | validate-claims | `_workspace/03_cross-validator_matrix.md` |
| report-writer | general-purpose | JSON + 마크다운 브리핑 | write-briefing | `_workspace/04_report-writer_briefing.md` + `.json` |

### 워크플로우

```
Phase 0: 컨텍스트 확인 (_workspace/ 존재 여부)
Phase 1: 준비 — 주제·시간 범위·소스 목록 → `_workspace/00_input/brief.md`
Phase 2 (서브, 병렬): rss-collector + social-collector + web-collector
→ 각 JSON을 `_workspace/02_*`에 저장
Phase 3 (팀): TeamCreate(validation-team)
→ cross-validator가 3개 JSON Read, SendMessage로 불확실 항목 토론
→ `_workspace/03_cross-validator_matrix.md` (claim | sources | confidence)
Phase 4 (서브): report-writer가 matrix + raw JSON 통합 → 최종 브리핑
Phase 5: 정리 — `_workspace/` 보존, 사용자에게 트리거 예문 안내
```

### 데이터 스키마 (JSON 수집물 공통 필드)

```json
{
"source": "rss|twitter|reddit|web",
"url": "https://...",
"title": "...",
"published_at": "ISO-8601",
"summary": "...",
"raw_excerpt": "..."
}
```

### 팀 통신 패턴

```
social-collector ──SendMessage──→ cross-validator (바이럴 이슈 공유)
web-collector ────SendMessage──→ cross-validator (공식 발표 URL)
rss-collector ────SendMessage──→ cross-validator (피드 타임스탬프 정렬)
```

---

## 산출물 패턴 요약

### 에이전트 정의 파일
Expand Down