新しいアイデアを取り込む

公式運用ルール

MURASAMEは、Card、Verified Knowledge、Global KG、Project KG、Distillerを並行して進化させます。そのため、新しいアイデアは「現行実装との差分」と「採用後に観測する成功条件」を先に固定します。

変更パケット

最低限、次の項目を一つの変更メモにします。コードを書く前に現行ファイル、DB、CLI出力、テストを確認します。

Hypothesis — 何がどれだけ良くなるか

Current behavior — 現在の事実とファイル

Desired behavior — 利用者が観測する変化

Delta — 追加・変更・移行・未解決

Trust / provenance — 自動確定してよいか

Acceptance — テストと数値の成功条件

Migration / rollback — データと戻し方

Documentation — 正本・Portal・CLI・Runbook

採用フロー

観測 / アイデア
  ↓ 現状基準と変更パケット
影響範囲・信頼境界・非目標
  ↓
最小Vertical Slice
  ↓
Unit / Integration / Runtime verification
  ↓
Proposal / Candidate / human gate
  ↓
コード・テスト・公式Docs・運用へ反映

最初に守る境界

LLM、Distiller、CodeGraph、Understand-Anythingの結果は既定で proposed / unverified。
承認なしに通常ターンへ注入されるCardや confirmed Graphへ書き込まない。
既存DBスキーマを変更する提案は、移行とロールバックを含むまでPoCの外へ出さない。
Graphとコードの矛盾は自動上書きせず、意図・実装事実・Evidenceの差分として表示する。

変更先の分類

領域	最初の実装先	主なゲート
Card	`src/knowledge` / `src/core/cards.ts`	Evidence、Evaluator、状態隔離
Verified	`src/verification`	決定的Runner、再検証条件
意味Graph	`src/kg`	Proposal → approve、provenance
蒸留	`distiller/`	Raw / Parsed、再開、メトリクス
公開Docs	`portal/app/docs`	ローカルbuild、live URL

GraphとCodeの変更

Graphからは人間がレビューできるSpecificationとNext.js最小Skeletonを生成します。 CodeGraph / AST / Understand-AnythingからはFile、Function、Route、実装関係の差分候補を作ります。どちらも本番コードや意図を無条件に上書きしません。

Requirement
  → IMPLEMENTS → Screen / API / Implementation
  → VALIDATED_BY → Test
  → JUSTIFIED_BY → Evidence

Code change
  → CodeGraph / analysis
  → Graph update candidate
  → conflict review
  → explicit approval

完了条件

現行テストと新しいテストが通る。
Candidate / Proposal / Verifiedの状態遷移を確認できる。
既存データ、秘密情報、ロールバックの扱いが書かれている。
現状基準とこの公式Docsが実装と一致する。
実測値または未実装であることを明示できる。

正本

詳細なテンプレートとDistiller取り込みの実例は、リポジトリの docs/17-change-delta-and-adoption.md にあります。現在の機能一覧は docs/16-current-system.md を優先してください。