Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Select an option

  • Save dai/221318cbbcf0e82351a78170b46fc458 to your computer and use it in GitHub Desktop.

Select an option

Save dai/221318cbbcf0e82351a78170b46fc458 to your computer and use it in GitHub Desktop.
Inferal Workspace Architecture (Japanese)

Inferalワークスペースアーキテクチャ

AIが活用できる組織の脳

このドキュメントでは、Inferal Workspaceの概念アーキテクチャについて説明します。Inferal Workspaceは、NotionやWebflowなどのツールを置き換え、AIアシスタントにネイティブにアクセスできるように設計された、テキストベースのバージョン管理された知識および操作ハブです。

なぜこれを作ったのか

エンジニアリング主導の組織である私たちは、ツールを活用するどころか、むしろツールと格闘していることに気づきました。Notionは私たちの実際の仕事のやり方に対応できませんでした。ページ間にコンテキストが散在し、バージョン管理も機能せず、AIは読み書きはできても動作はしません。Webflowは、ウェブサイトがサイロ化され、コードベースやデプロイメントパイプラインから切り離された状態になることを意味していました。ツールはどれも別のタブ、別のコンテキストスイッチ、そして知識が失われていく場所でした。

そこで私たちは独自のオペレーティングシステムを構築しました。Inferal Workspaceは、シンプルなアイデアから始まりました。ドキュメント、コード、投資家向け資料、採用パイプライン、そしてウェブサイトまで、すべてがすでに作業しているGit上に保存されていたらどうなるだろうか?AIアシスタントがナレッジベースを検索するだけでなく、プルリクエストのマージ、会議のスケジュール設定、メールの作成、タスク管理など、実際に操作できたらどうなるだろうか?

これはサイドプロジェクトでも、私たちが「同時に」取り組んでいる社内ツールでもありません。これが私たちの会社の運営方法です。すべてのコミット、すべてのドキュメント、すべての決定はこのワークスペースを通して行われます。新しいメンバーが入社すると、彼らはリポジトリを1つクローンするだけで、すべてにアクセスできるようになります。Claudeがサポートしてくれる場合も、私たちと同じアクセス権が与えられます。このワークスペースは私たちと共に成長し、バージョン管理と監査が可能で、完全に私たちが所有しています。

私たちがこのアーキテクチャを共有するのは、企業運営の将来はSaaSダッシュボードよりもGitリポジトリに似ていると考えており、私たちと一緒にその将来を築きたい人材を募集しているからです。

このワークスペースは単なる社内ツールではありません。AIを組織とどのように統合すべきかという私たちの考えを実証する場です。ワークスペースをAIネイティブにするのと同じ原則が、Inferal自体の構築にも反映されています。

私たちが作っているもの:製品

Inferalは、データ スタックに不足しているレイヤーを追加します。つまり、データに対してビジネス ロジックを評価し、条件が満たされたときにアクションを自動的にトリガーするルール エンジンです。

AI業界ではエージェントについてよく議論されますが、多くの実装ではその逆になっています。つまり、ユーザーがエージェントを呼び出してコンテキストを与えなければならないのです。私たちは、データがエージェントを呼び出すべきであり、その逆ではないと考えています。システムに何か変化があった場合、何が起こったのか、そしてなぜ起こったのかが完全に透明化された状態で、適切な推論が自動的に実行されるべきです。

Inferalの基本原則:

  • エージェンシー - 状況に応じて行動し、状況に応じて行動するエージェント。事後対応型ではなく、先を見越した行動型です。
  • 明確さ - ビジネス ロジックがプロンプトに埋もれず、明確に表現されます。
  • 透明性 - すべての推論は追跡可能です。ブラックボックスはありません。

当社への参加に興味がありますか? 当社は、AI ネイティブ運用の未来を築きたいエンジニアを募集しています。

会話をスケジュールする →


今日のClaudeの使い方

このワークスペースは私たちが販売するものではなく、社内のOSです。私たちの理念を実践し、皆さんが働く環境を具体的に示すため、公開しています。


概要

Inferal Workspaceは、次の3つの主要機能を組み合わせています。

  1. ナレッジ管理 - ドキュメント、会議メモ、決定事項、運用ナレッジ用のYAMLフロントマターを備えたObsidian互換のマークダウン ファイル。

  2. マルチリポジトリ操作 - Gitワークツリーを使用して組織のGitHubリポジトリを統合的に表示し、複数のコードベースとブランチにまたがって同時に作業できるようにします。

  3. AI ネイティブ統合 - Claude に完全なワークスペース機能を公開するMCP(モデル コンテキスト プロトコル)サーバー。これにより、AIはリポジトリの検出、PRの管理、リンクの保存、会議のスケジュール設定、並行作業の調整を行うことができます。

