法律事務所Wikiコンパイラ は何をしますか?
使用すべきタイミング
- 新しいケースや古いケースアーカイブをWikiに追加するとき
- アクティビティログの更新後に再コンパイルするとき
- Wikiに組織的知識を問い合わせるとき
- Wiki記事のlint/ヘルスチェックを実行するとき
- Wiki記事からHermesスキルを生成するとき
Excel取り込み(FileVineアクティビティエクスポート)
AaronがFileVineからアクティビティログのExcelスプレッドシートを送信した場合:
期待されるフォーマット
- シートの列:
Project Name | Note Text | Created At | (空) - Project Name = "クライアント名 ケースタイプ MM/DD/YYYY"(例: "Amy Stich WC 01/17/2024")
- Note Text = マークダウン形式のアクティビティノート(FileVineリンク、取り消し線を含む場合あり)
- Created At = 日時
変換手順
- 必要に応じて
pip install openpyxl openpyxl.load_workbook(path, read_only=True)で読み込み- FirmVaultのルールに従ってケース名をスラッグ化(小文字化、アポストロフィ/引用符の除去、&→and、非英数字→ハイフン)
- エントリをケースごと、各ケース内では日付ごとにグループ化
FirmVault/cases/<slug>/Activity Log/<YYYY-MM-DD>.mdにフロントマター付きで書き込み:schema_version: 2 date: "YYYY-MM-DD" category: imported subcategory: settlement_activity_exportsubcategory: settlement_activity_exportタグを使用して、後でExcelからインポートしたケースを識別
1セッション内での複数ファイル
Aaronは多くの場合、複数のExcelファイルを連続して送信します。各ファイルを完全に処理(変換→バッチ処理→コンパイル→インデックス再構築)してから、次のファイルを要求してください。 コンバーターは重複を自動的に処理します。ケースディレクトリが既に存在する場合は新しいログを追加し、その日付のログファイルが既に存在する場合は「Imported Entries」セクションを追加します。
サイズリファレンス(2026-04-12インポート)
- ファイル1 (settlement_1): 17,639行 → 198ケース → 6,221ログファイル (13.7 MB)
- ファイル2 (settlement_2): 22,182行 → 169ケース → 7,341ログファイル (12.9 MB)
- ファイル3 (settlement_3): 688行 → 8ケース → 158ログファイル (小さい)
- ファイル4 (closing): 9,363行 → 125ケース → 2,924ログファイル
- 変換には1ファイルあたり約2秒
- 重複検出: 行数と最初/最後の行を比較して再送信を識別
バッチサイズの決定
- >50ケース: 3つの並列サブエージェント(ログ数で均等に分割)
- 10~50ケース: ログボリュームに応じて1~2のサブエージェント
- <10ケース: 対象記事のみを更新する単一サブエージェント。 既存の全記事を読ませないでください。更新される可能性が最も高い5~6記事を指定します。読み取り中のターン枯渇を防ぐため、max_iterations=30に設定します。
再利用可能なコンバータースクリプト
/tmp/convert_excel.pyに保存し、新しいファイルごとにパスを変更します。スクリプトは:
- openpyxlを使用(不足時はpip install)
- FirmVaultルールに従ってスラッグ化
- ケース→日付でグループ化し、フロントマター付きマークダウンを書き込み
- 新規ケースディレクトリと更新ディレクトリを報告
アーキテクチャ
Karpathyの3層パターン: 生ソース → LLMコンパイラ → 構造化Wiki
Layer 1: Raw (不変)
cases/*/Activity Log/*.md — 21K+ アクティビティログ
cases/*/*.md — ケースファイル
Layer 2: Wiki (LLM保守)
wiki/
Home.md — Obsidianダッシュボード
index.md — マスターカタログ
log.md — コンパイル履歴
concepts/*.md — 原子知識記事(2026-04-12時点で63)
connections/*.md — クロスカッティングインサイト(2026-04-12時点で26)
AGENTS.md — コンパイラスキーマ(仕様書)
SPEC.md — アーキテクチャ文書
Layer 3: 消費者
Hermesセマンティックスキル、OpenClawエージェント、Hermes経由のAaron
コンパイルプロセス
バッチ処理(大量ケース用)
- ケースを約80Kトークンのバッチにグループ化
- 3バッチを並列で委任
- 各サブエージェントがAGENTS.md、既存記事、ケースファイル+サンプルログを読み取り
- サブエージェントは既存記事を更新(evidence_count++)または新しいものを作成
- サブエージェントにindex.mdを書き換えさせない(競合状態) — 後に再構築
- 全バッチ完了後、ディスク上の全記事からindex.mdを再構築
コンパイラサブエージェントへの主要指示
- AGENTS.mdを読んで完全なスキーマを理解
- 書き込む前に、既存の全概念+接続記事を読む
- すべてのPIIを匿名化(「ケースA」「ケースB」など)
- 新規作成よりも既存更新を優先(信頼度を高めることが目標)
- 信頼度: 低(<5ケース)、中(5~9)、高(10+)
- 記事間で[[wikilinks]]を使用
- log.mdに追記し、index.mdは書き換えない
サンプリング戦略
- 大規模ケース(400+ログ): 時系列で最初の40 + 最後の40
- 中規模ケース(100~400): 最初の25 + 最後の25
- 小規模ケース(<100): 最初の10 + 最後の10、または全部
サブエージェントプロンプトテンプレート
法律事務所Wikiコンパイラ。 /opt/data/FirmVault/wiki/AGENTS.md を読め。
wiki/concepts/ と wiki/connections/ の既存記事を読め。
ケースをコンパイル: [リスト]。各ケースについて: cases/<slug>/<slug>.md と
最初のN + 最後のNのアクティビティログをサンプルして読め。既存記事を更新
(evidence_countを増分、信頼度をアップグレード: 5=中、10=高)。
真に新しいパターンのみ新規作成。PIIを匿名化。
wiki/ に書き込め。index.md は書き換えるな。wiki/log.md に追記せよ。
データカテゴリに応じたプロンプト調整
異なるExcelエクスポートには異なる種類のデータが含まれています。フォーカスヒントを追加:
- Settlementファイル: 「焦点: 和解パターン、交渉戦術、治療タイムライン、時効管理、アジャスター行動、リーン解決」
- Closingファイル: 「これらはCLOSINGケースです。特に注目: ケースクロージングワークフロー、辞退理由、最終支払い、ファイルアーカイブ、クロージング後の義務、クライアント終了パターン」
- Intakeファイル: オンボーディング、保険確認、初期治療紹介に焦点 これによりパターン抽出の品質が大幅に向上します。
インデックス再構築
すべてのコンパイルバッチが完了した後、必ず別個のdelegate_taskとしてindex.mdを再構築します。小さなバッチでも同様です。サブエージェントは、concepts/ + connections/ 内のすべての .md ファイルからYAMLフロントマターを解析し、AGENTS.mdのスキーマに従ってインデックスを生成するだけです。所要時間は約60秒、max_iterations=15です。
Obsidian Vault
wiki/ ディレクトリはそのままObsidian Vaultです:
- .obsidian/ 設定、グラフ色(青=概念、橙=接続)
- Home.md がランディングページ
- [[wikilinks]] はスラッグ名を使用(パスプレフィックスなし)
- グラフビューで記事間の相互接続を表示
Wikilinkルール
[[concepts/slug-name]]ではなく[[slug-name]]を使用- Obsidianはファイル名で解決するため、パスではリンクが壊れる
コンパイル対象ケースのフィルタリング
2つのアプローチ — Excelファイルを直接使用する(推奨)か、Vaultをスキャンします:
推奨: Excelファイルから直接スラッグを抽出
# Excelを解析 → ユニークなProject Nameを取得 → スラッグ化 → バッチ化
wb = openpyxl.load_workbook(path, read_only=True)
cases = Counter(str(r[0]).strip() for r in list(wb.active.iter_rows(values_only=True))[1:] if r[0])
slugs = [{"slug": slugify(name), "logs": count} for name, count in cases.items()]
これにより、インポートされたものだけが正確にコンパイルされます。
フォールバック: サブカテゴリタグでVaultをスキャン
for slug in os.listdir(cases_dir):
for logfile in os.listdir(log_dir):
if "settlement_activity_export" in open(logfile).read(200):
new_slugs.append(slug)
break
mtimeベースのフィルタリングは使用しないでください — 変換中にディレクトリが touched された古いケースも含め、Vault内のすべてのケースを拾ってしまいます。
落とし穴
- 並列サブエージェントはevidence_countで競合状態を引き起こす — ±3の変動を受け入れる
- サブエージェントにindex.mdを書き換えさせない — 全バッチ後に自分で再構築する
- 大規模ケース(1000+ログ)は切り詰める必要がある — 戦略的にサンプリングする
- パスプレフィックス付きのWikilinkはObsidianで壊れる —
concepts/などを削除する - compile.pyスクリプトはプロンプトを生成するが、LLMを直接呼び出さない — delegate_taskを使用する
- 一部の記事は未作成の記事への有望リンクを含む — 問題ない。さらにケースがコンパイルされるにつれて作成される
- mtimeベースのVaultスキャンは機能しない 「インポートされたばかり」のケースを特定する場合 — 変換は既存のディレクトリにも触れる。常にExcelファイル自体からケースリストを抽出すること。
- Closingケースのほとんどは辞退であり、和解後のクロージングではない。辞退/クローズワークフローは、和解支払いワークフローではなく、クロージングデータから最も大きなエビデンスブーストを得る。
- 小規模バッチ(<10ケース) は、すべての89記事を読ませるとサブエージェントのイテレーションを使い果たす。代わりに特定の記事を指定すること。
複数ファイルワークフロー
ユーザーが複数のExcelファイルを送信する場合、最初にすべて変換してからコンパイルします:
- /tmp/convert_excel.py を再利用 — 各ファイルのファイル名だけを変更
- すべて変換した後、新しいケースのみをバッチ化(slugify + 存在確認を使用)
- 3つの並列バッチでコンパイルし、最後に一度インデックスを再構築
重複検出
ユーザーが同じファイルを2回送信する可能性があります(同じ名前、異なるドキュメントID)。変換前に、行数と最初/最後の行を比較して重複を検出します。
インポートのサイズ
- ファイル1 (settlement_1): 17.6Kエントリ、198ケース、6.2Kログファイル
- ファイル2 (settlement_2): 22.1Kエントリ、169ケース、7.3Kログファイル
- ファイル3 (settlement_3): 688エントリ、8ケース(小さい — シングルバッチ)
- ファイル4 (closing): 9.3Kエントリ、125ケース、2.9Kログファイル
- ファイル5~7 (アーカイブ2、3、4): 64.3Kエントリ、692ケース、21Kログファイル 合計取り込み: ~114Kエントリ、1,170ケース、~56Kログファイル → 93Wiki記事
推奨バッチ処理
- <20ケース: 単一サブエージェント、バッチ処理なし
- 20~300ケース: 3つの並列サブエージェント
-
300ケース: 3つの並列サブエージェント、積極的サンプリング(最初の10 + 最後の10)
- 全バッチ完了後に必ずindex.mdを再構築する(サブエージェントに触らせないこと)
落とし穴: mtimeベースのフィルタリングは信頼できない
ファイルのmtimeを使用して「新しい」ケースを見つけないでください — convert_excel.pyは既存のファイルにも触れます。代わりに、Excelから直接ケース名を抽出してスラッグ化し、ターゲットリストを取得してください。
ファイル
- FirmVault: /opt/data/FirmVault
- Wiki: /opt/data/FirmVault/wiki/
- スキーマ: wiki/AGENTS.md
- コンバーター: /tmp/convert_excel.py(実行間でファイル名を変更)
- 記事数: 65概念 + 28接続 = 93合計(2026-04-12時点)
- 決定事項: /opt/data/FirmVault/decisions/ (ADR-000 ~ ADR-006)
- 監査レポート: /opt/data/FirmVault/wiki/reports/workflow-vs-wiki-audit.md
- v2提案: /opt/data/FirmVault/wiki/reports/PHASE_DAG_v2_proposal.md
ワークフロー監査
大規模なコンパイルラウンドの後、PHASE_DAGに対してWikiを監査します:
- PHASE_DAG.yamlを読む(規定ワークフロー)
- すべてのWiki記事を読む(観測された現実)
- 比較: 矛盾、ギャップ、冗長性
- 監査レポートをwiki/reports/に書き込む
- 変更が必要な場合、PHASE_DAG v2提案をドラフトする
- 決定事項をdecisions/内のADRとして文書化する(stirps-ai/stirps-govから抜粋)
この監査により、93のWiki記事が実行可能なアーキテクチャ上の決定へと変わりました。Wikiはエビデンスであり、ADRはコミットメントです。