engineering

코드 리뷰 피드백을 받고 제안을 구현하기 전에 사용하며, 특히 피드백이 불명확하거나 기술적으로 의심스러울 때 적용한다

사용자가 repository 전체 또는 명시한 큰 경로를 over-engineering과 삭제 가능성 관점에서 audit해 달라고 요청할 때 사용한다. 일부 diff review나 코드 수정에는 사용하지 않는다.

기존 코드·문서·메타데이터의 국소적 또는 기계적 변경부터 새 기능·하위 시스템까지, 구현 전에 작업 범위와 설계 경계를 정해야 할 때 사용한다

버그, 테스트 실패 또는 예상하지 못한 동작을 만났을 때 수정안을 제안하기 전에 사용한다

사용자가 확인된 제품·도메인 계약이나 trust boundary를 타입, 상태, 경계와 제어 흐름에 직접 반영해 구현하거나 리팩터링해 달라고 명시적으로 요청할 때 사용한다. 도메인 용어 결정, ADR 작성, 일반 기능 구현·디버깅, 읽기 전용 리뷰와 Git 전달에는 사용하지 않는다.

승인된 여러 단계의 작업을 직접 또는 하위 에이전트로 실행·통합하거나 기존 계획을 재개할 때 사용한다

검증된 구현의 기존 커밋을 통합하거나 보존할 방법을 정해야 할 때 사용한다. 브랜치·커밋·푸시·티켓·PR 산출물을 직접 만들어 달라는 요청은 해당 작업 절차를 따른다

여러 단계의 구현 작업에 대해 승인된 요구사항이 있고 구현 전에 흐름·책임·의존 관계를 정해야 할 때 사용한다

현재 코드·diff·commit·branch·PR의 일반 리뷰, 명시적으로 요청한 독립 리뷰, 개발 중 필요한 전체 변경 리뷰에 사용한다. 같은 불변 입력을 받은 새 검토자 5명의 결과를 근거로 통합한다. PR 리뷰는 별도 세션·워크트리에서 병렬 검토 후 중복을 제거해 게시하며 로컬 전용·게시 금지는 우선한다. 한 관점만 지정한 집중 리뷰와 명시적인 PR 심층·다중 리뷰, 코드 수정에는 사용하지 않는다.

사용자가 현재 diff나 지정한 코드의 도달 가능한 실패 경로, retry, 부분 성공, 동시성, cleanup과 복구 동작을 읽기 전용으로 검토해 달라고 요청할 때 사용한다. penetration test나 repository-wide security scan에는 사용하지 않는다.

사용자가 현재 diff나 지정한 코드의 reader load, 변경 이유의 결합, 중복 지식, public surface와 장기 유지보수성을 읽기 전용으로 검토해 달라고 요청할 때 사용한다. 파일 길이만으로 분할을 요구하거나 코드를 수정하지 않는다.

사용자가 현재 diff나 지정한 코드의 error ownership, logging, telemetry, 진단 가능성과 민감정보 노출을 읽기 전용으로 검토해 달라고 요청할 때 사용한다. 특정 observability vendor나 모든 endpoint의 계측을 강제하지 않는다.

사용자가 현재 diff, commit, branch 또는 지정한 코드 변경을 over-engineering, 불필요한 추상화, YAGNI 관점에서 검토해 달라고 명시적으로 요청할 때 사용한다. 코드를 수정하거나 repository 전체를 audit하지 않는다.

GitHub PR을 심층 검토하거나 여러 독립 리뷰어로 검토해 달라는 요청에 사용한다. 현재 호스트의 기본 구성은 일반 검토자 5명과 상위 검토자 1명이며 별도 세션·워크트리에서 병렬 검토한 결과를 중복 제거해 PR에 게시한다. 로컬 전용·게시 금지 요청은 우선한다. 일반 코드·diff·PR 리뷰는 review가 담당하고 PR URL만으로 선택하지 않는다. 코드 수정과 개발 완료 게이트는 담당하지 않는다.

사용자가 코드 변경이나 구현을 가장 단순한 형태로 줄이거나 YAGNI, 삭제 우선, 최소 해법을 명시적으로 요청할 때 사용한다. 일반 구현을 가로채는 지속 모드, 읽기 전용 리뷰, repository 전체 audit에는 사용하지 않는다.

프로덕션 동작 변경, 결함 수정 또는 동작에 민감한 리팩터링에서 구현 전에 테스트 적용 방법을 정할 때 사용한다

현재 체크아웃과 작업을 격리해야 하거나 구현 계획 실행 전에 작업 공간 상태를 확인해야 할 때 사용한다

새 스킬을 만들거나 기존 스킬의 설명·절차·참고 자료를 수정하고, 배포 전에 형식과 실제 적용 동작을 검증한다.