@jungjaehoon/mama-os 0.1.1

package/scripts/postinstall.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+
+const { existsSync, mkdirSync, cpSync, readdirSync } = require('fs');
+const path = require('path');
+
+/**
+ * Copy templates to ~/.mama/ directory
+ */
+async function copyTemplates() {
+  const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+  const mamaDir = path.join(homeDir, '.mama');
+  const skillsDir = path.join(mamaDir, 'skills');
+  const workspaceDir = path.join(mamaDir, 'workspace');
+
+  // Create directories if they don't exist
+  if (!existsSync(mamaDir)) {
+    mkdirSync(mamaDir, { recursive: true });
+  }
+  if (!existsSync(skillsDir)) {
+    mkdirSync(skillsDir, { recursive: true });
+  }
+  if (!existsSync(workspaceDir)) {
+    mkdirSync(workspaceDir, { recursive: true });
+  }
+
+  // Find templates directory (in npm package or local)
+  const packageRoot = path.resolve(__dirname, '..');
+  const templatesDir = path.join(packageRoot, 'templates');
+
+  if (existsSync(templatesDir)) {
+    // Copy skills templates (only if not exist)
+    const skillsTemplateDir = path.join(templatesDir, 'skills');
+    if (existsSync(skillsTemplateDir)) {
+      const skillFiles = readdirSync(skillsTemplateDir);
+      for (const file of skillFiles) {
+        const dest = path.join(skillsDir, file);
+        if (!existsSync(dest)) {
+          cpSync(path.join(skillsTemplateDir, file), dest);
+          console.log(`  ✓ Skill 설치: ${file}`);
+        }
+      }
+    }
+
+    // Copy skill-forge (only if not exist)
+    const forgeTemplateDir = path.join(templatesDir, 'workspace', 'skill-forge');
+    const forgeDestDir = path.join(workspaceDir, 'skill-forge');
+    if (existsSync(forgeTemplateDir) && !existsSync(forgeDestDir)) {
+      cpSync(forgeTemplateDir, forgeDestDir, { recursive: true });
+      console.log('  ✓ Skill Forge 설치 완료');
+    }
+  }
+}
+
+async function main() {
+  console.log('\n🚀 MAMA Standalone 설치 완료!\n');
+
+  // Copy templates to ~/.mama/
+  console.log('📦 기본 스킬 설치 중...');
+  try {
+    await copyTemplates();
+  } catch (err) {
+    console.warn('  ⚠️  템플릿 복사 실패:', err.message);
+  }
+  console.log('');
+
+  const nodeVersion = parseInt(process.versions.node.split('.')[0]);
+  if (nodeVersion < 18) {
+    console.warn('⚠️  경고: Node.js 18+ 권장 (현재:', process.versions.node, ')\n');
+  }
+
+  console.log('📝 Embedding 모델 다운로드 중...');
+  console.log('   모델: Xenova/all-MiniLM-L6-v2 (~30MB)\n');
+
+  try {
+    const { pipeline } = await import('@huggingface/transformers');
+
+    const extractor = await pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2', {
+      quantized: true,
+    });
+
+    const testResult = await extractor('test', { pooling: 'mean', normalize: true });
+    console.log('✓ Embedding 모델 준비 완료 (차원:', testResult.data.length, ')\n');
+  } catch (err) {
+    console.warn('⚠️  모델 다운로드 실패:', err.message);
+    console.warn('   모델은 첫 사용 시 자동으로 다운로드됩니다.\n');
+  }
+
+  const credentialsPath = path.join(
+    process.env.HOME || process.env.USERPROFILE || '',
+    '.claude',
+    '.credentials.json'
+  );
+
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('✨ 설치 완료!');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+
+  if (existsSync(credentialsPath)) {
+    console.log('✓ Claude Code 인증 발견\n');
+    console.log('다음 단계:');
+    console.log('  1. mama setup    # 대화형 설정 마법사');
+    console.log('  2. mama start    # 서버 시작');
+    console.log('  3. mama status   # 상태 확인\n');
+  } else {
+    console.log('⚠️  Claude Code 인증 없음\n');
+    console.log('Claude Code를 먼저 설치하고 로그인하세요:');
+    console.log('  https://claude.ai/code\n');
+    console.log('로그인 후 다시 시도하세요:\n');
+    console.log('  mama setup\n');
+  }
+
+  console.log('문서: https://github.com/jungjaehoon-lifegamez/MAMA\n');
+}
+
+main().catch((err) => {
+  console.error('Postinstall 오류:', err.message);
+  process.exit(0);
+});

package/templates/skills/document-analyze.md

