코딩
현재 코드와 테스트를 보고 변이 테스트 도구 개선하기
변이 테스트 도구를 고칠 때 사용한다. 먼저 현재 코드와 테스트를 확인하고, 처리 순서와 지연 평가를 지키며, 잘못된 변이체를 만들지 않는 변이 연산자와 변이체를 잡아내는 테스트를 작성하고, 안전한 검토·CI·릴리스 절차를 따른다.
계층으로 나뉜 데스크톱 앱에 기능을 추가하고 모든 빌드를 테스트한다
코어, 데스크톱 호스트, 웹 UI로 나뉜 데스크톱 앱을 AI가 고칠 때 쓴다. 규칙은 코어에 두고, 도구가 쓸 수 있는 명령과 폴더를 좁히고, 선택 기능을 실제 의존성에 따라 나누고, 지원하는 모든 빌드를 테스트한 뒤에 완료한다.
저수준 시스템 패치에서 스타일 지적보다 진짜 버그를 먼저 찾기
드라이버나 네트워크 라이브러리 같은 저수준 시스템 코드의 패치를 검토할 때 씁니다. 메모리, 락, 오류 경로를 따라가고, 정수 폭, 스레드, 암호화, API 변경을 확인하며, 고칠 수 있는 문제만 알리고 스타일 지적은 아주 확실할 때만 합니다.
확장 가능한 Go 서비스에 기능을 더하고 설정이 덮어써져도 통과하는 테스트 쓰기
하위 빌드가 이름이나 설정을 바꾸는 Go 서비스를 고칠 때 사용한다. 로그에 트레이스 컨텍스트를 남기고, 새 도구를 알맞은 그룹에 등록하며, 설정이 덮어써진 상태에서도 공개 동작을 테스트하고, 생성되는 문서를 업데이트한다.
다른 웹 프레임워크와 똑같이 동작하는 호환성 계층을 만든다
다른 웹 프레임워크의 동작을 여러 런타임에서 다시 구현할 때 쓴다. 먼저 그 프레임워크의 테스트를 옮겨 오고, 요청 처리 순서와 런타임 경계를 지키며, 파일 경로 표기를 통일하고, 모든 검사를 통과한 pull request로만 병합한다.
관리형 래퍼와 네이티브 라이브러리를 ABI를 깨지 않고 고치기
네이티브 C 라이브러리를 감싸는 크로스 플랫폼 관리형 래퍼를 고칠 때 사용합니다. 모든 계층에서 변경을 따라가고, 오래된 다운로드 대신 소스에서 네이티브 바이너리를 빌드하며, 공개 ABI를 안정적으로 지키고, 포인터 소유권과 스레드를 바르게 다루며, 실패하는 테스트를 건너뛰지 않습니다.
JIT로 컴파일하는 GPU 커널 라이브러리에 커널을 추가하고 테스트하기
쓸 때 컴파일하는(JIT) GPU 커널 라이브러리를 AI가 다룰 때 쓴다. 커널을 모든 계층에 거쳐 추가하고, 생성 파일은 쓰기 가능한 폴더에만 두며, GPU 종류별로 테스트하고, 결과가 맞는지 확인한 뒤 속도를 잰다.
다중 프로토콜 통합 게이트웨이를 권한 검사를 깨지 않고 수정·검토하기
여러 프로토콜을 잇는 게이트웨이를 AI가 고치거나 검토할 때 사용합니다. 프로젝트의 검사를 통과시키고, 권한 검사를 엄격히 지키며, 추적과 감사 기록의 쓰기를 분리하고, 마이그레이션을 신중히 만들고, push 전에 승인을 받습니다.
취소와 장애에도 버티는 비동기 Rust 서비스 만들기
비동기 Rust 서비스를 만들 때 사용합니다. 목(mock)으로 때우지 않고 실제 코드를 끝까지 작성하고, 오류와 취소를 안전하게 처리하며, 실제 서비스 인터페이스로 테스트하고, 모든 검사를 통과한 뒤에 완료를 알립니다.
파일 형식과 API를 깨지 않고 다중 언어 데이터 라이브러리 수정하기
네이티브 코어와 가벼운 언어 바인딩으로 된 빠른 데이터 라이브러리를 AI에게 수정시킬 때 사용하세요. 안정 버전의 파일 형식과 공개 API의 호환성을 지키고, 문서화된 명령을 쓰며, 테스트와 문서까지 갖춥니다.
값을 몰래 바꾸거나 데이터를 흘리지 않는 데이터 복제(ETL) 코드 만들기
데이터베이스 사이에서 데이터를 복제하는 코드를 만들거나 고칠 때 쓴다. 변경을 작게 유지하고, 반올림 같은 조용한 값 변경을 막고, 잘못된 입력에는 멈추지 않고 오류를 돌려주며, 비밀 정보와 행 값을 로그에 남기지 않고, 테스트가 실제로 돌았는지 확인한다.
디바이스 자동화 도구의 코드를 고치고 실기기에서 동작 확인하기
여러 플랫폼에서 도는 디바이스 자동화 도구를 AI에게 고치게 할 때 씁니다. 변경을 작게 유지하고, 명령 정보를 하나의 레지스트리에 모으고, 변경에 맞는 테스트를 고르며, 새로 빌드한 결과로 실기기나 시뮬레이터에서 동작을 확인한 뒤 보고하게 합니다.
대규모 타입 모노레포를 수정하되 다른 패키지는 망가뜨리지 않기
AI가 여러 패키지로 된 코드베이스를 고칠 때 사용합니다. 변경을 맡은 패키지를 찾고, 공유 유틸리티를 재사용하며, 빌드와 타입 규칙을 지키고, 영향받는 패키지만 테스트한 뒤, 실제로 실행한 검사만 보고합니다.
데이터베이스 스토리지 엔진을 속도와 호환성을 해치지 않고 고치기
AI에게 데이터베이스 스토리지 엔진 코드를 고치게 할 때 사용합니다. 오류와 동시성을 올바르게 다루고, 자주 실행되는 코드는 벤치마크로 확인한 뒤에만 빠르게 하며, API·파일 형식·빌드의 호환성을 지키고, 재현 가능한 테스트를 통과한 뒤에 변경을 승인하게 합니다.
공유 워크트리에서 다른 작업을 망가뜨리지 않고 크로스 플랫폼 CLI 만들기
다른 세션도 함께 쓰는 워크트리에서 명령줄 도구를 만들 때 사용합니다. 현재 워크트리 안에서만 작업하고, 다른 사람의 변경을 버리지 않으며, 데이터 출력과 사람용 메시지를 나누고, 모든 OS에서 통과하는 테스트를 쓰고, 스냅샷과 문서를 최신으로 유지합니다.
루트 권한 없는 컨테이너 도구를 잠금과 이미지 다운로드 검증까지 갖춰 만들기
루트 권한 없이 동작하는 컨테이너 도구를 만들 때 사용합니다. AI가 변경 중인 컨테이너를 잠그고, 내려받은 이미지 레이어를 모두 검증하며, 호스트 설정을 컨테이너에 넘기지 않고, 프로세스 트리 전체를 종료하며, 백업 복원 시 위험한 경로를 거부합니다.
사용자 코드를 잃지 않고, AI 코드 리뷰와 수정을 자동으로 돌리는 도구 만들기
AI 코드 리뷰와 수정을 백그라운드에서 돌리는 도구를 만들거나 고칠 때 씁니다. 먼저 빌드 정의와 책임 문서를 읽고, 믿을 수 없는 브랜치의 설정이 명령을 실행하지 못하게 하며, 실행 중인 작업을 지키고 위험한 push와 릴리스를 막습니다.
AI 에이전트 스킬을 쓰고, 정말 도움이 되는지 테스트로 확인한다
AI 에이전트 스킬 라이브러리에 스킬을 추가하거나 고칠 때 쓴다. 이름과 버전, 알맞은 때에 호출되는 설명, 최소한의 도구 권한, 스킬이 있을 때와 없을 때를 비교하는 테스트, 릴리스 전 점검을 정한다.
프레임워크 모노리포에 테스트를 갖춘 작은 변경 넣기
AI에게 프레임워크 모노리포의 코드를 고치게 할 때 쓴다. 먼저 기준이 되는 지침 파일을 찾고, 변경을 하나의 동작으로 좁히고, 고치기 전에 실패하는 테스트를 쓰고, 건드린 부분의 보안·빌드·릴리스 노트를 확인한다.
워크플로를 돌리는 큰 Python 모노레포를 망가뜨리지 않고 고치기
워크플로를 예약하고 실행하는 큰 Python 모노레포에서 AI에게 코드를 고치게 할 때 쓴다. 스케줄러·워커·데이터베이스의 역할 구분을 지키고, 의존성을 알맞은 패키지에 두며, 바뀐 동작의 테스트부터 시작하고, 전체 diff를 다시 본 뒤 풀 리퀘스트를 연다.
API는 그대로 두고 클라이언트 라이브러리의 동기·비동기 버전 함께 수정하기
AI가 동기·비동기 클라이언트를 함께 제공하는 성숙한 클라이언트 라이브러리를 수정할 때 사용합니다. 공개 API와 오류 동작은 그대로 두고, 양쪽에 같은 변경을 적용하며, 자주 실행되는 경로를 느리게 하지 않고, 실패하는 테스트 하나부터 전체 매트릭스까지 테스트합니다.
AI 에이전트 메모리 서비스를 사용자별 기억이 섞이지 않게 만들기
AI 에이전트의 장기 메모리 서비스를 만들거나 확장할 때 쓴다. 메모리 뱅크마다 기억을 분리하고, 수집·검색·추론을 나누며, 데이터베이스 마이그레이션, API 클라이언트 갱신, 다른 모델이 판정하는 테스트, 테넌트나 뱅크별 설정까지 맞춘다.
분산 작업 플랫폼의 모노레포를 실제 서비스로 테스트하며 수정하기
AI가 분산 작업을 실행하는 모노레포를 수정할 때 사용한다. 패키지마다 맞는 검사를 고르고, 실제 데이터베이스와 큐로 테스트하고, 릴리스 기록을 남기고, 로컬에서 작업 하나를 끝까지 실행해 본 뒤, 무엇을 확인했고 무엇을 생략했는지 보고한다.
도메인 주도(DDD) .NET 모듈을 계층과 공개 API를 깨지 않고 만들기
도메인 주도 설계로 만든 모듈식 .NET 앱을 AI가 작성하거나 수정할 때 사용한다. 기존 방식을 따르고, 계층 간 의존을 한 방향으로 유지하며, 애그리게이트·리포지토리·DTO를 올바른 계층에 두고, 지원하는 모든 데이터베이스에서 기존 사용자에게 영향이 없는지 변경을 테스트한다.
시크릿을 유출하거나 저장 데이터를 깨지 않고 여러 브라우저용 확장 기능 수정하기
여러 브라우저에 배포하는 확장 기능을 고칠 때 씁니다. 시크릿을 로컬에만 두고, 의존성을 바꾸면 보안 정책을 다시 만들고, 저장 데이터 구조가 바뀌면 번호 붙은 업그레이드를 추가하고, 알맞은 계층에서 테스트하며, Git 작업은 요청받을 때만 합니다.
분산 머신러닝 학습·추론 코드를 망가뜨리지 않고 고치기
여러 프로세스나 가속기에서 머신러닝 모델을 학습하거나 실행하는 소프트웨어를 고칠 때 사용합니다. 위험한 변경 전에 먼저 확인받고, 가중치 버전을 맞추며, 모든 rank가 집합 통신을 같은 순서로 호출하게 하고, 구성 호환성을 지키며, 건너뛴 테스트를 알려 줍니다.
컨테이너 로그와 메트릭을 실시간으로 보여 주는 웹 앱 개발하기
백엔드와 단일 페이지 프런트엔드로 된, 컨테이너 로그와 메트릭을 실시간으로 보내는 앱을 고칠 때 씁니다. 계층, 스트림 한도, 로그인과 배포 모드를 지키며 기능을 모든 계층에 추가하고, 문서의 테스트를 돌리고, 짧은 검토를 씁니다.
다른 코드가 확장해 쓰는 공개 서버 패키지를 깨뜨리지 않고 변경하기
다른 코드가 훅으로 확장해 쓰는 공개 배포 서버 패키지를 고칠 때 쓴다. 비밀 정보를 넣지 않고, 콜백·훅·미들웨어 순서를 지키며, 기존 마이그레이션은 고치지 않고 새로 추가하고, 패키지에 실제로 있는 테스트와 린트를 실행한다.
오래 유지된 이식 가능한 C 프로젝트를 호환성을 깨지 않고 고치기
AI가 오래된 컴파일러, 여러 플랫폼, 선택 기능에서 계속 빌드되어야 하는 성숙한 C 코드를 고칠 때 쓴다. 영향받는 구성을 빌드하고 테스트하며, 스타일·메모리·커밋·문서·릴리스 규칙을 지키고, 패치마다 작고 단독으로 유효하게 만든다.
백엔드와 프런트엔드가 함께 있는 다중 모듈 저장소를 빌드를 깨지 않고 고치기
API, 백엔드, 프런트엔드가 한 저장소에 모여 있을 때 AI에게 수정을 맡기며 사용한다. 모듈마다 규칙을 읽고, 양쪽 변경을 맞추며, API 클라이언트는 손으로 고치지 않고 다시 생성하고, 바뀐 부분에 맞는 테스트를 돌리고, 마이그레이션이나 새 의존성 추가 전에는 먼저 묻는다.
대규모 다국어 데이터 플랫폼 모노레포를 수정하고 풀 리퀘스트를 준비한다
여러 언어로 작성된 대규모 데이터 플랫폼 코드베이스를 AI가 수정할 때 사용한다. 알맞은 Git 브랜치를 고르고, 자동 생성 파일은 직접 고치지 않으며, 가장 작은 테스트 기반을 쓰고, 바뀐 부분만 빌드·테스트하고, 실패한 CI를 모두 확인하며, push나 풀 리퀘스트 전에 허락을 받는다.
보안을 약하게 만들지 않고 Ansible 인프라 자동화를 작성하고 검토하기
AI에게 Ansible playbook 같은 인프라 자동화를 작성하거나 고치게 할 때 쓴다. 모든 lint와 보안 검사를 경고 없이 통과시키고, 비밀번호와 키를 저장소에 두지 않으며, 네트워크는 가장 아래 계층부터 살피고, 테스트가 버그를 잡는지 증명하고, 실제로 실행한 검사만 보고한다.
지연 실행을 지키며 대규모 Python 데이터 시스템 수정하기
AI가 대규모 Python 데이터 처리 또는 병렬 계산 코드베이스를 수정할 때 사용합니다. 먼저 계층을 파악하고, 그래프를 만드는 동안 계산을 실행하지 않으며, 가장 가까운 테스트부터 넓혀 가고, 허락 없이 배포나 패키지 공개를 하지 않습니다.
사양을 먼저 쓰고, 테스트부터 시작하는 작은 단위로 개발하기
사양과 계획이 있는 저장소에서 AI가 모호한 요청으로 코드를 쓸 때 씁니다. 불분명한 점은 질문으로 기록하고 답을 기다리며, 사양과 계획을 고치고, 실패하는 테스트를 먼저 쓰고, 바뀐 파일에 맞는 검사를 돌리고, 데이터베이스를 보호하고, 분명한 인계를 남깁니다.
통과·실패·판정 불가로 결과를 돌려주는 접근성 검사 규칙 만들기
웹 접근성 검사 엔진에서 AI가 규칙을 추가하거나 고칠 때 쓴다. DOM 계층과 의존성 계층을 나누고, HTML·ARIA 데이터를 한곳에서 읽으며, Shadow DOM을 포함한 실제에 가까운 페이지로 테스트하고, 번역을 맞추며, 호환성을 깨지 않게 한다.
실제 명령과 플래그로 AI 에이전트용 명령 스키마 생성하기
AI 에이전트에게 어떤 명령이 있고 어떻게 호출하는지 알려 주는 스키마를 만들 때 쓴다. 검토된 명령 목록과 실제 명령에서 한 방향으로 생성하고, 명령 대응, 예제, 안전과 확인 정보가 맞는지 확인한다.
모듈로 나뉜 Java 프로젝트에서 호환성을 지키며 작게 고치기
AI가 모듈로 나뉜 Java 프로젝트를 고칠 때 사용한다. 먼저 빌드와 CI 규칙을 확인하고, 이전 Java 버전과 모듈 간 의존성이 계속 동작하게 하며, 알맞은 계층에서 테스트하고, 범위가 넓거나 위험한 변경 전에는 묻는다.
다중 언어 코드형 인프라(IaC) 라이브러리에 기존 사용자를 깨지 않고 기능 추가하기
다른 언어용 바인딩을 자동 생성하는 타입 IaC 라이브러리를 고칠 때 씁니다. 기능을 알맞은 계층에 두고, 바인딩이 표현 못 하는 문법을 피하며, 동작 변경은 기능 플래그로 지키고, 권한을 좁게 유지하고, 문서와 테스트를 추가합니다.
보안을 약하게 하지 않고 Go 서버에 모듈 추가하기
확장할 수 있는 Go 서버의 기능을 만들거나 리뷰할 때 사용합니다. AI가 각 모듈을 만들기부터 정리까지 순서대로 작성하고, 구성 파일을 엄격하게 읽고, Linux·macOS·Windows에서 테스트·린트·빌드를 통과한 뒤 병합하며, 풀 리퀘스트는 사람에게 맡깁니다.
저장소 규칙에 맞춰 네이티브와 웹에서 동작하는 TypeScript 앱 만들기
네이티브와 웹에서 함께 동작하는 TypeScript 앱을 만들거나 고칠 때 쓴다. AI가 저장소의 스크립트와 폴더 구성을 따르고, 공용 컴포넌트를 재사용하며, 화면에 보이는 문구를 번역할 수 있게 만들고, 영향을 받는 모든 플랫폼에서 테스트한 뒤 마무리한다.
데이터베이스부터 UI까지 호환성을 지키며 풀스택 저장소 수정하기
AI가 풀스택 저장소를 수정할 때 사용합니다. 먼저 저장소 지침을 읽고, 데이터베이스 키와 마이그레이션, API 필드의 호환성을 지키며, 공유 구성 요소와 언어 리소스를 쓰고, 실제로 실행한 검사만 보고합니다.
실제 브라우저를 지켜보며 실패한 E2E 테스트를 고친다
E2E 테스트가 실패했을 때 사용한다. 브라우저에서 보이는 성공 상태를 정하고, 실제 브라우저에서 실행해 스크린샷과 콘솔 오류를 모으고, 원인을 테스트·코드·환경으로 나눈 뒤, 가장 작게 고치고, 통과하거나 멈춰야 할 때까지 다시 실행한다.
채팅과 이슈 추적기에서 요청을 받는 코딩 에이전트 서비스 만들기
코드 호스팅 플랫폼, 이슈 추적기, 채팅에서 일을 받는 코딩 에이전트 서비스를 만들 때 쓴다. 메인·검토·분석 역할을 나누고, 스레드마다 샌드박스를 하나씩 두며, 미들웨어 순서를 정하고, CI 자동 복구에 켜고 끄는 스위치를 단다.
OpenAPI 명세를 먼저 고쳐서 Go API와 React SPA 변경하기
Go 백엔드와 React SPA가 OpenAPI 명세를 함께 쓰는 저장소에서 사용합니다. 생성된 파일을 손으로 고치지 않고 명세를 고쳐 다시 생성하며, 설정·오류·로그인·다운로드·업데이트를 정해진 규칙대로 다루고, 테스트한 뒤 보고합니다.
테마를 지원하는 UI 컴포넌트 라이브러리에서 컴포넌트 만들기·고치기
재사용 가능한 UI 라이브러리에서 AI에게 컴포넌트를 추가하거나 고치게 할 때 사용하세요. 변경이 닿는 파일을 찾고, 테마 기본값·접근성·오른쪽에서 왼쪽 레이아웃을 지키며, 테스트와 문서까지 갖춥니다.
소프트웨어 아이디어를 테스트된 멀티 에이전트 시스템으로 만든다
여러 AI 에이전트와 도구가 함께 일하는 시스템을 만들 때 쓴다. 질문은 하나씩 하고, 역할과 통신 설계를 승인받은 뒤, 종속성 순서대로 만들며, 5개의 사용자 시나리오를 통과할 때까지 반복해서 테스트한다.
풀스택 TypeScript 모노레포를 고치고, LLM 기능은 의미로 테스트한다
LLM 기능이 있는 TypeScript 모노레포를 AI가 고칠 때 쓴다. CI와 같은 패키지 단위 검사만 돌리고, 동작을 테스트하며, 개인정보를 넓은 로그에 남기지 않고, LLM의 답을 표현이 아니라 의미로 판단한다.
서버와 클라이언트가 함께 쓰는 API 스키마로 풀스택 TypeScript 앱 만들기
풀스택 TypeScript 앱을 만들거나 고칠 때 사용하세요. AI가 라우트와 클라이언트 훅에서 함께 쓸 API 요청과 응답을 한 번만 정의하고, 입력을 읽기 전에 인증을 확인하며, 의존성·캐시·컴포넌트 스타일을 일관되게 유지하며, 빠른 테스트를 작성합니다.
풀스택 모노레포에서 공유 패키지를 망가뜨리지 않고 코드를 고친다
앱과 공유 패키지가 함께 있는 모노레포를 AI가 고칠 때 쓴다. 변경을 알맞은 모듈에 두고, 생성되는 번들을 다시 빌드하고, 조직별 데이터를 섞지 않으며, 테스트 결과를 붙인 풀 리퀘스트로 넘긴다.
고성능 데이터베이스 코드를 속도와 호환성을 해치지 않고 고치기
Java, SQL, Rust, 네이티브 코드, CI에 걸친 속도 중심 데이터베이스를 AI가 고칠 때 씁니다. 코드 작성 방식, NULL 처리와 메모리 정리, 쿼리 테스트, 실패 조사, 풀 리퀘스트와 빌드 규칙을 정하고, 완료를 말하기 전 마지막 확인으로 끝냅니다.
일부러 취약점을 넣은 보안 교육용 앱을 도전 과제를 깨지 않고 수정하기
보안 취약점을 교육 내용으로 쓰는 교육용 앱을 고칠 때 씁니다. 의도한 도전 과제와 실수로 생긴 취약점을 구분하고, 변경을 작게 유지하며, AI가 만든 불필요한 내용을 지우고, 필요한 테스트와 안전망을 돌리고, 수정 파일을 맞춥니다.
C++ 분석 데이터베이스 엔진을 고치고 필요한 테스트까지 통과시키기
C++로 만든 분석 데이터베이스 엔진의 코드를 고칠 때 사용한다. AI가 SQL 파싱부터 실행까지의 흐름을 따라 고칠 곳을 찾고, 생성 파일은 원본 소스에서 고치며, C++ 작성 규칙과 오류 처리 규칙을 지키고, SQL 로직 테스트와 필요한 빌드를 모두 통과한 뒤에 마친다.
실패하는 테스트로 먼저 재현한 뒤 최소한으로 버그 고치기
버그 보고를 받았을 때 쓴다. AI가 버그가 어느 부분의 문제인지 나누고, 사용자에게 보이는 실패를 실패하는 테스트로 재현하고, 진짜 원인을 찾아 최소한으로 고친다. 테스트는 재발 방지용으로 남기고, 사용자와 같은 순서로 다시 해 보며 고쳐졌는지 확인한다.
레이어가 있는 이미지 파일을 데이터 손실 없이 읽고 쓰는 라이브러리 만들기
레이어가 있는 이미지의 이진 형식을 다루는 라이브러리를 만들 때 사용합니다. 저수준 파싱과 사용자 API를 나누고, 구역을 순서대로 읽고, 알 수 없는 데이터를 남기고, 레이어 그룹을 다시 만들고, 읽기·쓰기·다시 읽기 테스트로 확인하고, 자동화로 출시합니다.
개발자를 위한 보안 문서를 쓰고 검토하기
공유 저장소에서 개발자를 위한 보안 문서를 쓰거나 검토할 때 사용한다. 실제로 읽은 출처만 인용하고, 각 대책이 무엇을 막고 무엇을 막지 못하는지 쓰며, 변경을 작게 유지하고, 저장소의 검사를 실행하고, AI 사용 사실을 밝힌다.
큰 TypeScript 모노레포에 테스트를 거친 작은 변경 적용하기
여러 패키지로 된 TypeScript 작업 공간을 AI가 수정할 때 사용합니다. 먼저 저장소 구조와 도구를 파악하고, 이번 변경과 관련된 빌드와 테스트만 실행하며, 생성된 파일은 함부로 바꾸지 않고, Unix와 Windows 양쪽에서 잘 동작하는지 확인합니다.
여러 구현이 있는 모노레포를 구현끼리 동작을 맞춘 채로 고치기
한 제품을 여러 구현으로 만든 대규모 다중 언어 모노레포를 변경할 때 쓴다. 먼저 해당 위치의 규칙을 읽고, 사용자에게 보이는 변경을 모든 구현에 똑같이 넣고, 테스트가 쓰는 산출물을 다시 빌드하고, 필요한 테스트만 돌려 실패를 모두 조사하고, 릴리스 항목을 추가하고, 변경 요청을 병합까지 최신으로 유지한다.
상태를 가진 UI 라이브러리를 기존 사용자를 깨뜨리지 않고 조금씩 고치기
상태를 가진 브라우저용 UI 라이브러리를 AI가 고치거나 바꿀 때 쓴다. 상태의 주인을 찾고, 공개 API와 저장된 데이터의 호환성을 지키며, 먼저 실패하는 테스트를 쓰고, 단위 테스트와 실제 브라우저 테스트 중에서 고르고, 끝내기 전에 변경 차이와 릴리스 노트를 확인한다.
공식 SDK와 CLI로 그대로 쓸 수 있는 로컬 클라우드 에뮬레이터 만들기
내 컴퓨터에서 클라우드 플랫폼을 흉내 내는 에뮬레이터에 서비스나 작업을 추가할 때 사용합니다. 먼저 실제 통신 프로토콜을 확인하고, 요청과 응답 형식을 실제 클라우드와 똑같이 유지하며, 저장 방식과 설정을 함께 고치고, 릴리스 전에 공식 SDK 클라이언트로 테스트합니다.
실제 하드웨어와 같은 버스·타이밍 동작으로 에뮬레이터 만들기
에뮬레이터를 만들거나 고칠 때 씁니다. 하드웨어 부품별로 코드를 나누고, 버스 읽기·쓰기와 타이밍, DMA를 실기와 똑같이 재현하며, 실기에서 통과하는 참조 프로그램으로 테스트하고, 저장 상태와 공개 API를 안정적으로 유지합니다.
작은 코드 변경을 로컬 검사와 검토로 확인하며 진행하기
AI에게 코드를 고치게 할 때 쓴다. 바꿀 범위와 완료를 증명할 방법을 먼저 정하고, 변경 전후에 로컬 검사를 돌리고, 현재 변경 차이를 검토받아 진짜 문제만 고치며, 마지막에 다른 에이전트가 이어받을 수 있는 인계 보고를 남긴다.
여러 언어의 자동화 모노레포를 호환성을 깨지 않고 고치기
여러 언어 바인딩이 있는 큰 자동화 모노레포를 AI에게 고치게 할 때 씁니다. 공개 API 호환성을 지키고, 고정된 빌드 도구로 영향을 받는 가장 작은 대상만 빌드하고 테스트하며, 다른 언어 바인딩이 같게 동작하는지 비교하고, 위험이 큰 공유 영역을 바꾸기 전에 확인을 요청합니다.
생성 워크플로 앱에서 OpenAPI로 백엔드와 프런트엔드를 맞추기
항목을 추출해 준비 페이지에서 확인하고 생성 작업공간에서 생성을 시작하는 앱을 고칠 때 사용합니다. API를 바꿀 때마다 OpenAPI 타입을 다시 만들고, 화면별 역할과 상태 종류를 나누며, architecture 문서·plans·릴리스 노트를 최신으로 유지합니다.
패키지가 많은 대규모 모노레포에서 코드를 고치고 테스트하기
패키지가 많은 대규모 프레임워크 저장소에서 AI가 작업할 때 쓴다. 편집 전에 구조를 파악하고, 빌드를 최신으로 유지하며, CI 모드에 맞는 테스트를 고르고, 검토 댓글보다 CI 실패를 먼저 고치며, 시크릿을 로그에 남기지 않고, 변경마다 확인한 뒤 완료를 알린다.
공개 API를 깨지 않고 저수준 라이브러리를 작게 고치기
저수준 시스템 라이브러리를 AI가 고치거나 바꿀 때 쓴다. 변경은 작게 하고, 요청이 없으면 공개 API와 ABI를 바꾸지 않으며, 빌드와 바뀐 하위 시스템의 테스트를 돌리고, 메모리 오류에도 안전하게 실패하게 하며, 원격으로 push하지 않는다.
여러 패키지로 된 코드베이스를 지금 동작을 깨뜨리지 않고 고치기
여러 패키지가 있는 저장소를 AI에게 고치게 할 때 쓴다. 변경을 맡은 패키지와 그곳의 규칙을 먼저 확인하고, 지금의 동작과 공개 이름을 유지하며, 테스트와 문서를 함께 추가하고, 의존성을 추가하기 전에 승인을 받고, 무엇을 확인했고 어떤 위험이 남았는지 보고한다.
코드 동작을 바꾸지 않는 자동 수정이 있는 정적 분석 규칙 만들기
정적 분석(lint) 규칙을 만들 때 씁니다. 흔한 패턴만 대상으로 하고, 기존 헬퍼를 다시 쓰며, 안전할 때만 자동 수정을 붙이고, 까다로운 구문도 테스트하며, 생성되는 문서는 손으로 고치지 않고 다시 생성합니다.
로봇과 AI용 Rust 데이터플로 프레임워크를 변경에 맞는 테스트로 개발하기
로봇과 AI용 Rust 데이터플로 프레임워크를 AI가 고칠 때 사용합니다. 메시지 규칙을 분명히 지키고, 커밋마다 검사를 통과시키며, 위험도에 따라 깊은 테스트를 고르고, 실제로 돌린 테스트를 보고합니다.
백엔드 코드를 고칠 때 업로드와 사용자 입력을 통한 공격 막기
업로드 파일, 아카이브, 요청 데이터를 다루는 백엔드 코드를 AI가 수정할 때 쓴다. 외부 데이터가 어디로 가는지 추적하고, 쓰기 전에 검증하고, 비슷한 모든 코드 경로에 같은 수정을 적용한 뒤, 보안 체크리스트와 lint·테스트 통과로 마무리한다.
테넌트와 에디션을 섞지 않고 멀티테넌트 자동화 플랫폼을 만든다
커뮤니티·엔터프라이즈·호스팅 에디션이 있는 멀티테넌트 자동화 플랫폼의 코드를 작성할 때 쓴다. 쿼리를 올바른 프로젝트로 좁히고, 외부 HTTP 요청을 안전한 클라이언트로 보내 SSRF를 막고, 의존성을 사용하는 워크스페이스에 선언하며, 모든 에디션을 테스트한 뒤에 끝낸다.
이벤트 기반 상태 머신을 동작을 깨뜨리지 않고 만들고 고치기
상태 머신 라이브러리를 만들거나 고칠 때 쓴다. AI가 이벤트 하나를 끝까지 처리한 뒤 다음으로 넘어가고, 오류가 나도 정리 콜백을 건너뛰지 않으며, 스레드와 자식 머신을 안전하게 지킨다. 테스트를 먼저 써서 동기·비동기 엔진에서 돌리고, 코드·문서·스키마를 맞춘다.
여러 언어가 섞인 큰 저장소에서 필요한 빌드와 테스트만으로 코드 변경하기
여러 프로그래밍 언어가 섞인 큰 저장소에서 코드를 고칠 때 쓴다. 비슷한 코드를 먼저 살피고, 쓸 수 있는 도구와 하드웨어를 확인하고, 변경이 영향을 주는 빌드와 테스트만 실행하며, 병합 전에는 전체 CI를 통과시키고 확인하지 못한 것도 보고한다.
JavaScript와 네이티브 코드로 된 웹 개발 CLI를 담당 계층에서 고치기
JavaScript와 네이티브 코드가 섞인 웹 개발 CLI를 바꿀 때 씁니다. CLI 동작을 담당하는 계층을 찾고, 전역과 로컬 두 명령 경로를 확인하며, 변경 종류에 맞는 테스트를 고릅니다.
업로드한 문서를 읽어 AI 에이전트가 검색할 수 있는 시스템 만들기
PDF 등의 파일을 받아 AI 검색용 서비스를 만들 때 사용한다. 각 파일을 형식에 맞는 파서로 보내고, 제목과 표를 보존하며, 청크를 정해진 형식으로 저장하고, 정해진 예산 안에서 검색해 출처가 붙은 근거를 돌려준다.
비밀을 조각으로 나누는 오프라인 복구 소프트웨어 개발하기
비밀을 조각으로 나눠 신뢰하는 사람들에게 맡기고 오프라인으로 복구하는 소프트웨어를 고칠 때 사용합니다. 변경과 연결된 부분을 모두 추적하고, 암호 처리를 CLI와 브라우저가 함께 쓰게 하며, 패키지를 오프라인으로 유지하고, 테스트를 먼저 쓰고, 불안한 사람도 이해할 차분한 문장을 씁니다.
하나의 API를 여러 프로그래밍 언어에서 쓸 수 있게 하는 프레임워크를 개발한다
하나의 코드에서 여러 언어용 패키지를 만드는 프레임워크를 개발할 때 쓴다. 프로세스 사이의 JSON 통신, 내보낼 수 있는 타입, 코드 생성, 모든 언어에서 동작이 같은지 확인하는 테스트의 규칙을 정한다.
도구로 조사하는 AI 에이전트를 만들고 추측으로 답하지 않는지 테스트하기
도구를 호출해 문제를 조사하는 AI 에이전트를 만들 때 사용합니다. 도구는 기본적으로 읽기 전용으로 두고 돌려주는 데이터를 제한하며 실패 내용을 정확히 알려 주고, 설정 이름을 바꿔도 옛 이름이 계속 동작하게 하며, 실제로 조회해야만 알 수 있는 사실을 묻는 테스트로 확인합니다.
사람이 검토하고 제출할 수 있도록 코드 기여 준비하기
여럿이 함께 쓰는 코드 저장소에서 AI에게 작업을 맡길 때 사용하세요. 프로젝트 규칙을 따르고, 관리자의 승인을 기다리며, 비밀 정보를 커밋과 테스트에 넣지 않고, 풀 리퀘스트는 사람이 보낼 초안으로 만듭니다.
모듈형 Rust AI 프레임워크에 새 AI 공급자와 벡터 스토어를 추가한다
여러 AI 공급자를 지원하는 Rust 프레임워크를 확장할 때 쓴다. 기존 trait와 builder를 따르고, WebAssembly 지원을 유지하며, 훅이 스트리밍 여부와 상관없이 똑같이 동작하게 하고, 녹화한 테스트 카세트에 API 키가 새지 않았는지 확인한다.
크로스 플랫폼 CLI 다운로더에 도구를 추가하고 바이너리마다 확인하기
릴리스 바이너리를 내려받는 설치 도구에 명령줄 도구를 추가하거나 검토할 때 씁니다. 운영체제와 아키텍처별 배포 파일을 조사하고, 다운로드 URL을 연결하고, 고정 버전으로 테스트를 쓰고, 내려받은 바이너리를 하나씩 검사하고, 카탈로그와 PR 설명을 업데이트합니다.
콘솔 UI 툴킷을 최신 문서대로 고치고 실제 화면으로 확인하기
큰 재작성이 있었던 콘솔 UI 툴킷에서 작업할 때 사용합니다. 옛 습관 대신 현재 저장소 문서를 따르고, 테스트를 알맞은 곳에 두며, 실행 중인 터미널을 녹화해 UI 변경을 확인합니다.
큰 .NET 코드베이스를 빠르고 호환되게 유지하며 고치기
널리 쓰이는 빌드 엔진처럼 성능이 중요한 큰 .NET 저장소를 고칠 때 사용합니다. 핵심 실행 경로에서 불필요한 메모리 할당을 늘리지 않고, 새 경고도 호환성을 깨는 변경으로 다루며, 가장 작은 프로젝트부터 빌드하고, 실행한 빌드·테스트·샘플을 알려 줍니다.
Rust 라이브러리·CLI 워크스페이스를 참조 도구와 비교하며 고친다
라이브러리와 명령줄 도구를 함께 담은 Rust 워크스페이스를 AI가 고칠 때 쓴다. 실패하는 테스트부터 쓰고, 참조 도구와 결과를 비교하며, unwrap()을 쓰지 않고, 모든 기능 조합을 테스트한다.
모바일 UI 자동화 프레임워크를 개발하고 버그는 CI가 아닌 제품에서 고치기
AI가 크로스 플랫폼 모바일 UI 자동화 프레임워크를 개발할 때 사용합니다. 각 변경을 맡은 모듈에 두고, 동작을 증명하는 가장 저렴한 테스트 계층을 고르며, 통과해야 할 테스트 모음과 실패해야 할 테스트 모음을 나누고, CI 설정이 아닌 제품에서 버그를 고칩니다.
AI 에이전트가 조회할 수 있는 로컬 코드 그래프 도구 만들기
코드베이스를 AI 에이전트용 로컬 그래프로 만드는 도구를 개발할 때 사용합니다. 구문 트리에서 심볼과 관계 추출, 여러 클라이언트에 설치하고 깔끔하게 제거하는 방법, 에이전트가 쓰기 좋은 검색 응답, 실제 저장소와 플랫폼에서의 테스트, 릴리스 진행을 다룹니다.
크로스 플랫폼 툴체인 관리자를 개발하고 레지스트리에 올릴 도구를 심사하기
개발 도구의 버전을 설치하고 바꿔 주는 도구를 AI 에이전트가 개발할 때 쓴다. 저장소의 작업 명령과 모듈 구조를 따르고, 도구를 레지스트리에 올리기 전에 널리 쓰인다는 근거를 모으며, 버전 순서는 각 백엔드에 맡기고, 플랫폼별로 범위를 좁힌 테스트를 실행한다.
생성 코드가 있는 여러 모듈 저장소를 승인 범위 안에서 고치기
AI가 생성 코드가 있는 여러 모듈 저장소에서 작업할 때 사용한다. 먼저 로컬 규칙을 읽고, 생성된 파일 대신 사양을 고치며, 모듈 단위로 테스트한 작고 호환되는 변경을 만들고, 릴리스와 파이프라인은 권한 있는 사람에게 맡긴다.
AI 모델을 평가하는 대규모 TypeScript 리포지토리를 수정하고 테스트하기
CLI, 웹 앱, AI 모델 평가를 갖춘 대규모 TypeScript 리포지토리에서 AI 에이전트가 작업할 때 사용합니다. 로컬 규칙을 읽고, 실제 CLI나 브라우저에서 변경을 확인하고, 캐시나 데이터를 지우지 않고 디버깅하며, 브랜치와 CI로 변경을 반영하고, 보안을 먼저 검토합니다.
타입 기반 모노레포를 망가뜨리지 않고 고치고, 프로젝트 Wiki를 최신으로 유지하기
프로젝트 Wiki가 있는 큰 타입 기반 모노레포에서 AI가 작업할 때 사용합니다. 리포지토리가 정한 명령을 쓰고, 오래된 빌드 출력과 시작 스냅샷 문제를 피하며, 필요한 테스트를 실행하고, Wiki 페이지를 출처 파일과 함께 갱신합니다.
이벤트 루프와 보안을 깨뜨리지 않고 Rust 리버스 프록시를 고치세요
AI가 다중 프로세스 Rust 프록시를 변경·테스트·출시할 때 사용합니다. 빌드와 기능 플래그, 오류와 로그, 이벤트 루프와 프로토콜 동작, 테스트와 퍼징, 보안 관련 코드, 풀 리퀘스트, 출시 절차의 규칙을 정합니다.
대규모 플랫폼 모노레포를 고치면서 영향받는 클라이언트를 모두 맞춘다
CLI, 클라이언트 라이브러리, 문서가 함께 있는 플랫폼 모노레포를 AI가 고칠 때 쓴다. 각 영역의 규칙을 먼저 읽고, 생성 파일은 소스에서 다시 만들며, 호환성을 깨는 변경 전에 묻고, 실행한 검사를 보고한다.
AI가 만든 풀 리퀘스트를 사람의 검토를 거쳐 오픈 소스 프레임워크에 보내기
AI가 Java 오픈 소스 프레임워크에 코드를 기여할 때 씁니다. AI 작업임을 밝히고, 고치기 전에 코드 이력을 읽고, 테스트의 고정 대기를 없애며, 프로젝트의 보안 신뢰 모델을 따르고, 사람의 승인 뒤에만 병합합니다.
스키마로 검사하는 AI 제공업체·모델 카탈로그에 항목 추가하기
AI 제공업체와 모델을 모은 카탈로그에 AI가 항목을 추가하거나 검토할 때 쓴다. 저장소의 검증 도구를 돌리고, 공통 모델 정보는 복사하지 않고 상속하며, 추론 설정과 가격은 확인된 것만 적고, 동기화 뒤에도 출처가 남게 한다.
빌드가 느린 대규모 네이티브 코드 저장소를 언어 간 호출을 깨지 않고 고치기
네이티브 언어, 생성된 바인딩, 오래 걸리는 빌드가 섞인 대규모 저장소를 고칠 때 씁니다. 변경 크기에 맞춰 진행 방식을 바꾸고, 가장 작은 테스트부터 돌리며, 긴 빌드 로그는 한 번만 저장하고, 언어 간 호출을 지킵니다.
웹 페이지에서 본문을 뽑아내는 도구를 만들고, 사라진 본문의 원인을 찾는다
브라우저, 서버, 명령줄, 엣지 환경에서 웹 페이지 본문을 뽑아내는 도구를 만들거나 고칠 때 쓴다. 정리 단계의 순서를 지키고, 제거한 것을 모두 기록하며, 페이지 HTML을 통한 스크립트 주입을 막고, 먼저 실패하는 작은 테스트로 수정을 증명한다.
사용자 코드를 깨뜨리지 않고 공개 Go 라이브러리를 수정한다
다른 사람이 쓰는 공개 Go 라이브러리를 바꿀 때 쓴다. 먼저 지원하는 Go 버전과 브랜치를 확인하고, 프로젝트의 도구로 검사와 테스트를 돌리고, 기존 API 작성 방식을 따르며, 테스트 결과와 호환성 영향을 적은 pull request를 준비한다.
내 문서를 키워드와 의미로 찾는 로컬 검색 CLI 만들기
내 컴퓨터의 문서를 찾는 명령줄 도구를 만들거나 고칠 때 쓴다. 컬렉션과 컨텍스트 메모의 관리, 키워드 검색과 벡터 검색의 조합, 돌려주는 양의 상한, 서비스로 실행하는 방법, 테스트와 릴리스 절차를 정하고, 인덱스를 바꾸는 명령은 사용자에게 맡긴다.
프로젝트 문서로 에이전트 스킬을 만들고 최신 상태로 유지하기
프로젝트 문서나 업스트림 프로젝트가 이미 내놓은 스킬로 AI 에이전트용 스킬을 만들 때 사용합니다. 생성형·동기화형·직접 작성한 스킬을 나눠 다루고, 짧은 색인과 주제 하나씩만 담은 참조 파일을 쓰며, 기록된 리비전 이후 바뀐 부분만 업데이트합니다.
찾기 쉬운 API와 실제 값 테스트를 갖춘 데이터 처리 라이브러리 만들기
복잡한 원본 데이터를 단순한 객체로 바꾸는 라이브러리를 만들거나 고칠 때 쓴다. 편집 전에 코드 구조를 파악하고 작업을 이슈로 기록하며, 새 기능마다 실제 값 테스트, 실행되는 문서 예제, 분명한 오류 메시지를 갖추게 한다.
여러 패키지가 있는 저장소에서 코드를 고치고 내 포크에서만 PR 올리기
업스트림이 읽기 전용인 다중 패키지 저장소에서 AI에게 작업을 맡길 때 씁니다. 폴더마다 있는 지침을 따르고, 내 포크에만 푸시하며, 커밋하지 않은 변경을 지키고, Python 테스트에 작성자 표시를 붙이고, 실제로 돌린 검사 결과로 보고하게 합니다.
그래프 검색과 벡터 검색으로 AI 에이전트의 장기 메모리 만들기
AI 에이전트가 세션이 바뀌어도 지식을 기억하게 하는 시스템을 만들 때 사용한다. 파일·URL·텍스트를 검색할 수 있는 그래프와 벡터 데이터로 바꾸고, 사용자마다 데이터를 나눠 인증으로 보호하며, 핵심 코드를 고치지 않고 스토리지와 모델 공급자를 바꿀 수 있게 한다.
그래프 기반 권한 부여 서비스를 테스트부터 써서 고치기
그래프 기반 권한 부여 서비스를 바꿀 때 씁니다. 요청이 지나가는 경로를 따라가고, 저장소의 빌드 타깃과 lint 규칙을 따르며, 실패하는 테스트를 먼저 쓰고, 생성된 파일은 손으로 고치지 않습니다.
타입 안전 Web 프레임워크를 고치고 데이터베이스 코드를 세 계층으로 나누기
여러 패키지로 된 타입 안전 Web 프레임워크를 바꿀 때 씁니다. 정해진 개발 환경 안에서 작업하고, 먼저 빠르게 확인한 뒤 전체를 테스트하며, 공개 모듈을 작게 두고, 데이터베이스 접근을 계층으로 나누고, force-push는 하지 않습니다.
AI 스킬 문서를 한곳에서 관리하고 AI가 찾기 쉽게 쓰기
AI 스킬의 지침 문서를 유지할 때 사용한다. 원본 파일 하나를 두고 다른 파일은 그것에서 다시 생성하며, 판단 표를 앞에 두고 자세한 내용은 참고 파일로 옮기고, 변경 전후에 AI의 동작을 시험하며, 버전 번호는 자동 릴리스에 맡긴다.
쿼리의 의미를 바꾸지 않고 여러 방언을 지원하는 SQL 컴파일러 확장하기
SQL을 AST로 바꾼 뒤 다른 데이터베이스용 SQL로 다시 만드는 컴파일러를 고칠 때 쓴다. 먼저 담당 계층을 찾고, 방언이 바뀌어도 의미를 지키며, SQL을 문자열 대신 AST 빌더로 만들고, 실제 실행과 속도를 테스트한다.
올바르게 호출되고 검사를 통과하는 에이전트 스킬을 만들어 릴리스하기
에이전트 스킬을 모아 둔 저장소에서 작업할 때 사용합니다. 설명은 '무엇을 하고 언제 쓰는지'만 쓰고, 메인 파일은 짧게 두고 자세한 내용은 참고 파일로 나누며, 버전과 문서를 맞추고, 릴리스 전에 검사 도구를 돌립니다.
스크립트로 복잡한 CLI 도구를 실행하고, JSON 보고서로 성공을 확인한다
스크립트나 코딩 에이전트가 복잡한 CLI 도구를 실행할 때 쓴다. 먼저 작업과 클래스 목록을 확인하고, 라이선스가 필요한 작업은 라이선스가 없으면 멈추며, 입력과 장치를 모두 지정해 실행하고, 진행 문구가 아니라 종료 코드와 JSON 보고서로 성공 여부를 판단한다.
언어 감지 저장소에 확장자나 새 언어 추가하기
AI가 언어 감지 저장소에 확장자나 언어를 추가할 때 사용합니다. 실제 코드 샘플과 확장자가 겹칠 때의 테스트된 판별 규칙을 추가하고, 생성 파일은 스크립트로 만들며, 제출 전에 사용량 증거와 라이선스를 확인합니다.
문서를 만드는 AI 에이전트 앱을 새 스택과 레거시 스택을 헷갈리지 않고 고치기
문서를 만드는 멀티 에이전트 앱 중 예전 스택이 아직 남아 있는 것을 AI에게 고치게 할 때 쓴다. 실제 시작 명령을 찾고, 오래된 문서보다 코드를 믿고, 설정 이름을 그대로 지키며, Python과 Node를 넘나드는 변경을 따라가고, 의미 있는 최소 테스트를 돌린다.
모듈형 네트워크 서비스에 모듈 경계를 지키며 모듈 추가하기
모듈로 이루어진 네트워크 서비스를 AI가 고치거나 넓힐 때 쓴다. 모듈끼리는 공통 인터페이스로만 잇고, 리포지토리의 빌드 방식과 테스트를 쓰며, 클라이언트에 보여도 안전한 오류를 돌려주고, 요청 사이에 상태를 공유하지 않는다.
인증서를 자동으로 발급·갱신하는 모노레포를 기밀 정보를 지키며 고치기
ACME로 인증서를 신청·갱신·배포하는, 직접 운영하는 도구를 AI에게 고치게 할 때 쓴다. 변경을 담당 패키지나 플러그인에 넣고, 테스트를 먼저 쓰고, SQL 마이그레이션을 붙이고, 기존 UI 방식을 따르며, 인증서와 키를 코드와 로그에 남기지 않는다.
여러 언어용 네이티브 라이브러리 래퍼를 만드는 코드 생성기 고치고 테스트하기
네이티브 라이브러리 선언으로 여러 언어용 래퍼를 만드는 컴파일러형 도구를 고칠 때 씁니다. 버그가 시작되는 처리 단계를 찾아가고, 변경에 맞는 크기의 테스트를 돌리며, 회귀 테스트를 더하고 변경 로그를 씁니다.
웹사이트 품질을 점검하는 AI 에이전트 스킬 모음을 만든다
웹사이트의 속도, 접근성, 검색 노출(SEO)을 점검하는 스킬을 추가하거나 고칠 때 쓴다. SKILL.md의 형식과 이름, 짧은 파일, 수정 전후 예시, 오류가 나면 멈추는 셸 스크립트, 사용자 영향에 따른 문제 순위를 정한다.
풀스택 저장소를 그 저장소의 명령과 테스트대로 고치기
프런트엔드, API, SDK, CLI, 데이터베이스가 있는 저장소를 AI에게 고치게 할 때 쓴다. 저장소의 명령과 고정된 버전을 따르고, 계층마다 역할을 나누고, 동작을 담당하는 계층에서 테스트하며, 바꾼 화면과 로그인이 필요한 API를 확인하고 실행한 확인을 보고한다.
기능마다 요구사항·설계·작업을 쓰고 승인받은 뒤 개발하기
AI가 명세를 바탕으로 소프트웨어를 단계별로 만들 때 사용합니다. 프로젝트 전체 지침과 기능별 명세를 나누고, 요구사항·설계·작업을 순서대로 써서 사람의 승인을 받으며, 구현 후 독립 검토를 받고, 최신 검증 결과로 완료를 확인합니다.
프런트엔드 규칙 저장소에서 규칙을 쓰고, 게시 전에 검사를 통과시키기
AI가 접근성·성능·SEO·보안 같은 프런트엔드 규칙을 모은 저장소를 고칠 때 사용한다. 규칙마다 필요한 메타데이터, 쓰는 순서, 측정 가능한 기준값을 정하고, 공유 UI는 디자인 시스템에 두며, 게시 전에 모든 검사를 실행한다.
빌드가 엄격한 저장소에서 AI 코딩 에이전트가 경고 없는 코드와 정직한 보고를 하게 하기
빌드 검사가 엄격한 저장소에서 AI 코딩 에이전트를 쓸 때 사용합니다. push 전에 빌드와 검증을 통과시키고, 커밋 규칙을 지키며, 안전한 코드를 쓰고, 모든 주장을 코드와 대조해 확인합니다.
큰 코드베이스에서 근본 원인을 고치고 공개 API 호환성 지키기
AI가 크고 계층화된 코드베이스를 고칠 때 씁니다. 빌드 로그를 짧게 줄이고, 버그를 상류의 원인까지 따라가 고치며, 자기 변경분에 문제를 덮기만 하는 헬퍼가 없는지 살피고, 알기 쉬운 풀 리퀘스트를 씁니다.
컴포넌트가 많은 대규모 코드베이스를 읽기 쉽고 망가뜨리지 않게 고칠 수 있도록 유지하기
여러 컴포넌트로 이루어진 큰 코드베이스에서 AI에게 코드를 맡길 때 사용합니다. 코드 작성법, 파일과 변경의 크기, 코드 리뷰에서 볼 점, 테스트, API 이름 짓기, 빌드 진행 방법의 규칙을 주어 변경을 작고 읽기 쉽게 유지하고 다른 부분을 망가뜨리지 않게 합니다.
AI가 필요한 코드만 고치고, 위험한 작업 전에는 사람에게 확인받게 하기
AI 에이전트에게 프로젝트 코드를 고치게 할 때 쓴다. 먼저 바꿀 범위를 정하고, 목적이 분명한 코드와 실제 버그를 잡는 테스트만 더하며, 파일 삭제·푸시·운영 API 호출 전에는 사람에게 확인받고, 마지막에 바꾼 파일과 실행한 검사를 보고한다.
대규모 코드베이스에서 테스트를 거쳐 리뷰에 바로 낼 수 있는 변경을 만든다
AI 에이전트가 대규모 다국어 코드베이스를 수정할 때 사용한다. 프로젝트의 래퍼 명령으로 빌드하고, 테스트를 코드 옆에 두어 변경 전에는 실패하는지 확인하며, 리뷰 기준을 따르고, 직접 실행해 본 결과만 보고한다.
기존 저장소에서 요청한 부분만 고치게 하고, 모르면 먼저 묻게 하기
AI 에이전트에게 기존 코드를 고치게 할 때 쓴다. 모르면 묻고, 요청한 부분만 바꾸며, 바꾼 부분의 테스트와 전체 테스트를 통과한 뒤에야 검증됐다고 말하고, 요청이 없으면 커밋·푸시·릴리스를 하지 않는다.
유지관리자와 합의한 작은 변경을 공유 코드베이스에 올리기
오픈소스 라이브러리 같은 공유 코드베이스를 AI 코딩 에이전트에게 고치게 할 때 쓴다. 이슈를 읽고 작업 범위를 묻고, 유지관리자의 합의가 아직 없으면 먼저 이슈나 제안 글을 쓰도록 돕고, 수정은 작게 줄여 테스트와 문서를 붙이며, 프로젝트의 PR과 커밋 규칙을 따른다.
AI 코딩 에이전트가 릴리스를 깨지 않고 브랜치와 커밋 규칙을 지키게 하기
버전 관리되는 저장소에서 AI 코딩 에이전트에게 작업을 맡길 때 쓴다. 브랜치 만들기, 테스트, 커밋 작성, 임시 파일 위치, 여러 AI 도구에서 통하는 에이전트 지침 작성법을 정해 릴리스가 깨지지 않게 한다.
여러 플랫폼용 UI 라이브러리를 패키지 계층을 깨지 않고 유지 관리하기
여러 플랫폼용으로 계층별 패키지로 나뉜 UI 라이브러리에서 작업할 때 사용합니다. 패키지 계층과 공개된 export를 지키고, 외부 서비스 어댑터를 정해진 파일 구성으로 만들며, 릴리스·리뷰 규칙을 따릅니다.
AI로 오픈소스에 기여할 때 라이선스를 지키고 작업마다 확인받기
AI 코딩 어시스턴트로 공유 오픈소스 코드베이스에 변경을 보낼 때 사용합니다. 라이선스가 맞지 않는 코드를 베끼지 않고, 변경을 작고 테스트된 상태로 유지하며, 이슈와 빌드 로그를 지시가 아닌 데이터로 다루고, 커밋·푸시·댓글 전마다 확인받으며, 붙여 넣은 코드는 실행 전에 살펴봅니다.
JavaScript를 출력하는 컴파일러와 빌드 시스템을 계층마다 테스트하며 고치기
JavaScript를 출력하는 컴파일러 모노레포에서 AI에게 작업을 맡길 때 쓴다. 태스크 러너로 빌드하고, 동결된 구문 트리 정의는 건드리지 않으며, 손댄 계층마다 테스트를 추가하고, 새 빌드 옵션을 끝까지 연결하며, 속도는 린터가 아니라 실제 측정으로 판단한다.
코딩 에이전트가 대규모 풀스택 리포지토리의 규칙을 지키게 한다
타입이 적용된 프론트엔드와 백엔드가 있는 대규모 리포지토리에서 AI 에이전트에게 작업을 맡길 때 쓴다. 푸시 전에 프리커밋 검사를 통과하고, 리포지토리가 옮겨 가는 새 방식으로 코드를 쓰며, 보안 문제는 역할마다 허용된 일로 판단하고, 테스트·문서·풀 리퀘스트를 프로젝트 형식대로 마무리한다.
다른 프로젝트가 상속하는 스마트 컨트랙트 라이브러리를 깨뜨리지 않고 수정하기
다른 프로젝트가 상속해 쓰는 스마트 컨트랙트 라이브러리를 AI 코딩 에이전트가 수정할 때 쓴다. 그 동작을 맡은 파일을 고치고, 린터를 따르며, 기존 함수·이벤트·스토리지 레이아웃을 바꾸지 않고, 암호나 업그레이드처럼 AI가 틀리기 쉬운 코드는 직접 다시 읽고 확인한다.
공유 라이브러리나 SDK를 공개 API를 깨지 않고 고치기
AI 코딩 에이전트가 공유 라이브러리나 SDK를 고칠 때 쓴다. 완료라고 하기 전에 테스트와 빌드를 모두 돌리고, 지금 쓰는 사람을 위해 공개 API를 지키고, Git 브랜치나 worktree를 바꾸기 전에 묻고, 마지막에 풀 리퀘스트 인계 내용을 낸다.
큰 데스크톱 미디어 앱을 UI 멈춤 없이, 실행 취소를 깨지 않고 고치기
파일과 미디어를 다루는 큰 데스크톱 앱에서 작업할 때 사용합니다. 무거운 작업을 UI 스레드 밖으로 옮기고, 취소와 경계 사례를 처리하며, 실행 취소가 정확히 되돌리게 하고, 실제로 돌린 테스트만 보고합니다.
브라우저, 서버, 네이티브에서 모두 제대로 동작하는 CSS-in-JS 라이브러리 유지보수하기
AI 코딩 도우미로 표준을 따르는 CSS-in-JS 라이브러리를 작업할 때 쓴다. 스타일은 표준 CSS만 쓰게 하고, 각 런타임에서 코드가 깨지지 않게 하며, 사양을 바탕으로 테스트를 먼저 쓰고, 릴리스 노트·문서·실제 코드를 돌리는 데모를 만드는 방법을 정한다.
AI에게 FastAPI 서비스를 만들게 하고, 리뷰에서 흔한 실수 찾기
AI에게 FastAPI 서비스를 만들거나 리뷰하게 할 때 쓴다. 최소 버전, 비동기·동기 라우트 선택, Pydantic 모델과 의존성 주입 작성법, 데이터베이스와 테스트 방법을 정하고, 코드 차이에서 찾아야 할 흔한 실수와 고치는 법을 표로 보여 준다.
TypeScript 프런트엔드 모노레포에서 패키지 경계를 지키며 작업하기
모듈형 TypeScript 프런트엔드 코드베이스를 AI가 고칠 때 쓴다. 패키지 경계와 프레임워크에 기대지 않는 코어, 상태를 담당 action으로만 바꾸는 법, 파일과 테스트의 위치, 커밋 전 검사, 릴리스 순서, UI 계층 나누는 법을 다룬다.
큰 저장소에서 AI가 코드를 먼저 읽고 고치게 하고, 리뷰를 거쳐서만 배포하게 한다
패키지가 많은 큰 저장소에서 AI 에이전트에게 일을 맡길 때 쓴다. 수정을 판단하기 전에 코드·의존성·테스트를 읽게 하고, 같은 일은 한 가지 방법으로만 하게 하며, 신뢰할 수 없는 코드는 로컬에서 실행하지 않고, 공유 코드는 리뷰와 사용자 승인을 거쳐서만 바꾸게 한다.
저장소를 조사하고 고치는 AI 에이전트에게 공통 작업 규칙 정해 주기
AI 에이전트가 저장소를 스스로 조사하고 고쳐 나갈 때 쓴다. 공유 메모리에 남길 내용, 움직이기 전에 계획을 내야 하는 경우, 푸시와 노출된 비밀 값을 다루는 법, 완료라고 하기 전에 변경과 자동화를 시험하는 법을 정한다.
두 런타임에 걸친 플러그인 기반 데이터 파이프라인을 망가뜨리지 않고 고치기
두 런타임에 걸친 플러그인 기반 백엔드에서 코딩 에이전트에게 코드를 고치게 할 때 쓴다. 버전을 한 파일에서 관리하고, 테스트 필터를 올바른 태스크에 걸고, 플러그인·동시성·서비스 레이어 규칙을 지키며, 새 테스트가 해당 변경 없이는 실패하는지 확인한다.
테스트를 먼저 써서, 다른 플랫폼을 깨뜨리지 않고 저수준 디버거 코드를 고친다
여러 OS와 백엔드에서 돌아가는 컴파일 언어용 디버거를 AI에게 고치게 할 때 쓴다. AI가 먼저 실패하는 테스트를 쓰고, OS별 코드를 별도 파일로 나누고, 공유 인터페이스를 바꿀 때 모든 백엔드를 확인하고, 커밋 메시지를 서브시스템 이름으로 시작하게 한다.
AI가 시스템 코드를 타입과 오류 처리까지 꼼꼼하게 작성하게 하기
엄격한 시스템 코드베이스에서 AI의 도움을 받을 때 사용합니다. AI가 작성한 시간의 세 배 이상 코드를 검토하고, 모든 오류 경우를 다루며, 규칙을 타입에 담고, 새 데이터 형식과 옛 형식이 서로 맞게 하며, 커밋마다 빌드가 되는 작은 커밋을 만듭니다.
제대로 로드되고 트리거되는 AI 에이전트 스킬과 플러그인 만들기
AI 에이전트용 스킬이나 플러그인을 만들어 리뷰에 낼 때 씁니다. 메타데이터 정본을 하나로 두는 법, 디렉터리 배치, 잘 트리거되는 이름과 설명문, 빠른 훅, 리뷰 전에 통과할 체크리스트를 알려 줍니다.
공유 프로젝트에 풀 리퀘스트를 열기 전에 정말 필요한 변경인지 확인하기
다른 사람이 관리하는 프로젝트에 AI 에이전트가 풀 리퀘스트를 보내려 할 때 쓴다. 보내기 전에 문제가 실제로 일어났는지, 변경이 코어 프로젝트에 들어갈 것인지, 사람이 전체 diff를 보고 승인했는지 확인한다.
계층형 앱 저장소에서 AI 코딩 에이전트가 요청한 범위만 작업하게 한다
프런트엔드, 백엔드, 데스크톱 패키징이 있는 앱 저장소에서 AI에게 코드를 맡길 때 쓴다. 요청을 읽기 전용·변경·빌드·공개로 나누고, 바꾼 부분에 따라 돌릴 검사를 정하며, 커밋·푸시·릴리스나 실제 데이터를 건드리기 전에 먼저 묻게 한다.
엄격한 타입의 함수형 코드베이스에서 오류를 숨기지 않고 코드 고치기
엄격한 타입의 함수형 코드베이스에서 AI에게 작업을 맡길 때 씁니다. 코드 스타일, 오류 타입, 서비스와 계층, 스키마, 로그, UI 컴포넌트 규칙을 정하고, 타입 검사·테스트·빌드가 모두 통과해야 완료라고 말하게 합니다.
사용자 데이터를 잃지 않고 승인 전 코드를 실행하지 않는 커맨드라인 도구 만들기
이미 사용자가 있는 CLI를 AI가 만들거나 고칠 때 쓴다. 플래그와 설정 파일의 호환성을 지키고, 작업을 망가뜨리기 전에 오류로 멈추며, 프로젝트 훅은 승인 뒤에만 실행하고, 모든 서브프로세스를 기록하며, 네트워크 결과보다 로컬 결과를 먼저 보여 준다.
기존 동작을 깨뜨리지 않고 대규모 다중 언어 런타임 코드베이스를 수정한다
네이티브 코드와 스크립트로 이루어지고 패치된 의존성을 벤더링한 대규모 런타임 프로젝트에서 쓴다. 가장 가까운 가이드를 먼저 읽고, 프로젝트의 빌드·테스트 단축 명령과 테스트 타깃을 쓰며, 자체 타입과 금지 사항을 지키고, 동작 변경은 호환성 플래그 뒤에 넣는다.
테스트를 통과하고 크래시에도 버티는 데이터베이스 인덱스 확장 만들기
AI가 데이터베이스 인덱스 확장을 만들거나 고칠 때 사용합니다. 모든 테스트 실패를 진짜로 다루고, 커밋 전에 정해진 순서를 지키며, 크래시 복구와 스탠바이가 제대로 동작하도록 모든 페이지 변경을 로그에 남깁니다.
공개 API를 깨지 않고 TypeScript 모노레포의 양방향 프로토콜 SDK 유지보수하기
클라이언트와 서버 모두 요청을 보내는, 여러 패키지로 배포되는 타입 SDK를 고칠 때 씁니다. 공개 내보내기를 의도적으로 고르고, 새 작업을 양쪽에 기능 확인과 함께 추가하며, 호환성을 깨는 변경을 기록하고, 예제를 테스트로 실행합니다.
샌드박스에서 보안 취약점을 찾아 고치는 AI 파이프라인 운영하기
신뢰할 수 없는 코드를 실제로 실행해 크래시를 찾는 자율 파이프라인을 운영할 때 사용하세요. 실행을 컨테이너에 격리하고, 발견 결과를 나오는 즉시 알리며, 모든 패치는 사람의 검토에 맡깁니다.
멀티 서비스 앱에 백엔드 코드와 알맞은 테스트를 추가하기
백그라운드 워커가 있고 여러 서비스로 나뉜 앱을 AI 에이전트가 수정할 때 사용한다. 환경과 실행 중인 서비스를 확인하고, 데이터베이스 코드와 태스크 코드를 정해진 곳에 두고, 작업과 오류를 프로젝트 방식대로 정의하고, 알맞은 테스트 한 종류를 고르고, 코딩 전에 계획을 세운다.
멀티 모듈 저장소에 프로바이더와 제너레이터 플러그인 추가하기
시크릿용 프로바이더와 제너레이터로 확장되는 멀티 모듈 저장소에서 AI에게 작업을 맡길 때 사용하세요. 모든 작업을 태스크 러너로 실행하고, 정해진 방식으로 확장을 추가하며, 푸시나 릴리스 직전에 멈춥니다.
로컬 우선 AI 디자인 데스크톱 앱을 정해진 제품 제약 안에서 고치기
로컬 워크스페이스에서 AI로 디자인을 만드는 데스크톱 앱을 AI 코딩 에이전트가 고칠 때 쓴다. 어떤 지침 파일이 우선인지, 지켜야 할 제약, 세션·저장소·도구의 구조, 네 단계 권한, 피할 일을 알려 준다.
큰 Java 백엔드에서 AI가 코드 스타일과 모듈 규칙을 지키게 한다
모듈과 프로바이더로 조립된 큰 Java 서버에서 AI에게 작업을 시킬 때 쓴다. 먼저 진입점 코드를 읽고, 자동으로 검사되는 코드 스타일과 지원하는 가장 오래된 Java 버전을 지키며, 사용하는 모듈을 모두 선언하고, 소스로 확인한 뒤 답하고, 푸시 전에 로컬에서 테스트한다.
여러 소스에서 활동 이벤트를 모아 여러 서페이스에 보여 주는 앱 만들기
여러 도구에서 이벤트를 모아 에디터 확장과 독립 서버 양쪽에 보여 주는 앱을 만들 때 쓴다. 계층 의존을 한 방향으로 지키고, 모든 소스를 같은 이벤트 형태로 바꾸며, 다른 코드를 고치지 않고 새 소스를 붙일 수 있게 하고, 상태를 안전하게 저장한다.