helm — 機能ロードマップ

動機: すべての正典書き込みが「なぜ・いつ・誰の承認で」を後から辿れること（来歴）と、間違えても戻せること（可逆性）を保証するため。個人プレーンでは git commit がこれを無料で提供する — 別立てのトランザクションログを作らない。

しくみ: 提案 → ゲート → 可逆な適用（git commit）→ 来歴（commit trailer）→ 記録（次の git log/digest から可視）の5段階。commit prefix（feat: fix: docs: chore(schema): chore(lint): chore(session):）が「どんな変更か」を、trailer（Helm-Actor: Helm-Txn: Helm-Source:）が「誰が・何のために」を分担して記録する。バッチ書き込みは全スキル共通の Batch Approval Plan テンプレート（CREATE/UPDATE/COUNT）で提示 — 1件ずつでなくバッチ単位で承認する。

ゲート: 削除・verified 上書き・risk:high・外部送信・金銭は永久 L0（自動化不可）。

詳細: docs/spec/transaction.md

動機: 自律性を"証拠"に基づいて拡張するには、何が起きたかを AI の自己申告でなく機械的に記録する層が要る（進捗報告は自己批評でなく証拠と突合、が運用原則）。

しくみ: events テーブル1本（ts, type, actor, target, outcome, meta）+ system/spine/log-event.sh。SQLite はリポジトリ外（~/.helm/spine.sqlite）— 秘密でなく可変状態だから。fail-open 設計（sqlite3 が無ければ何もせず exit 0）、再帰ガード付き。

現状: スキーマとロガーのみ実装済み。フック（PostToolUse 等）への配線は未接続 — secrets runbook 完了とオートノミー・ラダーの解禁待ち。Mac mini への配備・Litestream 継続バックアップも未着手。

詳細: system/spine/README.md

詳細は 次章「Autonomy Ladder」を参照。

動機: 手で管理するフィールドを最小限にし、新鮮さ（freshness）や孤立度（isolation）のような派生値は保存せず都度計算する — フロントマターの二重管理を避けるため。

しくみ: 手で持つのは status と、高リスクページのみ risk/confidence。updated は内容変更でのみ bump（スキーマ修正・改名・移動では bump しない）。system/lint がこの模型を17ルールで検査（後述）。

動機: vault が過去・現在を記録するのに対し、期限・更新・カデンス・マイルストーンという「未来」を持つ一級のストアが要る。期日不明の項目は隠さず「要確認」として出続ける。

しくみ（現状）: memory/system/horizon/（horizon.md + obligations.md + ログ）への暫定 MD 台帳。カレンダー・メール更新通知の harvest で更新。行の削除は禁止、完了は Archived セクションへ移動。

目標（未構築）: 状態DBの horizon テーブルへ移行し、この MD フォルダは再生成可能なビューになる。専用スキルファイルは現状なく、dashboard/daily-log/weekly-review が読みに行く共有台帳という位置づけ。

目的: 憲法をセッション開始時に強制注入し、2台のマシン間で正典を自動同期する — 人間が commit/push を意識しなくてよい状態にする。

しくみ: inject-constitution.sh（SessionStart で憲法注入）、session-pull.sh（ff-only pull、fail-open）、session-commit.sh（Stop で dirty なら auto-commit + push、fail-open）。すべて HELM_HOOK_GUARD で再帰防止。

実例: 本セッション冒頭の system-reminder に憲法全文が注入されているのがこの機構の直接の証拠。

目的: Obsidian に依存せず、スキーマ違反（フロントマター不備・リンク切れ・構造問題）を機械的に検出・分類する。Autonomy Ladder のリング1のツール基盤。

