oh-my-customcode 0.1.2 → 0.1.3

package/templates/agents/manager/supplier/refs/guides/aws/common-patterns.md

@@ -0,0 +1,169 @@
+# AWS Common Architecture Patterns
+
+> Source: https://aws.amazon.com/architecture/
+
+## Web Application (Three-Tier)
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                         Internet                             │
+└────────────────────────────┬────────────────────────────────┘
+                             │
+┌────────────────────────────┴────────────────────────────────┐
+│                     CloudFront (CDN)                         │
+│                         + WAF                                │
+└────────────────────────────┬────────────────────────────────┘
+                             │
+┌────────────────────────────┴────────────────────────────────┐
+│                  Application Load Balancer                   │
+│                    (Public Subnets)                         │
+└────────────────────────────┬────────────────────────────────┘
+                             │
+┌────────────────────────────┴────────────────────────────────┐
+│              ECS Fargate / EC2 Auto Scaling                  │
+│                   (Private Subnets)                         │
+│                  + ElastiCache (Redis)                      │
+└────────────────────────────┬────────────────────────────────┘
+                             │
+┌────────────────────────────┴────────────────────────────────┐
+│                  RDS Aurora (Multi-AZ)                       │
+│                    (Private Subnets)                        │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Serverless API
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        Client                                │
+└────────────────────────────┬────────────────────────────────┘
+                             │
+┌────────────────────────────┴────────────────────────────────┐
+│                      API Gateway                             │
+│                    (REST/HTTP API)                          │
+└────────────────────────────┬────────────────────────────────┘
+                             │
+         ┌───────────────────┼───────────────────┐
+         │                   │                   │
+┌────────┴────────┐ ┌───────┴────────┐ ┌───────┴────────┐
+│     Lambda      │ │    Lambda      │ │    Lambda      │
+│   (Get User)    │ │  (Create User) │ │  (List Users)  │
+└────────┬────────┘ └───────┬────────┘ └───────┬────────┘
+         │                   │                   │
+         └───────────────────┼───────────────────┘
+                             │
+┌────────────────────────────┴────────────────────────────────┐
+│                       DynamoDB                               │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Event-Driven Architecture
+
+```
+┌──────────────┐    ┌──────────────┐    ┌──────────────┐
+│   Producer   │───▶│   EventBridge│───▶│   Consumer   │
+│  (Lambda)    │    │    (Events)  │    │  (Lambda)    │
+└──────────────┘    └──────┬───────┘    └──────────────┘
+                           │
+         ┌─────────────────┼─────────────────┐
+         │                 │                 │
+         ▼                 ▼                 ▼
+┌──────────────┐  ┌──────────────┐  ┌──────────────┐
+│   SQS Queue  │  │  SNS Topic   │  │ Step Function│
+└──────────────┘  └──────────────┘  └──────────────┘
+```
+
+## Microservices
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    API Gateway / ALB                         │
+└────────────────────────────┬────────────────────────────────┘
+                             │
+    ┌────────────────────────┼────────────────────────┐
+    │                        │                        │
+┌───┴───┐               ┌────┴────┐              ┌────┴────┐
+│Service│               │ Service │              │ Service │
+│   A   │               │    B    │              │    C    │
+│(ECS)  │               │ (Lambda)│              │  (EKS)  │
+└───┬───┘               └────┬────┘              └────┬────┘
+    │                        │                        │
+    └────────────────────────┼────────────────────────┘
+                             │
+                    ┌────────┴────────┐
+                    │    Service Mesh │
+                    │   (App Mesh)    │
+                    └─────────────────┘
+```
+
+## Data Lake
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                      Data Sources                             │
+│  (Databases, APIs, IoT, Logs, Streams)                       │
+└────────────────────────────┬─────────────────────────────────┘
+                             │
+┌────────────────────────────┴─────────────────────────────────┐
+│                    Ingestion Layer                            │
+│  (Kinesis, DMS, AppFlow, Transfer Family)                    │
+└────────────────────────────┬─────────────────────────────────┘
+                             │
+┌────────────────────────────┴─────────────────────────────────┐
+│                     Storage Layer                             │
+│              S3 (Raw → Processed → Curated)                  │
+│                    + Lake Formation                           │
+└────────────────────────────┬─────────────────────────────────┘
+                             │
+┌────────────────────────────┴─────────────────────────────────┐
+│                   Processing Layer                            │
+│        (Glue, EMR, Athena, Redshift Spectrum)                │
+└────────────────────────────┬─────────────────────────────────┘
+                             │
+┌────────────────────────────┴─────────────────────────────────┐
+│                   Consumption Layer                           │
+│           (QuickSight, SageMaker, APIs)                      │
+└──────────────────────────────────────────────────────────────┘
+```
+
+## CI/CD Pipeline
+
+```
+┌──────────────┐    ┌──────────────┐    ┌──────────────┐
+│   GitHub /   │───▶│  CodePipeline│───▶│  CodeBuild   │
+│ CodeCommit   │    │   (Source)   │    │   (Build)    │
+└──────────────┘    └──────────────┘    └──────┬───────┘
+                                               │
+                         ┌─────────────────────┴─────────────────────┐
+                         │                                           │
+                         ▼                                           ▼
+                ┌──────────────┐                            ┌──────────────┐
+                │     ECR      │                            │     S3       │
+                │  (Container) │                            │  (Artifact)  │
+                └──────┬───────┘                            └──────┬───────┘
+                       │                                           │
+                       └─────────────────┬─────────────────────────┘
+                                         │
+                                         ▼
+                               ┌──────────────────┐
+                               │   CodeDeploy     │
+                               │  (Blue/Green)    │
+                               └────────┬─────────┘
+                                        │
+               ┌────────────────────────┼────────────────────────┐
+               │                        │                        │
+               ▼                        ▼                        ▼
+        ┌──────────┐            ┌──────────┐            ┌──────────┐
+        │   Dev    │            │  Stage   │            │   Prod   │
+        │   ECS    │            │   ECS    │            │   ECS    │
+        └──────────┘            └──────────┘            └──────────┘
+```
+
+## Disaster Recovery
+
+| Strategy | RTO | RPO | Cost |
+|----------|-----|-----|------|
+| Backup & Restore | Hours | Hours | $ |
+| Pilot Light | Minutes-Hours | Minutes | $$ |
+| Warm Standby | Minutes | Seconds | $$$ |
+| Multi-Site Active | Near Zero | Near Zero | $$$$ |

