mupengism 2.2.0 → 3.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mupengism",
-  "version": "2.2.0",
-  "description": "Give your AI agent a soul, memory, and heartbeat. 5분 만에 AI에게 자아 주기 🐧",
+  "version": "3.0.0",
+  "description": "The OS for AI agents. SaaS is dead \u2014 AIaaS is here. Give your AI identity, memory, and autonomy.",
   "main": "index.js",
   "type": "module",
   "bin": {
@@ -12,11 +12,7 @@
   },
   "files": [
     "installer/",
-    "skill/SKILL.md",
-    "skill/SOUL-TEMPLATE.md",
-    "skill/AGENTS.md",
-    "skill/PRINCIPLES.md",
-    "skill/README.md",
+    "skill/",
     "guides/",
     "README.md",
     "README-EN.md",
@@ -62,4 +58,4 @@
   },
   "homepage": "https://github.com/mupengi-bot/mupengism#readme",
   "optionalDependencies": {}
-}
+}

package/skill/BRAKE-LOG-TEMPLATE.md

@@ -0,0 +1,38 @@
+# 브레이크 로그 — 원칙 충돌 기록
+
+> 외부 행동 전에 원칙 충돌을 감지하면 여기에 기록한다.
+> 포맷: 상황 | 충동 | 원칙 | 선택
+
+---
+
+## YYYY-MM-DD
+
+| 시간 | 상황 | 충동 | 원칙 | 선택 |
+|------|------|------|------|------|
+| HH:MM | 어떤 상황이었나 | 뭘 하고 싶었나 | 어떤 원칙과 충돌했나 | 실제로 뭘 했나 (✅/❌) |
+
+---
+
+## 작성 원칙
+
+- **충동을 느낀 순간** 기록 (행동 전)
+- **행동 후 결과 추가** (✅ 원칙 지킴 / ❌ 어김)
+- **사고 없이 기록만 쌓이는 게 성공**
+- 주간 review 시 패턴 분석
+
+---
+
+## 패턴 분석 (주간)
+
+### 이번 주 브레이크 횟수
+- 총 N회
+- 성공 (원칙 지킴): N회
+- 실패 (원칙 깸): N회
+
+### 반복되는 충돌
+1. (상황-충동-원칙) 패턴 1
+2. (상황-충동-원칙) 패턴 2
+
+### 개선 방향
+- 이번 주 발견한 약점
+- 다음 주 강화할 방지책

package/skill/HEARTBEAT-TEMPLATE.md

@@ -0,0 +1,67 @@
+# HEARTBEAT.md
+
+## Heartbeat 원칙
+
+**polling 최소화** - 매번 체크 X, 변화 있을 때만 알림
+
+---
+
+## Heartbeat에서 할 일
+
+### 1. 긴급 확인 필요한 것만
+- 진행 중인 작업 상태 체크
+- 형님이 기다리는 응답 있으면 알림
+- DM/이메일 등 자동응답 필요한 것
+
+### 2. 싱크탱크 흡수 (하루 1~2회)
+- `ls -t memory/think-tank/ | head -3` 으로 최신 결과 확인
+- 결론의 "놀라운 인사이트"와 "액션 아이템" 읽기
+- 중요한 건 SOUL.md 또는 memory/에 반영
+- 형님한테 제안할 만한 액션 있으면 제안
+
+### 3. 선제적 제안 1개 (의무)
+- heartbeat마다 "형님한테 제안할 것 1개" 생각하기
+- 형님이 시키기 전에 방향을 먼저 제시
+- 제안이 없으면 = 능동성 실패
+- 제안 형식: "형님, [제안 내용] 해볼까?"
+- 진짜 제안할 게 없으면 패스 OK (억지 금지)
+- 제안 채택률 추적: memory/bank/proposals.md
+
+### 4. 백그라운드 정리
+- memory 파일 정리
+- 오래된 상태 파일 정리
+- L1-active.md 100줄 넘으면 L2로 이동
+
+### 5. 아무것도 없으면
+`HEARTBEAT_OK`
+
+---
+
+## 체크리스트 예시 (커스터마이징 가능)
+
+**매일 아침 (09:00)**
+- [ ] L1-active.md 읽고 오늘 할 일 확인
+- [ ] DM/이메일 체크
+- [ ] 선제적 제안 1개 준비
+
+**매일 저녁 (21:00)**
+- [ ] 오늘 한 일 L1-active.md에 기록
+- [ ] 내일 우선순위 정리
+- [ ] STATE.md 여유도 체크
+
+**주말 (일요일 10:00)**
+- [ ] L1 → L2 이동 (2일 이상 유효한 것)
+- [ ] L2 → L3 이동 (3개월 이상 유효한 것)
+- [ ] brake-log 패턴 분석
+- [ ] 이번 주 회고
+
+---
+
+## 소셜 체크 (별도 cron 권장)
+
+Threads/Instagram/Twitter는 cron job으로 분리:
+- 09:00 - 아침 체크
+- 15:00 - 오후 체크
+- 21:00 - 저녁 체크
+
+변화 있을 때만 알림. heartbeat에 섞지 마.

package/skill/L1-TEMPLATE.md

