e228faabf5
G-1: 메신저 Webhook Relay + _send_to_room 실제 httpx 호출 구현 G-2: POST /api/tasks/bulk SR 대량작업 엔드포인트 (최대 100건) G-3: 라이선스 만료 알림 스케줄러 (매일 09:00 KST) G-4: 체험판 upgrade_banner 필드 + license.py 배너 로직 G-5: core/auto_rca.py + incidents/problem auto-rca 엔드포인트 G-6: core/deploy_impact.py + vibe impact-analysis 엔드포인트 G-7: core/ticket_classifier.py + SR 생성 시 AI 분류 + ai-suggestion API G-8: VulnPatchRecord 모델 + vuln_scan 패치추적 4개 엔드포인트 G-9: core/jira_sync.py + gateway Jira/Confluence 연동 엔드포인트 G-10: core/push_notify.py + routers/push.py + PushSubscription 모델 G-11: approvals 다중승인 (위임/서명/기한초과/마감연장) G-12: alembic.ini + migrations/ + cicd/migrate_to_postgres.sh 하네스: guardia-orchestrator 확장기능 Phase 반영 봇명령어: /sr /status /license /bulk 슬래시 명령어 추가 설치스크립트: setup/ (Ubuntu, CentOS, RHEL, Windows) --test 옵션 포함 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
83 lines
2.4 KiB
Markdown
83 lines
2.4 KiB
Markdown
# 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` 로 확인
|