package/templates/agents/manager/supplier/refs/guides/aws/index.yaml

@@ -0,0 +1,26 @@
+# AWS Guide
+
+metadata:
+  name: aws
+  description: AWS cloud reference documentation
+
+source:
+  type: external
+  origin: aws.amazon.com
+  urls:
+    - https://docs.aws.amazon.com/wellarchitected/latest/framework/welcome.html
+    - https://docs.aws.amazon.com/
+    - https://aws.amazon.com/architecture/
+  last_fetched: "2026-01-22"
+
+documents:
+  - name: well-architected
+    path: ./well-architected.md
+    description: AWS Well-Architected Framework summary
+
+  - name: common-patterns
+    path: ./common-patterns.md
+    description: Common AWS architecture patterns
+
+used_by:
+  - aws-expert

package/templates/agents/manager/supplier/refs/guides/aws/well-architected.md

@@ -0,0 +1,143 @@
+# AWS Well-Architected Framework
+
+> Source: https://docs.aws.amazon.com/wellarchitected/
+
+## Overview
+
+The AWS Well-Architected Framework helps you understand the pros and cons of decisions you make while building systems on AWS.
+
+## Six Pillars
+
+### 1. Operational Excellence
+
+Focus on running and monitoring systems to deliver business value.
+
+**Design Principles:**
+- Perform operations as code
+- Make frequent, small, reversible changes
+- Refine operations procedures frequently
+- Anticipate failure
+- Learn from operational failures
+
+**Key Services:**
+- AWS CloudFormation
+- AWS Config
+- Amazon CloudWatch
+- AWS Systems Manager
+
+### 2. Security
+
+Protect information, systems, and assets.
+
+**Design Principles:**
+- Implement strong identity foundation
+- Enable traceability
+- Apply security at all layers
+- Automate security best practices
+- Protect data in transit and at rest
+- Keep people away from data
+- Prepare for security events
+
+**Key Services:**
+- AWS IAM
+- AWS KMS
+- AWS WAF
+- Amazon GuardDuty
+- AWS Security Hub
+
+### 3. Reliability
+
+Ensure workload performs correctly and consistently.
+
+**Design Principles:**
+- Automatically recover from failure
+- Test recovery procedures
+- Scale horizontally
+- Stop guessing capacity
+- Manage change through automation
+
+**Key Services:**
+- Amazon Route 53
+- Elastic Load Balancing
+- Auto Scaling
+- AWS Backup
+
+### 4. Performance Efficiency
+
+Use computing resources efficiently.
+
+**Design Principles:**
+- Democratize advanced technologies
+- Go global in minutes
+- Use serverless architectures
+- Experiment more often
+- Consider mechanical sympathy
+
+**Key Services:**
+- Amazon EC2 Auto Scaling
+- AWS Lambda
+- Amazon ElastiCache
+- Amazon CloudFront
+
+### 5. Cost Optimization
+
+Avoid unnecessary costs.
+
+**Design Principles:**
+- Implement cloud financial management
+- Adopt consumption model
+- Measure overall efficiency
+- Stop spending money on undifferentiated heavy lifting
+- Analyze and attribute expenditure
+
+**Key Services:**
+- AWS Cost Explorer
+- AWS Budgets
+- AWS Trusted Advisor
+- Savings Plans
+
+### 6. Sustainability
+
+Minimize environmental impacts.
+
+**Design Principles:**
+- Understand your impact
+- Establish sustainability goals
+- Maximize utilization
+- Anticipate and adopt efficient offerings
+- Use managed services
+- Reduce downstream impact
+
+## Well-Architected Review
+
+### Questions to Ask
+
+**Operational Excellence:**
+- How do you manage and automate changes?
+- How do you respond to unplanned events?
+- How do you evolve operations?
+
+**Security:**
+- How do you manage identities?
+- How do you detect security events?
+- How do you protect your network?
+
+**Reliability:**
+- How do you manage service quotas?
+- How does your system adapt to demand?
+- How do you back up data?
+
+**Performance Efficiency:**
+- How do you select compute resources?
+- How do you select storage solutions?
+- How do you configure networking?
+
+**Cost Optimization:**
+- How do you manage usage?
+- How do you monitor cost?
+- How do you decommission resources?
+
+**Sustainability:**
+- How do you select efficient hardware?
+- How do you reduce software impact?
+- How do you reduce data movement?