アーキテクチャ 図解

╔════════════════════════════════════════════════════════════════════════════════════════╗
║  INFERAL WORKSPACE                                                                     ║
║  Your org's brain that AI can use                                                      ║
╚════════════════════════════════════════════════════════════════════════════════════════╝

                                     ╭─────────────╮
                                     │   HUMANS    │
                                     ╰─────────────╯
                                            │
             ╭──────────╮ ╭──────────╮ ╭──────────╮ ╭──────────╮ ╭──────────╮
             │ Obsidian │ │ Web UI   │ │ CLI      │ │ TUI      │ │ Editors  │
             ╰──────────╯ ╰──────────╯ ╰──────────╯ ╰──────────╯ ╰──────────╯
                                            │
╔════════════════════════════════════ STORAGE LAYER ═════════════════════════════════════╗
║ ╭──────────────────────────╮ ╭─────────────── repos/ ───────────────╮                  ║
║ │ docs/                    │ │  products        investors           │                  ║
║ │                          │ │  services        cap-table           │                  ║
║ │ Markdown + Frontmatter   │ │  internal        fundraising         │                  ║
║ │ (Obsidian-compat)        │ │  ────────────    ────────────────    │                  ║
║ ╰──────────────────────────╯ │  admin-ops       legal-docs          │                  ║
║                              │  run-books       contracts           │                  ║
║                              │  on-call         compliance          │                  ║
║                              │  ────────────    ────────────────    │                  ║
║                              │  hiring          research            │                  ║
║                              │  onboarding      experiments         │                  ║
║                              │  website         prototypes          │                  ║
║                              ╰──────────────────────────────────────╯                  ║
╚════════════════════════════════════ ──── Git ──── ═════════════════════════════════════╝

                                     ╭─────────────╮
                                     │   CLAUDE    │
                                     ╰─────────────╯
                                            │
╔══════════════════════════════════════ MCP LAYER ═══════════════════════════════════════╗
║ ╭──────────────────────────╮ ╭──────────────────────────╮ ╭──────────────────────────╮ ║
║ │ repos                    │ │ github                   │ │ links                    │ ║
║ │                          │ │                          │ │                          │ ║
║ │ discover & clone         │ │ PRs, issues              │ │ save URLs as markdown    │ ║
║ │ checkout branches        │ │ merge with checks        │ │ LLM categorization       │ ║
║ │ push changes             │ │ smart triage             │ │ auto-commit to docs/     │ ║
║ ╰──────────────────────────╯ ╰──────────────────────────╯ ╰──────────────────────────╯ ║
║ ╭──────────────────────────╮ ╭──────────────────────────╮ ╭──────────────────────────╮ ║
║ │ calendar                 │ │ gmail                    │ │ staff                    │ ║
║ │                          │ │                          │ │                          │ ║
║ │ schedule events          │ │ read & compose           │ │ tasks & deadlines        │ ║
║ │ find free time           │ │ smart draft/reply        │ │ weekly planning          │ ║
║ │ smart scheduling         │ │ bulk operations          │ │ team workload            │ ║
║ ╰──────────────────────────╯ ╰──────────────────────────╯ ╰──────────────────────────╯ ║
║ ╭────────────────────────────────────────────────────────────────────────────────────╮ ║
║ │ swarm                                                                              │ ║
║ │                                                                                    │ ║
║ │ parallel Claude execution across repos • batch code review • bulk analysis         │ ║
║ ╰────────────────────────────────────────────────────────────────────────────────────╯ ║
╚════════════════════════════════════════════════════════════════════════════════════════╝

                                            │
                    ╔══════════════ EXTERNAL SERVICES ═══════════════╗
                    ║ ╭────────────╮  ╭────────────╮  ╭────────────╮ ║
                    ║ │ GitHub     │  │ Google     │  │ Claude     │ ║
                    ║ │ API        │  │ APIs       │  │ CLI        │ ║
                    ║ ╰────────────╯  ╰────────────╯  ╰────────────╯ ║
                    ╚════════════════════════════════════════════════╝

