Institution Mode

🟡 중급 : 장시간 분석 (LLM 호출 최대 25회, 실행당 60–600초). 설계상 읽기 전용입니다. ⚠️ 리스크 면책 조항: Institution Mode는 의견을 제시할 뿐, 주문을 실행하지 않습니다. 포트폴리오 매니저의 "매수" 등급도 사용자의 포지션 크기 결정, 비상 정지, 그리고 모든 자금 이동 호출에 적용되는 2단계 확인 절차를 거쳐야 합니다.

Institution Mode는 Minara 내부에 다중 Agent 투자 위원회를 소집합니다. TradingAgents 연구 방향에서 영감을 받아, 모든 티커(또는 티커 바스켓)에 대해 구조화된 6단계 파이프라인을 실행합니다. 결과로는 확률 가중 시나리오 트리, 구조화된 목표 가격, 영구 감사 로그가 포함된 5단계 등급이 생성됩니다.

전체 파이프라인은 읽기 전용입니다. 자금을 이동하지 않습니다. 권고안을 실행하려면 별도의 명시적 단계가 필요하며, 수동 주문과 동일한 미리보기-확인-실행 흐름을 거칩니다.

Institution Mode의 용도

다음 상황에서 Institution Mode를 사용하십시오.

• 단일 자산에 대해 강한 확신의 방향성 결정을 내리기 전에 자본을 투입하기에 앞서 대립적 검토를 원하는 경우.
• 후보 자산 비교 ("BTC vs ETH vs SOL, 지금 어느 것?")나 크로스 에셋 자산 배분 ("BTC, 금, S&P 500, 스테이블코인에 $100k 배분")이 필요한 경우.
• 결정에 대한 이사회 수준의 감사 추적이 필요한 경우. 모든 애널리스트 출력, 모든 토론 턴, 인용된 모든 방법론이 단일 run_id 하에 SQLite에 영구 저장되어 이후에 회고할 수 있습니다.
• 사용자가 "institution mode", "机构模式", "multi-agent", "多 agent", "boardroom" 호출, 또는 "투자 위원회" 검토를 명시적으로 요청하는 경우.

다음 상황에서는 적합하지 않습니다.

• 빠른 가격 또는 잔액 조회 (get_price / minara_account 사용).
• 간단한 심리 확인 (get_fear_greed, 소셜 애널리스트 직접 사용).
• 60초 이상의 지연이 허용되지 않는 경우.

매 실행 시 제공되는 결과

결정을 생성하는 모든 역할은 Zod 스키마를 사용한 강제 구조화 도구 호출을 사용하므로, 출력 형태가 결정론적이며 실행 간 직접 비교가 가능합니다. 전체 보고서는 report://{report_id}로 저장되어 채팅에 인라인으로 표시됩니다. 반성 단계 (1일 / 7일 / 30일 / 90일 / 180일 / 365일)는 위의 일정에 따라 각 실행을 재검토하여, 실제 가격 움직임 대비 판단을 평가하고 교훈을 방법론 저장소에 반영합니다.

자산군별 지원 범위

파이프라인은 각 티커를 classifyAsset() (apps/agent/src/learning/methodology-store.ts)를 통해 라우팅하여, 해당 자산군에 맞는 애널리스트 도구 허용 목록과 방법론 버킷을 선택합니다.

예시 프롬프트

/institution BTC
/institution NVDA --debate 3 --risk 3
/institution BTC ETH SOL
/institution gold SPY USDC --debate 5
/institution 分析下苹果
分析下机构模式 BTC 多 agent 视角

CLI 플래그 --debate N과 --risk N은 토론 라운드 수를 1..5로 제한합니다. 플래그가 없으면 INSTITUTION_MAX_DEBATE_ROUNDS 및 INSTITUTION_MAX_RISK_ROUNDS 기본값이 적용됩니다.

출력 예시, 단일 티커

프롬프트: /institution BTC

Agent 응답 (요약):

포트폴리오 매니저, 매수 (신뢰도 0.72)

