Concord

仕様を変えたら、
どこを直し、何をテストするか。

要件・実装・テストの対応をGitで管理し、変更差分から影響範囲と実行すべきテストを確認できる、開発チーム向けのCLIです。

要件を変更した開発チームは、関連する実装とテストをたどり、今回実行すべきテストを確認できます。

文書の閲覧ルールからテストまで
権限のない文書を閲覧できない
検索API検索結果から除外する
search.test.ts
詳細APIHTTP 404を返す
detail.test.ts

AIコーディングでも残る課題

AIが仕様書を読み、コードやテストを書けるようになっても、仕様と実装・テストの対応が文書や人の判断に任されていると、変更のたびにその関係を調べ直すことになります。Concordでは対応をGitに記録し、AIエージェントが更新案を作り、開発者がPRで妥当性を確認できます。

Concordは何を記録するか

Requirement要件
非公開文書は所有者だけが閲覧できる。
Contract契約
検索APIは閲覧できる文書のタイトルだけを返す。詳細APIは閲覧できない文書にHTTP 404を返す。
Property性質
認証済みの利用者は、自分が所有していない非公開文書を読めない。
Relation関係
各APIの契約と共通の性質を結び、その組み合わせに対応する実装コードとテストを記録する。
Concordの仕組みを見る

開発チームではどう使うか

仕様を変えるときは、関係する実装を把握し、コードを直す前にテストで何を期待するかをレビューします。まずは既存リポジトリの1機能から始められます。

concord plan
変更に対して選ばれたテストとその理由を確認する。
concord verify
対象のテストを実行し、結果を確認する。
concord explain
失敗したテストに対応する関係・契約・性質をたどる。
詳しい使い方を見る

利用例

公式サンプルでは、検索APIと詳細APIが同じPropertyと閲覧判定を使います。Gitの差分に応じて、concord plan が選ぶテストとその理由を比べます。

検索APIだけを変更

変更したファイル
src/search.ts
選ばれたテスト
  • tests/search.test.ts
選ばれた理由
検索APIの実装に紐づく Relation が、検索テストを選びます。

共通の閲覧判定を変更

変更したファイル
src/access.ts
選ばれたテスト
  • tests/search.test.ts
  • tests/detail.test.ts
選ばれた理由
変更した閲覧判定は共有Propertyの実装に登録されているため、両APIのRelationを通じて両方のテストが選ばれます。
公式サンプルを試す