ayghri/i-have-adhd: コーディングエージェントの出力を劇的に改善するスキル

リポジトリ

• ayghri/i-have-adhd
• 主要言語: Python / ライセンス: MIT / ★ 8,247

i-have-adhd とは

ayghri/i-have-adhd は、コーディングエージェント（LLMベースの開発支援ツール）からの出力を、より直接的で、行動志向的かつ簡潔にするためのオープンソーススキルです。その名の通り、「ADHDフレンドリー」な出力を目指しており、回りくどい説明や過剰な情報を排除し、次に取るべき具体的なアクションを明確に提示することを目的としています。

プログラミングにおける問題解決は、しばしば複雑で多段階のプロセスを伴います。通常のコーディングエージェントは詳細な背景情報や複数の選択肢を提示しがちですが、これがかえって開発者の集中を妨げたり、本質的な解決策を見つけるまでの時間を長引かせたりすることがあります。i-have-adhd は、このような課題に対し、エージェントの応答スタイルを最適化することで、開発フローをよりスムーズに、そして効率的に進めるための新しいアプローチを提供します。

開発を加速する「ADHD-friendly」な出力

このリポジトリが提唱する「ADHDフレンドリー」な出力とは、特定の診断を前提とするものではなく、情報がシンプルで明確に構造化され、すぐに実行可能な形で提示されるという、誰もが恩恵を受けられる情報デザインの原則に基づいています。開発者が求めるのは、しばしば「何をすればいいのか」という一点に集約されますが、従来の出力はその答えを多くの情報の中に埋もれさせてしまう傾向がありました。

具体的な変化は、以下の「Before」と「After」の比較が最も分かりやすく示しています。

Before:

Great question! Let me think about this. Your auth flow has a few moving pieces: the middleware, the token verification, and the cookie handling. Looking at src/auth.ts, the verifyToken function (around lines 42-58) seems to be using an older jsonwebtoken API. One approach would be to update the package and rewrite that function. After making the change, you’d want to run the auth tests to confirm nothing breaks. By the way, you might also want to look at your dependency versions overall. Hope this helps! Let me know if you want to dig deeper.

After:

Run npm install jsonwebtoken@latest, then edit src/auth.ts:42.

1. Open src/auth.ts
2. Replace verifyToken (lines 42–58) with the snippet below
3. Run npm test -- auth.spec.ts

Next: paste the first failing line if any test fails.

「After」の出力は、冒頭に次のアクションを提示し、具体的な手順を番号付きリストで示すことで、開発者が迷うことなく作業を進められるよう導きます。余分な挨拶や、本質的ではない情報、複数の選択肢の提示などを一切排除し、「次の一歩」に特化しているのが大きな特徴です。

このスタイルを実現するために、i-have-adhd は以下の10のルールに基づいてエージェントの応答を調整します。代表的なルールには、以下のようなものがあります。

• 常に次のアクションから始める：回りくどい導入は不要です。
• 複数ステップのタスクは番号を振る：視覚的に分かりやすく、進捗を把握しやすくします。
• 横道にそれない：無関係な情報や示唆を抑制します。
• リストは5項目までに限定する：情報の過負荷を防ぎます。
• 前置き、まとめ、締めはなし：本質的な情報のみを提供します。

これらのルールにより、開発者はエージェントからの情報に基づいて即座に行動を起こすことができ、思考の切り替えや集中力の維持にかかる労力を最小限に抑えられます。

どんな現場で役立つか

i-have-adhd は、以下のような多様な開発現場や状況で大きな価値を発揮します。

• 高い生産性が求められる開発現場：一刻も早く問題を解決し、次のタスクに進む必要がある場合に、エージェントの出力を最大限に活用し、無駄な思考時間を削減します。
• 学習中のエンジニア：初めての技術や複雑な課題に取り組む際、何から手をつけて良いか分からない状況でも、明確な指示があることでスムーズに学習を進められます。
• マルチタスクや割り込みが多い環境：複数のプロジェクトやタスクを並行して進める開発者にとって、エージェントからの簡潔な指示は、集中力を維持し、タスクの切り替えコストを減らすのに役立ちます。
• 既存のコーディングアシスタントの課題を解決したいユーザー：現在利用しているエージェントの出力が冗長だと感じている方、より「実践的」なアドバイスを求めている方に最適です。

このスキルは、特定の課題を抱えるユーザーだけでなく、すべての開発者にとって、より効率的でストレスの少ない開発体験を提供するための強力なツールとなり得ます。

主要な機能と導入方法

i-have-adhd は、特定のコーディングエージェント向けに「スキル」として提供されます。例えば、Claude Code や Codex といったエージェントに組み込むことができます。

インストールは非常に簡単で、対応するエージェントのプラグインマネージャーを通じて行えます。

Claude Code での導入例:

claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

一度インストールすれば、/i-have-adhd のようにコマンドを入力するだけで、エージェントの出力スタイルを変更できます。また、リポジトリをフォークして skills/i-have-adhd/SKILL.md を編集することで、上記の10のルールを自分好みにチューニングすることも可能です。これにより、組織や個人の開発スタイルに合わせた最適な出力を作り出すことができます。

独自の価値と今後の展望

ayghri/i-have-adhd は、単にコードを生成したり、既存のドキュメントを要約したりするだけのエージェント機能とは一線を画します。情報伝達の「質」と「効率」に焦点を当てることで、開発者の認知負荷を軽減し、最終的な生産性向上に貢献するという、ユニークな価値を提供します。

今後の展望としては、より多くのコーディングエージェントや開発環境への対応、ユーザーからのフィードバックを元にしたルールの洗練が考えられます。また、特定のプログラミング言語やフレームワークに特化した「ADHDフレンドリー」な出力スタイルの開発も、その応用可能性を広げるでしょう。

シンプルでありながらも、開発者の日々のワークフローに大きな改善をもたらす可能性を秘めたこのプロジェクトは、情報過多な現代において、効率的な情報消費のあり方を再考させる示唆に富んでいます。シンプルで効率的な情報伝達を求めるすべての開発者にとって、一見の価値があるでしょう。