# GUARDiA × Paperclip — AI 에이전트 개발 조직

## 개요
[Paperclip](https://github.com/paperclipai/paperclip) 오픈소스 프레임워크를 활용해  
GUARDiA ITSM 신기능을 AI 에이전트 조직이 자율 개발하는 환경입니다.

```
이사회 (인간)
    │
    ▼
CEO 에이전트 ──────────────────────────────┐
    │                                      │
    ├── CTO 에이전트                       PM 에이전트
    │       ├── Developer 에이전트         (WBS·일정 관리)
    │       └── QA 에이전트
    │
    └── [결과] GUARDiA ITSM 신규 기능 코드
```

## 설치

```bash
# 1. Paperclip 설치
npm install -g @paperclipai/paperclip

# 2. 환경변수 설정
cp .env.example .env
# .env 에서 ANTHROPIC_API_KEY 설정

# 3. 실행
paperclip start --config paperclip.config.json
```

## 에이전트 파일 구조
```
paperclip/
├── paperclip.config.json    ← 조직 구성 및 LLM 설정
├── agents/
│   ├── ceo.md              ← CEO 에이전트 페르소나
│   ├── cto.md              ← CTO 에이전트 (기술 표준 포함)
│   ├── developer.md        ← Developer 에이전트 코드 규칙
│   └── qa.md               ← QA 에이전트 테스트 규칙
└── README.md
```

## 사용 방법

### 새 기능 개발 요청
```bash
paperclip task create \
  --assignee ceo \
  --title "GUARDiA에 AI 인시던트 자동분류 기능 추가" \
  --priority high
```

### 진행 상황 확인
```bash
paperclip status
paperclip dashboard  # 웹 대시보드 (localhost:3000)
```

### GUARDiA SI 프로젝트 연동
에이전트들의 작업은 GUARDiA ITSM의 SI 프로젝트 관리 기능에 자동 연동됩니다:
```
POST /api/si/projects  ← 프로젝트: SI-GUARDIA-AGENT-DEV
POST /api/si/projects/{id}/wbs/bulk  ← WBS 자동 생성
GET  /api/si/projects/{id}/rtm  ← 요구사항 추적 매트릭스
```

## 거버넌스 규칙
| 작업 유형 | 승인 | 비고 |
|----------|------|------|
| 코드 생성 | 자동 | CTO 검토 후 이사회 확인 |
| 파일 수정 | 사람 승인 필요 | |
| DB 마이그레이션 | 사람 승인 필수 | |
| 배포 | 사람 승인 필수 | |
| 분석·문서화 | 자동 | |

## 비용 관리
- 일일 한도: $5.00 USD
- 초과 시 모든 에이전트 일시 정지 → 이사회 알림
- 토큰 사용량: `paperclip costs` 로 확인