개발 스킬

기존 구조를 활용해 새 기능이나 외부 연동을 필요한 범위에서 구현합니다. 완료 조건과 제외 범위를 먼저 정하고 관련 계층을 연결해 전체 동작을 완성합니다.

• 범위를 정해 새 기능을 구현할 때
• 기존 구조로 외부 서비스를 연동할 때
• 완료 조건과 제외 범위를 정할 때

코드에서 LLM을 사용하는 흐름을 업무 단위로 찾고 승인 후 용도별 라벨을 붙입니다. Caveman Cloud에서 처리 흐름별 비용을 나누어 확인할 수 있도록 합니다.

• LLM 비용을 업무별로 파악할 때
• API와 정기 작업의 LLM 사용을 조사할 때
• 평가 처리 비용을 따로 확인할 때

코드 위치 조사, 한두 파일의 수정, 변경 사항 검토를 전담 보조 에이전트에 맡깁니다. 짧고 구조화된 결과를 받아 주 에이전트의 문맥 사용량을 줄입니다.

• 정의와 호출 위치를 찾을 때
• 한두 파일만 제한적으로 수정할 때
• 변경 사항의 결함을 검토할 때

코드의 동작을 유지하며 로직 추출, 중복 통합, 담당 위치 이동을 진행합니다. 구조 변경 전후에 같은 검증을 수행해 동작이 일치하는지 확인합니다.

• 동작을 유지하며 로직을 추출할 때
• 중복된 로직을 통합할 때
• 모듈 사이에서 처리 책임을 옮길 때

처음 접하는 코드나 직접 검색으로 찾지 못한 처리의 관련 파일을 읽기 전용으로 조사합니다. 실제로 읽은 줄 범위와 짧은 이유를 함께 보고합니다.

• 처음 접하는 코드의 시작점 찾기
• 여러 파일에 걸친 처리 조사
• 직접 검색에 실패한 뒤 위치 찾기

Conventional Commits 형식으로 코드 변경 의도를 담은 짧은 커밋 메시지를 작성합니다. 호환성을 깨는 변경이나 마이그레이션 등에는 본문으로 배경을 덧붙입니다.

• 변경에 맞는 커밋 메시지 작성
• 커밋 메시지 형식 통일
• 호환성 변경과 마이그레이션 절차 기록

문제의 증상에서 원인을 추적해 해당 동작을 담당하는 최소 범위를 수정합니다. 주변 동작과 기존 변경을 보존하고 관련 테스트로 수정 결과와 재발 방지를 확인합니다.

• 주변 동작을 보존하며 오류를 수정할 때
• 작은 동작 변경을 적용할 때
• 특정 오류의 재발 방지 테스트를 추가할 때

테스트 실패, 빌드 오류, 예상 밖의 동작을 재현하고 원인을 좁힌 뒤 최소 재현 사례를 만듭니다. 근본 원인을 수정하고 재발 방지 테스트까지 진행합니다.

• 코드 변경 후 테스트 실패 조사
• 빌드 오류 원인 조사
• 작동을 멈춘 기능의 원인 확인

동작을 바꾸지 않고 깊은 조건 분기, 긴 함수, 중복, 모호한 이름을 정리합니다. 기존 규칙과 테스트를 확인하고 가독성을 기준으로 작은 변경을 이어 갑니다.

• 작동하는 기능의 코드 가독성을 높입니다
• 리뷰에서 지적된 복잡성을 정리합니다
• 깊은 조건 분기와 긴 함수를 정리합니다

프로젝트의 프레임워크와 라이브러리 버전을 확인하고 공식 문서에 따라 구현합니다. 판단의 출처를 제시하고 사용이 권장되지 않는 API와 확인하지 못한 방법도 표시합니다.

• 사용 버전의 공식 문서로 구현 확인
• 출처가 있는 기본 코드 작성
• 사용 중단이 권고된 API 점검

모호한 아이디어를 목표, 작업 범위, 검증 가능한 완료 조건이 담긴 명세로 정리합니다. 기능과 의존 관계를 나누고 사람의 승인을 거쳐 계획, 작업 분할, 구현으로 진행합니다.

• 구현 전에 아이디어를 구체화할 때
• 완료 조건을 포함한 요구사항 작성
• 큰 요구사항을 독립 기능으로 나누기

설계와 구현의 중요한 결정을 작업 이력을 공유하지 않는 별도 검토자에게 검증받습니다. 숨은 전제와 실패 조건을 찾아 수정하거나 결정을 재검토합니다.

• 설계안의 전제 검증
• 익숙하지 않은 코드의 판단 확인
• 인증과 민감한 처리 로직 검증

