i-have-adhd: AI 코딩 에이전트를 직설적으로 바꾸는 스킬

3주 전, 한 머신러닝 연구자가 마크다운 파일 폴더 하나를 깃허브에 올렸습니다. 오늘 이 저장소는 깃허브 일간 트렌딩 리더보드 1위에 올라 있습니다 — 이 페이지에 오른 투자받은 모든 AI 스타트업과 개발자 툴 런칭을 제친 순위입니다. 그리고 이미 보유하고 있던 38,226개의 스타에 더해, 지난 24시간 동안에만 3,882개의 스타를 추가로 얻었습니다.

이 프로젝트는 i-have-adhd입니다. AI 코딩 에이전트에 기능을 단 하나도 추가하지 않습니다. 그저 에이전트에게 핵심을 파묻지 말라고 지시할 뿐입니다.

i-have-adhd는 정확히 무엇인가

i-have-adhd는 무료로 제공되는 MIT 라이선스 "스킬"입니다 — AI 코딩 에이전트가 답변하기 전에 읽는 지시문 모음이며, 콜로라도 대학교 볼더의 CLIMB 리서치 그룹 소속이라고 스스로 소개하는 Ayoub Ghriss가 만들었습니다. 저장소 자체 설명에 따르면 이는 "A skill to stop your coding agent from burying the answer. ADHD-friendly output."(코딩 에이전트가 답을 파묻지 않게 만드는 스킬. ADHD 친화적인 출력.)입니다. README의 태그라인은 더 직설적입니다: "ADHD-friendly outputs. No ADHD diagnosis needed!"(ADHD 친화적인 출력. ADHD 진단은 필요 없습니다!)

그 뒤에 모델도, API도, 대시보드도 없습니다. Claude의 스킬 포맷(또는 그에 준하는 플러그인 포맷)을 지원하는 어떤 에이전트든 불러올 수 있는 프롬프트 엔지니어링 스킬 파일일 뿐이며, 이후 나오는 모든 응답의 형태를 다시 짭니다.

메커니즘: 답변의 순서를 바꾸는 열 가지 규칙

프로젝트의 SKILL.md에 따르면, 이 파일은 ADHD와 작업 기억에 관해 스스로 제시한 다섯 가지 "사실"로 시작한 뒤, 그 사실들을 언어 모델이 텍스트를 어떻게 구조화해야 하는지에 대한 지시로 옮긴 열 가지 규칙이 이어집니다. 이 열 가지 규칙의 핵심을 정리하면 다음과 같습니다.

1. 설명하기 전에 먼저 행동을 제시한다 — 명령어, 경로, 코드 스니펫부터.
2. 여러 단계로 이뤄진 작업은 번호를 매기고, 각 단계마다 명확히 한정된 행동 하나만 담는다.
3. 매 턴을 2분 안에 끝낼 수 있는 일 딱 하나로 마무리한다.
4. 부차적인 이슈를 언급하기 전에 현재 이슈부터 끝낸다.
5. 기억하고 있을 거라 가정하지 말고, 매 턴마다 진행 상황을 다시 알려준다(예: "5단계 중 3단계 완료").
6. 모호한 시간 표현 대신 구체적인 시간 추정치를 쓴다.
7. 요약 대신, 지금 무엇이 작동하는지를 구체적으로 보여준다.
8. 에두르는 표현 없이 오류와 해결책을 명확하게 말한다.
9. 목록은 다섯 개 이하로 제한하고, 관련성에 따라 그룹으로 묶는다.
10. 서두, 요약, 마무리 인사를 생략한다.

이 중 무엇도 새로운 모델이나 파인튜닝을 필요로 하지 않습니다. 지금 쓰고 있는 어떤 에이전트든 그 위에 얹는 포맷 계약일 뿐이며, 바로 그 덕분에 한 사람이 만들어 배포하기에 충분히 저렴했고, 3주 만에 수천 명이 시도해볼 만큼 빠르게 퍼질 수 있었습니다.

이번 주 모두가 설치하고 있는 이유

진짜 이야기는 성장 곡선 그 자체이며, 깃허브 트렌딩 페이지에서 실시간으로 확인할 수 있습니다: 오늘 기준 스타 38,226개, 포크 2.2k개이며, 이 중 3,882개의 스타는 지난 24시간 동안에만 추가된 것입니다. 프로젝트의 커밋 히스토리를 보면 활동이 최소 2026년 8월 21일까지 거슬러 올라가는데, 이는 이 성장 대부분이 3주도 안 되는 기간에 일어났다는 뜻입니다.

