i-have-adhd: 実行機能障害向けにコードエージェントの出力を最適化する

概要

i-have-adhd は、コードエージェントが会話的な余計な情報や冗長な説明で答えを隠してしまうのを防ぐために設計された特別なスキルおよびプラグインセットです。厳格な出力制約を実装することで、AIの応答を物語的な説明から行動指向の指示へと変換し、ADHDを持つユーザー、あるいは高密度・低ノイズの技術的コミュニケーションを好むユーザーにとってより使いやすくしています。

核心的な問題：AIの冗長性

最近のClaudeモデルで駆動される現代のコードエージェントは、極端な冗長性を示す傾向があります。この行動は通常、以下のようになります：

序論と締めくくり： 「素晴らしい質問ですね！」で始まり、「お役に立てれば幸いです！」で終わる。
物語的な説明： 実際の修正を述べる前に、長々とした文脈を提供する。
否定的な制約： 何をしたかだけでなく、何をしなかったかも説明する。
循環的な論理： 応答の最後に、主な解決策を無効にする可能性のある制約を追加する。

ADHDフレンドリーな出力の10のルール

i-have-adhd スキルは、AIがタスクに集中し、ユーザーの認知的負荷を最小限に抑えるために、10の具体的なルールを強制します：

次の行動から始める： 最初の文は、ユーザーが直ちに取るべきステップでなければならない。
複数ステップのタスクには番号を付ける： シーケンスの明確さと追跡可能性を確保するために、番号付きリストを使用する。
1つの具体的な次のステップで終わる： すべての応答は、1つの明確なアクションアイテムで終わらなければならない。
余談を抑制する： 現在のタスクを完了するために直接必要でない情報は削除する。
毎ターン状態を再確認する： プロジェクトの現在の状態を可視化して、方向感を失わないようにする。
具体的な時間見積もり： 「少し」などの曖昧な表現ではなく、実際に何分または何時間（例：「15分」）を使用する。
成果を可視化する： ステップが成功裏に完了したことを明確に強調する。
事実的なエラー報告： 謝罪的な言葉を使わず、エラーを素直に報告する。
リストは5項目までに制限する： リストの長さを制限して認知的負荷を防ぐ。
序論、要約、締めくくりを禁止： すべての会話的な余計な情報を排除する。

実装と互換性

このプロジェクトは、さまざまなAIエージェントに統合可能な「スキル」として実装されています。以下のプラットフォームに対応する特定のアダプタとプラグインを提供しています：

Claude Code： 「常時オン」機能をサポートするプラグインとフックを備える。
OpenCode： サーバープラグインと専用コマンドを含む。
Gemini CLI： カスタムコマンドと拡張機能用のネイティブルートを提供する。
Cursor： 統合用のポータブルスキルメタデータを含む。
その他のプラットフォーム： KimiおよびQwen用の互換性レイヤー。

インストール

ユーザーはCLIプロンプトを次のように指定してスキルをインストールできます：Install the i-have-adhd skill/plugin from https://github.com/ayghri/i-have-adhd, refer to the repo's AGENTS.md for instructions.

コミュニティの洞察と批判

このプロジェクトは大きな注目を集めています（ほぼ3万スター）が、その効果や実装に関して、技術的・哲学的な点でいくつかの議論がなされています。

モデル固有の挙動

多くのユーザーは、このスキルの必要性が特にAnthropicのClaudeモデルで顕著であると指摘しています。一部のユーザーは、このスキルが有効になっていても、数ターン後にClaudeが元の冗長な「Claudian」スタイルに戻ってしまうと報告しています。

"Claudeモデルがこのスキルを最も必要としているし、私の経験では、この特定のスキルは数ターン程度しか簡潔さを維持できず、その後完全に忘れ去られ、かつての理解不能な冗長性に戻ってしまう。"

技術的オーバーヘッド

一部の貢献者は、リポジトリのサイズについて疑問を呈しており、コアのプロンプトは比較的小さく（SKILL.mdで約140行）であるものの、数十ファイルにわたる数千行のコードが、さまざまなエージェントプラグインをサポートするために含まれていると指摘しています。

代替アプローチ

ユーザーは、類似の結果を得るための正式なスキル以外のいくつかの代替案を提案しています：

プロンプト： 「BLUF」（Bottom Line Up Front）、「簡潔に」、または「ADHDを前提とする」などのキーワードを使用する。
出力スタイル： 「出力スタイル」設定を使用し、グローバルスキルよりもモデルに頻繁に思い出させる可能性がある。
モデル選択： 一部のユーザーは、Opus 5からOpus 4.8にダウングレードすることで、読みやすさが向上し、冗長性が減少することを発見した。

アクセシビリティに関する懸念

プロジェクトの名前とフレーミングに関して、議論があります。実行機能障害を支援することを意図しているものの、一部のユーザーは「i-have-adhd」という名前が臨床的診断を軽視していると感じ、あるいは「10xing生産性」という表現が不適切だと指摘しています。

比較：前 vs 後

特徴	標準的なAI応答	i-have-adhd応答
開始	"素晴らしい質問ですね！検討してみましょう…"	"`npm install jsonwebtoken@latest` を実行してください…"
構造	物語的な段落	番号付きの行動ステップ
終了	"お役に立てれば幸いです！ご質問があれば…"	"次：失敗した最初の行を貼り付けてください…"
焦点	文脈と説明	即時実行