概要と現在地 Hands-on 導入ガイドコマンドリファレンスアーキテクチャ Concept Runtime Knowledge Society Knowledge Card / 評価 Knowledge Field Knowledge Graph Distiller / RunPod Security / Trust Boundary Operations 差分と取り込み管理者ガイド

OFFICIAL DOCUMENTATION

MURASAMEの現在地

現行実装基準: 2026-08-29 JST / CLI v1.5.92

MURASAMEは、複数のAI・ツール・計算資源・Knowledge Card・検証資産を束ね、自然言語の依頼を仕事として継続的に遂行するAI基盤です。回答だけを返すのではなく、実行結果・検証・判断・設計意図を次の仕事で使える形に残します。

このサイトのDocsは公式ドキュメントです。現在のコードで確認できる機能と、限定実装・将来案を分けて記載しています。詳細な現状基準はリポジトリの docs/16-current-system.md、新しいアイデアの差分管理は docs/17-change-delta-and-adoption.md が正本です。

自然言語の要求がConcept Runtimeの核を通り、設計・検証・実装へ分岐する抽象ビジュアル

最初に読む / CONCEPT RUNTIME

実装する前に、要件を動かす。

Concept Runtimeは、コードを書かずに要件・データフロー・判断条件を設計し、決められた条件で検証する開発環境です。一つのConcept Modelを、チームが使う複数の形式へレンダリングできます。

Concept Runtimeの詳細を見る →

現在のステータス

運用中

CLI / daemon / Gateway / Portal / Knowledge Card / Autopilot / Knowledge Society daemon loop / MVP運用面(health・readiness、graceful shutdown、再起動回復、murasame status)

実装済み

User Brain / Verified Knowledge / CodeGraph・Understand-Anything Bridge / KG Storeの検索・経路探索 / kg scopeとneighbors・path・reachableのread-only text・JSON・Sixel/Kitty/ANSI TUI / Knowledge Field metricsと--actionsのProposal/Ledger境界 / Conflict review TUI / Team sync・Source syncの差分契約 / 共通Trace契約 / Card→Graph Evidence付き候補

実装済み

Knowledge SocietyのPersona / Council / Claim / Question / Candidate / Job / Memory、daemon上のSimulation Loop、OpenCode Player、Evidence・Verification・Human Reviewの昇格ゲート、共有レート制御

検証・限定運用

Global / Project Knowledge Graph / Formal Verification / RunPod Distiller(queue・lease・retry・resume・systemd timerを含む) / Graph → Skeleton

実装済みだが限定的

Concept Runtimeの自然言語Orchestratorと通常TUIの保守的Router(確認→Model→simulate/Quint→コード/設計View)・既存コードObservation / 任意ドメインのOpenAI互換LLM Completion(provider未設定時はfail-closed) / Knowledge Packの署名・Evidence・Review・Rollback契約とvalidate/inspect / Private Runtimeのdeterministic planとlocal manifest apply

設計のみ

Knowledge Packの外部配信・Import / Private Runtimeの実GPU・クラウドProvisioning・SLA・監査認証 / 完全な双方向同期

未実装

Kuzu・PostgreSQL・AGE・Neo4jの実データプレーンAdapter(接続設定なし)

一つの仕事ループ

自然言語の依頼
  ↓
ルーティング / Knowledge retrieval / User Brain
  ↓
推論・ツール実行・バックグラウンド処理
  ↓
自動評価・修正・実行結果
  ↓
Memory / Knowledge Card / Verified Evidence / Project KG

通常のCodex-first経路は gpt-5.6-luna:low から開始し、必要なときだけeffortを上げます。 Knowledge Cardはcandidateをそのまま注入せず、評価済みのverified/referenceだけを検索対象にします。

Concept Runtime — 実装前の開発環境

Concept Runtimeは、実装を自動完成させる機能ではありません。実装を始める前に、要件を構造化し、誰が何を行い、どのデータがどの状態を通り、どの条件で止まるのかを確認するための環境です。曖昧な点は人のDecisionとして残し、保存・simulate・verifyの前に検証します。

要件が人間の判断ゲートを通り、構造化されたConcept Modelへ変換されるビジュアル

Concept Runtimeの設計ワークベンチで、要件、構造化モデル、人のDecision、Simulation Traceを一つの流れとして確認するビジュアル

Excel

Decisionと設計項目をチームでレビュー

PDF

設計・データフロー・Traceを共有

Markdown

正本を人が編集し、明示適用

実コード

types / permissions / MODELの骨格へ

要求から成果物まで、同じ正本を通る

一つのConcept Modelを中心に、要件から検証を経てExcel、PDF、Markdown、コード骨格へデータが分岐するビジュアル

現行のCode出力は本番アプリケーションを完成させるものではなく、types.ts、permissions.ts、MODEL.mdなどのコード骨格・設計Viewです。最終的な業務実装と外部作用は、別の実装・承認工程で確定します。

常駐運転と継続処理(v1.5.92)

daemonとgatewayは HTTP の /health(liveness)と /ready(readiness)を持ち、 SIGTERMでのgraceful shutdown、再起動後に残った背景タスクのfailed確定(回復)に対応します。murasame statusで状態と理由を確認できます。systemd等への常駐登録手順はアーキテクチャにまとめています。

