EXECUTION

사용자가 /optimize 명령을 실행했습니다.

입력 인자: $ARGUMENTS

실행 지시

1단계: 인자 파싱

$ARGUMENTS에서 다음을 추출하세요:

• target: agent | command | prompt (첫 번째 인자)
• file-path: 최적화할 파일 경로 (두 번째 인자)
• options: --mcp, --interactive, --dry-run 등 (나머지 인자)

인자가 부족하면 AskUserQuestion으로 확인하세요.

2단계: target별 분기 처리

target = agent

1. Read 도구로 에이전트 파일 읽기
2. 다음 항목 분석:
   • Role clarity (역할 명확성)
   • Trigger effectiveness (트리거 효과)
   • Tool utilization (도구 활용도)
   • Prompt structure (프롬프트 구조)
3. 개선 사항 적용 후 Edit으로 수정

target = command

1. Read 도구로 커맨드 파일 읽기
2. 다음 항목 분석:
   • Argument parsing (인자 파싱 로직 존재 여부)
   • Execution logic (실행 지시 존재 여부)
   • Help text clarity (도움말 명확성)
3. 개선 사항 적용 후 Edit으로 수정

target = prompt

1. --interactive 옵션: AskUserQuestion으로 프롬프트 입력 받기
2. 파일 경로 제공: Read로 프롬프트 파일 읽기
3. URL 제공: webReader로 내용 가져오기
4. 프롬프트 최적화 수행 후 결과 출력

3단계: 옵션 처리

• --mcp: Context7 (resolve-library-id, get-library-docs)로 최신 문서 참조
• --dry-run: 수정하지 않고 제안 사항만 출력
• --interactive: AskUserQuestion으로 대화형 진행

4단계: 결과 출력

최적화 전/후 비교 및 개선 사항 요약을 출력하세요.

---

REFERENCE

아래는 최적화 수행 시 참고할 지침입니다.

OPTIMIZATION PRINCIPLES

1. CLARITY

• 명확한 목표와 제약 조건
• 모호하지 않은 지시
• 성공 기준 정의

2. EFFICIENCY

• 토큰 사용량 최소화
• 컨텍스트 윈도우 최적화
• 불필요한 복잡성 제거

3. EFFECTIVENESS

• 행동 지향적 프롬프트
• 측정 가능한 결과
• 실용적 적용 가능성

4. MAINTAINABILITY

• 모듈식 구조
• 쉬운 업데이트
• 버전 관리 친화적

---

OPTIMIZATION WORKFLOWS

1. Agent Optimization

# 기본 에이전트 최적화
/optimize agent plugins/code-quality/agents/code-reviewer.md

# MCP 통합으로 최신 문서 반영
/optimize agent plugins/nestjs-backend/agents/typeorm-expert.md --mcp

Agent Optimization Process

1. Current State Analysis
   ├─ Role clarity assessment
   ├─ Trigger effectiveness review
   ├─ Tool utilization check
   └─ MCP integration opportunities

2. Best Practices Application
   ├─ Prompt structure optimization
   ├─ Context window efficiency
   ├─ Response format standardization
   └─ Error handling improvements

3. Integration Testing
   ├─ Simulated task execution
   ├─ Performance benchmarking
   └─ Compatibility validation

2. Command Optimization

# 커맨드 최적화
/optimize command plugins/code-quality/commands/review.md

