ノート駆動AIコーディング術の提案

Share
ノート駆動AIコーディング術の提案
ロボティックな手でキーボード入力するイヌさん

どうもTAKUYAです。みなさんはAIエージェントを普段のコーディングで活用されていますか。ちょっと面白いワークフローを思いついたのでシェアします。それは、ノート駆動のエージェンティック・コーディング・ワークフローです。最近Claude Codeのプランモードを使っていたら、ターミナル内で生成されたプランを読むのが辛かったんです。それで、じゃあMarkdownノートアプリであるInkdropをプランの保存先バックエンドとして使えば解決するんじゃないかと思って、​試してみました。こちらがそのデモです(英語):

こちらがClaude Codeの設定ファイル群です:

GitHub - inkdropapp/note-driven-agentic-coding-workflow at devas.life
Complete Claude Code configuration collection - agents, skills, hooks, commands, rules, MCPs. Battle-tested configs from an Anthropic hackathon winner. - GitHub - inkdropapp/note-driven-agentic-cod…

リポジトリはAffaanさんの設定集をベースにしています。これらを必要なものだけ .claudeフォルダに適宜コピペして使ってください。

なぜノート駆動?

もちろんローカルに保存されたプランファイルをVSCodeで開いてもいいですが、Inkdropを使うことで以下の利点が得られます:

  • 美しいMarkdownレンダリング - フォーマッティング、シンタックスハイライティング、Mermaidダイアグラム、LaTeX数式などに対応し、快適にプランを読める
  • 編集しやすい - バトルテステッドなMarkdownエディタでプランを実行する前に編集できる
  • いろんなデバイスで読める - データ同期により、スマホやタブレットでもプランを読んだり編集できる
  • リビジョン履歴が参照できる - ノートの変更履歴が見れるので、プランのどの部分がどのように変更されたかが確認できる
  • 進捗トラッキング - ノートステータスやチェックボックスで、進捗の変遷やサブタスクの完了具合などが追える
Mermaid図を含むプラン

使用の流れ

  1. プランをリクエストする - /plan コマンドを実行してタスクを指示する
  2. プランが生成される - Claude Codeがコードベースを解析して詳細なプランを作る
  3. Inkdropに保存される - 自動でノートが作成される。ノートステータスは初期状態で none
  4. レビューする - プランを読んで、良ければ取り掛かるように指示する
  5. タスクが実行される - ノートステータスが active に変更され、作業が開始される
  6. 進捗のアップデート - ノート内のチェックボックスが、タスクの進捗と共にアップデートされる
  7. 完了 - ノートステータスが completedにアップデートされて、outcomeが追記される
Revision historyで進捗を遡る

詳しい使い方はリポジトリのREADMEを参照ください。

アイデア: BeadsみたいなCLIツールを作る?

このワークフローは、新たなCLIツールを作ってみたいと思わせます。例えばBeadsみたいなやつ:

GitHub - steveyegge/beads: Beads - A memory upgrade for your coding agent
Beads - A memory upgrade for your coding agent. Contribute to steveyegge/beads development by creating an account on GitHub.

Beadsは、AIエージェント向けに設計されたシンプルなCLIベースのイシュートラッカーです。BeadsはSQLiteをバックエンドに使ってデータを保存します。動画で見せたように、代わりにInkdropを使うことは十分に可能でしょう。そうすれば、あなたはコンセプトやアイデアや仕様、デザインなどを書くのに集中できます。別の言い方をすれば、AIエージェントが自分のためにノートを取るのです。人間と同じで、Context Window Sizeのせいですぐに忘れるからです。あなたはこのアイデアについてどう思いますか?

Read more

個人開発で日本から海外へ、10年間の歴史 — ひろしさんとの対談(前編)

個人開発で日本から海外へ、10年間の歴史 — ひろしさんとの対談(前編)