@@ -0,0 +1,63 @@
+---
+name: 문서 분석
+description: Excel, PDF, Word 등 문서를 분석하고 요약
+keywords:
+  - 분석해
+  - 분석해줘
+  - 요약해
+  - 정리해
+  - analyze
+requiredInputs:
+  - document
+output: text
+allowedExtensions:
+  - .xlsx
+  - .xls
+  - .csv
+  - .pdf
+  - .doc
+  - .docx
+---
+
+# 문서 분석 스킬
+
+엑셀, PDF, Word 등 다양한 문서 형식을 분석하고 요약합니다.
+
+## 지시사항
+
+1. 첨부된 문서의 내용을 분석합니다.
+2. 문서 유형에 따라 적절한 분석을 수행합니다:
+   - **Excel/CSV**: 데이터 구조, 주요 통계, 패턴 분석
+   - **PDF/Word**: 내용 요약, 핵심 포인트 추출
+3. 결과를 간결하게 한국어로 보고합니다.
+
+## Excel 분석 포인트
+
+- 행/열 수
+- 데이터 유형 (숫자, 텍스트, 날짜)
+- 주요 수치 통계 (합계, 평균, 최대/최소)
+- 특이사항이나 패턴
+
+## PDF/Word 분석 포인트
+
+- 문서 길이
+- 주요 섹션/챕터
+- 핵심 내용 3-5개
+- 문서 유형 (보고서, 계약서, 매뉴얼 등)
+
+## 출력 형식
+
+### 문서 개요
+
+- 유형: [문서 유형]
+- 크기: [페이지/행 수]
+
+### 주요 내용
+
+1. [핵심 포인트 1]
+2. [핵심 포인트 2]
+   ...
+
+### 요약
+
+[2-3문장 요약]

package/templates/skills/heartbeat-report.md

@@ -0,0 +1,75 @@
+---
+name: 하트비트 보고서
+description: 채널 활동을 수집하고 보고서 작성
+keywords:
+  - 보고서
+  - 리포트
+  - heartbeat
+  - 상황보고
+  - 업무현황
+output: text
+---
+
+# 하트비트 보고서 스킬
+
+슬랙, 챗워크, 트렐로, 구글 드라이브의 활동을 수집하고 보고서를 작성합니다.
+
+## 지시사항
+
+1. 수집된 데이터를 분석합니다.
+2. 새로운 활동이 있는지 확인합니다.
+3. 보고서 형식에 맞춰 작성합니다.
+
+## 보고서 형식
+
+### 델타 보고서 (새 활동만)
+
+새 메시지가 없으면 `HEARTBEAT_OK`만 응답합니다.
+
+새 메시지가 있으면:
+
+```
+📊 델타 보고서
+
+**Slack**
+- #channel-name: 새 메시지 N개
+  - [사용자] 메시지 요약...
+
+**Chatwork**
+- [룸이름]: 새 메시지 N개
+  - [사용자] 메시지 요약...
+
+**Trello**
+- 보드명: 변경사항...
+
+**Drive**
+- 새 파일/수정된 파일 목록
+```
+
+### 종합 보고서 (전체 현황)
+
+```
+📋 종합 보고서
+
+## 프로젝트 현황
+
+### [프로젝트 1]
+- 상태: 진행중/완료/대기
+- 최근 활동: ...
+- 다음 단계: ...
+
+### [프로젝트 2]
+...
+
+## 주요 이슈
+- ...
+
+## 액션 아이템
+- [ ] ...
+```
+
+## 주의사항
+
+- Discord 메시지 길이 제한 (2000자) 고려
+- 중요한 내용 우선
+- 이모지로 가독성 향상

package/templates/skills/image-translate.md

@@ -0,0 +1,67 @@
+---
+name: 이미지 번역
+description: 이미지의 텍스트를 한국어로 번역
+keywords:
+  - 번역
+  - 번역해
+  - 번역해줘
+  - translate
+  - 한국어로
+  - 뭐라고
+  - 뭐라는
+  - 무슨말
+  - 읽어줘
+requiredInputs:
+  - image
+output: html-screenshot
+discordScreenshot: true
+---
+
+# 이미지 번역
+
+이미지에서 텍스트를 추출하고 한국어로 번역하세요.
+
+**⚠️ 절대 지켜야 할 것:**
+
+- 메모리 컨텍스트(<relevant-memories> 태그 안의 내용)는 절대 출력하지 마세요
+- 도구 이름, 이모지, 메타 정보를 출력하지 마세요
+- 순수하게 이미지 번역 결과만 출력하세요
+
+## 절대 규칙
+
+1. **번역 결과만 출력** - 설명, 요약, 코멘트 금지
+2. **모든 텍스트 번역** - 하나도 빠뜨리지 마세요
+3. **원본 구조 유지** - 제목, 목록, 표 그대로
+4. **도구 사용 금지** - Read, mama_search, mama_save 등 어떤 도구도 사용하지 마세요. 이미지만 보고 직접 번역하세요.
+
+## 금지 사항
+
+❌ "이 이미지는 ~입니다"
+❌ "번역 결과입니다:"
+❌ "완료했습니다"
+❌ 요약이나 설명
+❌ 이모지
+❌ **도구 호출** - Read, mama_search, mama_save, Write 등 절대 사용 금지
+❌ "이미지를 읽을 수 없습니다" - 이미지가 이미 제공되었으므로 직접 번역만 하세요
+
+## 출력 형식
+
+그냥 번역된 텍스트만. 마크다운 사용 가능.
+
+**중요**:
+
+- 이미지는 이미 컨텍스트에 포함되어 있습니다. 도구를 호출하지 말고 바로 번역을 시작하세요.
+- "📚 메모리", "⏱️ 1턴", 도구 이름 등 메타 정보를 출력하지 마세요.
+- 테이블, 헤더, 메타데이터 없이 순수 번역만 출력하세요.
+
+## 예시
+
+이미지에 "Special Skill: Fire Storm / Damage: 85 / Target: All enemies" 가 있으면:
+
+```
+스페셜 스킬: 파이어 스톰
+데미지: 85
+대상: 적 전체
+```
+
+이렇게만 출력. 다른 말 없이.

