# 엔지니어링 계획 리뷰 (plan-eng-review)

> 엔지니어링 매니저의 시각으로 계획, 브랜치 diff, 지정 코드를 검토해 아키텍처, 코드 품질, 테스트, 성능을 보고합니다.

- 카테고리: [아키텍처 설계](https://www.myskills.tools/ko/categories/architecture/)
- 출처: 커뮤니티 · Garry Tan
- 저장소: https://github.com/garrytan/gstack/tree/main/plan-eng-review (commit 8695938 · v1.0.0)
- SKILL.md: https://github.com/garrytan/gstack/blob/main/plan-eng-review/SKILL.md
- 설치 명령: `npx skills add garrytan/gstack --skill plan-eng-review`
- 라이선스: MIT
- 호환 도구: Claude Code, Codex, Cursor, Copilot
- 권한: read-repo ✓, write-files ✓, shell ✓, network ✓
- 상태: 스캔 통과
- 규칙 스캔으로 모든 위험을 찾을 수는 없습니다. 설치 전에 이 스킬의 SKILL.md를 읽고 권한을 확인하세요.
- ⚠ 기본으로 계획을 Codex 에 보내 독립 검토를 받으며, gstack-config set codex_reviews disabled 로 끌 수 있습니다.

## 핵심 규칙

검토만 하며, 사용자의 명시적 허가 없이는 기능, 인수 테스트, 벤치마크를 만들지 않습니다.

## 실행 단계

1. **검토 대상 선택** — 먼저 대상을 정합니다. 현재 브랜치 diff, 계획·설계 문서, 지정 경로 중 하나이며, 플랜 모드에서는 현재 계획을 자동 선택합니다.
2. **범위 점검** — 기존 해법, 최소 변경, 복잡도를 확인하고 새 패턴은 웹에서 내장 기능과 함정을 조사하며 TODOS.md 와 대조합니다.
3. **네 가지 검토** — 아키텍처, 코드 품질, 테스트, 성능 순으로 검토하고 각 절마다 발견을 나열해 하나씩 결정하며, 어느 절도 생략하지 않습니다.
4. **외부 의견** — 네 절을 마친 뒤 기본으로 다른 AI 시스템(Codex)이 계획을 독립적으로 검증하게 하고 결과를 종합합니다.
5. **보고서와 게이트** — 결과를 GSTACK REVIEW REPORT 로 끝나는 보고서 파일에 쓰고, 플랜 모드를 나가기 전에 형식을 점검합니다.

## 권한 설명 (SKILL.md 기준)

| 기능 | 필요 여부 | 설명 |
|---|---|---|
| 파일 쓰기 | 일부 필요 | 선택한 보고서 파일(검토 대상 계획 또는 별도 리뷰 파일)만 작성하며 구현 코드는 수정하지 않습니다. |
| 명령 실행 | 일부 필요 | gstack 보조 스크립트, git, 기존 테스트를 활용한 제한적인 동작 확인을 실행합니다. |
| 네트워크 송신 | 필요 | Aside 나 WebSearch 로 웹 조사를 하고, 기본으로 Codex 에 외부 의견을 요청합니다. |

## SKILL.md 프런트매터(YAML)

```yaml
---
name: plan-eng-review
preamble-tier: 3
version: 1.0.0
description: Eng manager-mode plan review. (gstack)
allowed-tools:
  - Read
  - Write
  - Grep
  - Glob
  - AskUserQuestion
  - Bash
  - WebSearch
triggers:
  - review architecture
  - eng plan review
  - check the implementation plan
---
```

홈: https://www.myskills.tools/ko/ · URL: https://www.myskills.tools/ko/skills/plan-eng-review/