predeploy-quality-gate

name	predeploy-quality-gate
description	배포/머지 전에 현재 Git 브랜치(HEAD) 변경사항을 품질 게이트로 검증하고, 차단(BLOCKER)/경고(WARN)/제안(SUGGEST) 항목을 리스트로 리포트하기. "배포 전 품질 점검", "quality gate", "머지 게이트", "현재 브랜치 코드 품질 검증" 요청에 사용하기. 프로젝트 유형(Flutter/Node/Python/Go/Rust 등)을 자동 탐지해 포맷/린트/타입체크/테스트를 가능한 범위에서 실행하고, 리팩터링 후 미사용/미참조 코드 제거를 제안하기. 변경 범위가 크면 sub-agent로 리뷰를 병렬화하기.

Predeploy Quality Gate (배포 전 품질 게이트)

목적

• 현재 브랜치(HEAD)의 변경사항을 기준 ref 대비 점검하고, 차단(BLOCKER)/경고(WARN)/제안(SUGGEST) 항목을 리스트로 반환하기.
• 자동 점검(명령 실행 + 휴리스틱)과 수동 점검(체크리스트 기반 리뷰)을 분리해 보고하기.

빠른 실행

• 자동 점검 스크립트 실행하기(기본: base 자동 탐지 + full 모드 + 작업 트리(workspace) 범위):
  • python3 ~/.codex/skills/predeploy-quality-gate/scripts/quality_gate.py
• 테스트를 생략하고 빠르게 확인하기:
  • python3 ~/.codex/skills/predeploy-quality-gate/scripts/quality_gate.py --mode quick
• 비교 기준 ref를 명시하기(예: main):
  • python3 ~/.codex/skills/predeploy-quality-gate/scripts/quality_gate.py --base origin/main
• 커밋된 변경만(PR diff처럼) 보려면:
  • python3 ~/.codex/skills/predeploy-quality-gate/scripts/quality_gate.py --scope committed
• 미추적 파일(untracked)을 제외하려면:
  • python3 ~/.codex/skills/predeploy-quality-gate/scripts/quality_gate.py --no-untracked

워크플로

1) 변경 범위 확정하기

• 기본 비교 기준을 origin/HEAD로 두고, 자동 탐지가 실패하면 --base로 지정하기.
• 기본 범위는 workspace이며, merge-base 대비 작업 트리(스테이징/미스테이징) 변경과 **미추적 파일(untracked)**까지 포함하기.
• PR diff처럼 커밋된 변경만 점검하려면 --scope committed로 base...HEAD(triple-dot) 범위를 사용하기.

2) 자동 점검 수행하기