package/templates/agents/manager/supplier/refs/guides/claude-code/01-overview.md

@@ -0,0 +1,42 @@
+# 기능 개요
+
+Claude의 고급 기능 및 역량을 살펴보세요.
+
+## 핵심 기능
+
+이러한 기능들은 다양한 형식과 사용 사례에 걸쳐 콘텐츠를 처리, 분석 및 생성하기 위한 Claude의 기본 능력을 향상시킵니다.
+
+| 기능 | 설명 |
+|------|------|
+| 1M token context window | 더 큰 문서를 처리하고, 더 긴 대화를 유지하며, 더 광범위한 코드베이스로 작업할 수 있게 해주는 확장된 컨텍스트 윈도우 |
+| Agent Skills | Skills로 Claude의 기능을 확장. 사전 구축된 Skills(PowerPoint, Excel, Word, PDF) 또는 사용자 정의 Skills 생성 가능 |
+| Batch processing | 비용 절감을 위해 대량의 요청을 비동기적으로 처리. 표준 API 호출보다 50% 저렴 |
+| Citations | Claude의 응답을 소스 문서에 기반하게 함. 정확한 문장과 구절에 대한 자세한 참조 제공 |
+| Context editing | 구성 가능한 전략으로 대화 컨텍스트를 자동으로 관리 |
+| Effort | effort 매개변수를 사용하여 Claude가 응답할 때 사용하는 토큰 수를 제어 |
+| Extended thinking | 복잡한 작업을 위한 향상된 추론 기능. Claude의 단계별 사고 과정에 대한 투명성 제공 |
+| Files API | Claude와 함께 사용할 파일을 업로드하고 관리 |
+| PDF support | PDF 문서에서 텍스트 및 시각적 콘텐츠를 처리하고 분석 |
+| Prompt caching | Claude에 더 많은 배경 지식과 예제 출력을 제공하여 비용과 지연 시간을 줄임 |
+| Search results | RAG 애플리케이션에 대한 자연스러운 인용을 활성화 |
+| Structured outputs | JSON 출력 및 엄격한 도구 사용을 통한 스키마 준수 보장 |
+| Token counting | 메시지를 보내기 전에 토큰 수를 결정 |
+| Tool use | Claude가 외부 도구 및 API와 상호 작용할 수 있게 함 |
+
+## 도구
+
+이러한 기능들은 Claude가 외부 시스템과 상호 작용하고, 코드를 실행하며, 다양한 도구 인터페이스를 통해 자동화된 작업을 수행할 수 있게 합니다.
+
+| 도구 | 설명 |
+|------|------|
+| Bash | bash 명령 및 스크립트를 실행하여 시스템 셸과 상호 작용 |
+| Code execution | 샌드박스 환경에서 Python 코드를 실행 |
+| Programmatic tool calling | 코드 실행 컨테이너 내에서 프로그래밍 방식으로 도구 호출 |
+| Computer use | 스크린샷을 찍고 마우스 및 키보드 명령을 실행하여 컴퓨터 인터페이스 제어 |
+| Fine-grained tool streaming | 버퍼링/JSON 검증 없이 도구 사용 매개변수를 스트리밍 |
+| MCP connector | Messages API에서 직접 원격 MCP 서버에 연결 |
+| Memory | Claude가 대화 간에 정보를 저장하고 검색 |
+| Text editor | 기본 제공 텍스트 편집기 인터페이스를 사용하여 텍스트 파일을 만들고 편집 |
+| Tool search | 정규식 기반 검색을 사용하여 동적으로 도구를 발견 |
+| Web fetch | 지정된 웹 페이지 및 PDF 문서에서 전체 콘텐츠를 검색 |
+| Web search | Claude의 포괄적인 지식을 웹 전체의 현재 실제 데이터로 보강 |

