oh-my-customcode 0.1.4 → 0.2.1

package/templates/agents/manager/supplier/refs/guides/claude-code/09-guardrails.md

@@ -1,80 +0,0 @@
-# 가드레일 강화
-
-> 이 문서는 Claude 공식 문서에서 해당 페이지가 아직 공개되지 않아 기본 구조만 제공합니다.
-
-## 개요
-
-가드레일은 AI 에이전트가 안전하고 의도된 범위 내에서 작동하도록 보장하는 메커니즘입니다.
-
-## 가드레일 유형
-
-### 1. 입력 가드레일
-- 프롬프트 인젝션 방지
-- 악의적인 입력 필터링
-- 입력 유효성 검사
-
-### 2. 출력 가드레일
-- 민감 정보 필터링
-- 유해 콘텐츠 차단
-- 형식 준수 확인
-
-### 3. 행동 가드레일
-- 도구 사용 제한
-- 파일 시스템 접근 제어
-- 네트워크 요청 제한
-
-### 4. 리소스 가드레일
-- 토큰 사용량 제한
-- 실행 시간 제한
-- API 호출 제한
-
-## 구현 전략
-
-### 권한 관리
-```python
-options = ClaudeAgentOptions(
-    allowed_tools=["Read", "Glob", "Grep"],  # 읽기 전용
-    permission_mode="bypassPermissions"
-)
-```
-
-### 훅을 통한 검증
-```python
-hooks={
-    "PreToolUse": [{
-        "matcher": "Bash",
-        "hooks": [{
-            "type": "command",
-            "command": "validate_command.sh"
-        }]
-    }]
-}
-```
-
-### 도구 필터링
-특정 도구만 허용하거나 특정 도구를 차단하여 에이전트의 능력을 제한
-
-## 모범 사례
-
-1. **최소 권한 원칙**: 필요한 최소한의 권한만 부여
-2. **계층적 검증**: 여러 레벨에서 검증 수행
-3. **실패 안전**: 검증 실패 시 안전한 기본값으로 폴백
-4. **로깅 및 감사**: 모든 작업을 기록하여 추적 가능
-5. **정기적 검토**: 가드레일 효과성 주기적 평가
-
-## 보안 고려사항
-
-### 프롬프트 인젝션 방어
-- 사용자 입력과 시스템 지침 분리
-- XML 태그를 사용한 구조화
-- 입력 이스케이프 처리
-
-### 데이터 보호
-- 민감 데이터 마스킹
-- 출력 스크러빙
-- 접근 제어 적용
-
-### 코드 실행 안전
-- 샌드박스 환경 사용
-- 실행 시간 제한
-- 리소스 쿼터 적용

package/templates/agents/manager/supplier/refs/guides/claude-code/10-monitoring.md

@@ -1,89 +0,0 @@
-# 관리 및 모니터링
-
-> 이 문서는 Claude 공식 문서에서 해당 페이지가 아직 공개되지 않아 기본 구조만 제공합니다.
-
-## 개요
-
-프로덕션 환경에서 AI 에이전트를 효과적으로 관리하고 모니터링하는 방법입니다.
-
-## 모니터링 영역
-
-### 1. 성능 모니터링
-- 응답 시간 (Latency)
-- 처리량 (Throughput)
-- 에러율 (Error Rate)
-- 성공률 (Success Rate)
-
-### 2. 비용 모니터링
-- 토큰 사용량
-- API 호출 수
-- 도구 실행 비용
-- 월별/일별 비용 추이
-
-### 3. 품질 모니터링
-- 출력 정확도
-- 사용자 만족도
-- 태스크 완료율
-- 재시도 비율
-
-### 4. 안전 모니터링
-- 가드레일 트리거 횟수
-- 차단된 요청
-- 보안 이벤트
-- 이상 탐지
-
-## 로깅 전략
-
-### 구조화된 로깅
-```json
-{
-  "timestamp": "2025-01-22T10:30:00Z",
-  "agent_id": "agent-123",
-  "action": "tool_use",
-  "tool": "Edit",
-  "input": {...},
-  "output": {...},
-  "duration_ms": 150,
-  "tokens_used": 500
-}
-```
-
-### 로그 레벨
-- **DEBUG**: 상세 디버깅 정보
-- **INFO**: 일반 작업 정보
-- **WARN**: 잠재적 문제
-- **ERROR**: 오류 발생
-- **CRITICAL**: 심각한 시스템 문제
-
-## 알림 설정
-
-### 임계값 기반 알림
-- 에러율 > 5%
-- 응답 시간 > 10초
-- 일일 비용 > 예산
-
-### 패턴 기반 알림
-- 비정상적인 사용 패턴
-- 갑작스러운 트래픽 증가
-- 연속 실패
-
-## 대시보드 구성
-
-### 핵심 메트릭
-- 실시간 요청 수
-- 평균 응답 시간
-- 현재 에러율
-- 활성 세션 수
-
-### 트렌드 분석
-- 시간별 사용량
-- 주간 비용 추이
-- 성능 변화 추적
-
-## 운영 모범 사례
-
-1. **자동화된 모니터링**: 24/7 자동 모니터링 구축
-2. **알림 피로 방지**: 중요한 알림만 전송
-3. **인시던트 대응**: 명확한 대응 절차 수립
-4. **용량 계획**: 사용량 예측 및 확장 계획
-5. **정기 리뷰**: 주기적인 성능 검토 미팅