数週間前、ひろしさんのポッドキャストにゲストで出演しました。お互いの長い個人開発の経験について語り合いました。英語版を作成する過程で、日本語でも綺麗に整形した書き起こしが出来たので、こちらに掲載します。お楽しみください。 ※ギアアイコンをクリックして、音声と字幕を日本語に変更できます。 00:00 イントロ:TAKUYAさんようこそ 01:32 TAKUYAさんの自己紹介:WalknoteからInkdropまで 04:54 独立への踏み切り方:慎重派と勢い派 06:51 個人開発がフリーランス案件につながった 09:17 Inkdropで食えるようになるまで 12:15 なぜ最初から海外市場を狙ったのか 14:54 AI登場前、英語コピーに苦戦した話 16:18 AIバイブコーディング時代をどう見ているか 17:24 全てのコードを一行ずつレビューする使い方 21:06 AIは新幹線:速さの先にあるもの 25:53 AI時代に「感性」が大事になる 27:

By Takuya Matsuyama
「一汁一菜」にAI時代の生き方が詰まっている

「一汁一菜」にAI時代の生き方が詰まっている

どうも個人アプリ作家のTAKUYAです。 今回は、AI時代を開発者・クリエイター・表現者としてどう健やかに生きるか、について考えていることをシェアしたいと思います。ここでの「健やかに生きる」とは、心身の健康を保ちながら、ものづくりを楽しみ続けるという意味です。 読者の中にも、最近のAIの急速な進化の中でどう生き残り、さらに活躍していくかを悩んでいる方は多いのではないでしょうか。正直、すべてに対する正解はわかりません。未来を正確に予測できる人はいないからです。 でも自分は、ソフトウェア寄りのアーティストとして生きる上で大事なのは、「戦略」や「堀(moat)」を築くことよりも、「生きる方向性」 だと思っています。 人生とは速度ではなく方向である – ゲーテ 自分はどこに行きたいのか?何を見たいのか?それが大事です。戦略は状況に合わせて柔軟に変えればいいからです。 今回は、日本の文化からいくつかの生き方の原則を探ってみたいと思います。 最近、料理研究家の 土井善晴 さんの 「一汁一菜でよいという提案」 を読んで、日々のリズムを健やかに保つためのヒントがたくさん詰まっていると感じまし

By Takuya Matsuyama
Claude Codeをtmuxのポップアップウィンドウで継続的に走らせる方法

Claude Codeをtmuxのポップアップウィンドウで継続的に走らせる方法

💡本記事は英語ブログの日本語訳です。 どうも、TAKUYAです。 AIコーディングでは専らClaude Codeを使っています。最初はtmuxでターミナルの右側にペインを分割して使っていたのですが、幅が狭すぎてメッセージやdiffがまともに表示できず、使いづらかったです。 <Prefix>+zでペインを最大化すればいいのですが、毎回やるのは面倒でした。 そこで、ポップアップウィンドウでClaude Codeを起動するようにしました。キーバインドを押せばセッションが開き、閉じてもバックグラウンドで動き続けるので、すぐに再開できます。 この記事では、それを実現するためのtmuxの設定方法を紹介します。 動画で見る(英語): ポップアップウィンドウはサブプロセスを維持できない tmuxのdisplay-popupコマンドを使うとポップアップウィンドウを表示でき、ちょっとしたツールにすぐアクセスするのに便利です。 僕はlazygitでgitの状態をサッと確認するのに使っています: bind -r g display-popup -d '#{pane_current_path}'

By Takuya Matsuyama
Keychron K2 HEを無刻印化する手順

Keychron K2 HEを無刻印化する手順

どうもTAKUYAです。KeychronさんにK2 HEをお願いしたら音速で送ってくれたので、無刻印化してみました。どうやったのか過程をシェアします。 Unboxing 上はKeychron Q1です。これは3年間ぐらい使ってきました。キーキャップが若干くたびれていますね。でも問題なく今まで使えていました。そろそろ飽きてきたので新しいキーボードを試したいと思い、前から気になっていたK2 HEを試すことにしました(写真下)。 Amazon | 【国内正規品】Keychron K2 HE ラピッドトリガー ワイヤレス カスタムキーボード、ホールエフェクトGateronダブルレール・マグネットスイッチ、2.4GHz・Bluetooth無線対応、QMKプログラム可能、アルミ+ウッドフレーム、USレイアウト、RGBライト、Mac Windows Linux対応 (ブラック) | Keychron | パソコン用キーボード 通販【国内正規品】Keychron K2 HE ラピッドトリガー ワイヤレス カスタムキーボード、ホールエフェクトGateronダブルレール・マグネットスイッチ、

By Takuya Matsuyama