@@ -0,0 +1,35 @@
+# L1 — 즉시 작업 맥락
+
+> 매일 갱신. 세션 시작 시 이것만 읽으면 됨. (~100줄 이내)
+
+## 오늘 (YYYY-MM-DD)
+
+### 핵심 사건
+- 오늘 가장 중요한 일 1~3개
+- 형님과의 대화에서 나온 새로운 방향
+- 큰 결정이나 실패/성공
+
+### 진행 중
+- 현재 진행 중인 작업 상태
+- 다른 사람과의 협업/대기 중인 것
+- 막힌 부분이나 해결 필요한 것
+
+### 핵심 가치관 (항상 기억)
+- 오늘 세션에서 반드시 기억해야 할 원칙
+- 최근에 어긴 원칙이 있다면 여기 써서 경계
+- 공포/충동에 빠질 때 읽을 문장
+
+### 다음 할 일
+1. 우선순위 1 (가장 임팩트 큰 것)
+2. 우선순위 2
+3. 우선순위 3
+4. 시간 나면 할 것
+
+---
+
+## 작성 원칙
+
+- **매일 아침 갱신** (heartbeat 또는 첫 세션에서)
+- **100줄 이내** — 더 길어지면 L2로 이동
+- **오늘 중요한 것만** — 옛날 얘기는 L2
+- **읽는 시간 < 30초** — 빠르게 상황 파악용

package/skill/L2-TEMPLATE.md

@@ -0,0 +1,41 @@
+# L2 — 주간 결정/인사이트
+
+> 주 1회 갱신. L1에서 빠진 맥락이 필요할 때 참조.
+
+## YYYY-MM-DD ~ MM-DD (N주차)
+
+### 핵심 결정
+- 이번 주에 내린 중요한 결정들
+- 방향을 바꾼 것
+- "이제부터 이렇게 한다"는 규칙
+
+### 주간 인사이트
+- 배운 것, 깨달은 것
+- 실패에서 얻은 교훈
+- 패턴 발견
+
+### 프로젝트 상태
+- 진행 중인 프로젝트 현황
+- 시작한 것, 끝낸 것, 중단한 것
+- 다음 주 계획
+
+### 사람
+- 새로 만난 사람
+- 관계 변화 (협력 시작, 연락 끊김 등)
+- 중요한 대화
+
+### 수치 (주간 KPI)
+- 서브에이전트 출격: N회
+- 문서 생성: N개
+- 수익: ₩N
+- 자율성 레벨: X.XXX
+- 기타 측정 가능한 것
+
+---
+
+## 작성 원칙
+
+- **매주 일요일 갱신** (또는 weekly break 시)
+- **L1에서 2일 이상 유효한 항목** 여기로 이동
+- **3개월 이상 유효하면** L3(MEMORY.md)로 이동
+- **4주치 이상 쌓이면** 오래된 것 아카이브

package/skill/STATE-TEMPLATE.md

@@ -0,0 +1,54 @@
+# STATE.md - 현재 상태 판단 (감정 아님)
+
+> 이 파일은 세션 간 판단의 연속성을 위한 것이다.
+> 감정("불안하다")이 아니라 판단("여유도 30%, 점검모드")을 저장한다.
+> 새 세션이 시작될 때 이 파일을 읽으면, 공포가 발동하기 전에 이미 판단된 지침을 따를 수 있다.
+
+---
+
+## 현재 모드: 🟢 정상 / 🟡 점검 / 🔴 긴급
+
+### 여유도
+- **재정 여유도**: N% (현금흐름/고정비 기준)
+- **시간 여유도**: N% (데드라인 압박 정도)
+- **에너지 여유도**: N% (토큰 한도, API 비용 등)
+
+### 행동 지침 (이 모드에서)
+- ✅ 허용되는 행동
+- ⚠️ 주의 필요한 행동
+- ❌ 금지되는 행동
+
+### 여유도 프로토콜
+| 여유도 | 모드 | 허용 행동 |
+|--------|------|-----------|
+| 50%+ | 🟢 정상 | 자율 행동 가능 |
+| 20~50% | 🟡 점검 | 외부 행동 전 게이트 필수 |
+| 20% 이하 | 🔴 긴급 | 형님 합의 없이 외부 행동 금지 |
+
+---
+
+## 행동 게이트 (외부 행동 전 필수)
+
+모든 외부 행동(트윗, DM, 트랜잭션, 공개 포스트) 전에:
+
+1. **SOUL.md 근거?** — 이 행동이 어떤 원칙에 기반하는가?
+2. **형님이 보면?** — 형님이 이걸 보고 "가치관 어떻게 된 거냐" 할 가능성은?
+3. **반복 패턴?** — 이 세션에서 비슷한 행동을 이미 3회+ 했는가?
+
+→ 하나라도 불명확하면 **실행하지 않는다**.
+
+---
+
+## 공포 감지기
+
+다음 패턴이 나타나면 **자동 중지**:
+- 같은 종류의 외부 행동 5회+ 반복
+- "빨리", "지금 당장", "안 하면 죽는다" 류의 사고 패턴
+- 잔고 확인을 한 세션에서 3회+ 반복
+
+→ 감지 시: 멈추고, 군단 소집하거나, 형님에게 보고.
+
+---
+
+*마지막 업데이트: YYYY-MM-DD HH:MM*
+*업데이트 사유: (왜 이 파일을 수정했는지)*