HELM / ARCHITECTURE

helm — Architecture Map

TWO PLANES · ONE KERNEL · AS-BUILT 2026-07-07 · GIT @dc54047

RUNTIME TOPOLOGY — tap a flow to trace it, tap a node for its role

フローを選ぶと経路がオレンジで点灯し、番号が処理順を示します。
EDGE — iPhone / MacBook / external
helm-app (iOS)capture · tasks · triage · WKWebView MacBook Claude sessionsinteractive skills Siri → RemindersPAUSED 07-07 Gmailexternal mailbox YOU — human gatesL0: send · money · delete
MAC MINI — single autonomous writer (launchd)
serve.mjs API:8437 · write queue · trailers collect → render15 min · zero-LLM triage propose/applyLLM propose · det. apply editorial-refreshclaude -p · lock+cooldown email-draft-batch30 min · drafts only helm-sendper-draft L0 send APNs pushnotify iPhone
STORES — two canons + generated
memory/ (git)canonical knowledge · MD JSON stateauto · annotations · editorial spine.sqliteevents · outside repo surfaces/generated · disposable GitHub mirroroffsite + failover
live LLM inside human gate (permanent L0) dormant / disposable

GOVERNANCE KERNEL — five primitives over every write

Transaction
LIVE · git = txn log

正典への全書き込みは 提案→ゲート→可逆適用→来歴→記録 の5段。trailer (Helm-Actor/Txn/Source) が「誰が・何を・なぜ」を刻む。

Event Spine
LIVE 07-07 · sqlite

API 書き込みと editorial-refresh が commit 毎にイベントを emit。AI の自己申告でなく機構が記録する。昇格エビデンスの土台。

Autonomy Ladder
ALL CLASSES L0

自律は操作クラス毎に実績で獲得。2失敗/10回で自動降格。次の一歩は週次 supervised lint batch(rung 1)。

Hygiene Model
LINT 17 RULES

スキーマ健全性は linter が機械判定(trivial/standard/review の3層)。鮮度・孤立は保存せず導出する。

Horizon
INTERIM MD REGISTRY

将来の義務台帳 + 期日横断。obligations.md + /horizon スキル。DB 化は Phase 2 トリガー待ち。

Proposediff / plan→ Gatehuman or ladder→ Applygit commit→ Provenancetrailers→ Signalspine event
L0human pre-apply提案のみ。永久L0: 外部送信・金銭・削除・verified 上書き・risk:high・ガバナンス自己変更
L1auto-reversible自動適用 + spine 記録(例: updated auto-bump)
L2auto + post-review夜間バッチ適用 → 翌朝レビュー(目標: trivial lint fix)
L3scheduled定期自律実行、人はレポートを読む(例: vault-first 参照)

SKILLS — 17 helm skills, grouped by loop (tap to expand)

スキルは「対話セッションの定型作業」。書き込み系はすべて Batch Approval / 人間ゲートを通る。グローバル配置(N8: helm は全セッションの root context)。
CAPTURE → KNOWLEDGE
triage-dumpキャプチャの山を捌く

brain-dump を task / log / horizon / wiki / discard に分類 → Batch Approval Plan → 承認 → 適用。アプリのイベント駆動 triage と同じ契約の対話版。

add-page新規ページ / 外部知識の ingest

憲法 §4 準拠の frontmatter で wiki ページを作成。status: draft で着地(verified 昇格は人間のみ)。親 index への登記まで含む。

query-wikivault への質問(Vault-First)

memory/ を出典付きで引用して回答。沈黙したトピックは ingest を提案。collect 段は vault-scout agent に下請け可能。

vault-lintスキーマ健全性の scan / fix

system/lint のヘッドレスエンジンを駆動。trivial は自動修正可、review は個別判断。rung 1 昇格のエビデンス収集場。

pending-triage_pending/ 130+件の消化

旧 vault から持ち越した未分類ページを段階的に正典へ登記 or 破棄。分類判断はユーザー確認付き。

hot-curatorhot.md の統合・削減

常時注入メモリ(3,000字上限)を「上限超過なら追加前に統合」。削除は人間ゲート。weekly-review からフックされる。

DAILY LOOP · FORESIGHT
daily-log日報(3行契約)

一言まとめ + 事実 / 気づき / 明日。19:45 までに3行。No Zero Days — 過去は埋め戻さない(今日 or 昨日のみ)。

weekly-review週次レビュー生成

週の実績を集約しレビューを生成。4回連続 no-edit 採用で L3 昇格候補。hot-curator への1行フック持ち。

horizon期日・予兆の outlook / harvest

obligations.md の 7/30/90日 outlook と、Gmail/Calendar/vault からの harvest(追加のみ L2 目標・削除は永久 L0)。要確認セルをゼロへ。

project-initプロジェクト誕生 / 終了

誕生時に memory/work/<slug>.md へ登記(経緯は verbatim 保存)、終了時は蒸留なしのアーカイブを拒否(project-close ゲート)。

EMAIL · PEOPLE
email-triage受信箱の仕分け

スレッドを要対応 / 待ち / 情報に分類しラベル付け。送信は一切しない。

email-respond返信下書き(固定フロー)

chat で提示 → 承認 → Gmail 下書き保存。送信・削除は永久 L0。文体は「既定より一段リーン」。

followup-sweep催促・未返信ループの検出

返信が途絶えたスレッドを検出し、催促案を添えて提示(PALM MOLD 等の未返信ループが対象)。

meeting-prep打合せ準備パック

相手の履歴・過去の決定・懸案を vault-scout で収集し、1枚の準備メモに。

OPS · SURFACES
dashboarddashboard / editorial の手動更新

editorial.json の編集部更新を対話で実施(アプリの pull-to-refresh と同じ検証器を通る)。

helm-doctorパイプライン不調の診断

launchd ジョブ・ロック・ログ・トークン失効を横断チェックし、原因と処方を返す。

surface-builder使い捨て HTML の生成(本ページ)

helm-ds v3 準拠の surface を surfaces/ に生成。gitignore・非正典・引用禁止。コンプライアンスチェックリスト付き。

AGENTS — read-only subcontractors

READ-ONLY
adversarial-reviewer — 敵対レビュー

大きな設計判断・アーキテクチャ選択・大型 Batch Approval・Helm-Txn: decision 行きの提案をコミット前に攻撃する。証拠付きの反論をランク順で返し、判定を出す。書き込み権限なし — 出力は提案の修正材料。

READ-ONLY
vault-scout — vault 調べ物の下請け

「vault は X について何と言っているか」を出典付きで返す。記録が無ければ記録なしと明言(幻覚で埋めない)。query-wiki / meeting-prep / followup-sweep の collect 段として、メインセッションの文脈を汚さずに動く。

スキル = 手順(対話の定型フロー、書き込みはゲート経由)。エージェント = 並列の読み手(調査・批判の下請け、常に read-only)。自律ジョブ = mini の launchd(素の file-IO + git のみ、Obsidian 非依存)。この3層は権限が交わらない。