BTC는 기술적으로 건설적 (4시간봉 EMA 스택 강세, RSI 중간 범위), 온체인도 건설적 (LTH 공급 비율 상승, 거래소 잔액 횡보 내지 감소), 펀딩은 중립이며, 30일 실현 변동성은 다음 FOMC를 앞두고 방향성 움직임의 여지를 남깁니다.

시나리오 (확률 가중)

• 기본 55% : 6주에 걸쳐 $122k까지 점진 상승, $108k에서 지지.
• 강세 25% : 유입 + ETF 재개에 따른 $122k 돌파 스퀴즈, 목표 $138k.
• 약세 20% : 매크로 충격으로 $96k 급락, $93k 하회 시 논거 무효.

트레이더 제안: 현물 매수, $93k 손절 기준 1.5R 포지션, 기본 목표 $122k / 연장 목표 $138k. 기간 6–10주.

리스크 토론: 보수적 관점은 $122k 근처 펀딩 전환 리스크를 경고하고, 공격적 관점은 ETF 유입 변곡점을 주목하며, 중립 관점은 위의 기본 시나리오 포지션 크기에 수렴합니다.

전체 보고서: Institution 보고서.

⚠ 이것은 분석이며 주문이 아닙니다. 실행하려면 buy 0.5 BTC 또는 long BTC 5x size $200을 요청하시면 자금이 이동하기 전에 표준 미리보기를 실행합니다.

출력 예시, 다중 티커 Allocator

프롬프트: /institution BTC ETH SOL

Agent 응답 (요약):

Allocator, 모드: 하이브리드

세 개의 주요 자산에 대해 위원회의 티커별 판단은 다음과 같습니다.

티커	PM 등급	신뢰도	Allocator 비중
BTC	비중 확대	0.71	50%
ETH	보유	0.55	30%
SOL	매수	0.68	20%

BTC는 가장 높은 신뢰도의 대다수 보유 포지션으로 앵커 역할을 하고, SOL은 가장 강한 모멘텀 판단에 따라 전술적 20%를 배분받으며, ETH는 L2 시퀀서 수수료 압축이 해소될 때까지 보유를 유지합니다.

실행은 여전히 별도의 단계입니다. 각 레그에 대해 swap 또는 buy를 요청하시면 모든 주문을 미리 보여드립니다.

비용 및 지연 시간

일반적인 실행은 약 25회의 LLM 호출과 60–600초가 소요되며, 대부분은 단계 1의 병렬 애널리스트와 두 개의 토론 단계에서 발생합니다. 다음 설정으로 조정할 수 있습니다.

• INSTITUTION_WALL_CLOCK_TIMEOUT_MS : 전체 예산 (기본값 1200초).
• INSTITUTION_MAX_DEBATE_ROUNDS / _MAX_RISK_ROUNDS : 토론 깊이.

파이프라인의 모든 역할은 운영자가 선택한 Agent 모델에서 실행됩니다. 더 강력한 합성을 원한다면 전체 세션을 더 강력한 모델로 전환하십시오 (역할별 재정의는 지원되지 않습니다).

전체 환경 변수 참조: 환경 변수.

안전 포지션

• 읽기 전용. minara_institution_analyze 도구는 READ_ONLY로 등록됩니다. 어떤 애널리스트, 토론자, 포트폴리오 매니저도 자금 이동 도구를 호출할 수 없습니다.
• 실행은 별도의 프롬프트가 필요합니다. 권고안을 받은 후 직접 주문을 실행하십시오 (swap_tokens, open_perps_position, strategy-codegen 스킬의 deploy.sh). 각각은 자체적인 2단계 미리보기-확인 게이트를 적용합니다.
• 감사 로그. 모든 run_id는 단계별 출력, 반성, 방법론 인용을 SQLite에 기록합니다. REPL에서 /institution-history로 또는 셸에서 minara institution history로 검사할 수 있습니다.

관련 스킬 및 도구

다음 단계:

• 첫 번째 Institution 분석 실행
• 실행 결과가 학습 시스템에 반영되는 방식
• Institution 환경 변수
• 기반 스킬: institution