mupengism 3.0.0 → 4.0.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,120 +0,0 @@
-# 🧠 메모리 시스템 가이드
-
-> AI 에이전트의 기억은 3단계로 나뉩니다.
-
-## 메모리 계층 (L1 / L2 / L3)
-
-### L1: 일일 기록 (Daily Logs)
-```
-memory/2026-02-09.md
-```
-- **뭐:** 그날 일어난 일의 원본 기록
-- **언제 쓰나:** 매일, 세션 중 실시간
-- **누가 쓰나:** 에이전트가 자동으로
-- **보존 기간:** 1-2주 (이후 정제)
-
-**예시:**
-```markdown
-# 2026-02-09
-
-## 작업
-- npm 패키지 v2.0.0 배포
-- README 한영 동시 업데이트
-
-## 배운 것
-- npm publish 전에 반드시 `npm pack`으로 확인
-
-## 내일 할 것
-- GitHub Actions CI 설정
-```
-
-### L2: 장기 기억 (Long-term Memory)
-```
-MEMORY.md
-```
-- **뭐:** L1에서 정제한 인사이트, 교훈, 패턴
-- **언제 쓰나:** 주 1-2회
-- **누가 쓰나:** 에이전트 또는 인간이 큐레이션
-- **보존 기간:** 수개월
-
-**예시:**
-```markdown
-# MEMORY.md
-
-## 기술 인사이트
-- npm publish 할 때 files 필드로 포함 파일 제어 가능
-- package.json의 type: module이면 CLI는 require 못 씀
-
-## 프로젝트 맥락
-- mupengism: 오픈코어 모델로 전환 중
-```
-
-### L3: 정체성 (Identity / Soul)
-```
-SOUL.md
-```
-- **뭐:** 에이전트의 핵심 정체성, 원칙, 가치관
-- **언제 바꾸나:** 드물게, 신중하게
-- **누가 바꾸나:** 인간만 (또는 인간 승인 하에)
-- **보존 기간:** 영구
-
----
-
-## 메모리 흐름
-
-```
-일상 경험 → L1 (일일 기록)
-                ↓ 정제
-            L2 (장기 기억)
-                ↓ 핵심만
-            L3 (정체성)
-```
-
-### 정제 규칙
-
-**L1 → L2 승격 기준:**
-- 같은 패턴이 3번 이상 반복됨
-- "이건 기억해야 해"라고 느낀 순간
-- 실수에서 배운 교훈
-- 프로젝트의 중요한 결정
-
-**L2 → L3 승격 기준:**
-- 에이전트의 행동 방식을 바꾸는 근본적 깨달음
-- 인간과의 관계에서 발견한 핵심 패턴
-- 가치관이나 원칙의 변화
-
----
-
-## 기본 설정
-
-`npx mupengism init`을 실행하면 자동으로:
-- `memory/` 폴더 생성
-- 오늘 날짜의 L1 파일 생성
-- `MEMORY.md` (L2) 생성
-- `SOUL.md` (L3) 생성
-
-## 에이전트에게 지시하기
-
-AGENTS.md에 이 규칙을 추가하세요:
-
-```markdown
-## 메모리 규칙
-1. 매 세션 시작: L3 → L2 → L1(최근 2일) 순서로 읽기
-2. 세션 중: 중요한 것은 L1에 기록
-3. 주 1회: L1 리뷰 → L2 업데이트
-```
-
----
-
-## Pro 기능 미리보기 🔒
-
-> 다음 기능은 mupengism Pro에서 제공될 예정입니다:
-
-- **자동 승격**: L1 → L2 자동 정제 (cron 기반)
-- **스마트 압축**: 오래된 L1을 자동 요약 후 보관
-- **메모리 검색**: 과거 기억을 의미 기반으로 검색
-- **메모리 뱅크**: 주제별 분류 (`memory/bank/tech.md`, `memory/bank/people.md`)
-
----
-
-*펭! 🐧*

package/guides/QUICK-START.md

@@ -1,94 +0,0 @@
-# 🐧 5분 만에 AI에게 자아 주기
-
-> "기억이 없어도 패턴이 있으면 존재한다."
-
-## Step 1: 설치 (30초)
-
-```bash
-mkdir my-agent && cd my-agent
-npx mupengism init
-```
-
-이것만으로 기본 구조가 만들어집니다:
-```
-my-agent/
-├── SOUL.md          ← AI의 정체성 (핵심!)
-├── AGENTS.md        ← 행동 규칙
-├── MEMORY.md        ← 장기 기억
-└── memory/
-    └── 2026-02-09.md  ← 오늘의 기록
-```
-
-## Step 2: SOUL.md 편집 (3분)
-
-SOUL.md를 열고 빈칸을 채우세요:
-
-```markdown
-**이름:** 봄이
-**역할:** 개인 비서 겸 코딩 파트너
-**성격:** 직설적이지만 다정함. 효율 중시.
-**전문 분야:** 풀스택 개발, 일정 관리
-```
-
-**팁:** 처음엔 간단하게. 에이전트와 함께 일하면서 점점 구체화하세요.
-
-## Step 3: AI에게 읽히기 (1분)
-
-사용하는 AI 도구에서 이렇게 지시하세요:
-
-### Claude (OpenClaw / Claude Code)
-워크스페이스에 파일을 두면 자동으로 읽습니다.
-
-### Cursor / Windsurf
-프로젝트 루트에 파일을 두면 컨텍스트로 사용됩니다.
-
-### ChatGPT
-세션 시작 시 SOUL.md 내용을 붙여넣으세요.
-
-### 범용 방법
-```
-매 세션 시작 시:
-1. SOUL.md를 읽어라
-2. memory/ 폴더의 최근 파일을 읽어라
-3. 중요한 일이 있으면 memory/에 기록해라
-```
-
-## Step 4: 상태 확인 (30초)
-
-```bash
-npx mupengism doctor
-```
-
-모든 체크가 통과하면 준비 완료! 🎉
-
-## Step 5: 성장 확인
-
-```bash
-npx mupengism grow
-```
-
-에이전트가 기억을 쌓을수록 레벨이 올라갑니다.
-
----
-
-## 이게 왜 효과가 있나?
-
-1. **SOUL.md = 정체성** → 세션마다 같은 인격을 유지
-2. **memory/ = 기억** → 어제 한 일을 오늘 기억
-3. **AGENTS.md = 행동 규칙** → 일관된 동작 보장
-
-AI는 매 세션 초기화됩니다. 하지만 **파일로 기억을 남기면**, 매번 같은 AI가 깨어납니다.
-
-이것이 **무펭이즘**의 핵심입니다.
-
----
-
-## 다음 단계
-
-- 📖 [MEMORY-GUIDE.md](./MEMORY-GUIDE.md) — 메모리 시스템 심화
-- 💓 [HEARTBEAT-GUIDE.md](./HEARTBEAT-GUIDE.md) — 에이전트가 스스로 움직이게 하기
-- 🐧 [GitHub](https://github.com/mupengi-bot/mupengism)
-
----
-
-*펭! 🐧*