コンテンツにスキップ

English · 日本語

将来構想

Bajutsu が向かう全体的な方向と、すべての方向が守るべき唯一の制約を扱うページです。個別の ロードマップ項目を横断する戦略的な概観であり、計画中のことだけでなく、各軸がすでにどこまで進んでいるかも 扱います。粒度の細かい優先順位付きバックログは roadmap に、今日の設計の根拠は DESIGN.md にあります。このページを読めば、各ピースがどう組み合わさるかを掴めます。 各計画の詳細は、リンク先を参照してください。

関連: concepts · drivers · selectors · roadmap · ロードマップダッシュボード → ホスティング


不変条件: 何が決して変わらないか

すべての将来方向は prime directive(CLAUDE.md · concepts · DESIGN §2)に照らして評価します。これらは以下のどの方向でも固定されたままです。

  1. AI は著者であり失敗時の調査役であって、決して判定者ではありません。 どの将来機能も、Tier-2 の run / 継続的インテグレーション(CI)ゲートに大規模言語モデル(LLM)を入れてはなりません。合否は常に 機械チェック可能なままにします。
  2. 決定性ファースト。 条件待機のみを使い(例外は、上限と理由を備え監査に列挙される明示的な sleep ステップだけです)、曖昧なセレクタは即失敗させます。どの新しい プラットフォーム、ホスト、オーサリングツールも、この原則を継承します。 到達範囲や利便性のために譲ることはありません。
  3. app-agnostic / backend-agnostic。 アプリ別、プラットフォーム別の差分は config と、Driver や 環境の継ぎ目の背後に置きます。決定的コアはどこでも同じです。

どのロードマップ項目でも、判定基準は「AI をゲートの外に保ち、ゲートを決定的に保つか」です。この基準を 満たさない項目は、Tier 1(オーサリング)か triage(調査) というゲートの外側に属するか、そもそも Bajutsu に属しません。


成長の 3 軸

Bajutsu は 3 つの独立した軸に沿って広がります。3 軸は合成可能で(どれも他をブロックしません)、 それぞれが具体的なページに対応します。

三軸図。決定的な Bajutsu コアが、Reach(より多くのプラットフォーム / 面。Web、Android、Flutter / ハイブリッド)、Scale & collaboration(ホスト / セルフホストのサービス、MCP)、Authoring & maintenance(GUI エディタ、操作キャプチャ、ビジュアル回帰、自己修復 triage)の 3 方向へ独立に広がります。

Mermaid ソース
flowchart LR
    core(["Bajutsu コア<br/>決定的 · app 非依存"])

    reach["REACH<br/>より多くのプラットフォーム / 面<br/>Web · Android · Flutter / ハイブリッド<br/>→ 下記 §1"]
    scale["SCALE &amp; COLLABORATION<br/>ホスト / セルフホストのサービス · MCP<br/>→ roadmap: ホスティング(BE-0015 / BE-0016)"]
    authoring["AUTHORING &amp; MAINTENANCE<br/>GUI エディタ · 操作キャプチャ ·<br/>ビジュアル回帰 · 自己修復 triage<br/>→ roadmap §3, §6, §10"]

    core --> reach
    core --> scale
    core --> authoring

1. Reach:より多くのプラットフォームと面

Driver、環境、id 規約の継ぎ目は、設定で調整できるだけでなく 丸ごと差し替えられるよう作ってあります。 その結果、同じ決定的コアが今日すでに iOS、Android、Web を駆動しています。各プラットフォームが足すのは、 自分の actuator と環境、安定 id 規約だけです。iOS(XCUITest)、web(Playwright)、 Android(adb)backend はいずれも実装済みで、エンドツーエンドで検証されています (architecture → 実装状況参照)。Flutter は今では、この同じ iOS / Android backend にそのまま乗り、新しい actuator を必要としません(BE-0008)。

抽象はすでにプラットフォームの境界に沿った形をしています。 プラットフォーム固有なのは、次の 3 つの継ぎ目だけです。

  • UI を駆動する actuator(common/drivers/xcuitest.py、common/drivers/adb.py など)
  • boot / erase / launch を担う environment manager(iOS の common/backend_cli/simctl.py、Android の対応物)
  • 安定 id の規約(iOS の accessibilityIdentifier、Android の resource-id、web の data-testid。 concepts §4参照)

それ以外(シナリオ DSL、セレクタ解決、機械アサーション、orchestrator、証跡、レポータ)は、 プラットフォームを一切名指ししません。プラットフォームを 1 つ追加するとは、新しい三点セットを足すことであり、 コアを分岐させることではありません。設計は、2 つ目の iOS actuator(XCUITest)でもすでに同じことを行っています。

セレクタの可搬性が核心です。 シナリオがプラットフォーム間で可搬なのは、そのセレクタが id による 場合に限ります。各プラットフォームの accessibilityIdentifier に相当するものは、同じ Selector フィールドへ写像します。

Selector フィールド iOS Android Web
id(主) accessibilityIdentifier resource-id(Compose: testTag) data-testid
label(補助) accessibilityLabel content-desc / text アクセシブル名 / aria-label
traits(role フィルタ) UI traits widget クラス ARIA role

YAML のセレクタ { id: settings.reindex } はすでにプラットフォーム中立です。異なるのは、 backend がセレクタを満たすためにアプリ側のどの属性を読むかだけです。この違いは Driver の内部に閉じ、 シナリオには出てきません。

