Repolode
truecourse-ai

truecourse-ai/truecourse

PRD、ADR、READMEからPlaywrightのE2Eテストを生成し、プロダクトとドキュメントの食い違いを検出します。

スター
538
フォーク
44
未解決の Issue
52
最終コミット
24 日前

これは何?

TrueCourseは、チームがすでに作成しているPRD、ADR、README、ドキュメントサイトなどを読み込み、主張の集合として整理します。次に、ユーザーがプロダクト内でたどるフローを洗い出し、実行中のインターフェースに対して各フローのテストを作成します。

テストが失敗した場合、プロダクトとドキュメントに食い違いが生じていることを示し、失敗したテストでは該当する主張を特定できます。テストはPlaywrightのspecとして記述され、それぞれに専用のシードデータが用意されるため、テスト間で状態を共有しません。このツールはClaude Codeのログインで利用でき、サインイン不要のローカルモードに加え、GitHub Appによるプルリクエストチェックにも対応しています。

このプロジェクトはTypeScript製で、pnpmモノレポとPostgreSQLを使用しています。MCPエンドポイントを公開しており、Claude Codeからワークスペースのドキュメント、フロー、実行結果、失敗内容を参照できます。

主な機能

  • 01PRD、ADR、README、ドキュメントサイトを、テスト可能な主張の集合に変換します。
  • 02実行中のプロダクトに対し、各ユーザーフローのPlaywright E2Eテストを作成します。
  • 03失敗したテストと、それに反する具体的なドキュメント上の主張を報告します。
  • 04GitHubでプルリクエストをチェックし、ドキュメントの食い違いやテストの失敗を検出します。
  • 05MCPエンドポイントを公開し、Claude Codeからワークスペースの結果を照会できるようにします。

ユースケース

  • プロダクトの動作が、PRDやユーザードキュメントの記述と一致しているか確認する。
  • アーキテクチャ決定記録と稼働中のシステムとの乖離を検出する。
  • マージ前に、プルリクエストでドキュメントに基づくチェックを実行する。

クイックスタート

  1. 1

    環境設定ファイルのサンプルをコピーする

    cp .env.example .env
  2. 2

    Docker ComposeでPostgresを起動する

    docker compose up -d
  3. 3

    依存関係をインストールする

    pnpm install
  4. 4

    開発サーバーを起動し、http://localhost:3000 を開く

    pnpm dev

使う前に知っておきたいこと

  • Claude Codeへのログインと、PATH上にclaudeバイナリが必要です。
  • truecourse npm CLIは非推奨となっており、メンテナンスされていません。
  • ee/コードを本番環境で使用するには、Enterpriseサブスクリプションが必要です。

収録されている特集

トピック

よくある質問

truecourse とは?
PRD、ADR、READMEからPlaywrightのE2Eテストを生成し、プロダクトとドキュメントの食い違いを検出します。 TrueCourseは、チームがすでに作成しているPRD、ADR、README、ドキュメントサイトなどを読み込み、主張の集合として整理します。次に、ユーザーがプロダクト内でたどるフローを洗い出し、実行中のインターフェースに対して各フローのテストを作成します。
truecourse は無料で使えますか?ライセンスは?
truecourse は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
truecourse は今もメンテナンスされていますか?
活発にメンテナンス中。truecourse の最終コミットは 2026年10月14日 です。
truecourse は何に使えますか?
プロダクトの動作が、PRDやユーザードキュメントの記述と一致しているか確認する。 アーキテクチャ決定記録と稼働中のシステムとの乖離を検出する。 マージ前に、プルリクエストでドキュメントに基づくチェックを実行する。
truecourse のインストール方法は?
環境設定ファイルのサンプルをコピーする: cp .env.example .env Docker ComposeでPostgresを起動する: docker compose up -d 依存関係をインストールする: pnpm install 開発サーバーを起動し、http://localhost:3000 を開く: pnpm dev
truecourse はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/truecourse-ai/truecourse

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト