zioinfo-mail/paperclip/README.md
DESKTOP-TKLFCPR\ython e228faabf5 feat(itsm): G-1~G-12 확장 기능 + 하네스/봇/설치스크립트 구현
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>
2026-05-29 18:18:52 +09:00

2.4 KiB
Raw Blame History

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

개요

Paperclip 오픈소스 프레임워크를 활용해
GUARDiA ITSM 신기능을 AI 에이전트 조직이 자율 개발하는 환경입니다.

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

설치

# 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

사용 방법

새 기능 개발 요청

paperclip task create \
  --assignee ceo \
  --title "GUARDiA에 AI 인시던트 자동분류 기능 추가" \
  --priority high

진행 상황 확인

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 로 확인