kairo-tasknote

A context-gathering command for Kairo development work. It collects project rules, technology choices, existing specifications, design documents, and optionally related code into a note file.

In plain words
What is it for?
Use it before implementing a requirement to create or display docs/spec/{requirement}/note.md, including information from files such as CLAUDE.md, AGENTS.md, README.md, design documents, and the technology-stack document.
Why use it?
It gives later development work one organized reference instead of making the developer repeatedly search through project documentation and code.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/classmethod/tsumiki/kairo-tasknote
Clone the repo
git clone --depth 1 https://github.com/classmethod/tsumiki
Per session 38 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 3,133 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00038 $0.03133
Opus 5 $0.00019 $0.01566
Sonnet 5 $0.00008 $0.00627
Haiku 4.5 $0.00004 $0.00313

Measured 2d ago against content hash fbd6087782cc, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

kairo-tasknote scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

legacy/commands/kairo-tasknote.md · 341 lines

How it starts

The opening of the file, as written. The whole thing — 341 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Kairo開発の前にコンテキスト情報を収集し、開発に必要な情報をノートファイルにまとめます。

context

出力ディレクトリ="docs/spec" 要件名={{requirement_name}} 収集情報=[]

step

  • $ARGUMENTS がない場合、「引数に要件名を指定してください(例: ユーザー認証システム)」と言って終了する
  • $ARGUMENTS の内容と context の内容をまとめてユーザに宣言する
  • step2 を実行する

step2: 既存ノートの確認

  • {{出力ディレクトリ}}/{要件名}/note.md が既にある場合:
    • 既存ファイルの内容を表示
    • 終了する
  • 存在しない場合: step3 を実行する

step3: 開発コンテキストの収集

Phase 1: プロジェクト基本情報の収集

追加ルールの読み込み

  • CLAUDE.md ファイルが存在する場合は読み込み(技術スタック・制約)
  • AGENTS.md ファイルが存在する場合は読み込み
  • README.md が存在する場合は読み込み
  • docs/rule ディレクトリが存在する場合は読み込み
  • docs/rule/kairo ディレクトリが存在する場合は読み込み
  • 各ディレクトリ内のすべてのファイルを読み込み、追加ルールとして適用

Phase 2: 既存設計文書・仕様書の収集

既存の要件定義・設計書の検索

  • docs/spec/{要件名}-requirements.md: 統合機能要件
  • docs/spec/{要件名}-user-stories.md: 詳細なユーザストーリー
  • docs/spec/{要件名}-acceptance-criteria.md: 受け入れ基準
  • docs/spec/{要件名}-*.md: その他関連ドキュメント
  • docs/design/*.md: 設計文書ディレクトリ
  • docs/tech-stack.md: 技術スタック
  • 見つかったファイルをすべて Read ツールで読み込み

Phase 3: 既存実装の調査(オプション)

  • ユーザーに確認: 「既存コードベースの詳細分析が必要ですか?(y/n)」
  • 必要な場合のみ実行:
    • Task tool (subagent_type: Explore, thoroughness: medium) を使用して実装関連情報を探索
      • 類似機能の実装例を探索
      • ユーティリティ関数・共通モジュールを探索
      • 実装パターンやアーキテクチャガイドラインを特定
      • 依存関係やインポートパスを確認

Phase 4: Git情報の収集

  • git status で現在の開発状況を確認
  • git log --oneline -20 で最近のコミット履歴を確認
  • 既存のブランチ情報を確認

Phase 5: プロジェクト構造の把握

  • ディレクトリ構造を把握(主要ディレクトリのみ)

  • 設定ファイルの確認(package.json, tsconfig.json等)

  • step4 を実行する

step4: 収集情報の整理と保存

  • 収集した情報を <note_template> の形式で整理

  • 以下の内容を含める:

    1. プロジェクト概要
    2. 技術スタック
    3. 開発ルール
    4. 既存の要件定義
    5. 既存の設計文書
    6. 関連実装(オプション)
    7. 技術的制約
    8. 注意事項
  • Write ツールを使用して {{出力ディレクトリ}}/{要件名}/note.md に保存

  • step5 を実行する

step5: 完了報告

  • TodoWrite ツールで TODO ステータスを更新する

    • 現在のTODOを「completed」にマーク
    • コンテキスト収集フェーズの完了をTODO内容に反映
    • 次のフェーズ「要件定義作成」をTODOに追加
  • 完了報告を表示:

    • 収集したファイルの一覧
    • プロジェクトの概要サマリー
    • 作成したノートファイルのパス

rules

ファイル名のルール

出力ファイルのパス形式

  • docs/spec/{要件名}/note.md
  • 例: docs/spec/user-auth-system/note.md

Read the full file on GitHub · 341 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 341 lines · 38 tokens per session scan A fbd6087782cc

Subscribe to this mod's changes

kairo-tasknote is a command published in the GitHub repository classmethod/tsumiki (974 stars, last pushed 25d ago), licensed MIT. It adds 38 tokens to every session and 3,133 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.