Skip to content

feature: 공통 PR template Real Behavior Proof 도입#12

Open
get6 wants to merge 1 commit into
mainfrom
agent/claude/d069f5c1
Open

feature: 공통 PR template Real Behavior Proof 도입#12
get6 wants to merge 1 commit into
mainfrom
agent/claude/d069f5c1

Conversation

@get6
Copy link
Copy Markdown
Member

@get6 get6 commented May 18, 2026

🌷 Summary

org 전체 저장소에 공통 적용되는 PR template을 .github/PULL_REQUEST_TEMPLATE.md로 추가합니다.

📢 Description

ITT-127의 child issue 작업입니다. agent-driven PR을 운영하기 위한 최소 시작점으로 공통 PR template을 도입합니다.

핵심적인 변경 내용

.github/PULL_REQUEST_TEMPLATE.md 신규 작성. 다음 섹션 포함:

  • Summary / Description / Related Issue (기본 PR 정보)
  • Real Behavior Proof (필수) — CI, unit test, lint 결과만으로는 충분하지 않다는 안내와 실제 실행 증거 체크리스트
  • Human Decision Needed — 제품/비용/보안/릴리즈 결정 필요 항목 체크박스
  • Commit / PR Title Conventionfeat: 금지, feature: <한국어 설명> 사용 안내

적용 범위 (상속 vs override)

GitHub은 .github organization 저장소의 PULL_REQUEST_TEMPLATE.md를 org-wide 기본 PR template으로 사용합니다. 각 저장소에 repo-local PR template이 있으면 그쪽이 우선합니다.

저장소 상태 적용 결과
ittae/.github (자체에는 자기 자신용 .github/pull_request_template.md가 따로 있음) 본 PR로 org-wide template 신규 추가
ittae/ittae repo-local PR template 존재 repo-local override (별도 PR에서 새 섹션 병합)
get6/vault 없음 org-wide template 상속
ittae/flutter_boilerplate 없음 org-wide template 상속
ittae/glimpshot 없음 org-wide template 상속
ittae/autocat 없음 org-wide template 상속
ittae/clean_architecture_linter 없음 org-wide template 상속
ittae/landing-page 없음 org-wide template 상속
ittae/openplant 없음 org-wide template 상속

🐙 Related Issue

ITT-127

Real Behavior Proof (필수)

  • 실제 실행 환경: GitHub .github repository (org template lookup)
  • 실행한 명령 / 조작: 파일 추가 후 새 PR 생성 시 GitHub UI에서 해당 template이 자동 로드되는지 검증 필요
  • 결과 증거: 본 PR 머지 후 다른 저장소(get6/vault 등 repo-local template 없는 곳)에서 PR을 새로 만들 때 본 template이 자동 채워지는지 확인 가능
  • 검증한 시나리오: 마크다운 렌더링 확인, 헤더/체크박스 구조 확인
  • 검증하지 않은 영역: 머지 후 실제 PR 생성 UI에서의 자동 채움 동작 (머지 전에는 검증 불가)
  • 증거가 부족하다면 그 이유: org-wide template의 적용 효과는 머지된 상태에서만 검증 가능

Human Decision Needed

  • 없음 — 에이전트 판단으로 진행 가능 (template 문구는 이슈 본문의 권장 문구를 기반)

Commit / PR Title Convention

  • feat: 사용 금지
  • feature: <한국어 설명> 사용

⚠️ Safety

  • rm, git rm, force push 사용하지 않음
  • auto-merge, labeler, CODEOWNERS, branch protection, Multica autopilot 설정 변경하지 않음
  • 기존 파일 삭제 없이 신규 파일만 추가

org 전체 저장소에 공통 적용되는 PR template을 .github 저장소에 추가한다.
Real Behavior Proof, Human Decision Needed, feat 금지 / feature 한국어
설명 convention 안내 섹션을 포함한다.

closes ITT-127

Co-authored-by: multica-agent <github@multica.ai>
Copilot AI review requested due to automatic review settings May 18, 2026 10:53
Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new Pull Request template for GitHub to standardize contributions, including sections for summaries, descriptions, and verification proofs. The review feedback suggests enhancing the issue linking field with a '#' prefix for better usability and expanding the list of documented conventional commit types to include 'build', 'style', and 'revert'.


## 🐙 Related Issue
<!-- 연관 이슈 번호 또는 링크 (예: close #123) -->
close
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

GitHub의 이슈 자동 종료 기능을 더 편리하게 사용할 수 있도록 #를 추가하는 것을 제안합니다. 사용자가 이슈 번호만 입력하면 되므로 실수를 줄일 수 있습니다.

Suggested change
close
close #

- ❌ `feat:` 사용 금지
- ✅ `feature: <한국어 설명>` 사용
- 예: `feature: 로그인 화면 에러 메시지 다국어 처리`
- 그 외 prefix는 conventional commits를 따른다: `fix`, `refactor`, `docs`, `test`, `chore`, `perf`, `ci`
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Conventional Commits 표준에서 정의하는 build (빌드 시스템 변경), style (코드 포맷팅), revert (이전 커밋 되돌리기) 타입이 누락되어 있습니다. 프로젝트의 다양한 변경 사항을 포괄할 수 있도록 이들을 추가하는 것을 권장합니다.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces an organization-wide pull request template for the .github org repository, aiming to standardize PR information and require “Real Behavior Proof” beyond CI/test/lint outputs.

Changes:

  • Add .github/PULL_REQUEST_TEMPLATE.md with standard sections (Summary, Description, Related Issue).
  • Add required “Real Behavior Proof (필수)” section to capture real execution evidence.
  • Add “Human Decision Needed” and commit/PR title convention guidance.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.


## 🐙 Related Issue
<!-- 연관 이슈 번호 또는 링크 (예: close #123) -->
close
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants