개발 스킬

기존 프로젝트의 코드와 설정을 조사해 기술 구성, 구조, 아키텍처, 규칙, 연동, 테스트, 우려 사항을 다루는 문서 7개를 작성합니다. 근거 파일을 연결하고 미확인 항목을 표시하며, 계획과 실제 구현의 차이를 드러냅니다.

• 익숙하지 않은 코드베이스 파악하기
• 프로젝트 인수인계 문서 준비하기
• 설계 문서와 실제 구현 비교하기

요청과 응답 유형을 명시하고 입력 검증과 표준 오류 응답을 포함하는 ASP.NET Minimal API 엔드포인트를 만듭니다. 관련 엔드포인트를 구성하고 OpenAPI에 작업, 매개변수, 데이터 구조 설명을 추가합니다.

• 입출력 유형을 명시한 API 만들기
• OpenAPI에 작업과 매개변수 설명 추가
• `MapGroup()`으로 관련 API 묶기

AgentRC로 저장소의 AI 에이전트 활용 준비도를 평가하고 독립 실행형 HTML 보고서를 생성합니다. 9개 영역의 점수와 우선순위별 개선안을 확인하고, 조직에 맞춘 채점 정책도 적용할 수 있습니다.

• AI 에이전트 도입 전 준비도 확인
• 평가 결과에 따라 개선 우선순위 결정
• 조직별 정책으로 점수 산정

Arduino 기기를 `Azure IoT Hub`에 직접 연결하거나 `IoT Edge` 게이트웨이를 거치는 구성을 계획합니다. 센서 메시지, 기기별 인증, 오프라인 버퍼링, 원격 명령을 정의하고 기기·게이트웨이·클라우드의 구현 작업으로 정리합니다.

• Arduino 센서를 Azure에 연결
• 현장 기기용 게이트웨이 설계
• 통신 중 센서 데이터 저장

Copilot CLI에서 전체 ai-ready 스킬을 설치하고 검토하는 방법을 안내합니다. 최신 버전을 추가하고 스킬을 다시 불러온 뒤, AI 코드 기여를 위한 저장소 준비를 요청할 수 있습니다.

• Copilot CLI로 전체 스킬 설치
• 불러오기 전에 스킬 내용 검토
• 설치된 스킬 업데이트

프로젝트의 실제 코드에서 언어, 프레임워크, 개발 관례를 파악해 AI 코딩 에이전트용 지침 파일을 생성하거나 갱신합니다. 하나의 파일에 모으거나 주제와 프로젝트 영역별로 나누며, 쓰기 전에 변경 내용을 미리 볼 수 있습니다.

• VS Code Copilot용 지침 만들기
• 바뀐 개발 규칙을 지침에 반영
• 모노레포 영역별 규칙 정리

기존 변경 기록과 검증 결과를 바탕으로 바로 붙여 넣을 수 있는 PR 설명을 작성합니다. 간결한 그림, 변경 전후 증거, 되돌리는 방법과 영향 범위를 정리해 검토자가 작업을 판단하도록 돕습니다.

• PR 설명 초안 작성
• 리팩터링을 그림으로 설명
• 기존 검증 결과의 전후 비교 제시

변경이 필요한지 먼저 살피고 기존 도우미 코드와 표준 라이브러리, 이미 사용할 수 있는 기능을 우선 검토해 코드 차이를 작게 유지합니다. 검증, 보안, 접근성, 요청한 기능을 보존하며 구현하도록 돕습니다.

• 최소한의 코드 차이로 기능 구현
• 커지는 구현을 요청 범위에 맞게 조정
• 보조 코드를 추가하기 전 재사용 여부 확인

완료된 코드 변경에서 결함, 보안 위험, 불필요한 복잡성, 테스트 누락을 검토합니다. 검증된 문제는 심각도, 파일 위치, 구체적인 실패 상황과 함께 보고하며 큰 변경은 규칙과 요구사항을 따로 평가합니다.

• 출시 전에 변경 사항 점검
• 문서화된 개발 규칙 준수 여부 확인
• 티켓 요구사항과 구현 비교

코드베이스를 살펴보고 디렉터리별 역할, 주요 파일, 의존 관계와 작업 규칙을 담은 연결된 AGENTS.md 문서를 만듭니다. 기존 문서를 갱신할 때 사람이 작성한 메모를 보존하고 계층 참조와 누락을 확인합니다.

• 낯선 코드베이스 구조 문서화하기
• 디렉터리별 규칙과 의존 관계 정리하기
• 구조 변경 뒤 안내 문서 갱신하기

합의된 개발 작업을 구현부터 검증까지 진행합니다. 기존 설계와 패턴을 따르는 작은 변경을 적용하고, 필요하면 독립된 작업을 나누며, 변경 파일과 검증 근거, 남은 문제를 보고합니다.

• 합의된 기능 구현
• 작은 코드 수정과 동작 확인
• 독립적인 개발 작업 나누기

개발 작업을 검증 가능한 작은 요구사항으로 나누고 진행 상황을 저장하면서 구현과 검증을 반복합니다. 각 요구사항의 증거와 검토자 승인을 거쳐 완료를 판단하고, 승인 후 정리와 재검증을 수행합니다.

• 여러 단계의 구현을 검증까지 진행
• 진행 상황을 저장하고 작업 재개
• 요구사항별 검증 근거 관리

이슈 수정, PR 검토, 기능 개발을 위한 독립된 Git 작업 디렉터리를 만들고 관리합니다. 선택적으로 tmux 세션을 연결해 병렬 작업을 전환하고 진행 중인 세션에 다시 접속하며 완료된 환경을 정리할 수 있습니다.

• 여러 이슈 수정을 위한 작업 공간 마련
• PR 검토 전용 작업 환경 만들기
• 진행 중인 개발 세션에 다시 접속

모호한 개발 아이디어를 질문을 하나씩 주고받으며 정리하고, 구현 단계와 확인 가능한 승인 기준, 위험 및 대응책을 담은 작업 계획으로 만듭니다. 여러 관점의 비교와 기존 계획 검토도 지원합니다.

• 모호한 개발 아이디어 구체화
• 요구사항을 바탕으로 구현 계획 수립
• 여러 관점에서 설계안 비교

유사 코드, 트리, Mermaid 또는 차이 비교로 코드 구조와 실행 흐름, 변경 내용을 필요한 범위에서 설명합니다. 더 복잡한 배치가 필요하면 HTML 파일 하나를 만듭니다.

• 분기와 함수 호출 순서 설명
• UI, 모듈 또는 파일의 역할 정리
• 변경 전후 구조 비교

코드 구성과 변경 이력을 살펴 수정하기 어렵게 만드는 설계 문제와 개선 후보를 찾습니다. 파일 위치, 제안, 위험을 우선순위와 함께 보고하며, 코드는 수정하지 않습니다.

• 개발 작업 묶음 이후 설계 점검
• 수정 범위가 넓어지는 원인 조사
• 구조 개선 우선순위 정하기

로그, 실행 추적, 상태 정보와 범위를 좁힌 재현으로 OMC 또는 Claude Code 세션의 문제를 진단합니다. 확인된 실패와 근거가 있는 원인 가설, 다음에 시도할 최소 조치를 정리합니다.

• Claude Code 작업 중단 원인 조사
• 훅이나 에이전트 동작 추적
• 테스트 또는 명령 실패 범위 좁히기

버그, 성능 변화, 실험 결과가 발생한 원인을 조사합니다. 여러 가설을 뒷받침하는 증거와 반대 증거를 비교해 가능성이 높은 원인을 정리하고, 아직 밝혀지지 않은 점과 다음 검증 방법을 제안합니다.

• 버그나 회귀 원인 조사
• 지연 시간과 리소스 사용 원인 파악
• 예상과 다른 실험 결과 검토

불필요하게 커진 AI 생성 코드에서 중복 로직, 사용하지 않는 코드, 과도한 계층을 정리하면서 기존 동작을 확인합니다. 지정한 파일만 다루고 관련 검사를 실행하거나 `--review`로 수정 없이 검토할 수 있습니다.

• 중복 로직과 미사용 코드 제거
• 기존 동작을 지키며 계층 줄이기
• 지정한 파일만 정리

GitHub에 들어온 issue와 PR을 검토하고 주장을 확인해 근거와 기존 결정을 정리합니다. 관리자가 판단할 사안에는 권고안과 영향을 제시하며, 확인된 권한 범위에서만 처리하고 변경 사항을 병합하지 않습니다.

• 버그 보고와 기능 요청 분류
• 승인 규칙에 따른 중복 보고 처리
• 관리자용 판단 자료 정리

여러 에이전트가 코드 개선 후보를 조사하고 구현하며, 벤치마크 결과를 비교해 재검증을 통과한 후보를 통합합니다. 목표나 반복 횟수 등 종료 조건에 도달할 때까지 실험 결과와 진행 상황을 기록합니다.

• 측정 결과로 코드 개선안 비교
• 수치 목표를 향해 실험 반복
• 후보 점수와 실험 이력 시각화

대규모 개발 작업을 순서가 있는 목표로 나누고 계획, 진행 기록, 장애 요인과 증거를 저장합니다. Claude Code 세션 간 작업을 이어가며 정리, 검증, 코드 리뷰 증거를 바탕으로 완료 여부를 관리합니다.

• Claude Code 세션 간 진행 상황 추적
• 목표 순서, 시도 횟수와 증거 관리
• 정리, 검증, 리뷰를 완료 조건으로 지정

개발 목표를 명세와 의존 관계가 있는 티켓으로 정리하고, 사람의 승인을 거쳐 구현, 검토, 검증으로 이어갑니다. 병렬 작업을 조정하고 용어, 업무 규칙, 기술 결정의 근거도 기록합니다.

• 개발 요청을 명세와 티켓으로 정리
• 의존 관계가 있는 병렬 구현 조정
• 승인 기준과 테스트 범위 승인

개발 작업을 여러 에이전트에 나누어 맡기고 공유 작업 목록으로 담당자, 의존 관계와 진행 상황을 관리합니다. 계획, 구현, 검증과 제한된 수정 단계를 진행하며 인계 내용도 기록합니다.

• 여러 모듈의 타입 오류 수정
• 에이전트별 빌드 오류 조사
• 여러 페이지의 반응형 화면 구현