name: code-investigation
version: 1
description: "코드베이스 탐색 → 요약 보고서 생성. 구조 파악·의존성 분석·이슈 발굴."
roles:
  - id: explorer
    required_capabilities:
      - evidence_check
      - code_review
    preferred_backends:
      - openrouter
    fallback_personas:
      - "openrouter-claude-code-reviewer@1"
      - "openrouter-deepseek-verifier@1"
  - id: summarizer
    required_capabilities:
      - evidence_check
      - final_report_compose
    preferred_backends:
      - openrouter
    fallback_personas:
      - "openrouter-claude-spec-writer@1"
phases:
  - key: explore
    title: "코드베이스 탐색 및 정보 수집"
    risk: low
    role: explorer
    expected_artifact:
      path: artifacts/exploration.json
      schema: dev/spec@1
    gates: []
    timeout_seconds: 600
    instructions: |
      코드베이스를 체계적으로 탐색합니다.
      glob으로 전체 파일 구조를 파악하고 read_file로 핵심 파일을 읽습니다.
      grep으로 주요 패턴·의존성·진입점을 검색합니다.
      발견한 내용 (구조, 주요 컴포넌트, 의존성, 잠재적 이슈)을
      dev/spec@1 형식으로 artifacts/exploration.json에 write_file로 저장합니다.
      requirements 필드: 탐색 목적
      approach 필드: 탐색한 파일 목록 및 방법
      acceptance_criteria 필드: 발견한 핵심 사실들
      risks 필드: 발견한 잠재적 이슈들
    max_budget_usd: 0.50
  - key: summarize
    title: "탐색 결과 최종 보고서 작성"
    risk: low
    role: summarizer
    expected_artifact:
      path: artifacts/report.json
      schema: common/final-report@1
    gates:
      - report_approved
    timeout_seconds: 300
    instructions: |
      artifacts/exploration.json을 read_file로 읽고 common/final-report@1 형식으로
      최종 보고서를 작성합니다.
      status: "completed"
      phases: explore와 summarize 단계 정보
      findings: exploration.json의 risks 항목을 finding으로 변환
      artifacts: exploration.json 경로 포함
      보고서를 write_file로 artifacts/report.json에 저장합니다.
    max_budget_usd: 0.30
default_gates: []
max_total_budget_usd: 1.0