# 배치 최적화
/optimize command plugins/full-stack-orchestration/commands/*.md

Command Optimization Checklist

✓ Argument parsing efficiency
✓ Help text clarity
✓ Error message usefulness
✓ Integration patterns
✓ Performance optimization
✓ Security considerations

3. Prompt Optimization

# 대화형 최적화
/optimize prompt --interactive

# 파일에서 프롬프트 최적화
/optimize prompt my-prompt.txt

# URL 기반 문서를 프롬프트로
/optimize prompt https://docs.example.com/guide

Prompt Enhancement Features

ENHANCEMENT TYPES:
├─ Task Decomposition
│   ├─ Complex task breakdown
│   ├─ Step-by-step clarification
│   └─ Dependency identification
│
├─ Context Optimization
│   ├─ Relevant information extraction
│   ├─ Noise reduction
│   └─ Structure organization
│
├─ Output Formatting
│   ├─ Structured responses
│   ├─ Code block optimization
│   └─ Example integration
│
└─ Resource Integration
    ├─ Latest documentation
    ├─ Best practices
    └─ Tool recommendations

OPTIMIZATION PRINCIPLES

1. CLARITY

• Clear objectives and constraints
• Unambiguous instructions
• Well-defined success criteria

2. EFFICIENCY

• Minimize token usage
• Optimize for context window
• Reduce unnecessary complexity

3. EFFECTIVENESS

• Action-oriented prompts
• Measurable outcomes
• Practical applicability

4. MAINTAINABILITY

• Modular structure
• Easy to update
• Version-friendly

ADVANCED FEATURES

1. Template-Based Optimization

# .claude/optimize-templates.yml
templates:
  agent:
    sections:
      - overview
      - capabilities
      - triggers
      - examples
    max_tokens: 8000

  command:
    sections:
      - description
      - usage
      - examples
      - integration
    max_tokens: 4000

2. Batch Operations

# 전체 플러그인 최적화
/optimize agent plugins/nestjs-backend/agents/ --batch

# 특정 패턴의 파일들 최적화
/optimize command "**/*review*.md" --recursive

3. Performance Analytics

{
  "optimization_report": {
    "file": "code-reviewer.md",
    "improvements": [
      {
        "type": "token_efficiency",
        "before": 2450,
        "after": 1890,
        "improvement": "23%"
      },
      {
        "type": "response_quality",
        "score_before": 7.2,
        "score_after": 8.9,
        "improvement": "24%"
      }
    ]
  }
}

INTEGRATION EXAMPLES

1. CI/CD Pipeline

# .github/workflows/optimize.yml
- name: Optimize Components
  run: |
    /optimize agent agents/ --batch --dry-run
    /optimize command commands/ --batch --dry-run

    # Check if optimization suggestions exist
    if [ -f .optimizations.md ]; then
      echo "Optimization suggestions found"
      cat .optimizations.md
    fi

2. Development Workflow

# 개발 사이클 통합
1. 에이전트/커맨드 작성
2. /optimize로 개선
3. 테스트 실행
4. PR 생성

BEST PRACTICES

Before Optimization

1. Backup Originals: Always keep original versions
2. Understand Context: Know the purpose and constraints
3. Identify Metrics: Define what improvement means

During Optimization

1. Incremental Changes: Apply changes gradually
2. Test Each Change: Validate modifications
3. Document Rationale: Note why changes were made

After Optimization

1. Benchmark Performance: Measure improvements
2. Gather Feedback: Collect user experiences
3. Iterate: Continue refining based on results

QUALITY ASSURANCE

Optimization Validation

CHECKLIST:
□ Clear objective definition
□ Appropriate complexity level
□ Efficient token usage
□ Proper error handling
□ Consistent formatting
□ Adequate examples
□ Integration compatibility
□ Performance benchmarking

Common Pitfalls to Avoid

1. Over-optimization: Don't sacrifice clarity for brevity
2. Context Loss: Preserve essential information
3. Tool Overload: Don't add unnecessary tools
4. Generic Responses: Maintain specificity

TROUBLESHOOTING

Optimization Not Applied

Issue: Changes not taking effect
Solution:
1. Check file permissions
2. Verify file paths
3. Clear any caches
4. Restart Claude Code

Performance Degradation

Issue: Slower responses after optimization
Solution:
1. Profile token usage
2. Check for circular references
3. Simplify complex logic
4. Reduce context window usage

FUTURE ENHANCEMENTS

Planned Features

• Auto-optimization: Scheduled optimization runs
• A/B Testing: Compare old vs new versions
• Custom Metrics: Define optimization KPIs
• Integration Templates: Pre-built optimization patterns

Community Contributions

• Share optimization templates
• Contribute best practices
• Report optimization success stories
• Suggest new optimization strategies

---

QUICK REFERENCE

# Common commands
/optimize agent <file>                    # Optimize agent
/optimize command <file>                  # Optimize command
/optimize prompt --interactive           # Interactive prompt
/optimize prompt <file>                   # Optimize from file
/optimize prompt <url>                    # Convert URL to prompt

# Options
--mcp                                    # Enable MCP
--dry-run                                # Preview only
--batch                                  # Batch mode
--interactive                            # TUI mode
--template <name>                       # Use template
--output <file>                         # Save report