ノート駆動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…

GitHubinkdropapp

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

なぜノート駆動？

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

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

使用の流れ

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

詳しい使い方はリポジトリの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.

GitHubsteveyegge

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