MINARA방법론 추가
독립적인 투자 규칙을 작성하고 근거, 적용 범위, 감사 이력을 보존합니다
방법론은 원래 대화나 Playbook과 분리해 평가할 수 있는 재사용 가능한 투자 규칙입니다. 신호, 임계값, 예상 방향, 기간, 적용하지 말아야 할 조건을 표현할 수 있습니다.
Minara의 방법론은 두 경로에서 옵니다.
apps/agent/src/learning/methodology-seeds.ts의 작성된 시드가 검토된 초기 코퍼스를 제공합니다.- 평가된 의사결정과 거래 사례에서 나온 학습 후보는 격리 상태에서 시작해 충분한 근거를 쌓은 뒤에만 사용됩니다.
독립성 검사하기
규칙 하나만 “NVDA 추세를 분석해 줘”라는 프롬프트에 넣어 보세요. 의미, 필요한 근거, 실패 조건이 여전히 명확하면 방법론이 될 수 있습니다. “이전 단계”, 특정 역할, Roundtable 단계, 다른 활성 규칙을 참조한다면 분석 Playbook에 남겨야 합니다.
좋은 예:
잉여현금흐름 전환율이 두 보고 기간 연속 70% 미만이고 매출채권 증가율이 매출 증가율보다 높으면 이익의 질이 악화되는 것으로 판단한다.
문맥에 의존하는 예:
분석가가 3단계를 마치면 위의 결과를 사용해 등급을 낮춘다.
작성된 시드 추가하기
METHODOLOGY_SEEDS에 하나의 집중된 항목을 추가합니다.
{
stableId: "stock.earnings_quality.cash_conversion.v1",
version: "v1",
source: "authored",
asset_class: "stock",
methodology:
"When free-cash-flow conversion stays below 70% for two reporting periods " +
"while receivables grow faster than revenue, treat earnings quality as deteriorating.",
thresholds: { fcf_conversion_floor_pct: 70 },
anti_patterns: [
"Do not apply to pre-revenue companies.",
"Skip periods distorted by a disclosed acquisition close.",
],
applies_only_to: ["stock"],
benchmark_profile: "asset_benchmark",
},| 필드 | 기여 규칙 |
|---|---|
stableId | 지속적이고 고유한 ID를 사용하며 다른 아이디어에 재사용하지 않습니다. |
version | 의미나 임계값이 바뀌면 올립니다. |
source | authored, derived_from_paper, community를 사용하고 필요하면 PR에 출처를 남깁니다. |
asset_class | asset-taxonomy.ts에서 고르며 작성된 시드에 unknown을 사용하지 않습니다. |
methodology | 독립적으로 검증할 규칙 하나를 작성하고 시나리오나 도구 이름을 넣지 않습니다. |
thresholds | Playbook이 참조할 수 있는 안정적인 snake_case 키를 사용합니다. |
anti_patterns | 영향이 큰 규칙에는 짧은 제외 조건을 한 개에서 세 개 추가합니다. |
applies_only_to | 같은 용어가 다른 자산군에 잘못 맞을 수 있을 때 범위를 좁힙니다. |
benchmark_profile | absolute, asset_benchmark, beta_adjusted, market_neutral, pair_trade 중 결과 비교 방식을 선언합니다. |
그럴듯하다는 이유만으로 시드를 추가하지 마세요. Pull Request에서 근거와 기대하는 증거를 설명합니다. 논문이나 공개 데이터셋에서 가져온 규칙은 인용과 라이선스 맥락을 보존해야 합니다.
수명 주기 이해하기
작성된 시드는 신뢰된 내장 시드 소스를 통해 들어옵니다. 신뢰되지 않은 학습 또는 가져오기 항목은 신뢰도 0.1의 격리 상태에서 시작합니다. 후보가 승격하려면 관측 10회 이상, 올바른 관측 5회 이상, Wilson 하한 0.55 이상이 필요합니다. 승격된 규칙은 20회 이상 사용된 뒤 Wilson 점수가 0.40 아래로 떨어지면 다시 격리됩니다.
Agent에는 승격된 방법론만 methodology_lookup 또는 {{methodology:...}} 자리표시자를 통해 전달됩니다. 자리표시자에는 항상 안전한 기본값이 있습니다. 운영자는 읽기, 사례 기록, 모든 변경을 각각 중단할 수 있습니다.
신뢰도, 카운터, 격리 상태의 모든 변경은 방법론 저장소의 수명 주기 계약을 사용해야 합니다. SQL 직접 수정은 원자적 감사 이벤트를 잃으므로 허용되지 않습니다.
기여 검증하기
pnpm --filter @minara/agent lint:methodology
pnpm --filter @minara/agent exec vitest run tests/unit/learning/methodology-seeds-lint.test.ts
pnpm --filter @minara/agent exec vitest run tests/unit/learning/methodology-store.test.ts
pnpm --filter @minara/agent typecheckInstitution Playbook에 자리표시자를 추가했다면 기본값과 저장소 기반 덮어쓰기를 모두 테스트합니다. 공개 동작이 바뀌면 관련 분석 문서를 네 언어로 수정하세요.
운영자는 SQLite를 직접 편집하지 않고 현재 상태를 확인할 수 있습니다.
minara learning methodology explain <id>
minara learning methodology lifecycle --id <id>
minara learning methodology cases --id <id>