# tadori

> tadori is a ledger on git that links every sentence of a spec to its test cases, test runs, findings and preventive actions — by ID. Per-phase rules show where a link is missing (a "gap"), the remaining work to release, and who should write what, in which line of which file, to close each gap. Open source (MIT) desktop app (macOS, Windows) that runs on your own machine.

Japanese version: https://meta-taro.github.io/tadori/ja/

## Key points

- Links are decided only by the IDs written in the ledger, never by guesswork
- People confirm the gaps. tadori never decides that a gap has been fixed. Approvals and test results are recorded by people
- No percentages or scores. Only facts: what the gaps are and how many, pending approvals, statuses and days overdue
- No new source of truth: design documents and verification sheets stay in their own tools; the ledger only records where they are
- Data lives in TSV files in the project folder (managed with git). The screen opens only on your machine (127.0.0.1) and never syncs with outside services
- Four kinds of rule check: covered (has something downstream), refers (is based on something upstream), filled (a column is filled), approval (human approval)
- AI agents can read the usage guide, remaining work, gaps and links over MCP. With the agent cursor inside the app, an agent can point at the screen to guide people without using their mouse
- Daily progress per person (today, next working day, questions) is drafted from WBS status changes, ledger diffs and the check log. Each person reviews it and, with an agent over MCP, adds and edits rows and moves tasks forward
- Requires Node.js 22 or later. Installers for macOS (Apple silicon, Intel) and Windows (x64, ARM)

## Pages

- [Home](https://meta-taro.github.io/tadori/): features and FAQ
- [Download](https://meta-taro.github.io/tadori/download.html): installers per OS and CPU
- [Past versions](https://meta-taro.github.io/tadori/releases.html): list of released versions
- [Roadmap](https://meta-taro.github.io/tadori/roadmap.html): stages, and the condition for deciding whether to continue
- [Use case: missing post-change impact](https://meta-taro.github.io/tadori/cases/design-change-gap.html)
- [Use case: trace from an acceptance finding](https://meta-taro.github.io/tadori/cases/trace-from-finding.html)
- [Use case: starting before the previous phase is done](https://meta-taro.github.io/tadori/cases/early-start.html)
- [Use case: let an agent guide you](https://meta-taro.github.io/tadori/cases/agent-guide.html)
- [Use case: run daily progress with an agent](https://meta-taro.github.io/tadori/cases/daily-with-agent.html)

## Source

- [GitHub repository](https://github.com/meta-taro/tadori)
- [Usage guide (same content as the MCP tool how_to)](https://github.com/meta-taro/tadori/blob/main/packages/cli/guide.md)
- [Decisions and their reasons (Japanese)](https://github.com/meta-taro/tadori/blob/main/docs/decisions.md)