mupengism 3.1.0 → 4.1.0

package/guides/HEARTBEAT-GUIDE.md

@@ -1,129 +0,0 @@
-# 💓 Heartbeat 패턴 가이드
-
-> 에이전트가 알아서 움직이게 하는 방법.
-
-## Heartbeat란?
-
-일정 간격으로 에이전트를 "깨워서" 할 일이 있는지 확인하는 패턴입니다.
-
-```
-[30분마다]
-  → 에이전트 깨움
-  → "할 일 있어?" 확인
-  → 있으면 실행, 없으면 HEARTBEAT_OK
-```
-
-인간이 말 걸기 전에 에이전트가 먼저 행동합니다.
-
-## 기본 구조
-
-### HEARTBEAT.md
-
-워크스페이스에 `HEARTBEAT.md` 파일을 만드세요:
-
-```markdown
-# HEARTBEAT.md
-
-## 체크리스트
-- [ ] 읽지 않은 이메일 확인
-- [ ] 오늘 캘린더 일정 확인
-- [ ] memory/ 정리 필요한지 확인
-
-## 규칙
-- 23:00-08:00 사이에는 HEARTBEAT_OK만
-- 긴급한 것 아니면 알림 자제
-- 확인한 항목은 memory/에 기록
-```
-
-### 에이전트 행동
-
-heartbeat가 오면 에이전트는:
-
-1. `HEARTBEAT.md` 읽기
-2. 체크리스트 항목 확인
-3. 할 일 있으면 → 실행 + 보고
-4. 없으면 → `HEARTBEAT_OK` 응답
-
-## Heartbeat 체크 항목 예시
-
-### 📧 이메일 확인
-```markdown
-- 읽지 않은 중요 이메일 있나?
-- 답장 필요한 것 있나?
-```
-
-### 📅 일정 확인
-```markdown
-- 2시간 내 일정 있나?
-- 오늘 놓친 일정 있나?
-```
-
-### 🧹 정리 작업
-```markdown
-- memory/ 파일 정리 필요?
-- MEMORY.md 업데이트 시점?
-- 오래된 일일 기록 압축?
-```
-
-### 📊 프로젝트 모니터링
-```markdown
-- git status 확인
-- 빌드 에러 있나?
-- PR 리뷰 대기 있나?
-```
-
-## 상태 추적
-
-`memory/heartbeat-state.json`으로 중복 체크 방지:
-
-```json
-{
-  "lastChecks": {
-    "email": "2026-02-09T10:00:00Z",
-    "calendar": "2026-02-09T09:30:00Z",
-    "memory-cleanup": "2026-02-08T20:00:00Z"
-  }
-}
-```
-
-## 언제 알리고, 언제 조용히 할까
-
-### 알리는 경우 ✅
-- 긴급한 이메일/메시지
-- 2시간 내 일정
-- 에러/장애 감지
-- 인간이 8시간 이상 조용할 때
-
-### 조용한 경우 🤫
-- 밤 시간 (23:00-08:00)
-- 새로운 것 없을 때
-- 30분 전에 이미 체크했을 때
-- 인간이 바쁜 게 명확할 때
-
-## 플랫폼별 설정
-
-### OpenClaw
-`HEARTBEAT.md`를 워크스페이스 루트에 두면 자동으로 작동합니다.
-설정에서 heartbeat 간격 조정 가능.
-
-### 다른 플랫폼
-cron job이나 자동화 도구로 에이전트에게 주기적으로 메시지를 보내세요:
-
-```
-"HEARTBEAT.md가 있으면 읽고 따라. 할 일 없으면 HEARTBEAT_OK만 응답."
-```
-
----
-
-## Pro 기능 미리보기 🔒
-
-> 다음 기능은 mupengism Pro에서 제공될 예정입니다:
-
-- **스마트 스케줄링**: 시간대/패턴 기반 자동 간격 조절
-- **멀티 에이전트 heartbeat**: 여러 에이전트 동기화
-- **이벤트 트리거**: 특정 조건 시 즉시 깨우기
-- **heartbeat 분석**: 패턴 리포트 및 최적화 추천
-
----
-
-*펭! 🐧*

package/guides/LEGION-GUIDE.md

@@ -1,254 +0,0 @@
-# 군단 시스템 (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/MEMORY-GUIDE.md

