개발자 ayghri가 코딩 에이전트(코드를 다루는 AI 도우미)의 답변에서 서론을 걷어내고 다음 행동을 맨 앞에 놓는 스킬(응답 방식을 정하는 지침 묶음) ‘아이 해브 ADHD(i-have-adhd)’를 GitHub에 공개했다. 질문을 칭찬하고 배경을 길게 설명한 뒤에야 할 일을 알려주는 답변을, 바로 실행할 수 있는 단계로 바꾸겠다는 제안이다. 답을 얼마나 많이 아느냐보다 사용자가 답을 얼마나 빨리 찾아 행동할 수 있느냐에 초점을 맞춘다는 점에서 눈길을 끈다.
핵심 요약
- ‘아이 해브 ADHD’는 코딩 에이전트가 다음 행동을 먼저 말하고 여러 단계의 작업에는 번호를 붙이도록 하는 스킬이다.
- 저장소는 기존의 긴 인증 오류 설명을 파일 수정 위치와 테스트 명령부터 제시하는 답변으로 바꿔, 무엇을 먼저 해야 하는지 보여준다.
- 지침 10개에는 매번 작업 상태를 다시 알리고, 예상 시간을 분 단위로 말하며, 목록을 다섯 항목 이내로 줄이라는 요구가 담겼다.
- 사용자는
SKILL.md를 고쳐 자기 버전으로 설치할 수 있어, 같은 원칙을 작업 방식에 맞게 조정할 수 있다. - Hacker News 토론에서는 간결한 답변의 필요성에 공감하면서도, 에이전트가 지침을 몇 차례 대화 뒤 잊거나 설치 과정이 불안하다는 지적이 나왔다.
진단과 무관하게 쓰는 응답 스킬
GitHub 저장소는 이 도구를 ‘ADHD 친화적 출력’으로 소개하면서도 ADHD 진단을 받아야 쓸 수 있는 것은 아니라고 밝힌다. 저장소에 표시된 별 수는 5만1800개다. 소개 화면에는 한국어를 포함한 여러 언어 표시가 있고, 중심 메시지는 한 가지다. 코딩 도우미가 답을 설명 속에 묻어 두지 말고 사용자가 취할 행동을 먼저 알려주라는 것이다.
설치 안내도 코딩 에이전트를 사용하는 방식에 맞춰져 있다. 사용자는 명령줄 도구의 프롬프트에 해당 스킬 또는 플러그인을 설치하라고 요청하고, 저장소의 AGENTS.md를 지침으로 참조하게 할 수 있다. 별도의 설치 안내도 마련돼 있다. 다만 이 스킬이 바꾸려는 대상은 코드 작성 기능 자체가 아니라, 작업을 설명하고 다음 단계를 전달하는 답변의 순서와 형태다.
인증 오류 설명보다 수정할 파일을 먼저
저장소는 같은 인증 흐름 문제에 답하는 두 방식을 나란히 보여준다. 기존 형태의 답변은 질문에 대한 인사말로 시작해 미들웨어, 토큰 검증, 쿠키 처리 등 관련 요소를 훑는다. 이어 src/auth.ts의 verifyToken 함수가 오래된 jsonwebtoken API를 쓰는 것 같다고 설명하고, 의존성 전반도 살펴보라고 권한다. 정작 사용자가 당장 무엇을 할지는 여러 문장을 읽고 나서야 드러난다.
스킬이 지향하는 답변은 npm install jsonwebtoken@latest를 실행하고 src/auth.ts의 42번째 줄을 확인하라는 지시로 시작한다. 그다음 verifyToken의 42~58번째 줄을 제시된 코드로 바꾸고 npm test -- auth.spec.ts를 실행하도록 단계를 나눈다. 테스트가 실패하면 첫 번째 실패 메시지 한 줄을 붙여 달라는 요청으로 끝난다. 같은 문제를 다루더라도 설명의 양보다 실행 순서와 다음 대화에 필요한 정보를 앞세운 구성이다.
첫 행동, 번호, 마지막 한 단계
저장소가 제시한 규칙은 모두 10개이며 전문은 SKILL.md에 담겨 있다. 앞부분의 세 규칙은 다음 행동으로 시작하기, 여러 단계의 작업에 번호 붙이기, 마지막에 구체적인 다음 단계 하나만 남기기다. 여러 선택지를 길게 늘어놓기보다 사용자가 지금 착수할 지점과 그다음 순서를 구분하도록 만든다. 인증 오류 예시에서 설치, 파일 수정, 테스트가 차례로 놓인 것도 이 원칙을 보여준다.
마지막 단계를 하나로 좁히라는 지시는 특히 답변의 끝을 바꾼다. 예시의 답변은 막연히 추가 질문을 받겠다고 끝나지 않고, 테스트 실패 시 무엇을 가져와야 하는지 지정한다. 그러면 사용자는 다시 어디서부터 설명해야 할지 고민하기보다 실패한 지점부터 대화를 이어갈 수 있다. 이 스킬은 문제를 한 번에 해결했다고 선언하기보다, 현재 답변을 다음 행동에 연결하는 방식을 택한다.
매번 상태를 알리고 시간은 분 단위로
다른 규칙들은 긴 작업이 이어질 때 답변을 읽는 부담을 겨냥한다. 에이전트는 매 차례 현재 상태를 다시 말하고, 시간이 필요하다면 ‘조금 걸린다’ 대신 분 단위로 구체화해야 한다. 완료한 일도 눈에 띄게 표시하며, 오류는 과장하거나 둘러대지 않고 사실대로 전달하도록 한다. 사용자가 앞선 답변을 다시 훑지 않아도 지금 어디까지 왔는지 파악하게 하려는 구성이다.
이 규칙들은 모두 짧게 쓰라는 주문과는 조금 다르다. 작업 상태, 걸리는 시간, 오류처럼 의사결정에 필요한 정보는 남기되 찾기 쉬운 자리에 놓으라는 요구에 가깝다. 특히 완료한 일을 드러내라는 규칙은 남은 일만 계속 제시하는 답변과 구별된다. 대화가 여러 차례 오갈수록 무엇이 끝났고 무엇을 해야 하는지를 구분하는 일이 중요해진다는 판단이 담겨 있다.
다섯 항목을 넘기지 않는 목록
저장소는 곁가지 설명을 줄이고 목록을 다섯 항목 이내로 제한하라고도 한다. 서론, 앞선 내용의 반복 요약, 형식적인 맺음말 역시 빼도록 정했다. 저장소가 없애려는 대표적인 문구는 질문을 칭찬하며 시작하는 말과 답변 끝의 의례적인 인사다. 친절해 보이는 표현이라도 파일 위치나 실행 명령을 찾는 데 방해가 되면 우선순위에서 밀린다.
목록 제한은 정보를 무조건 버리라는 뜻보다 한 번에 제시하는 작업을 좁히라는 편집 규칙으로 읽힌다. 인증 오류 예시도 관련 의존성을 모두 점검하자는 넓은 제안 대신, 수정할 함수와 확인할 테스트에 집중한다. 사용자는 긴 설명을 요약해 스스로 실행 계획을 만드는 일을 덜게 된다. 반대로 에이전트에는 중요한 정보를 남기면서 군더더기만 골라내는 판단이 요구된다.
SKILL.md를 고쳐 자기 버전으로 설치하기
저장소는 기본 규칙을 그대로 쓰는 데서 그치지 않고 개인별로 바꾸는 방법도 안내한다. 사용자는 저장소를 포크(원본을 복제해 자신의 저장소로 만드는 방식)한 뒤 skills/i-have-adhd/SKILL.md를 수정하면 된다. 안내된 절차는 기존 클로드(Claude) 플러그인을 제거하고, 같은 이름으로 등록된 기존 마켓플레이스 항목을 지운 다음, 자신의 포크를 추가해 다시 설치하는 순서다. 이후 코딩 도우미를 재시작하고 /i-have-adhd를 다시 호출하도록 한다.
이 과정에서 실제 응답 규칙이 담긴 파일은 SKILL.md다. 따라서 사용자가 바꾸려는 것이 목록 길이든 말투든, 손댈 지점은 저장소 전체가 아니라 그 지침 파일이다. 다만 설치 절차에는 플러그인과 마켓플레이스 설정을 교체하는 작업도 포함된다. 답변을 짧게 만드는 취향의 문제와, 에이전트에 어떤 지침을 설치할지 확인하는 운영상의 문제는 별개다.
사람의 일정 관리법을 LLM 답변에 맞추다
저장소는 이 스킬이 J. 러셀 램지(J. Russell Ramsay)와 앤서니 L. 로스테인(Anthony L. Rostain)의 책 《성인 ADHD 도구상자(The Adult ADHD Tool Kit)》를 느슨하게 참고했다고 설명한다. 동시에 사람이 하루를 정리하는 법이 아니라 LLM이 어떻게 답해야 하는지에 맞춰 각색했다고 밝힌다. 이름에 ADHD가 들어가지만, 저장소의 규칙은 진단 여부보다 답변을 읽고 행동으로 옮기는 과정에 집중한다.
마지막 안내도 이 도구의 문제의식을 드러낸다. 저장소는 형식적인 첫 문장을 지나 한 번이라도 더 스크롤할 필요를 줄였다면 별을 달아 달라고 말한다. 불필요한 도입부 하나가 큰 오류는 아닐 수 있다. 그러나 그런 문장이 매 답변마다 쌓일 때, 사용자가 필요한 명령과 경고를 찾아내는 일 자체가 작업이 된다는 것이 이 스킬의 출발점이다.
커뮤니티 의견
한 사용자는 클로드가 한 일뿐 아니라 하지 않은 일까지 길게 보고하는 버릇이 가장 거슬린다고 했다. 파일 두 개를 수정했다는 말 뒤에 다른 파일은 수정하지 않았고 커밋도 하지 않았다는 식의 설명이 따라온다는 것이다. 답글에서는 하지 말라는 지침을 받은 에이전트가 이를 지켰다고 반복하거나, 실패한 접근법을 되돌린 뒤 그 과정을 과하게 설명할 때 이런 답변이 나온다는 관찰이 이어졌다.
또 다른 사용자는 이 스킬을 지정하고 대화 중 거듭 상기시켜도 클로드의 간결함이 몇 차례 응답 뒤 무너진다고 했다. 매 응답에 지침을 주입하는 방법은 가능하겠지만 속도가 더 느려질까 걱정한다는 의견이다. 답글에서는 클로드 코드(Claude Code)에 결과부터 말하고 서론을 생략하는 ‘간결함’ 출력 스타일이 이미 있으며, 이 스타일도 오류 보고와 보안 경고 등은 온전히 유지한다고 소개했다.
설치 안내를 우려하는 의견도 나왔다. 한 사용자는 에이전트에게 GitHub 저장소를 찾아 설치하라고 지시하는 방식이, 출처를 확인하지 않은 스크립트를 실행하지 말라는 오래된 주의와 어긋나는 듯하다고 봤다. 이름이 비슷한 다른 저장소를 잘못 설치할 가능성이 걱정된다는 주장이다. 답글에서도 이런 설치 방식이 익숙한 절차처럼 받아들여지는 상황 자체를 불편해했다.
저장소의 규모에 의문을 제기한 사용자도 있었다. 한 댓글은 저장소가 59개 파일, 약 8700줄로 집계되는데 정작 핵심 프롬프트인 SKILL.md는 140줄이라고 짚었다. 답글에서는 나머지에 평가용 파일이 포함돼 있으며, 이는 배포되는 스킬 자체보다 지침을 개발하는 과정에 쓰이는 것으로 보인다고 설명했다. 짧은 응답 규칙을 만들기 위해 얼마나 많은 검토가 필요한가를 둘러싼 시각 차이다.
한 사용자는 답을 찾기 위해 장문의 설명을 읽어야 하는 문제가 ADHD 여부와 관계없이 누구에게나 성가시다고 했다. 더 나쁜 경우 중요한 세부 사항이 글 중간에 묻힌다는 지적도 이어졌다. 답글 작성자는 어떤 작업 표식의 근거를 이전 문서와 답변에서 찾지 못했던 경험을 들면서, 에이전트가 가끔은 완료된 일과 사용자가 할 일을 명확히 나눠 답한다고 말했다. 그런 형식을 꾸준히 유지하지 못하는 점이 불만이라는 것이다.
몇 달 동안 이 스킬을 써봤다는 사용자는 스킬만으로는 클로드의 장황한 말투를 계속 억제하기 어렵다고 평가했다. 같은 지침이라도 출력 스타일로 설정하면 응답 방식이 더 자주 상기돼 효과가 크다는 주장이다. 다만 출력 스타일에서도 긴 문장이 다시 나타나며, 동시에 활성화할 수 있는 스타일이 하나뿐이라는 제약을 덧붙였다.
다른 사용자는 문제를 인간의 처리 능력과 에이전트가 가정하는 정보량의 차이로 설명했다. 에이전트는 사용자가 긴 설명을 한꺼번에 소화할 수 있는 것처럼 답하지만, 실제 독자는 그렇지 않다는 의견이다. 이 관점에서 짧은 답변은 취향을 맞추는 장식이 아니다. 한 번에 처리해야 할 정보량을 사용자가 감당할 수 있게 조절하는 방식이다.
왜 이를 상시 설정인 AGENTS.md나 CLAUDE.md가 아니라 별도의 스킬로 만들었느냐는 질문도 나왔다. 답글은 긴 답변에 지쳤을 때 /i-have-adhd를 호출해 응답 방식을 바꿀 수 있다는 점을 이유로 들었다. 모든 대화에서 같은 형태의 답을 원하는 것은 아니며, 대화가 길어질수록 상시 지침의 영향력이 약해질 수 있다는 설명이다. 필요할 때 호출하는 방식과 처음부터 고정해 두는 방식 사이의 선택인 셈이다.
핵심 통찰
‘아이 해브 ADHD’가 바꾸려는 것은 코딩 에이전트의 지식보다 답의 전달 순서다. 수정할 파일, 실행할 명령, 실패했을 때 가져올 정보를 앞세우면 사용자는 설명 속에서 작업 계획을 다시 추출할 필요가 줄어든다. 관건은 이 형식이 긴 대화에서도 유지되는지, 그리고 간결함을 추구하다 오류나 보안 경고까지 밀어내지 않는지다. 설치할 지침을 확인하면서 필요한 순간에 안정적으로 호출할 수 있다면, 짧은 답변은 말투의 취향을 넘어 실질적인 작업 도구가 된다.
토론: Hacker News