Concord

When a spec changes,
what should you update and test?

Concord is a CLI for development teams. It tracks how requirements, code, and tests relate in Git so you can see what a change affects and which tests to run.

When a requirement changes, trace the related code and tests before deciding what to run.

From document access rules to tests
Block access to unauthorized documents
Search APIExclude the document from results
search.test.ts
Detail APIReturn HTTP 404
detail.test.ts

What still takes work with AI coding

AI can read specifications and write code and tests. When the links between them are implicit, each change still means tracing them again. Concord records those links in Git so AI agents can propose updates and developers can review them in a pull request.

What Concord records

Requirement
Keep private documents visible only to their owners.
Contract
Search returns only readable titles. Detail returns HTTP 404 for unreadable documents.
Property
An authenticated viewer cannot read a private document they do not own.
Relation
Connect each API contract to the shared property, and record the corresponding code and tests.
See how Concord works

How development teams use Concord

When a specification changes, find the affected implementation and review what the tests should expect before changing the code. Start with one feature in an existing repository.

concord plan
See which tests were selected for the change and why.
concord verify
Run the selected tests and check their results.
concord explain
Trace a failed test back to its relation, contract, and property.
Read the usage guide

Examples

In the official sample, the search and detail APIs share a property and its access check. Compare the tests and reasons concord plan reports for each Git diff.

Change only the search API

Changed file
src/search.ts
Selected tests
  • tests/search.test.ts
Selection reason
The Relation tied to the search implementation selects the search test.

Change the shared access check

Changed file
src/access.ts
Selected tests
  • tests/search.test.ts
  • tests/detail.test.ts
Selection reason
The access check is registered on the shared property. Concord follows each API’s Relation and selects both tests.
Try the official sample