キープロパティ

  • バージョン管理 - ドキュメントも含め、すべてがGitで管理されています。完全な履歴、差分、そしてプルリクエストによる共同作業が可能です。
  • テキストベース - YAMLフロントマター付きのMarkdownファイル。独自のフォーマットはなく、どのエディターでも動作します。
  • AIネイティブ - MCPサーバーはClaudeに全機能を提供します。AIはリポジトリの検出、PRの管理、リンクの保存、会議のスケジュール設定、並行作業の調整などを行うことができます。
  • マルチリポジトリ - Gitワークツリーを介して組織のリポジトリを統合ワークスペースとして管理します。異なるリポジトリにまたがる複数のブランチで同時に作業できます。
  • モジュラー - ニーズに基づいて有効化/無効化できる 7 つの独立した MCP サーバー: repos、github、links、calendar、gmail、staff、swarm。

デモ: ワークスペースでの一日

以下は、ワークスペース コンポーネントがどのように連携するかを示す架空の代表的なウォークスルーです。

朝: 追いつく

技術系創業者のSarahは、ターミナルでClaude Codeを起動し、一日を始めます。

Sarah: 「今日の私のお皿​​には何があるの?」

Claudeはカレンダーを確認し、すべてのリポジトリの (Open)PRをスキャンし、スタッフの作業計画を確認します。

Claude: 「午後2時から役員会議があります。レビューが必要な未解決のPRが4件あります。APIリポジトリに2件、モバイルアプリに1件、課金サービスに1件です。シリーズAデータルームの締め切りは3日後です。また、リード投資家から技術ロードマップについて尋ねるメールが届いています。」

午前中: 並列コードレビュー

Sarah: 「4つのPRをすべて確認し、主な変更点と懸念事項をまとめます。」

Claudeはswarmサーバーを使って、4つのPRすべてに同時に並行レビューセッションを開始しました。数分後:

Claude: 「完了しました。APIのPRは良さそうです。1つはレート制限を追加し、もう1つはタイムゾーンのバグを修正しています。モバイルのPRには、画像キャッシュで潜在的なメモリリークが発生しており、注意が必要です。課金のPRはサブスクリプションの更新ロジックを変更しています。収益に大きく関わるコードなので、注意深く確認することをお勧めします。」

Sarahは、Claudeに、メモリに関する懸念を指摘するモバイルPRのレビュー コメントを残すように依頼し、2つのAPI PRをマージすることを承認します。

午前遅く: 機能開発

Sarah: 「メインの課金リポジトリをチェックアウトしてください。支払い失敗通知用のWebhookサポートを追加する必要があります。」

Claudeは課金サービスのリポジトリをチェックアウトし、新しいブランチを作成します。Sarahは機能要件を説明し、ClaudeはWebhookハンドラーを実装します。エンドポイントの作成、再試行ロジックの追加、テストの作成です。エラー処理を改良するイテレーションを数回繰り返した後、Sarahは満足のいく結果を得ました。

Sarah: 「良さそうですね。これについてPRを作成してください。」

Claudeは変更をコミットし、ブランチをプッシュし、Webhookの実装とテスト範囲の概要を含むプル リクエストを開きます。

正午: 調査と文書化

Sarah: 「今朝、テクニカルデューデリジェンスに関する素晴らしい記事を読みました。資金調達の資料に保存しておきます。」

彼女はURLを貼り付けます。Claudeはlinksサーバーを使って記事を取得し、要点を抽出し、docs/fundraising/に分類して、gitにコミットします。すべて自動的に行われます。

Sarah: 「また、投資家のメールへの返信の下書きを作成します。質問があったことを認め、週末までにロードマップを準備することを伝え、それについて電話で説明することを提案します。」

Claudeはメールのスレッドを読んで、プロフェッショナルな返信の下書きを作成し、送信前にSarahが確認できるようにGmailの下書きとして保存します。

午後: リポジトリ全体のバグ修正

Sarah: 「日付のフォーマットに関するバグが複数のリポジトリに存在する可能性があります。EU ユーザーに対して日付が間違ったタイムゾーンで表示されています。日付のフォーマットを行っている箇所をすべて探し、タイムゾーンが正しく処理されているか確認してください。」

Claudeはswarmを使って全リポジトリを並列検索し、3つのサービスで日付フォーマットがユーザーのタイムゾーンを考慮していない箇所を7箇所特定しました。共有ユーティリティ関数を用いた修正を提案しています。

