분석 Playbook과 흐름 구성
스킬, Institution Playbook, Roundtable 파이프라인, 방법론이 책임을 나누는 방식
Minara는 2026년 5월 독립 Scenario Registry를 폐기했습니다. 요청 라우팅, 분석 지침, 학습된 투자 규칙은 이제 서로 다른 시스템이 담당합니다. 하나의 거대한 시나리오 카탈로그를 병목으로 만들지 않고 각 계층을 독립적으로 발전시킬 수 있습니다.
현재 모델
| 관심사 | 담당 | 기준 소스 |
|---|---|---|
| 사용자 요구를 인식하고 관련 기능 제공 | 스킬 라우팅 | apps/agent/src/skills/builtin/*/SKILL.md |
| Institution 역할에 재사용 가능한 분석 틀 제공 | Institution Playbook | apps/agent/src/tools/institution/playbooks/index.ts |
| Agent를 context, parallel, debate, synthesis, final 단계로 구성 | Roundtable 파이프라인 | @minara/types 정의와 Institution Builder Store |
| 장문 연구 보고서 안내 | Deep Research 스킬 참조 | deep-research/SKILL.md와 references/scenarios.md |
| 투자 규칙 재사용 및 평가 | 방법론 시스템 | apps/agent/src/learning/ |
스킬이 요청 라우팅을 담당합니다
스킬은 무엇을 하는지, 언제 나타나야 하는지, 어떤 도구를 노출할 수 있는지 설명합니다. 레지스트리는 바로 아래의 SKILL.md 패키지를 불러오고 충족되지 않은 환경 요구 사항을 걸러 낸 뒤 라우터에 작은 카탈로그를 제공합니다. 활성 SkillSession이 현재 턴에 들어갈 지침과 도구를 결정합니다.
일반 라우팅은 기능 자체와 가까운 곳에 남습니다. 새로운 사용자 요청 유형을 지원할 때는 대개 스킬 설명, 참조, 도구를 개선하면 됩니다. 중앙 시나리오 정의는 필요하지 않습니다.
Institution Playbook이 분석 내용을 담당합니다
Institution Playbook은 안정된 이름을 가진 연구 지침입니다. 한 역할이 주식, 디지털 자산, 지수, 원자재 등 자산군에 따라 다른 Playbook을 받을 수 있습니다. roles.ts가 내장 역할을 Playbook ID에 연결하고 테스트가 모든 참조를 검증합니다.
Playbook은 수집할 근거, 의견 충돌을 평가하는 방법, 실시간 데이터가 불완전할 때 진행할 방식을 설명합니다. 재사용 가능한 임계값은 {{methodology:...|default:...}} 자리표시자로 방법론 저장소에서 가져옵니다. 공통 안전과 인용 규칙은 공유 시스템 프롬프트에 둡니다.
Roundtable 파이프라인이 협업을 담당합니다
Roundtable Builder는 다섯 단계 유형을 조합합니다.
context가 제약과 과거 결정을 정리합니다.parallel에서 독립 전문가가 서로에게 끌리지 않고 근거를 수집합니다.debate가 여러 라운드의 명시적 반론을 진행합니다.synthesis에서 한 명의 관리자가 전체 기록을 종합합니다.final이 판단과 모니터링 계획을 만듭니다.
파이프라인은 단계 순서, Agent, 프롬프트, 스킬, 반복 한도, 예산을 저장합니다. 검증기는 고유 ID, debate 단계의 Agent 두 명 이상, synthesis와 final 단계의 관리자 한 명, 마지막에 정확히 하나의 final 단계를 요구합니다. 실행 시 파이프라인 스냅샷을 저장하므로 이후 편집이 과거를 바꾸지 않습니다.
사용자는 저장소를 수정하지 않고 자신만의 Roundtable을 만들고 저장할 수 있습니다. 내장 Agent, 단계, Roundtable 템플릿은 builder-templates.ts에 있으며 검토된 출발점을 제공합니다.
Deep Research는 독자적인 보고서 계약을 유지합니다
Deep Research는 이해, 계획, 수집, 분석, 시각화, 작성의 고정된 6단계를 사용합니다. 주제별 지침은 references/scenarios.md에 있습니다. 참조 문서가 출처 선택과 종합 방식을 이끌고 스킬은 진행 상황과 최종 산출물을 일관되게 유지합니다.
방법론은 독립성을 유지합니다
방법론은 근거, 범위, 제외 조건, 감사 가능한 수명 주기를 가진 독립 투자 규칙입니다. Playbook은 승격된 방법론을 자리표시자나 methodology_lookup으로 사용할 수 있지만 신뢰도와 결과 이력을 소유하지 않습니다.
이 분리는 효과적인 규칙이 한 흐름에 갇히지 않게 합니다. 승격 기준을 통과하지 못한 학습 규칙이 Institution 프롬프트에 들어가는 일도 막습니다.