メインコンテンツへスキップ
見出し画像

Claude Codeで案件を回す、1案件1枚の型


    Claude Codeで案件を回す、1案件1枚の型

    案件のメモに「稼働中」「交渉中」と書いていた僕の案件22件のうち、16件は、TODOの一覧に1行も出ていませんでした。

    性質の違う案件を3本以上抱えて Claude Code に手伝わせていると、決めたことと宿題が散らばっていきます。チャットに、AIの記憶に、自分の頭に。新しいセッションを開くたびに、案件の説明をやり直していませんか。

    この記事では、案件の事実を1案件1枚に書き、一覧と点検は機械に作らせる型を、僕の失敗と実測つきで渡します。

    画像

    1案件1枚とは、案件ごとにファイルを1つ決め、段階・決めたこと・TODO・担当をそこにだけ書くやり方のことだ。

    この記事は、Claude Code でのプロジェクト管理(案件管理)の話です。Claude.ai の「プロジェクト」機能の話ではありません。

    Obsidian がなくても使えます。チームに広げる前に、まず自分の案件で試したい人にも向けて書きました。ここに書くのは、僕個人の運用の記録と見解です。

    この記事でわかること

    • 「自動で集まる一覧」を作ったのに、動いている案件のTODOが見えなかった本当の理由

    • 案件の事実をAIの記憶に置かない理由(公式ドキュメントの上限と、僕の記憶の索引の実測)

    • AIの記憶(auto memory)を無効にした Claude Code が、1枚を頼りに12項目すべてに根拠を付けた引き継ぎテストと、そこで見つかった抜け

    • 自分の案件で15分で試せる、引き継ぎテストの指示文と判定のしかた

    • 半年回して、僕の運用にまだ残っている穴

    • 後半(有料):1枚のテンプレート、案件名を並べない一覧のクエリ、読むだけの点検スクリプト、棚卸しと議事録の指示文


    Claude Codeのプロジェクト管理で、動いている案件のTODOが自作の一覧に1行も出ていなかった

    6月に出した記事で、僕はこう書きました。

    各案件のノートに散らばるTODOを、ひとつの一覧へ自動集約します。元のメモが正、一覧は自動生成なので、二重管理が起きません

    「僕がAIにやらせている仕事100選」の67番目です。半分は合っていて、半分は違いました。

    TODOの一覧は、Obsidian(Markdownで書くメモアプリ)の Tasks というプラグインで作っていました。各メモのチェックボックスのうち、TODOの印を付けた行を集める仕組みです。

    印は行の末尾に付けるタグで、この記事では #todo と書きます。集める部分は、たしかに自動です。

    ところが、当時の一覧ファイルを git(変更の履歴を残す仕組み)でさかのぼってみました。案件名のタグで絞り込む条件の塊(区画)が6つ、手で並べてありました。

    区画を足さないかぎり、新しい案件のTODOは案件の区画に出ません。ほかの区画が拾えたのは、期限を過ぎた行と、案件名のタグを付け忘れた行だけでした。

    秋には、溜まったTODOをAIと1行ずつ見直す棚卸しをしました。その直前の区画は7つです。

    ここまでなら「区画をやめて条件で集めれば直る」話で、実際にそう直しています。ただ、棚卸しで見つかったのは、もっと手前の穴でした。

    棚卸しの直前の状態を、git で数え直しました。案件ごとの1枚として僕が使っている _INDEX.md は、34枚。

    冒頭にある段階の欄(stage)が「稼働中」か「交渉中」の案件は、括弧で補足を足した書き方も含めて22件ありました。

    その22件のうち16件は、フォルダのどこにも、TODOの印を付けた未完了の行がありませんでした。

    一覧は、印の付いた行を集める作りです。だから16件は、一覧に1行も出ていませんでした。

    16件を1件ずつ確かめると、11件は、段階の欄のほうが古くなっていました。案件はもう終わっていたか止まっていたのに、欄だけが「稼働中」「交渉中」のまま。

    残りの5件は、見直してもまだ続いている案件です。うち4件は、次にやることをチェックボックスで書いていて、印だけが抜けていました。

    最後の1件は、フォルダに未完了のチェックボックスが1つもない状態でした。この5件には、その日のうちに印つきのTODOを入れています。

    16件全体で見ると、10件はTODOや次にやることの節に未完了の行があるのに、印だけが付いていませんでした。

    印のないものも、書かれていないものも、どの一覧にも出ない。

    一覧をどれだけ自動にしても、ここは直りません。必要だったのは逆向きの点検です。「動いているのにTODOが0件」の案件と、印のない行を、機械に探させること。


    原因はAIではなく、案件の事実の置き場所だった

    画像

    振り返ると、案件ごとの _INDEX.md は、このときすでに34枚ありました。それでも案件の事実は、1枚の外の3か所に散っていました。

    1つは、手で並べた一覧です。案件の区画も、案件の状態を手で書いた表も、案件が増えたり状況が変わったりするたびに、人が直さないと古くなります。

    もう1つは、AIの記憶です。Claude Code には、会話から学んだことを自分で書き残す auto memory という機能があります。ここに案件の状況を書かせても、一覧は拾いません。

    残りは、相手とのチャットと僕の頭の中でした。段階を直した11件も、1枚ではなく、相手とのやり取りや入金の記録、フォルダの動きを見て確かめています。

    そこで、1枚の外に散っていたものを1枚に寄せ、次のように決めました。

    • 案件の事実(段階・決めたこと・TODO・担当)は、その案件の1枚にだけ書く。例外は会議で出たTODOで、その案件の議事録に置いたままにする

    • 一覧は、案件名を並べずに「案件フォルダの中にあるTODO」という条件で機械に集めさせる

    • 週に1回、「動いているのにTODOが0件」の案件と、印のない行を機械に探させる。直すのは人

    CLAUDE.md(Claude Code が起動時に読む指示ファイル)は、道案内役にします。「TODOは各案件の1枚に書く」と、場所だけを書く。案件の中身は書きません。

    いちばん上のフォルダ(ルート)に置いた CLAUDE.md は、いま91行です(2026年10月13日に数えた)。5月に「日付・件数・TODOの数のような変わる中身は書かない」と1行足しました。

    それから案件の _INDEX.md は7枚から41枚に増えましたが、CLAUDE.md は90〜96行のままです。

    案件が増えても、道案内は増えない。


    Claude Codeの記憶に案件を覚えさせるのを、やめた理由

    正直に書くと、3月の僕は逆のことを勧めていました。「今週のプロジェクト状況」や「進行中の案件の状態」は、AIの記憶の索引(MEMORY.md。起動時に読まれる目次のファイル)に書く、と。

    「コード0行でAIに記憶を持たせた設計図」と「453ファイルが勝手に育つVaultの設計図」で書いた内容です。

    半年使って、考えを変えました。

    いちばん大きいのは、起動時に読まれる量に上限があることです。

    公式ドキュメントによると、起動時に読み込まれるのは索引の先頭だけです。200行または25KBのうち、先に達した上限で切れます。個別の記憶ファイルは、必要になったときにだけ読まれます(公式:Claude Code の memory)。

    僕の以前の索引は、346行・96,758バイトありました。25KBで切られるので、起動時に読まれるのは先頭の約4分の1です。残りの4分の3は、書いてあるのに読まれていませんでした。

    いまの Claude Code では、索引が上限を超えていても、書き込み自体は成功します。ただ、上限から先は次の起動で読み込まれないので、索引を書き直すよう AI にエラーで促す作りです。

    もう1つは、記憶がPCごとに保存されることです。同じページによると、記憶はそのPCの中だけにあり、別のPCとは共有されません。2台目のPCや一緒に働く人のAIは、その案件を知らないわけです。

    記憶に書いたTODOは、一覧にも点検にも出ません。どの一覧の条件(クエリ)にも拾われないからです。

    いま記憶に残すと決めているのは、どの案件でも使うものです。書き方の好み、ツールの癖、繰り返した失敗とその防ぎ方。それに、どのファイルが正本(正しいとみなす元のファイル)かという道案内です。

    案件の状態は、案件の1枚に書きます。ただし、この切り替えはまだ終わっていません。数字は、このあとの「まだ直っていないこと」の節に書きます。


    棚卸しのほかに壊れたこと:人の名前、警告、自由に書いた欄

    人の名前を、取り違えたこともあります。AIに案件の1枚を更新させていたとき、AIがチャットの表示名から相手の名前を推測して書きました。実在しない人名が、1枚に残っていました。

    画面では「知らない人が担当になっている」「同じ人が2人いる」と見えます。表示名と正式な名前は、対応表で持っておくべきでした。

    警告も、放置しました。Vault(Obsidian で開いているメモのフォルダ全体)を週に1回点検するスクリプトを、4月から動かしています。

    4月半ばから数えて26週。レポートが出たのは22週で、出た24本はすべて「WARN(要対応)」でした(2本出た週が2回あります)。

    鳴りっぱなしの警報は、読まれなくなる。

    その中に、稼働中の案件の1枚で、冒頭の欄(frontmatter。段階などを書くところ)が壊れているという警告がありました。

    直したのは、レポートに出てから約3週間後の棚卸しの日です。その間、その案件は、案件を段階ごとに自動で並べる画面(ダッシュボード)の「稼働中」の表に出ていませんでした。

    点検そのものも止まっていました。レポートが出なかった4週のうち2週は、直近の2週です。止まったことに気づくための見張りは、この記事を公開した日に入れました。翌朝、点検のレポートが16.9日更新されていないことを、その見張りが検出しました。

    この記事を書きながら数え直して、もう1つ見つかりました。

    段階の欄は、自由に書けるようにしていました。いま案件の _INDEX.md は41枚あって、段階の値は12通りあります。

    いま動いている5件(段階が稼働中か進行中のもの)だけでも、書き方が4通りに割れていました。「稼働中」「稼働中(日付つき)」「稼働中(補足つき)」「進行中」です。

    ダッシュボードの「稼働中」の表は、値がちょうど「稼働中」のものだけを拾います。5件のうち、表に出ていたのは2件。

    点検のスクリプトも、「進行中」と書いた1件を対象から外していました。閉じた案件の書き方も、「クローズ」「クローズ(理由つき)」「終了(長い説明つき)」など5通りあります。

    段階のように機械が読む欄は、自由に書かせると割れる。 候補から選ぶ欄にしておけば防げました。

    見出しの名前も、「TODO」と「ToDo」に割れています。この記事のために書き直した点検スクリプトは、最初「TODOの節にあるのに印がない行」を0件と返しました。「ToDo」と書いた節を見ていなかったからです。


    Before/After:1案件1枚に寄せて変わったこと

    テーブル 1

    TODOとして数えたのは、「未完了のチェックボックスに、僕がTODOに付けている印がある行」です。棚卸し前の数字は git の記録から、いまの数字は2026年10月13日のファイルから数えています。

    見てのとおり、きれいに直った表ではありません。直ったのは一覧の作りです。引き継ぎは、測ってみたら12項目すべてに根拠が付きました。ただし期限の抜けが多く、1枚の冒頭の欄は3件とも古いままでした。記憶はまた膨らみ始めています。


    新しいセッションに引き継げるか、15分で試す

    1枚に書く運用が効いているかは、auto memory を無効にした新しいセッションで確かめられます。目安は、4項目を聞いて答えの根拠を確かめるまでに5分、足りなかった情報を1枚に書き足すのに10分です。

    案件フォルダに移って、auto memory を無効にした Claude Code を起動します。

    使うのは、公式ドキュメントにある CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 という設定です。止まるのは auto memory だけで、CLAUDE.md はふだんどおり読み込まれます。だから、このテストでわかるのは「auto memory に頼らずに引き継げるか」です。

    Mac・Linux のターミナルなら、こう書きます。

    cd <案件のフォルダ>
    CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 claude

    Windows の PowerShell なら、2行目をこう書きます。そのウィンドウを閉じるまで、auto memory は無効のままです。

    $env:CLAUDE_CODE_DISABLE_AUTO_MEMORY="1"; claude

    次の指示を、1回だけ送ります。

    このフォルダの _INDEX.md(無ければ案件の概要メモ)から読み始めて、次の4つに答えてください。
    1. この案件の目的
    2. いまの段階
    3. 次にやること(誰が・いつまでに)
    4. まだ決まっていないこと
    答えごとに、根拠にしたファイル名と行番号を付けてください。
    根拠が見つからない項目は「根拠なし」と書き、推測で埋めないでください。
    ほかのエージェントやワークフロー、スキルは起動せず、ファイルも書き換えずに、この会話の中だけで答えてください。

    判定は、根拠つきで答えられた項目を数えるだけです。数える前に、挙がったファイルの該当の行を開き、本当にそう書いてあるかを確かめます。

    挙がった行にそう書いていない答えと、根拠のない答えは数えません。どちらも、案件のファイルから読み取った答えとは言えないからです。答えられなかった項目は、その場で1枚に書き足します。

    「次にやること」は、やること自体に根拠があれば1と数えます。担当や期限が「根拠なし」だった行は、数とは別に書き出し、これも1枚に書き足します。

    根拠つきでも、もう終わったことを「次にやること」と答えていたら、そこは1枚が古くなっている場所です。数とは別に、その場で直します。

    僕の結果:12項目すべてに根拠が付いた。ただし期限は抜け、冒頭の欄は古かった

    性質の違う3件の案件で、auto memory を無効にして試しました。12項目(3案件×4項目)すべてに、根拠のファイルが付きました。挙がった根拠のファイルと行は、別のセッションで実物と突き合わせています。

    数え方は、上に書いた判定のとおりです。12は「4つの問いそれぞれに根拠があったか」の数で、担当と期限まで揃っていたという意味ではありません。読んだファイルは各5〜6本で、どれも1枚から辿っていました。

    気になったのは中身です。3件とも、1枚の冒頭に書いていた「いまの状態」と「次の一手」の欄が、本文の日付つきの記録(ログ)より古いままでした。AI自身が「冒頭の欄ではなく、ログとTODOを根拠にした」と書いてきました。

    3件の答えに出てきた「次にやること」は計22件で、期限が書いてあったのは約9件。残りは「根拠なし」と答え、推測で埋めていません。

    期限を過ぎたまま閉じていないTODOも、3件すべてにありました(計5件)。担当の欄がなく、別の印から担当を推測していた案件もあります。

    書く場所が正しければ、auto memory に頼らなくても引き継げる。ただし、書いた中身が更新されなければ1枚も腐ります。だから週1回の点検が要ります。

    初回は、AIが勝手に検証を始めて失敗した

    最初の実行では、起動した Claude Code が、並列の検証作業(ワークフロー)を自分で立ち上げました。僕の Vault のルールに従った動きです。3件とも、答えが出る前に終わりました。

    ほかのエージェントは禁止したのに、ワークフローを禁止し忘れていたのが原因です。指示文の最後の1行は、この失敗から足しました。

    試したら、4項目のうちいくつに根拠つきの答えが返ってきたか、よかったらコメントで教えてください。


    複数人や2台のPCで使うとき(この記事の範囲外)

    1人でも、PCが2台あれば複数人と同じことが起きます。

    僕は2台のPCで Claude Code を使っています。禁止する操作を並べた設定(deny)が、約2か月のあいだ2台で食い違っていました。片方は41件、もう片方は95件。どちらのPCにも、もう一方にない禁止の項目がありました。

    記憶もPCごとです。共有したい事実は1枚に書き、その1枚を、2台のPCから同じファイルを開ける場所(git や同期フォルダ)に置きます。禁止したい操作は、設定ファイルに書く。

    禁止を設定で止める考え方は「「AIが勝手にやらかす」を防ぐ — 禁止事項・品質基準・段階的開示の設計」に書きました。

    この線引きは人数が増えても使えると考えていますが、多人数のチームでは試していません。


    まだ直っていないこと

    直したふりはしません。今日(2026年10月13日)数えた、僕の運用に残っている穴です。

    • 記憶:縮めたのは索引だけで、個別の記憶ファイルは残しています。プロジェクト用の記憶ファイル(ファイル名が project_ で始まるもの)は125本。うち4本に、未完了のチェックボックスが計27行あります。どの一覧にも出ないTODOです

    • 一覧のファイル:手で書いたTODOの行は、10月に19行を別のメモのTODOの節へ移し、0行にしました。ただ、お金と期限の義務を並べた手書きの表が1つ残っています

    • 点検:WARN は消えていません。最新のレポート(9月末)に出た9項目は、タグ、ファイルの置き場所、壊れた冒頭の欄といった Vault 全体の片づけです。「動いているのにTODOが0件」の項目は、棚卸しの日に点検へ足しました。該当がない週は何も書かない作りなので、レポートにはまだ一度も出ていません

    • 期限:Vault 全体の未完了TODO 約150行のうち、68行には期限がありません。期限のある行も、約4分の3が期限を過ぎています

    • 段階の欄:まだ候補に揃えていません。41枚すべてが段階(stage)と状態(status)の両方を持っています。「見直した日」の欄はありません。更新日の欄がある7枚も、名前が updated と last_updated の2通りに割れています

    見つけるところまでは、機械にできました。直すのは人の仕事で、僕はまだ追いついていません。


    よくある質問

    Q. Claude.ai の「プロジェクト」機能とは何が違いますか? Claude.ai の Projects は、チャットに資料と指示をまとめて持たせる機能です。この記事は Claude Code の話です。パソコンのフォルダを直接読み書きし、案件ごとのファイルを正本にします。

    Q. CLAUDE.md や記憶に書いておけば足りませんか? 足りません。CLAUDE.md は全案件に共通の道案内に使い、変わる中身は書きません。記憶は起動時に読まれる量に上限があり、PCをまたいで共有されず、一覧にも出ないからです。

    Q. Obsidian を使っていなくてもできますか? できます。1枚はただの Markdown ファイルです。一覧と点検は、有料パートの Python スクリプト(読むだけで、ファイルを書き換えない)で作れます。

    Q. Notion や Jira のような専用ツールではだめですか? だめではありません。正本を1か所にし、一覧は条件で集め、点検は逆向きにかける。この3つは、どの道具でも同じです。

    この記事は、Claude Code がファイルを直接読める形にこだわっています。新しいセッションのAIが、説明なしで案件を再開できるからです。

    Q. チームでも使えますか? この記事の型は人数が増えても使えると見ていますが、多人数のチームでは試していません。広げる前に、まず自分の案件1つで引き継ぎテストを回し、auto memory を無効にした新しいセッションが、何項目に根拠つきで答えられるかを見てください。


    続きでわかること

    • コピーするだけで、段階・TODO・呼び名の置き場所が決まる1枚のテンプレート(記入例、いまの案件を移す指示文、CLAUDE.md に足す4行つき)

    • 新しい案件のTODOが、案件名を書き足さなくても一覧に出てくるクエリ(Obsidian 版)

    • 「動いているのにTODOが0件」「段階が候補にない」「印の付け忘れ」を週1回拾う、読むだけの点検スクリプト(Obsidian 不要。僕の案件で回した結果つき)

    • 担当と期限を推測で埋めず、決まっていなければ「未定」と書くTODOの1行の書式と、僕の Vault にあった悪い書き方5つ(担当を呼び名で書く、期限を書かない、など)

    • 溜まったTODO 197行のうち114行をその日のうちに閉じた、AIとの棚卸しの手順と指示文

    • 案件を閉じても消してはいけない3種類のTODO(入金・アクセス権・契約の期限)と、閉じてよい条件

    • 議事録からTODOの候補だけをAIに抜かせ、担当と期限の推測を混ぜない指示文

     
     
    コンサルタント×Claude Codeで、仕事の「考える」を仕組み化する人。AIに調査・分析・レポートを全部やらせる11エージェントパイプラインを構築。実務で使い倒してるノウハウを毎週noteで公開中。有料記事を購入いただいた方には、記事内容に関する質問を受け付けています。

    あなたへのおすすめ