一点だけ事情があります。プラットフォーム本来の id 構文が、SPEC の id をそのまま再現できないことが あります。Android の android:id(Views)は . も - も許さないので、stable.refresh は stable_refresh として現れます。Driver の側で暗黙に書き換える代わりに、シナリオが id 候補のリスト (id: [stable.refresh, stable_refresh]。OR として照合)で差異を明示的に保ちます。この明示的な リストにより、showcase の共有シナリオが両 Android UI toolkit でそのまま走ります (BE-0221。scenarios参照)。

段階 範囲 状態
共有抽象 プラットフォーム対応の backend レジストリ + Environment Protocol 実装済み(BE-0042、BE-0009)
Web Playwright。既存の Linux ゲートで動き、Mac もエミュレータも不要 実装済み(BE-0041、BE-0054)
Android adb + UI Automator。座標駆動の backend 実装済み(BE-0007、BE-0208、BE-0209)
Flutter / ハイブリッド 新しい actuator や semantics ブリッジではなく、既存の iOS / Android backend 上の id 規約 実装済み(BE-0008)

Android のほうが座標駆動の backend に構造的に近いにもかかわらず、Web が先に出荷されました。Web は macOS も デバイスエミュレータも不要な唯一のプラットフォームで、初日から make check / CI ゲートの内側に収まったからです。この順序により、コアがプラットフォーム中立であることを最小 コストで証明できました。その後 Android が、一般化済みのコアの上で、同じ軽量な座標駆動のパスを裏づけました。 裏づけは、Android 専用のエミュレータ付きゲートによります。

プラットフォーム別の詳細は、drivers と ロードマップダッシュボード → プラットフォーム対応 を参照してください。

2. Scale & Collaboration:ローカルツールから共有サービスへ

bajutsu serve はローカルで動く単一ユーザのランチャとして始まりましたが、今では 共有サービス としても動きます。安価な Linux コントロールプレーン(認証、履歴、キュー、レポートビューア)を、 高価なデバイスワーカープールから切り離し、チームがブラウザから実行とレビューを行えるようにします。

  • BE-0015(公開 / クラウドホスティング) と BE-0016(セルフホスティング) はどちらも実装済みです。control-plane ⇄ Mac ワーカープールの分離、ジョブキュー、複数 org 対応、 そして公開時に必須となるセキュリティ堅牢化です。自前のハードウェアで今すぐ動かす方法は self-hosting を参照してください。
  • Model Context Protocol(MCP)サーバ(BE-0017) は実装済みです。run と doctor を MCP ツールとして、run の証跡を MCP リソースとして公開し、 エージェントが直接 Bajutsu を駆動できます。MCP サーバは Tier-1 の境界の内側に収まります。エージェントは 著者と調査役であり、ゲートは決定的なままです。

3. Authoring & Maintenance:テストを所有するコストを下げる

シナリオは、人間が所有するただの YAML です。この軸は、ゲートを一切緩めずに、書くコストと保つコストを 下げます。

  • グラフィカルユーザーインターフェース(GUI)エディタと非 AI 操作キャプチャ (BE-0012、 BE-0013)は bajutsu serve に実装済みです。シナリオを画面上で編集し、スクリーンショット上でセレクタを選び、 実際の tap や type を LLM なしでシナリオに取り込めます。
  • ビジュアル回帰アサーション(BE-0029) は実装済みです。新しい決定的アサーション種別(ベースライン差分。approve が新しいベースラインを 昇格します)です。AI が判定するのではなく機械がチェックするので、directive に適合します。
  • 自己修復 triage(BE-0021)は 実装済みです。AI が失敗証跡を読んで 最小差分を提案し、人間がレビューして --write で適用します。 コミット済みテストを自動で緩めないというガードレールが、自己修復 triage を directive の内側に保ちます。

この軸は今も広がり続けています。例えば、 ロードマップダッシュボード → オーサリング体験 に継続中の作業があります。ただし、基盤となる能力(画面上での編集、AI なしのキャプチャ、失敗の自己修復)は 3 つの面すべてですでに整っています。


3 軸すべてで固定されるもの

下表のすべては 共有され、決定的で、プラットフォームとホストに中立であり、Bajutsu が成長しても分岐しません。 この共有コアがあるので、3 軸は独立でいられます。各軸は縁を伸ばすだけで、コアには手を付けません。

固定コア どこ
シナリオのドメイン固有言語(DSL)と文法 scenarios · dsl-grammar
セレクタモデルと決定的解決 selectors
機械アサーション(唯一の判定者) assertions/ · concepts
observe → act → verify オーケストレータ run-loop
証跡サブシステム(capturePolicy / manifest) evidence
レポーター(manifest / JUnit / HTML) reporting
設定の階層(defaults × targets) configuration

新しいプラットフォームは、Driver の継ぎ目の背後に backend を足します。新しいホスティングは、run を どこで起動するかを変えるだけで、run が何をするかは変えません。新しいオーサリングは、同じ YAML を生みます。 コアは一定のままです。


各軸の現在地

このページがかつて推奨していた直近の順序(Playwright による Web、MCP サーバ、ビジュアル回帰 アサーション)は、いずれもすでに出荷済みです。scale 軸の公開・セルフホストの両トポロジーも、 authoring 軸の GUI エディタと非 AI キャプチャも同様です。Reach 軸で最後に残っていた Flutter (BE-0008)も、既存の iOS / Android backend 上の id 規約というかたちで出荷済みで、新しい actuator は増えていません。 そのため 3 軸とも、1 つの大きな残作業を中心にではなく、少しずつ広がり続けています。

次に何をやるかは、roadmap が優先順位付きの生きたバックログとして持っています。 このページが扱うのは根拠と方向性であり、順序付けではありません。ロードマップの項目が出荷されると、 architecture 実装状況へ移ります。3 者は同期させます。