# 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 🔥