i-have-adhd: 실행 기능 장애를 위한 코딩 에이전트 출력 최적화

개요

i-have-adhd는 코딩 에이전트가 대화적 채우기와 과도한 설명으로 인해 답변을 가리지 않도록 설계된 전용 기술 및 플러그인 세트입니다. 엄격한 출력 제약을 적용함으로써, AI 응답을 서사적 설명에서 행동 중심의 지시로 전환하여 ADHD가 있는 사용자나 단순히 고밀도, 저노이즈 기술 커뮤니케이션을 선호하는 사용자에게 더 접근하기 쉽게 만듭니다.

핵심 문제: AI의 과도한 설명

최근 클로드 모델을 기반으로 하는 현대 코딩 에이전트는 종종 극도로 긴 설명을 하는 경향을 보입니다. 이 행동은 일반적으로 다음과 같은 형태로 나타납니다:

서론과 결론: "좋은 질문이에요!" 또는 "도움이 되었기를 바랍니다!"와 같은 문장으로 응답을 시작하거나 끝냅니다.
서사적 설명: 실제 수정 방법을 제시하기 전에 긴 맥락을 제공합니다.
부정적 제약: 무엇을 하지 않았는지에 대한 설명을 무엇을 했는지와 함께 제시합니다.
순환적 추론: 응답의 끝에 주된 해결책을 무효화할 수 있는 예외 조건을 추가합니다.

ADHD 친화적 출력을 위한 10가지 규칙

i-have-adhd 기술은 AI가 작업에 집중하고 사용자의 인지 부담을 최소화하도록 보장하기 위해 10가지 구체적인 규칙을 강제합니다:

다음 행동을 먼저 제시하세요: 첫 번째 문장은 사용자가 즉시 수행해야 할 단계여야 합니다.
다단계 작업은 번호 매기기: 순서를 명확하고 추적 가능하게 하기 위해 번호 매긴 목록을 사용하세요.
한 가지 구체적인 다음 단계로 마무리하세요: 모든 응답은 단 하나의 명확한 행동 항목으로 끝나야 합니다.
편향 제거: 현재 작업을 완료하는 데 직접적으로 필요하지 않은 정보는 제거하세요.
각 단계마다 상태 재진술: 프로젝트의 현재 상태를 항상 시각적으로 유지하여 방향 감각을 잃지 않도록 하세요.
구체적인 시간 예측: "조금" 같은 모호한 표현 대신 실제 분 또는 시간(예: "15분")을 사용하세요.
성공을 명확히 표시하세요: 단계가 성공적으로 완료되었을 때 이를 명확히 강조하세요.
사실적인 오류 보고: 사과하는 언어 없이 오류를 객관적으로 보고하세요.
목록은 5개 항목으로 제한하세요: 목록의 길이를 제한하여 인지 과부하를 방지하세요.
서론, 요약, 결론 없음: 모든 대화적 채우기를 제거하세요.

구현 및 호환성

이 프로젝트는 다양한 AI 에이전트에 통합할 수 있는 "기술"로 구현되었습니다. 여러 플랫폼용 특수 어댑터와 플러그인을 제공합니다:

Claude Code: "항상 켜져 있는" 기능을 위한 플러그인과 훅을 지원합니다.
OpenCode: 서버 플러그인과 전용 명령어를 포함합니다.
Gemini CLI: 사용자 정의 명령어 및 확장 기능을 위한 네이티브 경로를 제공합니다.
Cursor: 통합을 위한 이식 가능한 기술 메타데이터를 포함합니다.
기타 플랫폼: Kimi와 Qwen용 호환성 레이어.

설치

사용자는 CLI 프롬프트를 다음과 같이 지시하여 기술을 설치할 수 있습니다: https://github.com/ayghri/i-have-adhd에서 i-have-adhd 기술/플러그인을 설치하세요. 지침은 리포지토리의 AGENTS.md를 참조하세요.

커뮤니티의 통찰과 비판

이 프로젝트는 큰 인기를 끌었으며(거의 3만 개의 스타), 커뮤니티는 그 효과성과 구현 방식에 대해 여러 기술적이고 철학적인 논의를 제기했습니다.

모델별 행동

많은 사용자들이 이 기술이 앤트로픽의 클로드 모델에서 가장 필요하다고 지적했습니다. 일부 사용자는 이 기술이 활성화된 상태에서도 클로드가 몇 번의 응답 후에 원래의 긴 설명 스타일로 돌아간다고 보고했습니다.

"클로드 모델이 이 기술이 필요한 가장 큰 대상이며, 제 경험상 이 특정 기술은 몇 번의 응답 이후에는 거의 항상 긴 설명 스타일로 돌아가며, 그 비약적인 설명 능력은 여전히 놀랍습니다."

기술적 부담

일부 기여자는 리포지토리의 크기에 대해 의문을 제기하며, 핵심 프롬프트는 비교적 작지만(SKILL.md에서 약 140줄), 다양한 에이전트 플러그인을 지원하기 위해 수천 줄의 코드가 수십 개의 파일에 분포되어 있다고 지적했습니다.

대안 접근 방식

사용자들은 유사한 결과를 얻기 위한 공식적인 기술 대신 몇 가지 대안을 제안했습니다:

프롬프팅: "BLUF"(Bottom Line Up Front), "간결하게", 또는 "ADHD를 가정하라"와 같은 키워드 사용.
출력 스타일: "출력 스타일" 설정을 사용하면 전역 기술보다 모델을 더 자주 상기시킬 수 있습니다.
모델 선택: 일부 사용자는 오퍼스 5에서 오퍼스 4.8로 다운그레이드하는 것만으로도 가독성과 설명의 길이가 크게 향상된다고 느꼈습니다.

접근성에 대한 우려

이 프로젝트의 이름과 프레임워크에 대해 논의가 있습니다. 실행 기능 장애를 돕기 위한 의도는 있지만, 일부 사용자는 "i-have-adhd"라는 이름이 임상 진단을 과소평가하거나 경시하는 것으로 느껴질 수 있다고 지적했습니다.

비교: 전후 비교

기능	표준 AI 응답	i-have-adhd 응답
시작	"좋은 질문이에요! 생각해볼게요..."	"`npm install jsonwebtoken@latest`를 실행하세요..."
구조	서사적 단락	번호 매긴 행동 단계
결론	"도움이 되었기를 바랍니다! 알려주세요..."	"다음: 실패하는 첫 번째 줄을 붙여넣기..."
중점	맥락과 설명	즉각적인 실행