package/templates/agents/manager/supplier/refs/guides/claude-code/11-sub-agents.md

@@ -1,159 +0,0 @@
-# Sub-agent 가이드
-
-Claude Code에서 특화된 서브에이전트를 생성하고 사용하는 방법
-
-## 개요
-
-서브에이전트는 특정 작업을 처리하는 특화된 AI 어시스턴트입니다. 각 서브에이전트는 자체 컨텍스트 윈도우에서 실행되며, 사용자 정의 시스템 프롬프트, 특정 도구 액세스, 독립적인 권한을 가집니다.
-
-## 서브에이전트의 이점
-
-- **컨텍스트 보존**: 탐색과 구현을 주 대화에서 분리
-- **제약 적용**: 서브에이전트가 사용할 수 있는 도구 제한
-- **비용 제어**: 작업에 맞는 모델로 라우팅
-
-## Task Tool
-
-서브에이전트는 `Task` 도구를 통해 생성됩니다.
-
-### 기본 문법
-
-```
-Task(
-  subagent_type: "general-purpose",
-  prompt: "수행할 작업 설명",
-  model: "sonnet"
-)
-```
-
-### 파라미터
-
-| 파라미터 | 필수 | 설명 |
-|----------|------|------|
-| `subagent_type` | ✓ | 에이전트 유형 (general-purpose, Explore, Plan 등) |
-| `prompt` | ✓ | 수행할 작업 설명 |
-| `model` | - | 사용할 모델 (opus, sonnet, haiku, inherit) |
-| `description` | ✓ | 짧은 작업 설명 (3-5 단어) |
-
-## 모델 지정
-
-### 사용 가능한 모델
-
-| 모델 | 특성 | 용도 |
-|------|------|------|
-| `opus` | 가장 강력, 복잡한 추론 | 아키텍처 설계, 복잡한 판단 |
-| `sonnet` | 균형 잡힌 성능 | 일반 개발 작업 (기본값) |
-| `haiku` | 빠르고 저렴 | 단순 작업, 파일 검색 |
-| `inherit` | 부모 모델 상속 | 일관성 필요 시 |
-
-### 모델 선택 기준
-
-```
-판단이 필요한 작업 → opus
-  - 아키텍처 분석
-  - 복잡한 코드 리뷰
-  - 설계 결정
-
-생성이 필요한 작업 → sonnet
-  - 코드 작성
-  - 문서 작성
-  - 일반 개발
-
-단순한 작업 → haiku
-  - 파일 검색
-  - 간단한 검증
-  - 상태 확인
-```
-
-## 기본 제공 서브에이전트
-
-### Explore
-
-코드베이스 탐색에 최적화된 빠른 읽기 전용 에이전트
-
-- **모델**: haiku (빠름, 낮은 지연시간)
-- **도구**: 읽기 전용 (Write, Edit 불가)
-- **용도**: 파일 검색, 코드 검색, 코드베이스 탐색
-
-### Plan
-
-계획 모드에서 컨텍스트를 수집하는 연구 에이전트
-
-- **모델**: inherit (부모 모델 상속)
-- **도구**: 읽기 전용
-- **용도**: 계획을 위한 코드베이스 연구
-
-### general-purpose
-
-탐색과 작업 모두를 수행하는 범용 에이전트
-
-- **모델**: inherit (기본값) 또는 지정
-- **도구**: 모든 도구
-- **용도**: 복잡한 연구, 다단계 작업, 코드 수정
-
-## 사용 예시
-
-### 복잡한 분석 (opus)
-
-```
-Task(
-  description: "Analyze architecture",
-  subagent_type: "general-purpose",
-  prompt: "Analyze the agent architecture and identify improvement opportunities",
-  model: "opus"
-)
-```
-
-### 코드 구현 (sonnet)
-
-```
-Task(
-  description: "Implement feature",
-  subagent_type: "general-purpose",
-  prompt: "Implement the user authentication feature following the existing patterns",
-  model: "sonnet"
-)
-```
-
-### 빠른 검색 (haiku)
-
-```
-Task(
-  description: "Search files",
-  subagent_type: "Explore",
-  prompt: "Find all files that handle authentication",
-  model: "haiku"
-)
-```
-
-## 병렬 실행
-
-독립적인 작업은 병렬로 실행할 수 있습니다 (최대 4개).
-
-```
-# 단일 메시지에서 여러 Task 호출
-Task(prompt: "Task A", model: "haiku")
-Task(prompt: "Task B", model: "haiku")
-Task(prompt: "Task C", model: "haiku")
-```
-
-## 비용 최적화
-
-| 전략 | 설명 |
-|------|------|
-| 탐색은 haiku | 파일 검색, 구조 파악에 haiku 사용 |
-| 구현은 sonnet | 일반적인 코딩 작업에 sonnet 사용 |
-| 판단은 opus | 중요한 결정에만 opus 사용 |
-| 병렬화 | 독립 작업은 병렬로 실행하여 시간 절약 |
-
-## 주의사항
-
-- 서브에이전트는 다른 서브에이전트를 생성할 수 없음
-- 백그라운드 서브에이전트는 권한 프롬프트 자동 거부
-- 모델 미지정 시 기본값은 sonnet
-
-## 참고 문서
-
-- [Claude Code Sub-agents 공식 문서](https://docs.anthropic.com/claude-code/sub-agents)
-- R009: Parallel Execution Rules
-- R010: Orchestrator Coordination Rules

package/templates/agents/manager/supplier/refs/guides/claude-code/index.yaml

@@ -1,51 +0,0 @@
-# Claude Code Guide Index
-# Claude로 에이전트를 구축하기 위한 가이드 문서 인덱스
-
-documents:
-  - name: overview
-    title: 기능 개요
-    description: Claude의 핵심 기능 및 도구 요약
-    path: ./01-overview.md
-
-  - name: tools
-    title: 도구 사용
-    description: Claude와 도구 통합 방법
-    path: ./03-tools.md
-
-  - name: agent-skills
-    title: 에이전트 스킬
-    description: Skills로 Claude 기능 확장
-    path: ./04-agent-skills.md
-
-  - name: agent-sdk
-    title: 에이전트 SDK
-    description: Python/TypeScript로 에이전트 구축
-    path: ./05-agent-sdk.md
-
-  - name: mcp
-    title: MCP 커넥터
-    description: Model Context Protocol 서버 연결
-    path: ./06-mcp.md
-
-  - name: prompt-engineering
-    title: 프롬프트 엔지니어링
-    description: 프롬프트 최적화 기법
-    path: ./07-prompt-engineering.md
-
-  - name: testing
-    title: 테스트 및 평가
-    description: 품질 보장을 위한 테스트 방법
-    path: ./08-testing.md
-    status: placeholder  # 공식 문서 미공개
-
-  - name: guardrails
-    title: 가드레일 강화
-    description: 안전한 에이전트 운영을 위한 제약
-    path: ./09-guardrails.md
-    status: placeholder  # 공식 문서 미공개
-
-  - name: monitoring
-    title: 관리 및 모니터링
-    description: 프로덕션 에이전트 운영
-    path: ./10-monitoring.md
-    status: placeholder  # 공식 문서 미공개

package/templates/agents/manager/supplier/refs/guides/docker/compose-best-practices.md

@@ -1,284 +0,0 @@
-# Docker Compose Best Practices
-
-> Source: https://docs.docker.com/compose/compose-file/best-practices/
-
-## File Structure
-
-```yaml
-version: "3.8"
-
-services:
-  # Application services
-  app:
-    ...
-
-  # Infrastructure services
-  db:
-    ...
-
-volumes:
-  # Named volumes
-
-networks:
-  # Custom networks
-```
-
-## Service Configuration
-
-### Build Configuration
-
-```yaml
-services:
-  app:
-    build:
-      context: .
-      dockerfile: Dockerfile
-      target: production
-      args:
-        - NODE_ENV=production
-```
-
-### Environment Variables
-
-```yaml
-services:
-  app:
-    # From file
-    env_file:
-      - .env
-      - .env.local
-
-    # Inline
-    environment:
-      - DATABASE_URL=${DATABASE_URL}
-      - NODE_ENV=production
-```
-
-### Dependencies
-
-```yaml
-services:
-  app:
-    depends_on:
-      db:
-        condition: service_healthy
-      redis:
-        condition: service_started
-```
-
-### Health Checks
-
-```yaml
-services:
-  db:
-    image: postgres:16
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U postgres"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-      start_period: 30s
-```
-
-### Resource Limits
-
-```yaml
-services:
-  app:
-    deploy:
-      resources:
-        limits:
-          cpus: "1"
-          memory: 512M
-        reservations:
-          cpus: "0.5"
-          memory: 256M
-```
-
-## Volumes
-
-### Named Volumes
-
-```yaml
-services:
-  db:
-    volumes:
-      - postgres_data:/var/lib/postgresql/data
-
-volumes:
-  postgres_data:
-    driver: local
-```
-
-### Bind Mounts (Development)
-
-```yaml
-services:
-  app:
-    volumes:
-      - ./src:/app/src:ro
-      - ./config:/app/config:ro
-```
-
-## Networks
-
-### Custom Networks
-
-```yaml
-services:
-  app:
-    networks:
-      - frontend
-      - backend
-
-  db:
-    networks:
-      - backend
-
-networks:
-  frontend:
-  backend:
-    internal: true
-```
-
-## Multiple Environments
-
-### Override Files
-
-```bash
-# Base configuration
-docker-compose.yml
-
-# Development overrides
-docker-compose.override.yml
-
-# Production overrides
-docker-compose.prod.yml
-
-# Usage
-docker compose -f docker-compose.yml -f docker-compose.prod.yml up
-```
-
-### Example: Production
-
-```yaml
-# docker-compose.prod.yml
-services:
-  app:
-    build:
-      target: production
-    restart: always
-    deploy:
-      replicas: 3
-      resources:
-        limits:
-          cpus: "1"
-          memory: 1G
-
-  db:
-    restart: always
-    volumes:
-      - /mnt/data/postgres:/var/lib/postgresql/data
-```
-
-### Example: Development
-
-```yaml
-# docker-compose.override.yml
-services:
-  app:
-    build:
-      target: development
-    volumes:
-      - ./src:/app/src
-    environment:
-      - DEBUG=true
-    ports:
-      - "3000:3000"
-      - "9229:9229"  # debugger
-```
-
-## Complete Example
-
-```yaml
-version: "3.8"
-
-services:
-  app:
-    build:
-      context: .
-      target: production
-    restart: unless-stopped
-    environment:
-      - DATABASE_URL=postgresql://user:pass@db:5432/myapp
-      - REDIS_URL=redis://redis:6379
-    ports:
-      - "8080:8080"
-    depends_on:
-      db:
-        condition: service_healthy
-      redis:
-        condition: service_started
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-    deploy:
-      resources:
-        limits:
-          cpus: "2"
-          memory: 1G
-    networks:
-      - frontend
-      - backend
-
-  db:
-    image: postgres:16-alpine
-    restart: unless-stopped
-    environment:
-      - POSTGRES_USER=user
-      - POSTGRES_PASSWORD=pass
-      - POSTGRES_DB=myapp
-    volumes:
-      - postgres_data:/var/lib/postgresql/data
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U user -d myapp"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-    networks:
-      - backend
-
-  redis:
-    image: redis:7-alpine
-    restart: unless-stopped
-    command: redis-server --appendonly yes
-    volumes:
-      - redis_data:/data
-    networks:
-      - backend
-
-  nginx:
-    image: nginx:1.25-alpine
-    restart: unless-stopped
-    ports:
-      - "80:80"
-      - "443:443"
-    volumes:
-      - ./nginx.conf:/etc/nginx/nginx.conf:ro
-      - ./certs:/etc/nginx/certs:ro
-    depends_on:
-      - app
-    networks:
-      - frontend
-
-volumes:
-  postgres_data:
-  redis_data:
-
-networks:
-  frontend:
-  backend:
-    internal: true
-```