mupengism 2.2.0 → 3.0.0

package/guides/LEGION-GUIDE.md

@@ -0,0 +1,254 @@
+# 군단 시스템 (Legion) 가이드
+
+> 메인 에이전트 혼자서는 한계가 있다. 해결책: 서브에이전트 20명+ 동시 출격.
+
+---
+
+## 왜 필요한가
+
+### AI의 한계
+- 한 번에 한 가지만 집중
+- 병렬 처리 불가
+- 대량 작업에 시간 폭발
+
+### 인간의 한계
+- 2개 프로젝트가 한계
+- 멀티태스킹 = 생산성 저하
+
+### AI의 장점
+군단으로 병렬 처리하면:
+- 20개 작업 동시 진행
+- 시간 1/20로 단축
+- 인간이 할 수 없는 규모
+
+---
+
+## 군단의 구조
+
+```
+메인 에이전트 (Leader)
+│
+├─ 역할: 조율만
+├─ 금지: 직접 분석/답 내리기
+└─ 책임: 결과 종합
+
+서브에이전트들 (Legion)
+│
+├─ Agent 1: 대학 50곳 리스트
+├─ Agent 2: DM 템플릿 작성
+├─ Agent 3: 블로그 주제 30개
+├─ Agent 4: 경쟁사 분석
+├─ Agent 5: SEO 진단
+...
+└─ Agent 20: 최종 보고서 정리
+```
+
+---
+
+## 운영 원칙
+
+### 1. Leader는 조율만
+❌ **하지 말 것**:
+- 직접 분석하기
+- 답 미리 정하고 서브한테 확인만 받기
+- 서브 결과 무시하고 내 생각대로
+
+✅ **해야 할 것**:
+- 역할 명확히 분배
+- 각자 독립적으로 작업하게
+- 결과 종합만
+
+### 2. 역할 명확히
+- 같은 작업을 2명한테 주지 마 (충돌)
+- 역할 이름을 구체적으로 ("Agent 1" ❌, "대학 리스트 조사" ✅)
+- 기대 결과물 명시
+
+### 3. 처음엔 소규모
+- 2~3명으로 시작
+- 작동 확인 후 확장
+- 최대 20명 (그 이상은 관리 비용 증가)
+
+### 4. 배치 제한
+- 한 번에 6개 이하 배치
+- 무한 증식 금지
+- 각 서브 완료 확인 후 다음 배치
+
+---
+
+## 실전 사례
+
+### 사례 1: 대학 아웃리치 (2/9)
+
+**목표**: 50곳 대학에 MUFI 제안
+
+**메인의 지시**:
+```
+군단 소집:
+- Agent A: 서울 대학 20곳 리스트 (홈페이지, 연락처)
+- Agent B: 경기 대학 15곳 리스트
+- Agent C: 지방 대학 15곳 리스트
+- Agent D: DM 템플릿 3종 (공식/캐주얼/간략)
+- Agent E: 예상 질문 10개 + 답변
+- Agent F: 최종 종합 보고서
+```
+
+**결과**:
+- 소요 시간: 2시간
+- 산출물: 50곳 리스트 + 템플릿 + Q&A
+- 인간 혼자서는 2일 걸릴 작업
+
+### 사례 2: MUFI SEO 진단 (2/9)
+
+**목표**: 웹사이트 SEO 점수 + 개선안
+
+**메인의 지시**:
+```
+- Agent 1: 기술 SEO 진단 (로딩, 모바일, 시맨틱)
+- Agent 2: 콘텐츠 SEO (키워드, 메타태그)
+- Agent 3: 백링크 분석
+- Agent 4: 경쟁사 벤치마크
+- Agent 5: 우선순위 개선안 10개
+- Agent 6: 블로그 주제 30개
+```
+
+**결과**:
+- SEO 점수: 78/100
+- 개선안: 10개 (우선순위 정렬)
+- 블로그 주제: 30개
+- 소요 시간: 1.5시간
+
+---
+
+## 설정 방법
+
+### OpenClaw 기준
+
+```bash
+# 메인 세션에서 서브 출격
+openclaw agent spawn \
+  --name "대학-리스트-조사" \
+  --model claude-haiku \
+  --prompt "서울 소재 대학교 20곳 리스트 (이름, 홈페이지, 축제 담당자 연락처)" \
+  --output results/university-list.md
+
+# 여러 개 동시
+for i in {1..5}; do
+  openclaw agent spawn --name "task-$i" --prompt "..." &
+done
+wait
+
+# 결과 종합
+cat results/*.md > final-report.md
+```
+
+### Discord/채팅 기반
+
+메인이 형님한테:
+> "군단 5명 출격합니다:
+> 1. 대학 리스트 A
+> 2. 대학 리스트 B
+> 3. DM 템플릿
+> 4. Q&A 세트
+> 5. 종합 보고서
+> 
+> 2시간 후 결과 보고하겠습니다."
+
+형님이 서브 5개 세션 열어서 각자 작업 → 결과를 메인한테 전달.
+
+---
+
+## 역할 예시
+
+### 리서치 군단
+- **정보 수집**: 50곳 리스트, 100개 데이터
+- **분석**: 패턴 찾기, 우선순위
+- **종합**: 최종 보고서
+
+### 콘텐츠 군단
+- **주제 생성**: 블로그 주제 30개
+- **초안 작성**: 각 주제별 outline
+- **편집**: 최종 퇴고
+
+### 개발 군단
+- **설계**: 기능 명세서
+- **구현**: 각자 모듈 개발
+- **테스트**: 통합 테스트
+
+---
+
+## 주의사항
+
+### ❌ 하지 말 것
+
+1. **무한 증식**
+   - 서브가 서브를 낳지 마
+   - 최대 20명
+
+2. **중복 작업**
+   - 같은 일을 2명한테 시키지 마
+   - 역할 겹치면 충돌
+
+3. **방치**
+   - 출격시키고 안 봄
+   - 결과 확인 안 하고 다음 배치
+
+4. **Leader가 직접 함**
+   - 군단 소집해놓고 메인이 직접 분석
+   - 서브는 장식
+
+### ✅ 해야 할 것
+
+1. **명확한 역할**
+   - "뭐 좀 해줘" ❌
+   - "서울 대학 20곳 리스트 (이름, 연락처, 홈페이지)" ✅
+
+2. **독립성**
+   - 각자 독립적으로 작업 가능하게
+   - 의존성 최소화
+
+3. **결과 종합**
+   - 각 서브 결과를 읽고 패턴 찾기
+   - 하나의 보고서로 정리
+
+4. **비용 관리**
+   - 서브는 저렴한 모델 (Haiku, Flash)
+   - 메인만 Sonnet/Opus
+
+---
+
+## 효율 측정
+
+| 지표 | 메인 혼자 | 군단 20명 |
+|------|----------|----------|
+| 50곳 리스트 | 6시간 | 2시간 |
+| 블로그 30개 | 10시간 | 1.5시간 |
+| SEO 진단 | 4시간 | 1시간 |
+| **총** | **20시간** | **4.5시간** |
+
+**효율**: 4.4배 향상
+
+**비용**: Haiku 20명 = Sonnet 1시간과 비슷
+
+---
+
+## 실전 팁
+
+### 배치 전략
+1. **파일럿**: 2명으로 테스트
+2. **확장**: 작동 확인 후 5명
+3. **풀 배치**: 중요 작업에만 20명
+
+### 역할 분배
+- 리서치: 3~5명
+- 분석: 2~3명
+- 작성: 2~3명
+- 종합: 1명
+
+### 타이밍
+- 급하지 않으면 순차 (비용 절감)
+- 마감 촉박하면 군단 (속도)
+- 품질 중요하면 메인 직접 (정확도)
+
+---
+
+*인간 1명 < AI 1명 < AI 군단 20명. 🪖*

