개발자를 위한 생성형 AI 활용 가이드

핫토리유우키

SENIORARCHITECT@GITHUB/VICEPRESIDENT@INNERSOURCECOMMONS.
개발자경험향상이나생성형AI의활용에조예가깊은아키텍트이다.생성형AI도구의도입,이너소스(OSS의수법을사내의클로즈드소프트웨어에적용하는수법)에대한풍부한경험이있다.

1장생성형AI,엔지니어링의상식을뒤집다
1.1변화는‘지금’일어나고있다.이제무엇을할것인가?
1.2생성형AI에대한과도한기대와현실의간극
1.3프롬프트엔지니어링기술은사실그리중요하지않다
__1.3.1용어의의미를정확히이해하자
__1.3.2안정성과정확도를추구하는것이프롬프트엔지니어링의핵심이다
__1.3.3엔지니어링작업의대부분은일회성이다
__1.3.4프롬프트엔지니어링기술이만능은아니다
1.4개발자의일자리는사라지지않는다
__1.4.1거짓을간파하는개발자가되자
__1.4.2AI에적절한작업을할당하는능력을키우자
__1.4.3토큰수에대한감각적인이해
__1.4.4토큰수를조정하여정확도유지
__1.4.5코드리뷰의프로가되자
__1.4.6적절한속도의코드리뷰
__1.4.7한번에적은양의코드리뷰
__1.4.8AI의발전속에서시험받는개발자의진정한가치
1.5AI는뛰어난개발자만을위한것이아니다
__1.5.1AI는주니어개발자의학습을돕는강력한도구
__1.5.2AI를통한지식습득
__1.5.3AI와의협업을통한빠른시행착오
1.6개발을지원하는AI도구를적절히활용하자
__1.6.1자동완성형–실시간으로소규모코드를제안
__1.6.2대화형–문제해결을유연하게지원
__1.6.3에이전트형–복합적인작업처리를지원
__1.6.4상황에맞게도구를적절히활용하자
1.7AI로팀의경쟁력을높이자
__1.7.1맞춤형AI로팀차별화하기
__1.7.2AI에제공할코드베이스는준비되어있는가?
__1.7.3내재화를통해AI를최대한활용하기
__1.7.4코드를조직차원에서성장시키기
__1.7.5비용절감만을목적으로AI를도입하고있지않은가

2장프롬프트로생성형AI제어하기
2.1시스템프롬프트와사용자프롬프트
__2.1.1업무용프롬프트의재사용여부판단하기
__2.1.2빠르고간결한일회성프롬프트생성하기
__2.1.3재사용프롬프트의추상화및세분화하기
2.2프롬프트의구성요소–AI에적절한정보를제공하기위한정보전략
__2.2.1정보구조화의세요소
__2.2.2글머리기호를사용한조건지정하기
__2.2.3제약조건을단계적으로도입하기
__2.2.4프롬프트수정하기
__2.2.5약속을어기는AI에대응하기
__2.2.6전문성을이끌어내는역할설정하기
__2.2.7즉석으로역할설정하기
__2.2.8퓨샷프롬프팅
__2.2.9제로샷프롬프팅
2.3상황에따른프롬프트최적화전략
__2.3.1프롬프트의품질과분량의균형
__2.3.2최소한의프롬프트
__2.3.3효율성을중시하는언어선택:영어와한국어의적절한활용
__2.3.4모국어를활용한빠른반복
__2.3.5영어프롬프트를활용한정교화
__2.3.6문맥을분리하기위한구분기호

3장프롬프트의사례와분석
3.1React컴포넌트생성프롬프트
__3.1.1핵심프롬프트는단순하게:롤플레이와기본지시
__3.1.2정확도를높이기:요구사항을정확하게만족하는지시
__3.1.3프롬프트출력을제어하기:포맷지시
__3.1.4사용하는기술지정하기:명확한조건
__3.1.5프로그램에서활용을고려하기:출력포맷에관한지시
__3.1.6프롬프트엔지니어링의핵심
3.2스크린샷으로UI를생성하는프롬프트
__3.2.1당신은숙련된개발자:롤플레이
__3.2.2한줄도빠짐없이전부작성해!:문맥을강조하는지시
__3.2.3외부에서제공되는기술:명확한조건
__3.2.4완전한코드만반환:출력형식지시
__3.2.5목적에맞는구체적인프롬프트설계
3.3SQL쿼리생성프롬프트
__3.3.1당신은SQL전문가:롤플레이와지시
__3.3.2절대하지마세요:강한금지의지시
__3.3.3주의해주세요:지시에우선순위를부여
__3.3.4출력정리하기:포맷지정
__3.3.5실행전에명령을구체화하기:콘텐츠삽입
3.4프롬프트에서문맥정보의중요성
3.5범용에이전트의프롬프트
__3.5.1범용에이전트의프롬프트는참고가될까
__3.5.2OpenHands의프롬프트디자인
__3.5.3명확한능력과행동범위:역할설정
__3.5.4여러개의작업을실행하기위한계획설계:전체계획
__3.5.5작업의의존관계를정리:작업순서정하기
__3.5.6작업실행에일관성을부여:이력관리
__3.5.7에이전트의행동을지정:Action정의
__3.5.8AI의사고와행동의균형:흐름제어
3.6프롬프트엔지니어링의본질
__3.6.1사용자프롬프트는정교하지않아도괜찮다
__3.6.2프롬프트의품질을높이기위한힌트