명세나 요구사항을 완료 기준과 검증 방법이 있는 작은 구현 작업으로 나눕니다. 의존 관계, 작업 순서, 확인 지점을 정리해 계획서와 작업 목록에 남깁니다.

• 큰 기능을 구현 작업으로 분할
• 의존 관계에 맞춘 작업 순서 정리
• 완료 기준과 검증 방법 명문화

혼합된 코드 변경을 목적별 커밋으로 나누고 브랜치와 PR 준비를 돕습니다. 호환성에 맞는 버전 번호와 변경 기록을 정리하고 커밋 전 점검도 다룹니다.

• 혼합된 변경을 목적별 커밋으로 나눕니다
• 검토할 브랜치와 PR을 준비합니다
• git worktree로 병렬 작업을 분리합니다

개발 과제에 맞는 스킬과 사용 순서를 선택하고 명세 작성부터 구현, 테스트, 배포까지의 흐름을 정리합니다. 전제 명시, 작업 범위 준수, 결과 검증의 공통 규칙도 안내합니다.

• 개발을 시작할 때 사용할 스킬을 고릅니다
• 새 기능의 작업 순서를 정리합니다
• 오류 수정과 검토 절차를 선택합니다

여러 파일에 걸친 기능 추가와 수정을 검증 가능한 작은 단위로 나눕니다. 구현, 테스트, 검증, 커밋을 반복하며 각 단계에서 작동하는 상태를 유지합니다.

• 여러 파일에 걸친 기능을 추가합니다
• 계획의 다음 작업을 구현합니다
• 기능 플래그로 미완성 기능을 숨겨 통합합니다

프로젝트 품질 기준을 수치와 확인 방법으로 문서화합니다. 변경 내역에서 테스트 생략, 경고 억제, 기준 하향을 점검해 에이전트 개발의 품질을 유지합니다.

• 에이전트 개발의 품질 기준 설정
• 커버리지와 성능 목표 선택
• 테스트 생략과 경고 억제 발견

화면 표시, API, 데이터베이스의 지연을 측정해 원인을 좁히고 개선 전후 수치로 효과를 확인합니다. 효과 없는 변경의 되돌리기와 성능 저하를 막는 감시까지 안내합니다.

• 페이지 표시와 조작 지연의 원인을 조사합니다
• API 지연과 반복 쿼리를 줄입니다
• 변경 후 성능 저하를 확인합니다

병합 전에 코드 변경을 정확성, 가독성, 설계, 보안, 성능의 다섯 기준으로 검토합니다. 필수 수정과 선택 제안을 구분하고 구체적인 개선 방법을 제시합니다.

• 병합 전 풀 리퀘스트 검토
• 인공지능이 작성한 코드 확인
• 리팩터링의 개선 효과 확인

기존 API와 기능의 폐기 판단부터 대체 구현으로의 단계적 이전, 사용 확인, 삭제까지 정리합니다. 운영 데이터베이스의 열 변경도 신구 코드가 공존하는 절차로 진행합니다.

• 기존 API에서 대체 API로 이전합니다
• 불필요한 기능의 종료를 계획합니다
• 운영 데이터베이스 열 이름을 단계적으로 바꿉니다

API와 모듈 사이의 입출력을 정의하고 이름, 오류 형식, 입력 검증을 통일합니다. 기존 호출 측과의 호환성과 재시도로 인한 중복 처리도 고려합니다.

• 새 REST API를 설계합니다
• 화면과 서버 사이의 데이터 규격을 정합니다
• 호환성을 유지하며 API를 확장합니다

기존 디자인 체계에 따라 스마트폰부터 큰 화면까지 대응하는 UI를 구현합니다. 컴포넌트 구조와 상태 관리, 키보드 조작, 로딩 중·빈 데이터·오류 표시를 정리합니다.

• 새 페이지와 UI 컴포넌트를 만듭니다
• 스마트폰과 컴퓨터 화면을 조정합니다
• 키보드와 화면 읽기 지원을 개선합니다

Paperclip의 실패, 중단, 지연, 잘못된 차단을 조사합니다. 원인 재현과 수정, 회귀 테스트, 실제 사용 절차 검증을 거쳐 검사를 통과하는 PR을 작성합니다.

• Paperclip 실행 실패를 수정합니다
• 중단과 잘못된 차단의 원인을 조사합니다
• 작업 실행 지연을 개선합니다

native Paperclip Runner에 새 실행 도구나 제공업체를 연결합니다. 요구 사항과 통신 규격 조사부터 구현, 패키지 제작, 실제 환경의 전체 동작 검증까지 진행합니다.

• Runner에 새 연결을 추가합니다
• 실행 도구의 통신 규격과 기능을 조사합니다
• 연결 기능의 취소와 복구를 검증합니다