愚直な協調ツール

人間とコーディングエージェントのチームのためのプロジェクト管理。トラッカーも、スプリントも、儀式もいりません。

npm install -g @haksolot/ank
npx skills add haksolot/ank

無料のオープンソース。Linux、macOS、Windows に対応。

  1. 01ルールを読むank context
  2. 02タスクを取るank claim
  3. 03コードを書くank log
  4. 04チェックを通すank done

エージェントは、あなたが決めたことを知らない

ルールはチャットや会議で決めたもの。エージェントはそれを見ていないので、破ってしまいます。

ank なら、ルールはリポジトリの中にあり、守るべきフォルダに結びついています。エージェントはコードを書く前に問い合わせ、そのルールを受け取ります。

src/auth/src/api/.ank/ADR-06d2TASK-820dsrc/ui/src/auth/**
Fig. 01ank context src/auth/ → ADR-06d2 + TASK-820d

信頼できる理由

  • ルールはコードについてくる

    TASK-820dTASK-357bADR-06d2ADRTASKglob src/auth/**

    ルールはフォルダに結びつく。そこに触れるタスクには、必ずそのルールが届く。

  • ゴールは動かせない

    TASK-820ddone_criteriasha256 94a1f6ank checkdone_criteria'≠

    タスクを取った時点で、完了条件は固定される。書き換えても意味はない。

  • 完了とは、チェック済みのこと

    proof 94a1f6auth-testsno-jwt$ ank done

    完了を決めるのはエージェントではない。ank がチェックを実行し、証明を残す。

コマンドは 6 つ

エージェントに必要なのはこれだけです。

ank01 → 06
  1. 01

    ank context <path>

    フォルダのルールとタスクを取得する。

  2. 02

    ank claim <id>

    タスクを取る。ほかのエージェントにも取得済みと見える。

  3. 03

    ank show <id>

    タスクを全文で読む。

  4. 04

    ank log "<message>"

    作業中にわかったことを書き留める。

  5. 05

    ank done

    ank がチェックを実行する。通れば、タスクは完了。

  6. 06

    ank release --reason "<why>"

    タスクを返す。理由を添えて。

ank ではないもの

  1. チケットトラッカーではない。 スプリントも見積もりもボードもありません。

  2. wiki ではない。 入れるのは、エージェントが守るべきこと、やるべきことだけです。

  3. セキュリティツールではない。 エージェントが道を外れないようにするもので、攻撃者は止めません。

ank をインストール

コマンドは二つ。Linux、macOS、Windows に対応。git が必要です。

npm install -g @haksolot/ank
npx skills add haksolot/ank