English · 日本語
将来構想¶
Bajutsu が向かう全体的な方向と、すべての方向が守るべき唯一の制約を扱うページです。個別の ロードマップ項目を横断する戦略的な概観であり、計画中のことだけでなく、各軸がすでにどこまで進んでいるかも 扱います。粒度の細かい優先順位付きバックログは roadmap に、今日の設計の根拠は
DESIGN.mdにあります。このページを読めば、各ピースがどう組み合わさるかを掴めます。 各計画の詳細は、リンク先を参照してください。
関連: concepts · drivers · selectors · roadmap · ロードマップダッシュボード → ホスティング
不変条件: 何が決して変わらないか¶
すべての将来方向は prime directive(CLAUDE.md · concepts · DESIGN §2)に照らして評価します。これらは以下のどの方向でも固定されたままです。
- AI は著者であり失敗時の調査役であって、決して判定者ではありません。 どの将来機能も、Tier-2 の
run/ 継続的インテグレーション(CI)ゲートに大規模言語モデル(LLM)を入れてはなりません。合否は常に 機械チェック可能なままにします。 - 決定性ファースト。 条件待機のみを使い(例外は、上限と理由を備え監査に列挙される明示的な
sleepステップだけです)、曖昧なセレクタは即失敗させます。どの新しい プラットフォーム、ホスト、オーサリングツールも、この原則を継承します。 到達範囲や利便性のために譲ることはありません。 - app-agnostic / backend-agnostic。 アプリ別、プラットフォーム別の差分は config と、
Driverや 環境の継ぎ目の背後に置きます。決定的コアはどこでも同じです。
どのロードマップ項目でも、判定基準は「AI をゲートの外に保ち、ゲートを決定的に保つか」です。この基準を 満たさない項目は、Tier 1(オーサリング)か triage(調査) というゲートの外側に属するか、そもそも Bajutsu に属しません。
成長の 3 軸¶
Bajutsu は 3 つの独立した軸に沿って広がります。3 軸は合成可能で(どれも他をブロックしません)、 それぞれが具体的なページに対応します。
Mermaid ソース
flowchart LR
core(["Bajutsu コア<br/>決定的 · app 非依存"])
reach["REACH<br/>より多くのプラットフォーム / 面<br/>Web · Android · Flutter / ハイブリッド<br/>→ 下記 §1"]
scale["SCALE & COLLABORATION<br/>ホスト / セルフホストのサービス · MCP<br/>→ roadmap: ホスティング(BE-0015 / BE-0016)"]
authoring["AUTHORING & 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 者は同期させます。