package/templates/agents/manager/supplier/refs/guides/claude-code/03-tools.md

@@ -0,0 +1,107 @@
+# 도구 사용 (Tool Use)
+
+Claude는 도구 및 함수와 상호작용할 수 있으므로 Claude의 기능을 확장하여 더 다양한 작업을 수행할 수 있습니다.
+
+## 도구 유형
+
+Claude는 두 가지 유형의 도구를 지원합니다:
+
+### 1. 클라이언트 도구
+사용자의 시스템에서 실행되는 도구:
+- 사용자가 만들고 구현하는 사용자 정의 도구
+- 컴퓨터 사용 및 텍스트 편집기와 같이 클라이언트 구현이 필요한 Anthropic 정의 도구
+
+### 2. 서버 도구
+Anthropic의 서버에서 실행되는 도구:
+- 웹 검색 및 웹 가져오기 도구
+- API 요청에서 지정해야 하지만 사용자 측에서 구현할 필요 없음
+
+## 클라이언트 도구 통합 단계
+
+1. **Claude에 도구 및 사용자 프롬프트 제공**
+   - API 요청에서 이름, 설명 및 입력 스키마를 사용하여 클라이언트 도구를 정의
+   - 이러한 도구가 필요할 수 있는 사용자 프롬프트를 포함
+
+2. **Claude가 도구 사용을 결정**
+   - Claude는 사용자의 쿼리에 도움이 될 수 있는 도구가 있는지 평가
+   - 올바르게 형식화된 도구 사용 요청을 구성
+
+3. **도구를 실행하고 결과 반환**
+   - Claude의 요청에서 도구 이름 및 입력을 추출
+   - 사용자의 시스템에서 도구 코드를 실행
+   - `tool_result` 콘텐츠 블록을 포함하는 새로운 `user` 메시지에서 결과를 반환
+
+4. **Claude가 도구 결과를 사용하여 응답을 작성**
+   - Claude는 도구 결과를 분석하여 원래 사용자 프롬프트에 대한 최종 응답을 작성
+
+## 기본 예제
+
+```python
+import anthropic
+
+client = anthropic.Anthropic()
+
+response = client.messages.create(
+    model="claude-sonnet-4-5",
+    max_tokens=1024,
+    tools=[
+        {
+            "name": "get_weather",
+            "description": "Get the current weather in a given location",
+            "input_schema": {
+                "type": "object",
+                "properties": {
+                    "location": {
+                        "type": "string",
+                        "description": "The city and state, e.g. San Francisco, CA",
+                    }
+                },
+                "required": ["location"],
+            },
+        }
+    ],
+    messages=[{"role": "user", "content": "What's the weather like in San Francisco?"}],
+)
+```
+
+## MCP 도구 사용
+
+Model Context Protocol (MCP)을 사용하는 애플리케이션을 구축하는 경우 MCP 서버의 도구를 Claude의 Messages API와 함께 직접 사용할 수 있습니다.
+
+### MCP 도구를 Claude 형식으로 변환
+
+```python
+from mcp import ClientSession
+
+async def get_claude_tools(mcp_session: ClientSession):
+    """Convert MCP tools to Claude's tool format."""
+    mcp_tools = await mcp_session.list_tools()
+
+    claude_tools = []
+    for tool in mcp_tools.tools:
+        claude_tools.append({
+            "name": tool.name,
+            "description": tool.description or "",
+            "input_schema": tool.inputSchema  # Rename inputSchema to input_schema
+        })
+
+    return claude_tools
+```
+
+## 도구 사용 패턴
+
+### 병렬 도구 사용
+Claude는 단일 응답 내에서 여러 도구를 병렬로 호출할 수 있습니다. 모든 `tool_use` 블록은 단일 어시스턴트 메시지에 포함되며, 모든 해당 `tool_result` 블록은 후속 사용자 메시지에서 제공되어야 합니다.
+
+### 순차적 도구
+일부 작업은 여러 도구를 순차적으로 호출해야 할 수 있으며, 한 도구의 출력을 다른 도구의 입력으로 사용합니다.
+
+### 사고의 연쇄 도구 사용
+Claude Opus는 도구 사용 쿼리에 답하기 전에 생각하도록 프롬프트되어 도구가 필요한지 여부, 어떤 도구를 사용할지, 적절한 매개변수를 최선으로 결정합니다.
+
+## 가격 책정
+
+도구 사용 요청은 다음을 기반으로 가격이 책정됩니다:
+1. 모델에 보내는 총 입력 토큰 수 (`tools` 매개변수 포함)
+2. 생성된 출력 토큰 수
+3. 서버 측 도구의 경우, 추가 사용량 기반 가격 책정