しくみ: 4ファイル・17ルール（a-schema.js 必須項目/日付引用/廃止キー、b-links.js orphan/デッドリンク、c-structure.js ディレクトリ構造・命名、property-renames.js 旧キー統合）。すべての issue が tier（trivial/standard/review）を持ち、tier がレポート区分と自動適用可否を兼ねる唯一のモデル。_lint_skip: true が唯一のファイル単位オプトアウト。raw/** はスキーマ対象外。

実例: 2026-07-03、~/helm/memory 807ファイルの初回フルスキャンで trivial 681件・standard 2586件・review 1369件（計4636件）を検出。まだ --apply は未実行。

詳細: docs/spec/lint.md

目的: フォルダが肥大化しても「いつ分割し、いつそのまま持つか」を毎回考え直さずに済む一貫した基準を持つ。

しくみ: 4+ ファイル & 独自語彙で sub-wiki 昇格候補（c1-subwiki-threshold が review tier で検出、自動分割はしない）。最大4階層（Directory Depth Rule）。分類は階層でなくフロントマター（taxonomy ≠ sub-domain）。アーカイブは status: archived が既定、5+件で物理移動。

詳細: docs/spec/reorganization.md, docs/spec/wiki-conventions.md

目的: 取り込み（ingest）・引用付き回答・lint 実行という3つの vault 操作を、Batch Approval の一貫した契約の上で提供する。

しくみ: add-page はインタビュー→ドラフト→Batch Approval Plan 提示→承認で page + 親 index + log を1回のトランザクションで書き込み+commit。query-wiki は index-first walk→grep フォールバック→[[Page]] 引用必須、3ページ以上を統合した回答は wiki への昇格を提案。vault-lint は headless engine の薄いラッパー。

目的: 「3行で終わる日報」「月曜の振り返り」「1画面の現在地」という3つの定期リズムを摩擦なく回す。

しくみ: daily-log は3行契約 + streak を Horizon に反映。weekly-review は daily logs + Horizon + lint 差分から生成し停滞プロジェクトを検出。dashboard は morning-briefing を統合済み（2026-07-03）— カレンダー・メール件数・Horizon を1枚に再生成し、同一 claude.ai Artifact URL に上書き（iPhone から閲覧可）。目標の「状態プレーン PWA v1（Tailscale）」はまだ無く、これは interim 実装。

「5つのプリミティブ」章を参照。専用スキルファイルは無く、dashboard/daily-log/weekly-review が読みに行く共有 MD 台帳（memory/system/horizon/）。

目的: 「vault が知らないプロジェクトは存在できない」— 登記なきプロジェクトを助長しない。誕生時登記と終了時蒸留をセットで強制する。

しくみ: スキルファイルでなく会話パターンとして実装（「プロジェクト立ち上げ: <名前>。ゴールは◯◯。経緯は…。期限は△△」と言うだけ）。不足質問≤4問→Batch Approval→承認で projects/<slug>/PROJECT.md（チャーター）+ memory/work/<slug>.md（登記）+ 期限があれば Horizon 行 を一括作成。close は蒸留（結果・決定・学びの書き戻し）を経るまでアーカイブ不可。

実例: 2026-07-03、進行中プロジェクトの棚卸し retrofit で traffic-accident-2026 / email-migration / household-finance-automation の3件を登記。helm 自身も同じ契約の第一適用例として自己登記済み。

詳細: docs/runbooks/project-playbook.md

目的: 移動中・運転中・オフラインでも思いつきを取りこぼさず、単一ライター規律を保ったまま inbox に届ける。

しくみ: iPhone（Siri/ウィジェット/Watch/共有シート）→ Reminders リスト「helm Inbox」→ iCloud がオフラインキューを兼ねる → mini の launchd が30分毎に排水 → memory/inbox/brain-dump-YYYY-MM-DD.md（キャプチャ時刻を保持）→ 書き込み成功後にのみ Reminders 側を完了化（削除しない・可逆）→ chore(capture): commit。多重起動は lock dir でガード。

実例: 2026-07-03、dry-run で検証済み。launchd 本登録は TCC（オートメーション権限）の対話承認が必要なため次の mini セッションに持ち越し。

将来の合流先: Spine/PWA の自前 capture UI ができ次第、この経路と並走→置換判断。dashboard への排水件数タイル統合も予定。

詳細: docs/runbooks/capture-pipeline.md

目的: 最長3ヶ月滞留していた未返信をゼロに近づける。送信は事業の対外行為であり永久に人間ゲート（Autonomy Ladder の pinned-L0）。

しくみ: 2026-07-03、送信済み58スレッド（2026-01-01〜07-03）を3並列エージェントでマイニングし、文体ガイド・分類taxonomy・取引先台帳を正典化。L0（機械的フィルタ）/ L1（トリアージ）/ L2（本人文体の下書き半自動）/ L3（要人間）のレーンに分離。email-triage / email-respond スキルが実装層（v2 改修対象）。承認サーフェスは Gmail 下書きフォルダ（モバイルファースト — iOS/iPad 移動中の処理が主要ユースケース）。Gmail API は drafts.send（gmail.compose 最小権限）を採用、無人化（mini 直 OAuth）は Spine 合流後の v2。

実例: 前セッションで `search_threads` がスレッド内メッセージを全部返さない不具合（9通中5通のみ）を発見 — トリアージは必ず get_thread で全文確認する設計に修正。

helm 誕生以前から存在した個人スキル群。統治カーネル（Transaction/Ladder）の対象ではあるが、独立に運用中。invoice-generator は請求書/領収書/見積書 PDF を会社プロフィール（Private/ 配下）から自動生成。quest-tracker は LifeQuest ゲーム状態（4層クエストアーキテクチャ）を追跡。learn はセッションの学びを memory/rule/skill/hook の適所へ格納 — このドキュメント自体の生成もこの学習ループの延長にある。

目的: Hermes / OpenClaw のような外部エージェント基盤は「便利な常駐能力（capability convenience）」を最適化するが、helm は「証拠とともに拡大する信頼できる自律（trustworthy autonomy）」を最適化する。機能をそのまま輸入（ポート）すると前者の思想が混入するため、必ず5問で再基礎づけしてから採用する。

実例（初適用、Hermes、2026-07-03）: bounded memory → 「正典の実体化ビュー（各行が正典に遡れる）」に再設計。cron→messaging 配信 → 「通知は使い捨て surface、送信事実だけ Spine に記録」に再設計。skill 自己昇格 → 「_pending/ に証拠付き起票し人間昇格」に再設計。

詳細: docs/design/2026-07-03-adoption-doctrine.md