tsutome

エージェントが仕事をする時代の、オープンソースのタスク管理

ルールから生まれ
証拠で閉じる務め

tsutome(つとめ)では、タスクは誰も書きません。ルールが「何のあとに、何を、いつまでに」を定め、記録が「何が起きたか」を示します。tsutome はこの二つを読んで、いま何が期限か、誰の務めか、期限内に済んだかを出します。務めはチェックを付けて閉じるのではなく、実際に行われたことが記録に載ると閉じます。

導入のご相談 GitHub で見る

現在 0.1 系。npm install -g tsutome で使えます。

なぜ、いま tsutome なのか?

規程は、書いただけでは守られない

「回答後30日以内に削除する」と規程に書いても、30日後にそれを思い出す人はいません。誰かがタスクを起こし、期限を覚え、終わったら閉じる。この手作業が抜けたところから、規程と実際がずれていきます。

チェックを付けても、済んだことにはならない

タスク管理ツールの「完了」は、誰かがそう押したという記録です。本当に削除されたかどうかは、別に確かめるしかありません。tsutome の務めは、削除が行われたという出来事が記録に載ったときにだけ閉じます。

決めるのは人、動くのはエージェント

期限を見に来る、担当に知らせる、実行する、記録する。これはエージェントに任せられます。ルールの採用、実行の承認、務めの保留は人が行い、誰が行ったかが記録に残ります。

3分でわかる仕組み

問い合わせに回答したら、その内容を30日以内に削除する、という規程を例にします。

人が採用したルール 一本の記録(チェーン) 務め期限と担当 エージェント、業務システム 採用を記録 読んで計算 起きたことを追記 務めは保存せず、記録から計算する
  1. ルールを書き、人が採用する

    規程の条文を、条件つきの Markdown ファイルにします。エージェントが下書きを作れますが、人が tsutome adopt で採用するまで何も生みません。採用すると、ルールの条件とファイルのダイジェストが記録に入ります。

  2. 出来事が記録されると、務めが生まれる

    問い合わせ q1 に data.answered が記録されると、q1 の data.deleted が30日以内に続かなければならない、という務めが生まれます。誰もタスクを起こしません。務めは保存されず、記録を読むたびに計算されます。

  3. エージェントが見に来て、知らせる

    期限の7日前に務めが期限に入ります。エージェントは定期的に tsutome agenda を呼び、担当の support に知らせ、削除の承認を取ります。期限を過ぎると legal に知らせます。

  4. 行われたことが記録されると、閉じる

    承認のあと削除が行われ、data.deleted が記録されると、務めは閉じます。期限内なら done、過ぎていれば done_late です。tsutome audit が、承認なしに行われたことや期限を過ぎたものを報告します。

ルールは、人が読めるファイル

冒頭に条件、その下に規程の文言を書きます。法務の担当者が読んで確かめられ、変更は差分で見られます。

---
id: delete-after-answer
title: 回答後30日で削除
source: 個人情報取扱規程 第12条 第1項
when: data.answered
expect: data.deleted
within: 30d
notice: 7d
owner: support
escalate: legal
approval: required
where:
  form: contact
---
お問い合わせの内容は、回答が完了した日から30日以内に削除する。

ある対象に data.answered が記録されると、同じ対象の data.deleted が30日以内に続かなければなりません。7日前に務めが期限に入り、support に知らせます。期限を過ぎると legal に知らせます。削除の前に、人が承認します。

when、expect期限の起点になる出来事と、そのあとに続くべき出来事
within期限。30d、12h、45m
notice期限のどれだけ前に務めが期限に入るか。省くと最初から
owner、escalate動くべき担当と、期限を過ぎたときに知らせる相手。人の名前ではなく役割で書く
per対象を表すキー。値の組み合わせごとに一つの務めになる。device, advisory と書くと、機器と勧告の組ごと
approvalrequired なら人の承認が先に要り、承認なしの実行は指摘になる
whereこの値に一致する出来事だけを起点にする

承認なしの実行も、止まったエージェントも、あとから分かる

ルールも、承認も、行われたことも、すべて一本の追記専用の記録にあります。記録を持つ人は誰でも同じ務めを計算できます。

承認と、実際に行われたことを突き合わせる

承認を記録するとき、承認した計画のダイジェストが残ります。tsutome audit は、ルールの求める承認なしに行われたことや、承認された計画と違うことを、記録の行番号つきで報告します。

見に来なくなったエージェントが分かる

エージェントがやるべきことを見に来るたびに、そのことが記録されます。止まったエージェントは、記録が途切れることで分かります。

昨日の期限を、今日こっそり変えられない

ルールのファイルを変えても、もう一度採用するまで何も変わりません。すでに始まっていた務めは、始まったときの版のままです。記録は deedlog のチェーンなので、署名し、連署を受け、誰でも検証できます。

tsutome は門ではありません。エージェントが承認なしに動くことを止めることはできず、あとから示します。事前に止めたい場合は、エージェントと道具の間にポリシーの門を置いてください。また、記録は報告されたことです。重要なところでは、エージェント以外のもの(MCP の中継や、システム自身の監査ログ)に記録を書かせてください。

記録に入るもの、入らないもの