더 이상 한 사람의 취미 프로젝트도 아닙니다. 이 글을 쓰는 시점 기준 저장소에는 머지된 풀 리퀘스트 61개와 열린 이슈 18개가 있습니다 — 기여자들이 새로운 툴을 위한 설치 문서를 추가하고, 플랫폼별 버그를 고치고, 개별 규칙의 정확한 문구를 두고 논쟁을 벌이고 있습니다. 머지된 PR 중 하나는 "rules: reword rule 9 to presentation-only ranking"(규칙: 규칙 9를 '표시 방식에만 적용되는 순위'로 다시 쓰기)라는 제목을 달고 있습니다.

하나의 툴만이 아니라 거의 모든 AI 코딩 툴에서 작동한다

이렇게 빠르게 퍼진 이유는 부분적으로는 배포 방식에 있습니다. 특정 에이전트 하나에 묶여 있지 않다는 것이죠. 프로젝트의 INSTALL.md에 따르면, 15개의 서로 다른 툴을 위한 설치 안내를 제공합니다 — Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot(VS Code 확장과 Copilot CLI 포함), Zed, OpenCode, Qwen Code, Amp, Antigravity, AstronClaw, Hermes, Kimi Code CLI, Pi, Oh My Pi까지. 이는 대부분의 단일 벤더 런칭이 치는 그물보다 훨씬 넓은데, 지난달 등장한 에이전트 우선(agent-first) 브라우저들이 걸었던 것과 같은 종류의 크로스 툴 베팅이며, 다만 브라우징이 아니라 출력 포맷팅을 겨냥했다는 점만 다릅니다.

활성화 방식은 이 툴들 사이에서 통일돼 있지 않으며, 프로젝트 자체 설치 문서도 이 불일치를 숨기지 않고 밝힙니다. Claude Code, Qwen Code, Codex에서는 스킬을 명시적으로 호출하기 전까지 아무 일도 일어나지 않습니다(/i-have-adhd를 입력하면 해당 세션에서 활성화됩니다), 반면 다른 일부 통합에서는 세션 시작 시 규칙 세트가 자동으로 로드됩니다. 설치 한 단계면 어디서든 똑같이 동작할 거라 기대하는 사람에게는 거친 지점입니다 — 자신이 쓰는 툴에 대한 구체적인 안내를 먼저 확인하고, 바로 적용됐다고 넘겨짚지 마세요.

아직 갖추지 못한 것들

3주가 지난 지금도 버전이 매겨진 릴리스는 아직 없습니다 — 릴리스 탭은 비어 있으며, 그래서 오늘 이 스킬을 설치하는 사람은 누구든 main 브랜치에서 곧바로 가져오는 셈입니다. "ADHD 친화적"이라는 프레이밍 뒤에는 독립적인 연구가 없습니다 — SKILL.md에 스스로 적어둔 다섯 가지 "사실"과 메인테이너 본인의 설계 노트가 있을 뿐입니다. 이는 ADHD 관련 커뮤니케이션 조언을 LLM 출력에 적용한 한 개발자의 해석이며, 임상적으로 검증된 개입이 아니고, 프로젝트 스스로도 그렇게 주장하지 않습니다. 그리고 이 전체가 포크할 수 있는 마크다운 파일이기 때문에, README에 따르면 의도된 커스터마이징 경로는 문자 그대로 SKILL.md를 직접 수정하는 것입니다 — 즉 각 사용자가 받는 "규칙"은 그 사람이 포크한 버전에 뭐라고 적혀 있느냐에 따라 달라지며, 하나의 유지관리되는 표준이 아닙니다.

결론

i-have-adhd의 성장 곡선은 이 블로그가 이전에도 추적해온 패턴을 보여주는 깔끔한 데이터 포인트입니다: 날카로운 README를 갖춘 단일 목적의 무료 깃허브 저장소가 이제는 며칠 안에 투자받은 제품 런칭보다 더 많은 관심을 끌 수 있다는 것 — 지난달 God's Eye View가 나흘 만에 트렌딩 1위에 오른 것도 같은 배포 구조 변화였습니다. 여기서의 메커니즘은 그보다도 훨씬 작습니다 — 새로운 데이터도, 새로운 UI도 아니라 열 가지 포맷 규칙일 뿐이라는 점이, 오히려 교훈을 더 뾰족하게 만듭니다: 지금 많은 AI 툴의 병목은 능력(capability)이 아니라, 답이 도착한 순간 바로 쓸 수 있느냐입니다. 직접 테스트해보고 싶다면, 이미 매일 쓰고 있는 툴 하나부터 시작해서 INSTALL.md에 나온 그 툴의 정확한 단계를 따라 설치하고, 규칙을 취향대로 포크하기 전에 더 짧고 핵심이 앞에 오는 답변이 실제로 시간을 절약해주는지 확인해보세요.