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 回以上の正しい観測、0.55 以上の Wilson 下限が必要です。昇格済みルールは、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>