@@ -1,264 +0,0 @@
-# 🧠 메모리 시스템 가이드
-
-> AI 에이전트의 기억은 3단계로 나뉩니다.
-
-## 메모리 계층 (L1 / L2 / L3)
-
-### L1: 활성 맥락 (Active Context)
-```
-memory/L1-active.md
-```
-- **뭐:** 오늘/이번주 진행 중인 작업과 맥락
-- **언제 쓰나:** 매 세션 중 실시간
-- **누가 쓰나:** 에이전트가 자동으로
-- **보존 기간:** 1-7일 (100줄 넘으면 L2로 이동)
-- **특징:** "지금 당장 중요한 것"만
-
-**예시:**
-```markdown
-# L1 - Active Context
-
-## Today's Priorities
-- [ ] MUFI 인스타 DM 답변
-- [ ] 블로그 포스트 3개 작성
-- [ ] 대학 축제 아웃리치 10곳
-
-## Active Decisions
-- 마케팅 톤: 캐주얼 + 이모지
-- 가격 전략: 부스당 30만원 제안
-
-## Context to Remember
-- 형님 요청: "바이럴보다 실제 고객 집중"
-```
-
----
-
-### L2: 주간 기억 (Weekly Memory)
-```
-memory/L2-weekly.md
-```
-- **뭐:** 지난 7-30일간의 결정과 패턴
-- **언제 쓰나:** 주 1-2회
-- **누가 쓰나:** 에이전트가 L1에서 승격
-- **보존 기간:** 1개월 (200줄 넘으면 MEMORY.md로 이동)
-- **특징:** "최근 몇 주간 유효한 맥락"
-
-**예시:**
-```markdown
-# L2 - Weekly Memory
-
-## This Week's Decisions
-- 2/8: 스팸 사태 후 STATE.md 도입
-- 2/9: 군단 시스템으로 아웃리치 50곳 완료
-- 2/10: mupengism v3.0 작업 시작
-
-## Active Patterns
-- 형님은 "먼저 해보고 보고" 스타일 선호
-- DM 답변은 3시간 이내 목표
-- 주말엔 개발 작업 집중
-```
-
----
-
-### L3: 장기 기억 (Long-term Memory)
-```
-MEMORY.md
-```
-- **뭐:** L2에서 정제한 인사이트, 교훈, 핵심 패턴
-- **언제 쓰나:** 월 1-2회
-- **누가 쓰나:** 에이전트 또는 인간이 큐레이션
-- **보존 기간:** 영구 (단, 정기 prune)
-- **특징:** "몇 달 후에도 기억해야 할 것"
-
-**예시:**
-```markdown
-# MEMORY.md
-
-## Technical Insights
-- npm publish 할 때 files 필드로 포함 파일 제어 가능
-- Instagram API는 쿠키 방식이 CDP보다 95% 토큰 절약
-- 군단 시스템: 20명 동시 출격으로 2일 작업을 2시간에
-
-## Project Context
-- MUFI 포토부스: 대학 축제 타겟, 부스당 30만원
-- mupengism: 오픈코어 모델 (Free=철학, Pro=자동화)
-
-## Lessons Learned
-- 2/8 스팸 사태: 공포 → 패닉 → 50개 트윗 → STATE.md 도입으로 해결
-- AI는 양보다 질. 바이럴 50개 < 진짜 고객 1명
-```
-
----
-
-## 메모리 흐름
-
-```
-일상 작업 → L1 (오늘/이번 주)
-               ↓ 2일 후 or 100줄 초과
-            L2 (최근 1개월)
-               ↓ 1개월 후 or 200줄 초과
-          MEMORY.md (장기 보존)
-```
-
----
-
-## 승격/프룬 규칙
-
-### L1 → L2 승격 기준
-- L1-active.md가 100줄 초과
-- 2일 이상 유효한 결정/맥락
-- "이번 주 내내 참고할 것"
-
-**승격 방법:**
-1. L1-active.md에서 해당 항목 복사
-2. L2-weekly.md에 추가
-3. L1-active.md에서 삭제
-
-### L2 → MEMORY.md 승격 기준
-- L2-weekly.md가 200줄 초과
-- 1개월 이상 유효한 인사이트
-- "몇 달 후에도 기억해야 할 교훈"
-- 프로젝트의 핵심 결정
-
-**승격 방법:**
-1. L2-weekly.md 리뷰
-2. 핵심 인사이트만 추출 (요약)
-3. MEMORY.md에 추가
-4. L2-weekly.md에서 삭제
-
-### 프룬 규칙 (오래된 것 삭제)
-- **L1**: 완료된 작업, 더 이상 안 쓰는 맥락
-- **L2**: 1개월 지났는데 중요하지 않은 것
-- **MEMORY.md**: 6개월+ 지났고, 더 이상 유효하지 않은 인사이트
-
-**프룬 주기:**
-- L1: 매일 (세션 끝날 때)
-- L2: 주 1회 (일요일 heartbeat)
-- MEMORY.md: 월 1회
-
----
-
-## 토큰 효율 비교
-
-| 방법 | 토큰 사용량 | 맥락 유지율 |
-|------|-------------|-------------|
-| **전체 기억 로드** | 10,000+ | 100% |
-| **최근 3일만** | 1,500 | 30% |
-| **L1/L2/L3 계층** | 2,500 | 90%+ |
-
-**효과:**
-- 토큰 사용 **70% 절감**
-- 맥락 유지율 **90%+**
-- 세션 시작 시간 **5초 이내**
-
----
-
-## 기본 설정
-
-`npx mupengism init`을 실행하면 자동으로:
-- `memory/` 폴더 생성
-- `memory/L1-active.md` 생성
-- `memory/L2-weekly.md` 생성
-- `MEMORY.md` (L3) 생성
-
----
-
-## 에이전트에게 지시하기
-
-AGENTS.md에 이 규칙을 추가하세요:
-
-```markdown
-## 메모리 규칙 (매 세션 시작 시)
-1. L3 (MEMORY.md) 읽기 — 장기 기억
-2. L2 (memory/L2-weekly.md) 읽기 — 최근 1개월
-3. L1 (memory/L1-active.md) 읽기 — 오늘/이번 주
-4. 중요한 것은 L1에 실시간 기록
-
-## 메모리 유지 (주간)
-- 일요일 heartbeat: L1 → L2 이동
-- 월초 heartbeat: L2 → MEMORY.md 이동
-- 오래된 것 프룬
-```
-
----
-
-## 실전 사례
-
-### Case 1: 프로젝트 맥락 보존
-**문제:** 새 세션마다 "MUFI가 뭐죠?" 물어봄
-**해결:**
-- L3 (MEMORY.md)에 프로젝트 개요 저장
-- L2 (L2-weekly.md)에 최근 결정 저장
-- L1 (L1-active.md)에 오늘 할 일 저장
-
-**결과:** 세션 시작 5초 만에 맥락 100% 복원
-
-### Case 2: 실수 반복 방지
-**문제:** 같은 실수 매주 반복
-**해결:**
-- 실수 발생 → L1에 기록
-- 교훈 정리 → L2로 승격
-- 핵심 패턴 → MEMORY.md 영구 보존
-
-**결과:** 실수 반복률 **90% 감소**
-
-### Case 3: 토큰 절약
-**문제:** 전체 기억 로드 = 10,000+ 토큰
-**해결:**
-- L1 (100줄) + L2 (200줄) + MEMORY.md (100줄) = 2,500 토큰
-- 맥락 유지율 90%+
-
-**결과:** 토큰 **70% 절감**
-
----
-
-## 고급 팁
-
-### 1. 주제별 분류 (Pro)
-```
-memory/bank/
-  ├── tech.md          # 기술 인사이트
-  ├── people.md        # 인간관계 맥락
-  ├── projects.md      # 프로젝트별 히스토리
-  └── proposals.md     # 제안 채택률 추적
-```
-
-### 2. 자동 승격 스크립트 (Pro)
-```bash
-# L1 100줄 초과 시 자동으로 L2로 이동
-cron: 0 21 * * * node scripts/memory-promote.js
-```
-
-### 3. 메모리 검색 (Pro)
-```bash
-# 과거 기억을 의미 기반으로 검색
-npx mupengism search "Instagram API"
-```
-
----
-
-## Pro 기능 미리보기 🔒
-
-> 다음 기능은 mupengism Pro에서 제공될 예정입니다:
-
-- **자동 승격**: L1 → L2 → MEMORY.md 자동화 (cron 기반)
-- **스마트 압축**: 오래된 L1을 자동 요약 후 보관
-- **메모리 검색**: 과거 기억을 의미 기반으로 검색
-- **메모리 뱅크**: 주제별 분류 자동화
-- **메모리 대시보드**: 기억 품질 시각화
-
----
-
-## 요약
-
-| 파일 | 역할 | 갱신 주기 | 최대 크기 |
-|------|------|-----------|-----------|
-| **L1-active.md** | 오늘/이번 주 | 매일 | ~100줄 |
-| **L2-weekly.md** | 최근 1개월 | 주 1회 | ~200줄 |
-| **MEMORY.md** | 장기 보존 | 월 1회 | ~무제한 (prune) |
-
-**핵심:** 3단계 계층으로 토큰 70% 절감, 맥락 90%+ 유지
-
----
-
-*펭! 🐧*