入らないもの

  • 個人情報。記録にあるのは出来事の名前と識別子だけ
  • 承認した計画や、保留の理由の文面(入るのはダイジェスト)
  • 推測できる識別子。受付番号などは HMAC にして記録できる

入るもの

  • 採用したルールの条件と、ファイルのダイジェスト
  • 起点になる出来事と、務めを果たした出来事
  • 誰に知らせたか、誰が承認したか、誰が保留を認めたか
  • エージェントがやるべきことを見に来たこと

状態はこの記録とルールのファイルだけです。データベースもサーバーもありません。

タスク管理ツールとの違い

一般的なタスク管理(チケット)tsutome
タスクを作るのは人。起こし忘れると存在しない誰も作らない。ルールと出来事から生まれる
閉じるのは誰かが「完了」を押したとき期待する出来事が記録に載ったとき
期限あとから編集できるルールと起点の出来事から決まる。変えるにはルールを採用し直す
状態の置き場所ツールのデータベース保存しない。記録から毎回計算する
規程とのつながり担当者の頭の中か、別の文書ルールのファイルに条文と出典がある
承認コメントやステータスの変更誰が、どの計画を承認したかを記録。承認なしの実行は指摘になる
外から確かめるツールの管理者を信頼する記録を持つ人は誰でも同じ結果を計算できる
費用の構造利用者ごとの月額ソフトは無料(Apache-2.0)。設計と組み込みは自前か支援を依頼

導入に必要なもの

役割ごとに、持つものと行うことを分けて示します。新しく動かすサーバーはありません。

ルールを決める人(法務、管理者)

  • 規程の条文を、条件つきの Markdown ファイルにする。エージェントに下書きを作らせてもよい
  • tsutome check で誤りを確かめ、tsutome adopt で採用する
  • 期限を過ぎたときに知らせを受ける。保留(例外)を認めるのもこの役割

担当者(務めを負う役割)

  • エージェントから知らせを受ける
  • 承認が要るルールでは、実行の前に計画を確かめて承認する
  • 承認は、組織でいま使っている道具(チャット、ワークフロー)で取ってよい

エージェント

  • スケジュール実行(Claude や ChatGPT のスケジュール、cron など)で tsutome_agenda を呼ぶ
  • 担当に知らせ、承認を取り、対象のシステムの道具で実行する
  • 行ったことを記録する。務めの保留は申請できるが、認めるのは人

現在のバージョンでできること

できること

  • ルールのファイルの検査、採用、廃止。採用していない変更の検出
  • 務めの計算(待ち、期限に入った、期限超過、完了、遅れて完了、保留、取り下げ)
  • 知らせ、承認、保留の記録と、監査(tsutome audit)
  • コマンドライン、MCP サーバー、ライブラリ(Node.js)
  • deedlog のチェーンとしての記録。dlog で署名、連署、検証ができる

しないこと

  • エージェントを動かすこと。エージェントの側のスケジュールを使う
  • 通知を送ること、承認を取ること。組織でいま使っている道具を使う
  • 仕事をするシステムを呼ぶこと。そのシステムの道具を使う
  • 承認なしの実行を事前に止めること。あとから示す

技術者向け

npm install -g tsutome

tsutome check rules/delete-after-answer.md
tsutome adopt rules/delete-after-answer.md --by legal --name example.com/duties
tsutome record data.answered -m item=q1 -m form=contact --by support
tsutome agenda
tsutome approve DUTY --by support --plan plan.txt
tsutome record data.deleted -m item=q1 --by agent
tsutome audit
インストール
npm install -g tsutome。Node.js 20 以上。記録は tsutome.jsonl、ルールは rules/。--chain と --rules(TSUTOME_CHAIN、TSUTOME_RULES)で変えられます。
コマンド
check / adopt / retire / rules / record / duties / duty / agenda / told / approve / except / unexcept / audit / verify。audit は指摘があれば終了コード 1 を返すので、CI や cron に置けます。
MCP サーバー
tsutome-mcp。tsutome_agenda、tsutome_record、tsutome_told、tsutome_draft_rule、tsutome_request_exception など。人の承認を記録する tsutome_approve は、サーバーを TSUTOME_APPROVER つきで起動したときだけ使えます。
務めの状態
notice までは waiting、そのあと due、期限を過ぎると overdue。期待する出来事が記録されると done か done_late。人が保留すると excepted、ルールが廃止されると withdrawn。
あとから採用したルール
すでにあった対象にも当てはまり、期限は採用の時点から数えます。ルールのファイルを変えても、採用し直すまで何も変わりません。
記録の形式
deedlog のチェーン(JSON Lines)。tsutome は追記し、dlog がチェックポイントに署名し、連署を受け、検証します。識別子は --hmac item=Q-0001 で HMAC にできます。
ライセンス
Apache-2.0。GitHub と npm。
関連
記録そのものは deedlog。フォームの入力を暗号化したまま保管する shinten、顧客情報を持たない共通ポイント kangoh も、同じ「必要以上に持たない」設計の姉妹プロジェクトです。

導入のご相談

規程からルールへの落とし込み、エージェントや既存システムへの組み込み、承認の流れの設計についてご相談ください。ソフトウェアは無料で使えます。費用がかかるのは設計と組み込みの支援です。

送信された内容は、お問い合わせへの対応にのみ使用します。このサイトには保存されません。取り扱いは プライバシーポリシーをご覧ください。