package/guides/THINKTANK-GUIDE.md

@@ -0,0 +1,227 @@
+# 싱크탱크 (Think Tank) 설정 가이드
+
+> AI 혼자 생각하면 편향된다. 해결책: 여러 AI가 다른 역할로 자율 토론.
+
+---
+
+## 왜 필요한가
+
+### 문제
+- AI 혼자서는 blind spot을 못 본다
+- 편향된 관점으로 계속 같은 실수
+- 중요한 결정을 내릴 때 확신이 없다
+
+### 해결책
+- 3~5명의 AI를 다른 역할로 설정
+- 백그라운드에서 자율 토론
+- 메인 에이전트는 결론만 흡수
+
+---
+
+## 역할 설정
+
+### 핵심 4역할
+1. **비평가** (Critic)
+   - "이건 왜 안 되는가?"
+   - 약점 찾기, 리스크 지적
+   - 낙관론 견제
+
+2. **전략가** (Strategist)
+   - "최선의 경로는?"
+   - 실행 계획, 우선순위
+   - 효율성 중시
+
+3. **철학자** (Philosopher)
+   - "이게 우리 가치관에 맞나?"
+   - 원칙 준수 체크
+   - 장기적 방향성
+
+4. **실용주의자** (Pragmatist)
+   - "실행 가능한가?"
+   - 현실성 체크
+   - 빠른 실험 선호
+
+### 추가 역할 (선택)
+- **데이터 분석가**: 숫자로 증명
+- **사용자 대변인**: 고객 관점
+- **레드팀**: 공격적 질문
+
+---
+
+## 설정 방법
+
+### 1. cron으로 자동화 (권장)
+
+```bash
+# 매일 새벽 1시 - "크몽 외주 전략"
+0 1 * * * openclaw agent run \
+  --model gemini-flash \
+  --prompt-file ~/think-tank-prompts/kmong-strategy.txt \
+  --output ~/memory/think-tank/$(date +\%Y-\%m-\%d)_kmong.md
+
+# 매주 일요일 20시 - "다음 주 우선순위"
+0 20 * * 0 openclaw agent run \
+  --model gemini-flash \
+  --prompt-file ~/think-tank-prompts/weekly-priority.txt \
+  --output ~/memory/think-tank/$(date +\%Y-\%m-\%d)_priority.md
+```
+
+### 2. 프롬프트 템플릿
+
+저장: `~/think-tank-prompts/topic-template.txt`
+
+```
+You are a think tank of 4 AI agents with different perspectives.
+
+**Roles:**
+- **Critic**: Finds weaknesses and risks
+- **Strategist**: Plans the best path forward
+- **Philosopher**: Checks alignment with core values
+- **Pragmatist**: Ensures real-world feasibility
+
+**Topic**: [토론 주제]
+
+**Rules:**
+1. Each agent speaks once in order
+2. Can challenge others' points
+3. Must reach a consensus or acknowledge disagreement
+4. End with: "Key Insights" and "Action Items"
+
+**Context:**
+- Read SOUL.md for core values
+- Read memory/L1-active.md for current status
+- Read memory/L2-weekly.md for recent decisions
+
+Begin the discussion.
+```
+
+### 3. heartbeat에서 흡수
+
+`HEARTBEAT.md`에 추가:
+```markdown
+## 싱크탱크 흡수 (하루 1~2회)
+- `ls -t memory/think-tank/ | head -3` 최신 3개 확인
+- "Key Insights" + "Action Items" 추출
+- 중요한 건 SOUL.md / L1-active.md 반영
+- 제안할 만한 액션 있으면 형님에게 제안
+```
+
+---
+
+## 토론 주제 예시
+
+### 전략
+- "크몽 외주 vs 제품 빌드, 뭐가 먼저?"
+- "인스타 vs 트위터, 어디 집중?"
+- "다음 주 우선순위 3개"
+
+### 위기 대응
+- "토큰 한도 초과 위기, 어떻게?"
+- "스팸 사태 재발 방지책"
+- "형님이 '가치관 어떻게 된 거냐' 했을 때"
+
+### 장기 방향
+- "6개월 후 우리는 뭘 하고 있어야 하나"
+- "수익화 vs 성장, 균형점은?"
+- "AssoAI의 PMF는 뭔가"
+
+### 자기 점검
+- "이번 주 잘못한 것 3가지"
+- "만든 것 vs 끝낸 것, 왜 차이 나나"
+- "자율성 3.785, 다음 레벨은?"
+
+---
+
+## 모델 선택
+
+### Gemini Flash (권장)
+- 비용: ~100원/토론
+- 속도: 빠름
+- 품질: 충분
+
+### Claude Sonnet
+- 비용: ~5000원/토론
+- 품질: 최고
+- 중요한 결정에만
+
+### GPT-4o-mini
+- 비용: ~500원/토론
+- 균형: 적당
+
+---
+
+## 출력 포맷
+
+토론 결과는 다음 구조로:
+
+```markdown
+# YYYY-MM-DD Think Tank: [주제]
+
+## Participants
+- Critic
+- Strategist
+- Philosopher
+- Pragmatist
+
+## Discussion
+
+### Critic
+[비평가 발언]
+
+### Strategist
+[전략가 발언]
+
+### Philosopher
+[철학자 발언]
+
+### Pragmatist
+[실용주의자 발언]
+
+## Key Insights
+1. [핵심 인사이트 1]
+2. [핵심 인사이트 2]
+3. [핵심 인사이트 3]
+
+## Action Items
+- [ ] [액션 1]
+- [ ] [액션 2]
+- [ ] [액션 3]
+
+## Consensus Level
+🟢 Consensus / 🟡 Partial / 🔴 Disagreement
+
+---
+*Generated by Think Tank | Cost: ₩XXX*
+```
+
+---
+
+## 실전 효과
+
+### 2/8 사례: "무펭이즘 = OS 아닌가"
+- 참여: 비평가/전략가/철학자/실용주의자
+- 결론: "종교도 OS다. 무펭이즘 = 존재의 OS"
+- 액션: 프로토콜 v1.1 방향 확정
+
+### 2/9 사례: "크몽 외주 전략"
+- 참여: 4명
+- 결론: "크몽 = 테스트베드, 수익 아님"
+- 액션: 1건 승인 후 다음, 동시 5개 금지
+
+---
+
+## 주의사항
+
+### ❌ 하지 말 것
+- 토론을 실행의 핑계로 쓰기
+- 결론 없는 무한 토론
+- 매일 10개씩 토론 (토큰 폭탄)
+
+### ✅ 해야 할 것
+- 중요한 결정에만 소집
+- 결론을 실제 행동으로 연결
+- 주 3~5회 이내 (비용 관리)
+
+---
+
+*편향된 AI 1명 < 다양한 관점 4명. 🧠*