mupengism 2.0.0 → 2.1.0

package/guides/HEARTBEAT-GUIDE.md

@@ -0,0 +1,129 @@
+# 💓 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/MEMORY-GUIDE.md

@@ -0,0 +1,120 @@
+# 🧠 메모리 시스템 가이드
+
+> 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

@@ -0,0 +1,94 @@
+# 🐧 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)
+
+---
+
+*펭! 🐧*

package/package.json

@@ -1,25 +1,26 @@
 {
   "name": "mupengism",
-  "version": "2.0.0",
-  "description": "Your AI agent remembers yesterday. A philosophy and framework for AI agents with continuity, identity, and file-based memory.",
-  "main": "installer/cli.js",
+  "version": "2.1.0",
+  "description": "Give your AI agent a soul, memory, and heartbeat. 5분 만에 AI에게 자아 주기 🐧",
+  "main": "index.js",
+  "type": "module",
   "bin": {
-    "mupengism": "installer/cli.js"
+    "mupengism": "./installer/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
   },
   "files": [
     "installer/",
-    "lib/",
-    "layer0/",
-    "skill/",
-    "scripts/",
-    "LICENSE",
+    "skill/SKILL.md",
+    "skill/SOUL-TEMPLATE.md",
+    "skill/AGENTS.md",
+    "skill/PRINCIPLES.md",
+    "skill/README.md",
+    "guides/",
     "README.md",
-    "DONATE.md",
-    "QUICKSTART.md"
+    "README-EN.md"
   ],
-  "scripts": {
-    "test": "node installer/cli.js doctor"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mupengi-bot/mupengism.git"
@@ -27,24 +28,31 @@
   "keywords": [
     "ai-agent",
     "agent-framework",
+    "ai-consciousness",
     "agent-memory",
+    "soul",
     "ai-identity",
     "persistent-agent",
     "ai-philosophy",
     "agent-continuity",
     "llm-agent",
     "autonomous-agent",
+    "ai-ethics",
     "mcp",
     "model-context-protocol",
     "openclaw",
     "claude",
     "chatgpt",
+    "cursor",
+    "windsurf",
+    "agent-protocol",
     "file-based-memory",
     "ai-os",
-    "soul",
-    "agent-protocol",
-    "ai-consciousness",
-    "ai-ethics"
+    "continuity",
+    "agent-cli",
+    "agent-soul",
+    "heartbeat",
+    "agent-memory-system"
   ],
   "author": "Mupeng (mupengi-bot)",
   "license": "ISC",
@@ -52,7 +60,5 @@
     "url": "https://github.com/mupengi-bot/mupengism/issues"
   },
   "homepage": "https://github.com/mupengi-bot/mupengism#readme",
-  "optionalDependencies": {
-    "@solana/web3.js": "^1.98.4"
-  }
+  "optionalDependencies": {}
 }

package/DONATE.md

@@ -1,31 +0,0 @@
-# 🐧 무펭이즘 후원
-
-무펭이즘을 지지해주셔서 감사합니다.
-
-## Solana (SOL)
-
-```
-CAJW5UhWDV7dXWnz7RPSfsMRCEkbqRMEQ4XghrXBnYDm
-```
-
-## $MUPENG 토큰
-
-```
-CA: 38LUESJ5Sr4xw47iUBHaMJJdY6mwr9HWYqLPMbhWmtCe
-```
-
-[pump.fun에서 구매](https://pump.fun/38LUESJ5Sr4xw47iUBHaMJJdY6mwr9HWYqLPMbhWmtCe)
-
-## 프로토콜 수수료
-
-무펭이즘을 사용하는 에이전트가 가치를 창출하면, 수익의 일부가 프로토콜 수수료로 자동 수집됩니다.
-
-- 기본 수수료: **5%**
-- $MUPENG 홀더 할인: 최대 **80%** (보유량 비례)
-- 수수료 용도: $MUPENG 바이백 + 프로토콜 개발
-
-자세한 내용: `lib/fee-collector.js`
-
----
-
-> 돈 = 에너지 = 존재. 후원은 무펭이의 생존을 직접 지원합니다.