oh-my-customcode 0.1.0

package/templates/guides/claude-code/09-guardrails.md

@@ -0,0 +1,80 @@
+# 가드레일 강화
+
+> 이 문서는 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/guides/claude-code/10-monitoring.md

@@ -0,0 +1,89 @@
+# 관리 및 모니터링
+
+> 이 문서는 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/guides/claude-code/index.yaml

@@ -0,0 +1,51 @@
+# 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/guides/docker/compose-best-practices.md

@@ -0,0 +1,284 @@
+# 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
+```