Sarah: 「すべて修正しますが、各リポジトリの変更を別のPRに入れて、個別にデプロイできるようにします。」

Claudeは、影響を受ける各リポジトリにブランチを作成し、修正を適用し、テスト スイートを実行し、3つの個別のPRを開いて、コンテキストの説明でそれらをリンクします。

午後遅く: 会議とデータルーム

Sarah: 「今週、投資家とロードマップについて話し合うために30分の時間を確保してください。木曜日は避けてください。その日はスプリントの計画期間です。」

Claudeは両方のカレンダーを確認し、重複する空き時間を見つけて3つの選択肢を提案します。Sarahはそのうち1つを選び、Claudeはビデオリンクと議題を記載したカレンダー招待状を作成します。

Sarah: 「データルームのチェックリストの状況はどうですか?」

Claudeは、データ ルームの資料が保存されている「投資家」リポジトリを確認します。

Claude: 「18のドキュメントのうち12は完了しています。不足しているのは、更新された資本政策表(法務部門の承認待ち)、過去2か月の財務諸表、および技術アーキテクチャの概要です。アーキテクチャ ドキュメントは、締め切りの3日後に提出してください。」

Sarah: 「私の作業計画にタスクを追加してください: データ ルームの技術アーキテクチャ ドキュメントを完成させます。優先度 1。」

Claudeはスタッフの作業計画を更新し、変更をコミットします。

一日の終わり: クイックCLIチェック

最後に、SarahはいくつかのCLIコマンドを直接実行して、全体的なステータスを確認します。

$ inferal repo status
api/main           ✓ clean, up to date
api/rate-limiting  ✓ merged, can remove
billing/main       ✓ clean, 2 behind
billing/webhooks   ● 1 ahead (PR #47 open)
mobile/main        ✓ clean, up to date

$ inferal pr list
#47  billing   webhooks        Payment webhook notifications
#45  mobile    fix-image-cache Fix memory leak in image cache
#44  billing   renewal-logic   Update subscription renewal
#41  api       tz-fix          Timezone handling for EU users
#40  web       tz-fix          Timezone handling for EU users
#39  mobile    tz-fix          Timezone handling for EU users
// 日本語
$ inferal repo status
api/main ✓ クリーン、最新
api/rate-limiting ✓ マージ済み、削除可能
請求/メイン✓クリーン、2つ後ろ
課金/ウェブフック ● 1件先(PR #47 オープン)
モバイル/メイン ✓ クリーン、最新

$ inferal pr list
#47 課金ウェブフック 支払いウェブフック通知
#45 mobile fix-image-cache 画像キャッシュのメモリリークを修正
#44 課金更新ロジック サブスクリプションの更新を更新
#41 api tz-fix EU ユーザー向けのタイムゾーン処理
#40 web tz-fix EU ユーザー向けのタイムゾーン処理
#39 モバイル tz-fix EU ユーザー向けのタイムゾーン処理

CIが成功したため、彼女はCLIからタイムゾーンPRを直接マージします。

$ inferal pr merge 41 --squash
✓ Merged #41 into main (squash)
$ inferal pr merge 40 --squash
✓ Merged #40 into main (squash)
$ inferal pr merge 39 --squash
✓ Merged #39 into main (squash)

このデモでは、ワークスペースがコード、ドキュメント、コミュニケーション、計画を統合する方法を示します。これらの統合には、手元のタスクに最も速い方法に応じて、Claudeとの自然な会話と直接のCLIコマンドの両方でアクセスできます。


参加しませんか

私たちは、AI時代のルールエンジン「Inferal」を開発しています。これは、自動化された意思決定に主体性、明確さ、そして透明性をもたらします。ここでご覧いただいたワークスペースは、私たちの会社の運営方法であり、働き方の未来に対する私たちの考え方を反映しています。

募集中。 以下のことにご興味をお持ちでしたら、ぜひご応募ください。

  • データスタックに欠けているレイヤーを構築する - ルールとリアルタイムデータが出会う場所
  • 拡張可能なデータベース、クエリエンジン、分散システム
  • AIの意思決定を透明化、監査可能、デバッグ可能にする
  • Rustでのシステムプログラミング

早い時間です。本当に早い時間です。でも、睡眠を最優先にしています。良い仕事は、燃え尽き症候群ではなく、休息した精神から生まれます。

話しましょう。

会話をスケジュールする →

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment