// tier: vasic-util-secondary · order 27

Herald activelicense: UNVERIFIED

GoShellClaude Code (LLM intent inference)Messenger channel adaptersDocs ChainHelix Constitution submodule

Source

• vasic-digital/Herald

// architecture

すべてのアラートは適切な宛先に届く——コマンド構文は不要。

Heraldはシステムイベントを取り込み、複数の通知チャネルに確実に配信することで、すべてのアラートが適切な場所に届くようにします。利用者は自然な言葉でやり取りし、Heraldは三段階のプロセス（コマンド高速パス→LLMによる意図推論→確認フォールバック）を通じて意図を解釈します。

イベント取り込みとマルチチャネル通知配信システム。Heraldはシステムイベントをメッセンジャーチャネル全体に確実にルーティングし、利用者が自然な言葉で対話できるようにします。意図の解決は、コマンド高速パス、LLMによる推論、そして確認・質問によるフォールバックという三段階で行われます。

Heraldは、システムイベントが実際に人間の手で対処できる場所に確実に届くことを保証する通知基盤です。これは地味ながらもミッションクリティカルなレイヤーであり、多くの自家製アラートシステムが静かに失敗する部分でもあります。Heraldはイベントを取り込み、複数の通知チャネルに確実に配信することで、アラートが見落とされたり、無効なチャネルに誤配信されたり、ノイズに埋もれて手遅れになるといったよくある失敗を防ぎます。しかし、確実な配信は半分に過ぎません。もう半分は、人間が応答したいときに何が起こるかです。Heraldは、利用者がアラートボットとのやり取りのために厳格なコマンド構文を覚えるという従来の妥協を拒否します。利用者は単に自然な言葉で書き込むだけで、Heraldは三段階のプロセスを通じてその意図を解決します。まず、明示的なコマンドを即座に認識する高速パス、次にLLM（Claude Codeを介した）による自由形式メッセージの意図推論、そして最後に、意図が本当に曖昧な場合には「確認」フォールバックが返信し、タグ付けして質問を投げかけます。この「認識→推論→確認」の階段構造こそが、設計思想の縮図です。一般的なケースは瞬時に確定的に処理され、柔軟なケースはモデルが対応し、不確かなケースは誤ったアクションを起こすような盲目的な推測で解決されることはありません。

Heraldは参加者と帰属のモデル化も行います。オペレーターのユーザー名環境変数（HERALD_<CHANNEL>_OPERATOR_USERNAME）と参加者・帰属の契約により、created_by/assigned_toフィールドと通知の@メンションが駆動され、誰が何をしたのか、誰に通知されているのかが明確になります。ガバナンス面では、HeraldはHelix Constitutionを同居サブモジュールとして継承し、そのルールに従います。また、Docs Chainの初期プロダクション利用者でもあり、66件のMarkdown→HTML/PDF/DOCXコーパス全体がDocs Chainのexec:変換を通じて接続され、クリーンな検証が行われています。Heraldは主にShell/Goツール群で構成され、仕様は段階的にバージョンアップ（V1→V2→V3→V4の置き換え）されており、メッセンジャーやLLM/エージェントディスパッチャー向けのチャネルごとのオペレーターセットアップガイドも用意されています。

アラートは静かに失敗します——誤ったチャネルに送られたり、配信されなかったり、利用者が覚えられない厳格なコマンド構文を要求したり。Heraldは、確実な配信と自然な言葉での応答を可能にすることで、通知を信頼性高く、かつ容易に対処できるものにするために開発されました。

コンテンツ

通常は別々の製品として購入される2つの機能――信頼性の高いマルチチャネル・イベントルーティングと自然言語インターフェース――を融合し、オペレーターが単に話すだけでソフトウェアがその意図を理解するシステムを実現しました。本番環境で信頼できる決め手は、明確化のためのフォールバック機能です。誤発報よりも確認を優先するアラートシステムだからこそ、実際の運用に組み込むことができるのです。

• 3段階のインテント処理：コマンド高速パス → LLMによる推論 → 確認・質問
• 自然言語によるサブスクライバーとの対話（コマンド構文の習得不要）
• created_by/assigned_toと@メンションを駆動する参加者帰属契約
• 本物のDocs Chainコンシューマー（66ドキュメントのコーパス、マルチフォーマット、検証済み）

• 自然言語インテントの曖昧さ：3段階の認識→推論→確認のプロセスにより、盲目的な推測を排除。
• 確実な配信：イベントの取り込みからマルチチャネル配信までの設計により、アラートが正しい宛先に届く。
• チャネルをまたいだ正確な帰属：オペレーターのユーザー名環境変数と参加者帰属契約により解決。
• ドキュメントの乖離：Docs Chainを通じたドキュメントコーパスの検証変換により解決。

• Go ― コアイベント／ディスパッチロジック（組織ごとの言語パターン対応）
• Shell ― オペレーター向けツールとセットアップスクリプト
• Claudeコード（LLM） ― フリーフォームメッセージ向けインテント推論層
• メッセンジャーチャネルアダプター ― マルチチャネル通知の配信
• Docs Chain ― ドキュメントビルド／検証パイプライン（Markdown→HTML／PDF／DOCX）
• Helix Constitutionサブモジュール ― 継承されたガバナンス／ルール