4장AI도구에적합한프롬프트전략
4.1자동완성형AI도구
__4.1.1사용자에의한프롬프트최소화
__4.1.2점진적구현지원
__4.1.3빠른응답과집중력유지
__4.1.4주석으로지시강화하기
__4.1.5AI도구에대한정보를제공하고관리하기
__4.1.6코드정의를명시적으로제공하기
__4.1.7중요한파일을고정해즉시참조하게하기
4.2대화형AI도구
__4.2.1문맥의유연한제어
__4.2.2다양한파일형식지원
__4.2.3외부정보에접근
__4.2.4이력의축적과재사용
__4.2.5명확한프롬프트
__4.2.6프롬프트품질에대한조기평가
__4.2.7AI기반프롬프트생성
__4.2.8AI를사용한자동리팩터링
__4.2.9AI의가독성을고려한정보설계
4.3에이전트형AI도구
__4.3.1AI작업적합성의사전평가와세분화수준의조정
__4.3.2에이전트에대한부분적인의뢰
__4.3.3필요한도구찾아보기

5장AI와협업하기위한코딩테크닉
5.1AI로작업단위최적화하기
__5.1.1관심사의분리를통한코드최적화
__5.1.2AI의효율을고려한파일구성
__5.1.3작은코드단위부터점진적으로작업
5.2코드의AI가독성향상
__5.2.1AI와의협업을고려한명명
__5.2.2검색에최적화된명명전략
__5.2.3AI의적절한명명제안
__5.2.4일관된변수명부여
5.3AI와협업을위한코딩스타일
__5.3.1스타일가이드를명시적으로제공
__5.3.2스타일가이드커스터마이즈
5.4부가정보를제공해AI의이해를돕기
__5.4.1표준화된코드안의문서
__5.4.2최소한의주석추가
__5.4.3애너테이션을활용한의도전달
5.5AI가가진지식을최대한이끌어내기
__5.5.1정보요구사항에맞춘도구선택
__5.5.2창의성을이끌어내는개방형질문
__5.5.3개수를지정해AI의아이디어발산유도
__5.5.4AI로부터미지의아이디어추출
__5.5.5아이디어평가를위한체크리스트생성

6장AI의잠재력을이끌어내는개발방식
6.1AI에적합한코드아키텍처
__6.1.1중첩을줄여AI협업의효율성개선
__6.1.2AI와분리된코드
__6.1.3확장을고려한코드설계
__6.1.4체계적인리팩터링기법적용
__6.1.5소규모오픈소스재구현
6.2AI를활용한코드품질향상
__6.2.1AI를활용한단위테스트생성
__6.2.2명확한테스트조건25
__6.2.3포괄적인테스트설계를위한의사결정테이블활용
__6.2.4상태전이도를기반으로테스트코드생성
__6.2.5필요없는테스트제거
6.3코드리딩에서의AI활용
__6.3.1자연어를활용한코드로직설명
__6.3.2복잡한로직의시각적표현생성
6.4코드리뷰에서AI활용
__6.4.1Big-O표기법기반성능개선
__6.4.2BUD프레임워크를활용한코드최적화
__6.4.3데이터구조의적절성평가
__6.4.4SOLID기반의코드품질향상
__6.4.5Chain-of-Thought프롬프팅

7장생성형AI의역량을최대한이끌어내는방법
7.1AI시대의경쟁력을높이는개발조직전략
__7.1.1오픈소스문화를조직에정착시키기
__7.1.2이너소스의원칙
__7.1.3이너소스의운영
__7.1.4조직내체계적인코드공유
__7.1.5메인테이너의명확한역할
__7.1.6사내소프트웨어카탈로그구축
__7.1.7경영진을참여시켜기술을공유하는전략
__7.1.8안전한코드공유체계마련
7.2AI시대의소프트웨어개발방식을팀차원에서실천하기
__7.2.1AI몹프로그래밍
__7.2.2AI페어프로그래밍
__7.2.3프롬프트활용사례공유
__7.2.4조직내AI활용을주도할인재육성
7.3AI와문서화
__7.3.1AI친화적인정보정리방식
__7.3.2구현중심의사양서작성
7.4AI시대에적합한팀기술스택최적화
__7.4.1AI시대에적합한기술스택선정
__7.4.2정보의이식성향상
__7.4.3AI로생성한코드의보안대책
7.5생성형AI도입효과의평가
__7.5.1개발자경험
__7.5.2FourKeys로개발프로세스평가
__7.5.3SPACE프레임워크로개발자경험평가
__7.5.4개발지원AI도구도입평가
__7.5.5도구도입의가치를가늠하기

8장개발에서AI를활용하기위한팁
8.1에디터와터미널을능숙하게활용하기
__8.1.1에디터에서필요없는정보제거
__8.1.2자동으로라이선스확인활용
__8.1.3에디터통합형터미널활용
__8.1.4환각을막기위한도움말정보활용
__8.1.5변경내용의차이를활용한커밋메시지품질향상
8.2데이터를자유롭게다루기
__8.2.1AI를활용한정규표현식생성지원
__8.2.2다양한날짜포맷인식
__8.2.3POSIXCRON형식의생성
__8.2.4특수한데이터포맷변환
__8.2.5AI를활용한비정형데이터분류
__8.2.6데이터전처리효율화
8.3빠른웹개발을위한AI테크닉
__8.3.1SEO개선제안
__8.3.2접근성평가
8.4AI와협업할때필수적인도구활용법
__8.4.1diff명령어를활용한변경지점파악
__8.4.2프롬프트라이브러리구축과활용
__8.4.3AI친화적인마크다운으로변환
__8.4.4머메이드로AI가독성이높은도식작성
__8.4.5PlantUML을활용한복잡한도식의AI가독화

9장AI시대를선도하기위해