このプロジェクトについて

T3Xは、コードではなく構造化状態のために設計されたバージョン管理システムです。これはコントロールプレーンとして機能し、人とAIエージェントが構造化成果物(通常はYAML)に対する変更を提案、検証、レビュー、コミットできるようにすると同時に、完全な来歴と可逆的な履歴を維持します。 中心となる考え方は、各状態遷移が以前の状態、提案された差分、チェック、根拠、実行者、証拠を記録し、監査可能な追跡記録を生成するというものです。T3Xは、基盤となる信頼できる情報源を失うことなく、構造化状態を人間が読める文書(例:技術PRD)として描画できます。 主な機能: - コミット前のレビュー:履歴が進む前に正確な差分を検査します。 - 決定論的な遷移:YOpsエンジンを介して、順序付けられたフェイルファスト操作を適用します。 - 付随するチェック:YSchemaを使用して検証と外部チェックを行い、失敗を隠しません。 - 来歴に富む意思決定:各変更はソース、根拠、実行者、証拠を結び付けます。 - 可逆的な履歴:以前の変更を消去せずに、構造化状態を比較、分岐、マージ、復元します。 - 人間とエージェントの統一された経路:エージェントの提案も人間の変更と同じレビュープロセスを経ます。 このプロジェクトはパブリックアルファ(v1.0.0)です。公開されているnpmサーフェスには4つのパッケージが含まれます: - @t3x-dev/local – ランチャー経由でT3Xをローカル実行します。 - @t3x-dev/yops – 宣言的なYAML操作を適用します。 - @t3x-dev/transition – プロトコルオブジェクトとコミットの完全性を検証します。 - @t3x-dev/yschema – 構造化状態を検証し、修正を生成します。 WebUI、API、CLI、MCP統合、ランナー、ストレージは内部またはプレビューのままであり、変更される可能性があります。 クイックスタートの選択肢: - ローカル評価:npx -p @t3x-dev/local t3x-local - ソースからの開発:リポジトリをクローンし、pnpm installを実行してから、pnpm dev:apiとpnpm dev:webuiを実行します(Node.js 20+とpnpm 10+が必要)。 - Dockerによるセルフホスト:.env.exampleを.envにコピーし、docker compose up -d --buildを実行します。 このシステムはApache 2.0の下でライセンスされています。詳細はドキュメント(https://docs.t3x.dev)で入手できます。デプロイ、制限、安定性、セキュリティ、およびコントリビューションに関するガイドも含まれます。