Distillerの蒸留WindowはTopic Queue・lease・retry / backoff・再開(resume)を持ち、 systemd timerによる日次の時間制限付き運用ができます。クラッシュ・SIGTERM後も未処理Topicから再開し、 Graph bridgeの失敗は次回起動時に自動再試行します。詳細はDistiller / RunPodを参照してください。

Knowledge Society — 知識を育てる常駐ループ

Knowledge Societyは、知識を蓄えるだけでなく、Personaの視点を切り替えながら議論・問い・根拠・実地検証を積み重ねる拡張ランタイムです。実行主体は murasamed で、CLIは society.op を送って状態を観測・操作します。MURASAME_SOCIETY=1 をdaemonの設定で明示したときだけ常駐ループが動きます。

Persona Context
      ↓
Council / Player turn
      ↓
Claim・Question・Conflict
      ↓
Evidence・Verification
      ↓
Knowledge Candidate
      ↓
Human Review → candidate card

同じGLM-5.3がPersonaを切り替えて議論しても、独立した専門家の合意とはみなしません。 CandidateはEvidence・Verification・人手確認の境界を越えるまで、Verified Knowledgeへ自動昇格しません。詳細はKnowledge Societyの現行仕様を参照してください。

Concept RuntimeとKnowledge Societyの関係

Concept Runtimeはコードを書く前の設計・権限・状態遷移を検証する実行核です。Knowledge Societyは、その検証や既存Knowledgeを議論の材料として、次の問い・Candidate・Verification Jobをゆっくり生み出す上流の活動層です。両者は同じdaemon側のJob・Trace・Evidence境界へ接続しますが、CLIがDBやPlayerを直接所有することはありません。

Knowledge CardとKnowledge Graph

運用中

Knowledge Card

技術・業務のQ&A、手順、制約、判断基準を共有する知識です。一次資料のEvidenceと複数Judgeの評価を持ち、検索・注入に使う状態を制御します。

Cardと評価の詳細 →

現行: SQLite / Proposal-first

Knowledge Graph

Requirement、Decision、Constraint、Entity、Role、Screen、API、Test、Evidenceとその関係を保持します。人間は自然言語で話し、Graphへの変更はProposalとして承認します。

Graphの詳細 →

Concept RuntimeとKnowledge Field

実装済み / 限定範囲

Concept Runtime

自然言語の要求を確認質問付きでConcept Modelへ形成し、simulate・validate・verify・コード/HTML/PDF/Excel Viewまで一気通貫で実行します。未解決の確認や検査が残る場合は保存前に停止します。既存コードはImplementation Observationとしてimportし、checkで差分を継続検証できます。

現行仕様と限界 →

実装済みの第一段階

Knowledge Field

murasame kg scope と kg neighbors/path がLocal / GlobalのKnowledgeをread-onlyでtext、JSON、TUI表示します。TUIはSixel / Kitty / ANSI fallbackのGalaxy・Cluster・Card投影、回転・ズーム・深度、semantic bridge、決定的アニメーション・pulseに対応します。通常ターンのreasoning.nodesはCtrl+GのLive Fieldへ自動連動します。--actionsを明示したTUIとkg field-actionは、IMPORT/CREATEをProposal、IGNOREをLedgerへ送りますが、確定昇格は行いません。

現行Scopeの契約 →

Graphの位置付け

Human Intent + Global Knowledge + Card + Evidence
                    ↓
          Project Knowledge Graph
             ↓              ↘
       Specification       Code Skeleton
             ↑                  ↓
       CodeGraph / AST / Understand-Anything
                    ↓
             Graph Update Candidate

CodeGraphやUnderstand-Anythingはコードを理解するための観測層です。MURASAMEのGraphはその上位に意味・設計・検証を置き、コードを唯一の一次情報にはしません。ただし現時点では完全な双方向同期ではなく、コード変更は確認用の差分候補として扱います。

Global Knowledgeはどう進化するか

RunPod 48GB級GPU上のLLM-jp 4 33B Thinking Distillerが、ブログに限らず任意のSeed Topicを探索します。 Raw Generation、Parsed Candidate、Provenanceを保存し、Parsed結果からGlobal KGの未承認Proposalを自動生成します。探索は自動化しますが、確定知識への昇格はEvidence、評価、人の承認を通します。

Distiller / RunPodの詳細 →

読みはじめる

導入ガイド — CLIを入れて最初の対話を始める
コマンドリファレンス — 対話、User Brain、KG、管理操作
アーキテクチャ — 公開面、daemon、知識境界、Graphの流れ
Concept Runtime — 自然言語Orchestrator、Model、simulate、validate、verify、Renderer、import、check
Knowledge Society — Persona、Council、Player、Simulation Job、Candidate昇格ゲート、OpenCode間隔制御
Knowledge Card / 評価 — candidate、Evidence、verified、reference
Knowledge Field — read-only Scopeのtext / JSON / TUIと設計境界
Knowledge Graph — Global / Project、Proposal、Spec、Reverse Analysis
Security / Trust Boundary — Local / Global、Proposal、承認境界
Operations — health、ready、status、回復、Distiller運用
差分と取り込み — 新しいアイデアを現行実装へ安全に追加する方法
管理者ガイド — 組織、ユーザー、Token、知識運用