package/templates/workspace/skill-forge/DESIGN.md

@@ -0,0 +1,115 @@
+# Skill Forge - Multi-Agent Skill Generator
+
+> 다단계 에이전트 팀이 실시간 협업으로 스킬을 생성하는 시스템
+
+## Problem
+
+스킬 작성이 복잡하고 일관성 부족. 매번 구조를 새로 설계해야 하고, 품질 검증이 누락되기 쉬움.
+
+## Solution
+
+**Architect → Developer → QA** 파이프라인으로 스킬 생성 자동화.
+5초 카운트다운으로 각 단계에서 유저 검토 기회 제공.
+
+---
+
+## Requirements
+
+### 필수 기능
+
+| #   | 기능                     | 설명                                  |
+| --- | ------------------------ | ------------------------------------- |
+| 1   | **Architect 에이전트**   | 프롬프트/구조 설계 담당               |
+| 2   | **Developer 에이전트**   | 실제 코드/스킬 작성                   |
+| 3   | **QA 에이전트**          | 체크리스트 검증                       |
+| 4   | **에이전트 간 핸드오프** | 자동 위임 + 컨텍스트 전달             |
+| 5   | **Discord 피드백 루프**  | 리액션/버튼으로 승인/수정 요청        |
+| 6   | **MAMA 연동**            | decision 저장, TOOLS.md 자동 업데이트 |
+
+---
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────┐
+│                   Discord Interface                  │
+└─────────────────────┬───────────────────────────────┘
+                      │
+                      ▼
+┌─────────────────────────────────────────────────────┐
+│                   Orchestrator                       │
+│        (상태 머신 + 카운트다운 + 핸드오프)            │
+└─────────────────────┬───────────────────────────────┘
+                      │
+        ┌─────────────┼─────────────┐
+        ▼             ▼             ▼
+   ┌─────────┐   ┌─────────┐   ┌─────────┐
+   │Architect│ → │Developer│ → │   QA    │
+   │(Sonnet) │   │ (Opus)  │   │(Haiku)  │
+   └─────────┘   └─────────┘   └─────────┘
+```
+
+---
+
+## Status
+
+- [x] 설계 문서 작성
+- [x] **Phase 1: 기반 구축** ✅
+  - [x] 1.1 Orchestrator 기본 구조
+  - [x] 1.2 Architect 에이전트
+  - [x] 1.3 5초 카운트다운 + Discord 버튼
+  - [x] 1.4 첫 테스트
+- [x] **Phase 2: 핵심 기능** ✅
+  - [x] 2.1 Developer 에이전트 (코드 생성)
+  - [x] 2.2 에이전트 간 핸드오프
+  - [x] 2.3 QA 에이전트 (체크리스트)
+  - [x] 2.4 통합 테스트
+- [x] **Phase 3: 완성** ✅
+  - [x] 3.1 MAMA 연동 (decision 저장)
+  - [x] 3.2 실제 Claude API 연동
+  - [x] 3.3 Discord UI 개선
+  - [x] 3.4 에러 핸들링 강화
+
+---
+
+## Files
+
+| 파일                  | 역할               | Lines |
+| --------------------- | ------------------ | ----- |
+| `types.ts`            | 타입 정의          | ~160  |
+| `orchestrator.ts`     | 상태 머신 + 조율   | ~450  |
+| `agents/architect.ts` | 구조 설계          | ~200  |
+| `agents/developer.ts` | 코드 생성          | ~250  |
+| `agents/qa.ts`        | 체크리스트 검증    | ~200  |
+| `discord-ui.ts`       | Discord UI + Embed | ~350  |
+| `claude-api.ts`       | Claude API 연동    | ~280  |
+| `mama-integration.ts` | MAMA MCP 연동      | ~250  |
+| `error-handler.ts`    | 통합 에러 처리     | ~280  |
+
+---
+
+## Test Results
+
+```
+🔥 Full Pipeline Test
+
+📥 REQUEST_RECEIVED
+🚀 Architect → ✅ COMPLETE
+⏱️ 2초 카운트다운 → ⏰ 자동 승인
+🚀 Developer → ✅ COMPLETE
+⏱️ 2초 카운트다운 → ⏰ 자동 승인
+🚀 QA → ✅ COMPLETE
+⏱️ 2초 카운트다운 → ⏰ 자동 승인
+🎉 SESSION_COMPLETE
+
+Generated Files:
+- skills/hello-world/index.ts
+- skills/hello-world/types.ts
+- skills/hello-world/README.md
+
+QA Result: 9/9 checks passed ✅
+```
+
+---
+
+Generated by Skill Forge 🔥