Claude Code로 코딩 생산성 높이기 - i-have-adhd 프롬프트 후기

Claude Code에게 질문을 던지고 긴 설명을 읽었는데도 손이 멈추는 일이 있습니다. 답은 맞는데 첫 행동이 안 보일 때입니다.
i-have-adhd는 이 지점을 겨냥한 Claude Code 스킬입니다. GitHub 저장소 설명도 "답을 묻어버리지 않게 하는 ADHD 친화적 출력"으로 적혀 있습니다. 2026년 7월 20일 확인 기준 별 3,536개를 받았습니다. MIT 라이선스라 내용을 읽고 팀 규칙에 맞게 고칠 수 있습니다.

개요

i-have-adhd의 기준은 답변을 짧게 자르는 데 있지 않습니다. 사용자가 모든 문맥을 기억하지 않아도 다음 행동을 바로 할 수 있게 답변 순서를 바꿉니다.

예를 들어 인증 오류를 설명할 때 일반 답변은 원인 후보부터 길게 늘어놓기 쉽습니다. 이 스킬은 src/auth.ts:42를 열고 무엇을 바꿀지 먼저 말합니다. 설명은 뒤에 둡니다.

작업이 여러 단계면 번호를 붙이고, 한 단계에는 행동 하나만 둡니다. "파일을 열고 함수를 찾고 코드를 바꾸고 테스트를 실행"처럼 한 줄에 묶지 않습니다. 시작 비용을 줄이는 쪽입니다.

적용 대상

코딩 에이전트와 대화할 때 다음 상황에 특히 잘 맞습니다.

• 버그를 고치려는데 설명이 길어서 첫 파일을 못 고를 때
• 계획은 많지만 지금 할 일이 흐릴 때
• 여러 턴을 오가면서 현재 진행 단계를 잊을 때
• "조금 걸립니다" 같은 시간 표현이 판단에 도움이 안 될 때

저는 이 규칙이 ADHD 진단 여부와 관계없이 개발 작업에 유효하다고 봅니다. 에러 메시지, 수정할 파일, 실행할 테스트를 첫 화면에 두면 대화 기록을 다시 읽는 시간이 줄기 때문입니다.
반대로 한 번에 많은 선택지를 비교하거나 설계 배경을 깊게 검토해야 하는 작업에는 답변 길이를 무조건 줄이면 안 됩니다. 이 스킬도 사용자가 "설명해줘" 또는 "차근차근 알려줘"라고 요청하면 충분히 설명합니다.

전체 구성 흐름

스킬은 모든 사용자 메시지에 적용하도록 작성돼 있습니다. 출력은 다음 순서를 지킵니다.

• 실행할 명령, 파일 경로, 코드 조각을 첫 줄에 둡니다.
• 여러 작업은 번호 목록으로 분리합니다.
• 현재 완료 상태를 매 응답에 다시 적습니다.
• 예상 시간을 "약 15분"처럼 구체적인 단위로 말합니다.
• 남은 일이 있으면 2분 안에 가능한 다음 행동 하나로 끝냅니다.

파괴적인 작업은 예외입니다. rm -rf, force push, 스키마 마이그레이션처럼 되돌리기 어려운 행동은 짧은 답변보다 확인 절차가 우선입니다.

설치 절차

저장소의 skills/i-have-adhd/SKILL.md 파일을 Claude Code가 읽는 프로젝트 스킬 경로에 넣으면 됩니다. 저장소 전체를 내려받은 뒤 해당 폴더를 프로젝트의 .claude/skills/ 아래로 복사하는 방식이 가장 단순합니다.

git clone https://github.com/ayghri/i-have-adhd.git
mkdir -p .claude/skills
action_dir=i-have-adhd/skills/i-have-adhd
cp -R "$action_dir" .claude/skills/

스킬 설명에는 모든 메시지에서 적용하라고 적혀 있으니 확인하시면 됩니다. 팀에서 쓰기 전에는 강제 적용 범위를 먼저 정하십시오. 짧은 답변이 필요한 디버깅·작업 지시는 그대로 두고, 설계 검토나 문서 작성에는 "설명해줘" 예외를 명시하면 됩니다.
Claude Code 같은 도구를 자동화 흐름에 연결하는 방법은 n8n 셀프 호스팅 설치 글도 같이 보면 이어집니다.

확인

Claude Code에서 작은 요청 하나를 던져 확인해주시면 됩니다. 예를 들어 "로그인 테스트가 실패해"라고 물었을 때, 답변 첫 줄에 수정 대상이나 실행 명령이 나오고 마지막 줄에 다음 행동 하나가 남으면 적용된 것입니다.
저장소: ayghri/i-have-adhd
이 스킬의 포인트는 짧은 답변이 아니라, 읽은 뒤 바로 움직일 수 있는 답변입니다.