분석 Playbook 추가

Minara는 2026년 5월 독립 Scenario Registry를 폐기했습니다. SCENARIO_* 정의 파일을 만들거나 시나리오 카탈로그와 SCENARIO_LEARNING 플래그를 추가하지 마세요. 사용자 의도 라우팅은 이제 스킬이 담당하며, 남아 있는 분석 Playbook은 Institution Mode와 Deep Research가 직접 사용합니다.

올바른 확장 영역 선택하기

Institution Playbook 추가하기

Institution Playbook은 하나 이상의 역할에 분석 내용을 제공합니다. institution.playbook.stock_quality처럼 안정적인 네임스페이스 ID를 만들고 INSTITUTION_PLAYBOOKS에 추가합니다.

"institution.playbook.stock_quality": {
  id: "institution.playbook.stock_quality",
  description: "Evaluate earnings quality, reinvestment, and balance-sheet resilience.",
  body: `1. Verify the latest filing period and data freshness.
2. Compare cash conversion, margins, and invested-capital returns.
3. Identify the strongest disconfirming evidence.
4. State the conditions that would invalidate the conclusion.`,
},

본문만 읽어도 이해할 수 있게 작성하세요. 필요한 근거, 상충하는 근거가 결론을 바꾸는 방식, 실시간 데이터를 사용할 수 없을 때의 동작을 명시합니다. 시스템 프롬프트의 공통 안전, 인용, 언어 규칙은 반복하지 않습니다.

내장 역할이 기본으로 사용해야 할 때만 apps/agent/src/tools/institution/roles.ts에서 ID를 연결합니다. 자산별 연결은 playbookIdsForRole()에 둡니다. 테스트는 참조한 모든 ID가 실제로 해석되는지 확인합니다.

조정 가능한 값에는 안전한 기본값이 있는 방법론 자리표시자를 사용합니다.

Treat beta above `{{methodology:stock_beta_high_corr_threshold|default:0.8}}`
as market-sensitive.

재사용할 투자 규칙을 긴 Playbook에 숨기지 마세요. 방법론 시스템으로 옮긴 뒤 자리표시자나 methodology_lookup으로 참조합니다.

내장 Roundtable 템플릿 추가하기

Roundtable Builder는 context, parallel, debate, synthesis, final 다섯 단계 유형을 지원합니다. 내장 Agent, 단계, 전체 Roundtable 템플릿은 builder-templates.ts에 있으며 공유 타입은 @minara/types에서 가져옵니다.

검증기는 다음 규칙을 강제합니다.

• 파이프라인 전체에서 단계 ID와 Agent ID가 고유해야 합니다.
• debate 단계에는 Agent가 두 명 이상 있어야 합니다.
• synthesis와 final 단계에는 관리자가 정확히 한 명 있어야 합니다.
• final 단계는 정확히 하나이며 마지막에 있어야 합니다.
• 반복, 도구 호출, 시간 제한, 출력 Token이 선언된 범위 안에 있어야 합니다.

템플릿 변경은 Agent 테스트와 Web UI Builder 테스트를 함께 갱신합니다. 사용자가 만든 템플릿은 Builder Store에 저장되므로 소스 관리에 추가하지 않습니다.

Deep Research 확장하기

Deep Research의 외부 6단계 계약은 deep-research/SKILL.md에 있습니다. 주제별 수집 및 분석 지침은 references/scenarios.md에 추가합니다. 출처 선택, 근거 품질, 비교 논리, 최종 종합 형식에 집중하세요.

새 기능이 필요하다면 먼저 도구를 추가하고 테스트한 다음 스킬의 tool_names에 노출하고 참조 문서를 수정합니다. 출처나 자격 증명을 사용할 수 없을 때 Playbook은 제한을 솔직하게 밝히고 축소 동작해야 합니다.

기여 검증하기

pnpm --filter @minara/agent exec vitest run tests/unit/tools/institution.test.ts
pnpm --filter @minara/agent exec vitest run tests/unit/tools/institution-builder.test.ts
pnpm --filter @minara/agent typecheck

Deep Research를 변경했다면 관련 스킬 및 보고서 흐름 테스트도 실행합니다. 공개 동작이 바뀌면 Institution Mode 또는 Deep Research 문서를 네 언어로 함께 수정하세요.