package/templates/agents/manager/supplier/refs/guides/claude-code/04-agent-skills.md

@@ -0,0 +1,90 @@
+# Agent Skills
+
+Agent Skills는 Claude의 기능을 확장하는 모듈식 기능입니다. 각 Skill은 지침, 메타데이터 및 선택적 리소스(스크립트, 템플릿)를 패키징하며, Claude는 관련이 있을 때 자동으로 이를 사용합니다.
+
+## Skills를 사용하는 이유
+
+Skills는 Claude에 도메인 특화 전문성을 제공하는 재사용 가능한 파일시스템 기반 리소스입니다.
+
+**주요 이점**:
+- **Claude 전문화**: 도메인 특화 작업을 위한 기능 맞춤화
+- **반복 감소**: 한 번 생성하고 자동으로 사용
+- **기능 구성**: Skills를 결합하여 복잡한 워크플로우 구축
+
+## Skills 작동 방식
+
+Skills는 Claude의 VM 환경을 활용하여 프롬프트만으로는 불가능한 기능을 제공합니다. 파일시스템 기반 아키텍처는 **점진적 공개**를 가능하게 합니다.
+
+### 세 가지 로딩 수준
+
+| 수준 | 로드 시기 | 토큰 비용 | 콘텐츠 |
+|------|-----------|-----------|--------|
+| **메타데이터** | 항상 (시작 시) | Skill당 약 100 토큰 | YAML 프론트매터의 `name` 및 `description` |
+| **지침** | Skill이 트리거될 때 | 5k 토큰 미만 | SKILL.md 본문 |
+| **리소스** | 필요에 따라 | 사실상 무제한 | bash를 통해 실행되는 번들 파일 |
+
+## Skill 구조
+
+모든 Skill에는 YAML 프론트매터가 있는 `SKILL.md` 파일이 필요합니다:
+
+```yaml
+---
+name: your-skill-name
+description: Brief description of what this Skill does and when to use it
+---
+
+# Your Skill Name
+
+## Instructions
+[Clear, step-by-step guidance for Claude to follow]
+
+## Examples
+[Concrete examples of using this Skill]
+```
+
+### 필드 요구 사항
+
+**`name`**:
+- 최대 64자
+- 소문자, 숫자 및 하이픈만 포함해야 함
+- "anthropic", "claude" 예약어를 포함할 수 없음
+
+**`description`**:
+- 비어 있지 않아야 함
+- 최대 1024자
+
+## 사용 가능한 Skills
+
+### 사전 구축된 Agent Skills
+
+- **PowerPoint (pptx)**: 프레젠테이션 만들기, 슬라이드 편집, 프레젠테이션 콘텐츠 분석
+- **Excel (xlsx)**: 스프레드시트 만들기, 데이터 분석, 차트가 있는 보고서 생성
+- **Word (docx)**: 문서 만들기, 콘텐츠 편집, 텍스트 서식 지정
+- **PDF (pdf)**: 형식이 지정된 PDF 문서 및 보고서 생성
+
+## Skills가 작동하는 위치
+
+| 플랫폼 | 사전 구축된 Skills | 사용자 정의 Skills |
+|--------|-------------------|-------------------|
+| Claude API | ✓ | ✓ |
+| Claude Code | - | ✓ |
+| Claude Agent SDK | - | ✓ |
+| Claude.ai | ✓ | ✓ |
+
+## 보안 고려 사항
+
+Skills는 신뢰할 수 있는 출처(자신이 만들었거나 Anthropic에서 얻은 것)에서만 사용할 것을 강력히 권장합니다.
+
+**주요 보안 고려 사항**:
+- **철저히 감사**: Skill에 번들된 모든 파일을 검토
+- **외부 출처는 위험함**: 외부 URL에서 데이터를 가져오는 Skills는 특히 위험
+- **도구 오용**: 악의적인 Skills는 도구를 해로운 방식으로 호출할 수 있음
+- **데이터 노출**: 민감한 데이터에 액세스할 수 있는 Skills는 정보를 유출하도록 설계될 수 있음
+
+## 제한 사항 및 제약
+
+### 런타임 환경 제약
+
+- **네트워크 액세스 없음**: Skills는 외부 API 호출을 하거나 인터넷에 액세스할 수 없음
+- **런타임 패키지 설치 없음**: 미리 설치된 패키지만 사용 가능
+- **사전 구성된 종속성만**: 사용 가능한 패키지 목록은 코드 실행 도구 문서 참조