From e5e799bef6f24c99c793e6cc0bb76a1639284e0f Mon Sep 17 00:00:00 2001
From: hyoseok <alexization@gmail.com>
Date: Sun, 8 Mar 2026 19:16:54 +0900
Subject: [PATCH 1/2] chore: refresh GitHub issue and PR templates

---
 .github/ISSUE_TEMPLATE/bug_report.yml       | 116 +++++++++++++-------
 .github/ISSUE_TEMPLATE/config.yml           |   6 +-
 .github/ISSUE_TEMPLATE/engineering_task.yml |  72 ++++++++++++
 .github/ISSUE_TEMPLATE/feature_request.yml  | 105 +++++++++++++-----
 .github/ISSUE_TEMPLATE/harness_epic.yml     |  67 -----------
 .github/ISSUE_TEMPLATE/harness_task.yml     |  63 -----------
 .github/ISSUE_TEMPLATE/weekly_scorecard.yml |  58 ----------
 .github/PULL_REQUEST_TEMPLATE.md            |  62 +++++------
 .github/workflows/harness-pr-guardrail.yml  |  95 +---------------
 9 files changed, 257 insertions(+), 387 deletions(-)
 create mode 100644 .github/ISSUE_TEMPLATE/engineering_task.yml
 delete mode 100644 .github/ISSUE_TEMPLATE/harness_epic.yml
 delete mode 100644 .github/ISSUE_TEMPLATE/harness_task.yml
 delete mode 100644 .github/ISSUE_TEMPLATE/weekly_scorecard.yml

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index da71f6c..5cb520f 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -1,79 +1,114 @@
-name: 🐞 버그 리포트 (Bug Report)
-description: 발생한 버그나 오류를 제보해 주세요.
-title: "[Bug]: "
+name: "🐞 Backend Bug Report"
+description: API, 인증, 배치, 점수 계산, 데이터 정합성 관련 문제를 제보합니다.
+title: "[Bug] "
 labels: ["bug", "triage"]
 body:
   - type: markdown
     attributes:
       value: |
-        이 이슈를 작성해 주셔서 감사합니다! 문제를 파악할 수 있도록 상세히 적어주세요.
+        재현 가능한 정보와 로그를 남겨 주세요.
+        백엔드 이슈는 "어떤 요청/배치/계산 경로에서 깨졌는지"가 중요합니다.
 
   - type: textarea
-    id: description
+    id: problem
     attributes:
-      label: 어떤 버그인가요?
-      description: 발생한 문제에 대해 명확하고 간결하게 설명해 주세요.
-      placeholder: 로그인 버튼을 눌렀을 때 반응이 없습니다.
+      label: 문제 요약
+      description: 무엇이 잘못되었는지 한두 문장으로 설명해 주세요.
+      placeholder: GitHub 로그인 후 access token 재발급이 실패합니다.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: 영향 영역
+      options:
+        - auth
+        - ranking
+        - user
+        - badge
+        - batch
+        - integration/github
+        - security
+        - observability
+        - infra/config
+        - unknown
     validations:
       required: true
 
   - type: textarea
     id: reproduction
     attributes:
-      label: 재현 방법 (Steps to Reproduce)
-      description: 개발자가 문제를 재현할 수 있도록 순서대로 적어주세요.
+      label: 재현 절차
+      description: 요청 순서, 입력값, API 경로, 배치 실행 조건을 순서대로 적어 주세요.
       placeholder: |
-        1. 메인 페이지로 이동
-        2. '로그인' 버튼 클릭
-        3. 오류 메시지 발생
+        1. `/api/v1/auth/refresh` 호출
+        2. 만료된 refresh token 쿠키 포함
+        3. 500 응답 발생
     validations:
-      required: false
+      required: true
 
   - type: textarea
-    id: expected-behavior
+    id: expected_behavior
     attributes:
-      label: 기대 동작 (Expected Behavior)
-      description: 원래 정상적으로 작동했다면 어떤 결과가 나와야 했나요?
-      placeholder: 로그인 모달 창이 떠야 합니다.
+      label: 기대 동작
+      placeholder: 401 또는 정상적인 토큰 재발급 응답이 와야 합니다.
     validations:
-      required: false
+      required: true
+
+  - type: textarea
+    id: actual_behavior
+    attributes:
+      label: 실제 동작
+      placeholder: 응답 본문 없이 500이 발생하고 서버 로그에 JWT 파싱 예외가 남습니다.
+    validations:
+      required: true
 
   - type: textarea
-    id: intent_spec
+    id: evidence
     attributes:
-      label: 의도 명세 (Intent Spec)
-      description: 버그 수정에서 반드시 보장해야 할 동작과 비목표를 작성해 주세요.
+      label: 로그 / 메트릭 / 트레이스 / 스크린샷
+      description: 서버 로그, actuator 정보, trace id, 클라이언트 콘솔, 스크린샷 등 증거를 남겨 주세요.
       placeholder: |
-        반드시 보장할 동작:
-        비목표:
+        - trace_id:
+        - log excerpt:
+        - metric/query:
+        - screenshot/link:
     validations:
       required: false
 
-  - type: input
-    id: related_plan
+  - type: textarea
+    id: impact
     attributes:
-      label: 관련 계획 문서 경로 (선택)
-      placeholder: "docs/plans/active/2026-02-25-bugfix-name.md"
+      label: 영향도와 범위
+      description: 사용자 영향, 데이터 손상 가능성, 우회 가능 여부를 적어 주세요.
+      placeholder: |
+        - 영향 사용자:
+        - 데이터 영향:
+        - 우회 방법:
     validations:
       required: false
 
   - type: textarea
-    id: environment
+    id: acceptance
     attributes:
-      label: 실행 환경 (Environment)
-      description: 버그가 발생한 환경 정보를 입력해 주세요.
+      label: 수정 후 확인해야 할 조건
       placeholder: |
-        - OS: [e.g. macOS, Windows 10]
-        - Browser: [e.g. Chrome 98, Safari]
-        - Version: [e.g. 1.0.0]
+        - 만료 토큰 요청 시 401을 반환한다.
+        - 정상 토큰 요청 시 재발급이 성공한다.
+        - 관련 에러 로그가 더 이상 발생하지 않는다.
     validations:
-      required: false
+      required: true
 
   - type: textarea
-    id: logs
+    id: environment
     attributes:
-      label: 스크린샷 또는 로그 (Screenshots/Logs)
-      description: 문제 상황을 보여주는 스크린샷이나 에러 로그가 있다면 첨부해 주세요.
+      label: 실행 환경
+      placeholder: |
+        - profile: local / dev / prod
+        - branch or commit:
+        - DB:
+        - 요청 클라이언트:
     validations:
       required: false
 
@@ -83,4 +118,7 @@ body:
       label: 확인 사항
       options:
         - label: 이 이슈와 동일한 기존 이슈가 있는지 검색해 보았습니다.
-          required: false
+          required: true
+        - label: 재현 절차 또는 로그 등 디버깅 가능한 증거를 남겼습니다.
+          required: true
+
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index 74750f4..7f989d7 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,8 +1,6 @@
 blank_issues_enabled: false
 contact_links:
-  - name: 💬 질문 및 토론 (Discussions)
-    url: https://github.com/alexization/git-ranker/discussions
-    about: 버그나 기능 요청이 아닌 일반적인 질문이나 의견은 이곳을 이용해 주세요.
   - name: 🔒 보안 취약점 제보
     url: mailto:alexizationy@gmail.com
-    about: 민감한 보안 문제는 공개 이슈 대신 이메일로 제보해 주세요.
\ No newline at end of file
+    about: 인증, 권한, 토큰, 사용자 데이터 관련 민감 이슈는 공개 이슈 대신 이메일로 제보해 주세요.
+
diff --git a/.github/ISSUE_TEMPLATE/engineering_task.yml b/.github/ISSUE_TEMPLATE/engineering_task.yml
new file mode 100644
index 0000000..c3a6f52
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/engineering_task.yml
@@ -0,0 +1,72 @@
+name: "🛠️ Backend Engineering Task"
+description: 리팩터링, 성능, 테스트, 보안, 관측성, 운영 개선 작업을 기록합니다.
+title: "[Task] "
+labels: ["task", "triage"]
+body:
+  - type: dropdown
+    id: task_type
+    attributes:
+      label: 작업 유형
+      options:
+        - refactor
+        - performance
+        - testing
+        - security
+        - observability
+        - infra/config
+        - documentation
+    validations:
+      required: true
+
+  - type: textarea
+    id: reason
+    attributes:
+      label: 왜 필요한가요?
+      description: 지금 이 작업이 필요한 이유와 방치 비용을 적어 주세요.
+    validations:
+      required: true
+
+  - type: textarea
+    id: scope
+    attributes:
+      label: 작업 범위
+      description: 변경할 패키지, 설정, 테스트 범위를 적어 주세요.
+      placeholder: |
+        - `domain/ranking`
+        - `global/logging`
+        - `src/test/...`
+    validations:
+      required: true
+
+  - type: textarea
+    id: done
+    attributes:
+      label: 완료 조건
+      placeholder: |
+        - [ ] ...
+        - [ ] ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: validation
+    attributes:
+      label: 검증 방법
+      placeholder: |
+        - `./gradlew test`
+        - `./gradlew integrationTest`
+        - 로그/메트릭 확인
+    validations:
+      required: true
+
+  - type: textarea
+    id: risks
+    attributes:
+      label: 리스크 및 의존성
+      placeholder: |
+        - 리스크:
+        - 의존성:
+        - 후속 작업:
+    validations:
+      required: false
+
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
index ffda77e..4f243a6 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.yml
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -1,64 +1,111 @@
-name: 🚀 기능 요청 (Feature Request)
-description: 프로젝트에 새로운 기능을 제안해 주세요.
-title: "[Feat]: "
+name: "🚀 Backend Feature Request"
+description: API, 배치, 점수 계산, 인증, 데이터 처리 기능을 제안합니다.
+title: "[Feature] "
 labels: ["enhancement", "feature"]
 body:
   - type: markdown
     attributes:
       value: |
-        프로젝트 발전을 위한 아이디어를 제안해 주셔서 감사합니다!
+        기능 요청은 "무엇을 만들고 싶은지"보다 "어떤 문제를 해결해야 하는지"가 먼저여야 합니다.
 
   - type: textarea
     id: problem
     attributes:
-      label: 관련된 문제 상황 (Is your feature request related to a problem?)
-      description: 어떤 불편함이나 문제를 해결하고 싶은지 설명해 주세요.
-      placeholder: "예: 매번 수동으로 설정을 변경해야 하는 것이 번거롭습니다."
+      label: 해결하려는 문제
+      description: 현재 어떤 불편, 누락, 운영 문제를 해결하려는지 적어 주세요.
+      placeholder: 현재 랭킹 계산 결과가 오래된 상태로 유지되어 사용자 혼란이 발생합니다.
     validations:
       required: true
 
   - type: textarea
-    id: solution
+    id: outcome
     attributes:
-      label: 제안하는 해결책 (Describe the solution you'd like)
-      description: 기능이 어떻게 동작해야 하는지 구체적으로 묘사해 주세요.
-      placeholder: "설정 파일 자동 로드 기능을 추가했으면 좋겠습니다."
+      label: 원하는 결과
+      description: 기능이 추가되면 사용자나 운영자가 무엇을 할 수 있어야 하는지 적어 주세요.
+      placeholder: 사용자가 수동 갱신을 요청하면 최신 집계 상태와 완료 시점을 확인할 수 있어야 합니다.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: 영향 영역
+      options:
+        - auth
+        - ranking
+        - user
+        - badge
+        - batch
+        - integration/github
+        - security
+        - observability
+        - infra/config
     validations:
       required: true
 
   - type: textarea
-    id: intent_spec
+    id: desired_behavior
     attributes:
-      label: 의도 명세 (Intent Spec)
-      description: 문제, 목표 동작, 비목표를 작성해 주세요.
+      label: 원하는 동작
+      description: API, 배치, 계산, 에러 처리 관점에서 원하는 동작을 구체적으로 적어 주세요.
       placeholder: |
-        문제:
-        목표 동작:
-        비목표:
+        - 어떤 입력을 받는지
+        - 어떤 결과를 반환하는지
+        - 실패 시 어떻게 동작하는지
     validations:
       required: true
 
-  - type: input
-    id: plan_path
+  - type: textarea
+    id: acceptance
     attributes:
-      label: 계획 문서 경로 (선택)
-      description: 큰 변경이면 docs/plans/active 경로를 연결해 주세요.
-      placeholder: "docs/plans/active/2026-02-25-feature-name.md"
+      label: 수용 기준
+      description: 완료 판정이 가능한 체크리스트를 적어 주세요.
+      placeholder: |
+        - [ ] ...
+        - [ ] ...
     validations:
-      required: false
+      required: true
 
   - type: textarea
-    id: alternatives
+    id: contract_impact
     attributes:
-      label: 고려해 본 대안 (Alternatives considered)
-      description: 위 해결책 외에 고려해 본 다른 방법이 있다면 적어주세요.
+      label: API / 스키마 / 배치 영향
+      description: 엔드포인트, DTO, 이벤트, DB, 캐시, 스케줄러 영향이 있으면 적어 주세요.
+      placeholder: |
+        - API:
+        - DTO/Schema:
+        - DB/Migration:
+        - Batch/Scheduler:
     validations:
       required: false
 
   - type: textarea
-    id: context
+    id: qa_evidence
+    attributes:
+      label: 필요한 검증 증거
+      description: 구현 후 어떤 테스트, 로그, 메트릭, trace 확인이 필요한지 적어 주세요.
+      placeholder: |
+        - `./gradlew test`
+        - `./gradlew integrationTest`
+        - actuator/prometheus 확인
+        - 관련 로그 확인
+    validations:
+      required: true
+
+  - type: textarea
+    id: non_goals_and_risks
+    attributes:
+      label: 비목표와 리스크
+      placeholder: |
+        비목표:
+        리스크:
+    validations:
+      required: false
+
+  - type: input
+    id: related_client_issue
     attributes:
-      label: 추가 정보 (Additional context)
-      description: 스크린샷이나 참고할 만한 링크가 있다면 추가해 주세요.
+      label: 연관된 프론트엔드 이슈 또는 PR (선택)
+      placeholder: "alexization/git-ranker-client#123"
     validations:
       required: false
diff --git a/.github/ISSUE_TEMPLATE/harness_epic.yml b/.github/ISSUE_TEMPLATE/harness_epic.yml
deleted file mode 100644
index 21b23f3..0000000
--- a/.github/ISSUE_TEMPLATE/harness_epic.yml
+++ /dev/null
@@ -1,67 +0,0 @@
-name: 🧭 Harness Epic
-description: 에이전트 운영체계(legibility, observability, system of record, feedback loop)용 상위 이슈
-title: "[Harness Epic]: "
-labels: ["harness", "epic"]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        이 이슈는 하나의 단계(Phase)를 관리하는 상위 Epic입니다.
-        하위 Task 이슈로 분해해서 진행해 주세요.
-
-  - type: input
-    id: phase
-    attributes:
-      label: Phase
-      description: 예) M1 Legibility / M2 Observability / M3 System of Record / M4 Feedback Loop / M5 Quality Automation
-      placeholder: "M1 Legibility"
-    validations:
-      required: true
-
-  - type: textarea
-    id: objective
-    attributes:
-      label: 목표 (Objective)
-      description: 이번 Epic이 해결해야 하는 운영 문제를 명확히 작성하세요.
-      placeholder: "예: 신규 기여자와 AI agent가 저장소 구조를 10분 내 이해할 수 있어야 함"
-    validations:
-      required: true
-
-  - type: textarea
-    id: success_criteria
-    attributes:
-      label: 완료 기준 (Success Criteria)
-      description: 측정 가능한 완료 기준을 작성하세요.
-      placeholder: |
-        - AGENTS.md 정착
-        - docs index 구축
-        - PR 템플릿 강제 항목 운영
-    validations:
-      required: true
-
-  - type: textarea
-    id: planned_tasks
-    attributes:
-      label: 예정된 하위 Task 이슈
-      description: 체크리스트로 분해하세요.
-      placeholder: |
-        - [ ] M1-1 ...
-        - [ ] M1-2 ...
-    validations:
-      required: true
-
-  - type: textarea
-    id: risks
-    attributes:
-      label: 리스크 및 대응
-      description: 실패 가능성과 완화 전략을 작성하세요.
-    validations:
-      required: false
-
-  - type: textarea
-    id: out_of_scope
-    attributes:
-      label: 범위 제외 (Out of Scope)
-      description: 이번 Epic에서 하지 않을 항목을 명확히 작성하세요.
-    validations:
-      required: false
diff --git a/.github/ISSUE_TEMPLATE/harness_task.yml b/.github/ISSUE_TEMPLATE/harness_task.yml
deleted file mode 100644
index cc6359f..0000000
--- a/.github/ISSUE_TEMPLATE/harness_task.yml
+++ /dev/null
@@ -1,63 +0,0 @@
-name: ✅ Harness Task
-description: Epic 하위 실행 단위 이슈 (하나의 목표, 하나의 PR)
-title: "[Harness Task]: "
-labels: ["harness", "task"]
-body:
-  - type: input
-    id: epic_link
-    attributes:
-      label: 상위 Epic 이슈 링크
-      placeholder: "예: #123"
-    validations:
-      required: true
-
-  - type: input
-    id: plan_doc
-    attributes:
-      label: Plan 문서 경로
-      description: docs/plans/active/ 경로를 입력하세요.
-      placeholder: "docs/plans/active/2026-02-25-<slug>.md"
-    validations:
-      required: true
-
-  - type: textarea
-    id: intent
-    attributes:
-      label: 의도 명세 (Intent Spec)
-      description: 문제, 목표 동작, 비목표를 작성하세요.
-      placeholder: |
-        문제:
-        목표 동작:
-        비목표:
-    validations:
-      required: true
-
-  - type: textarea
-    id: scope
-    attributes:
-      label: 구현 범위
-      description: 이번 Task에서 실제로 바꿀 파일/구성요소를 작성하세요.
-    validations:
-      required: true
-
-  - type: textarea
-    id: validation
-    attributes:
-      label: 검증 방법
-      description: 실행할 명령과 확인할 관측 포인트를 작성하세요.
-      placeholder: |
-        명령:
-        - ./gradlew test --tests "..."
-        관측:
-        - actuator/metrics 확인
-        - 로그 필드 확인
-    validations:
-      required: true
-
-  - type: textarea
-    id: done
-    attributes:
-      label: 완료 조건
-      description: 이 Task가 끝났다고 판단할 기준을 작성하세요.
-    validations:
-      required: true
diff --git a/.github/ISSUE_TEMPLATE/weekly_scorecard.yml b/.github/ISSUE_TEMPLATE/weekly_scorecard.yml
deleted file mode 100644
index 3797c96..0000000
--- a/.github/ISSUE_TEMPLATE/weekly_scorecard.yml
+++ /dev/null
@@ -1,58 +0,0 @@
-name: 📊 주간 Scorecard
-description: 한 주간의 품질/드리프트 점검을 기록하는 이슈
-title: "[Weekly Scorecard]: "
-labels: ["harness", "scorecard"]
-body:
-  - type: input
-    id: week
-    attributes:
-      label: Review Week
-      placeholder: "2026-W09"
-    validations:
-      required: true
-
-  - type: input
-    id: owner
-    attributes:
-      label: Owner
-      placeholder: "@username"
-    validations:
-      required: true
-
-  - type: input
-    id: scorecard_doc
-    attributes:
-      label: Scorecard Document Path
-      placeholder: "docs/scorecards/2026-W09-scorecard.md"
-    validations:
-      required: true
-
-  - type: textarea
-    id: summary
-    attributes:
-      label: Week Summary
-      description: 핵심 변화와 품질 상태를 3~5줄로 요약해 주세요.
-    validations:
-      required: true
-
-  - type: textarea
-    id: risks
-    attributes:
-      label: Top Risks Next Week
-      placeholder: |
-        1) ...
-        2) ...
-        3) ...
-    validations:
-      required: true
-
-  - type: textarea
-    id: action_items
-    attributes:
-      label: Action Items
-      description: 다음 주 실행 항목과 담당자를 작성해 주세요.
-      placeholder: |
-        - [ ] #123 ... (@owner)
-        - [ ] #124 ... (@owner)
-    validations:
-      required: true
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index e803115..90079d7 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -4,54 +4,46 @@
 
 ## 2) 연관 이슈
 - Closes #
+- 관련 frontend 이슈/PR:
 
-## 3) 의도 명세
+## 3) 문제와 목표
 - 문제:
-- 목표 동작:
+- 사용자/운영자 관점의 결과:
 - 비목표:
 
-## 4) System of Record 링크
-- Plan (머지 전 최종 상태): `docs/plans/completed/YYYY-MM-DD-<slug>.md`
-- ADR (필요 시): `docs/adr/...`
-- 관련 runbook/docs 업데이트:
+## 4) 영향 범위
+- 변경된 패키지/모듈:
+- API/DTO/Schema 영향:
+- DB/Cache/Batch/Scheduler 영향:
+- 보안/권한 영향:
 
-## 5) 변경 범위
-- 변경된 파일/패키지:
-- API/스키마/동작 영향:
+## 5) 검증 증거
 
-## 6) 검증 증거
-
-| 유형 | 명령어 | 결과 |
+| 유형 | 명령어 / 증거 | 결과 |
 | --- | --- | --- |
 | Build | `./gradlew build -x test` | |
 | Unit | `./gradlew test` | |
-| Integration | `./gradlew integrationTest` 또는 `미실행(사유)` | |
-| Quality (Coverage) | `./gradlew test jacocoTestCoverageVerification` 또는 `미실행(사유)` | |
-
-## 7) AI 리뷰 루프 증거
-
-| 리뷰어 | 라운드 | 최종 결과 | 증거 링크 |
-| --- | --- | --- | --- |
-| Codex |  |  |  |
-| CodeRabbitAI |  |  |  |
+| Integration | `./gradlew integrationTest` 또는 `미실행(<사유>)` | |
+| Coverage | `./gradlew test jacocoTestCoverageVerification` 또는 `미실행(<사유>)` | |
+| API/Manual Smoke | `curl ...` / Postman / 배치 실행 기록 또는 `미실행(<사유>)` | |
 
-## 8) 관측성 확인
+## 6) 관측성 확인
 - 확인한 로그:
 - 확인한 메트릭:
-- 확인한 대시보드/쿼리:
+- 확인한 trace/dashboard/query:
 
-## 9) 리스크 및 롤백
+## 7) AI 리뷰 메모 (선택)
+- Codex:
+- CodeRabbitAI:
+
+## 8) 리스크 및 롤백
 - 리스크:
 - 롤백 계획:
 
-## 10) Merge Ready Gate
-- [ ] Codex/CodeRabbit final re-reviews completed
-- [ ] All review findings triaged (fixed or justified)
-- [ ] Plan moved to `docs/plans/completed/...` in this PR
-- [ ] Risk and rollback section updated
-
-## 11) 체크리스트
-- [ ] 이슈가 연결되어 있음
-- [ ] Plan 문서가 연결되어 있음
-- [ ] 검증 증거가 포함되어 있음
-- [ ] 문서가 업데이트되었거나 불필요 사유가 명시되어 있음
+## 9) 체크리스트
+- [ ] 연관 이슈가 연결되어 있음
+- [ ] Build / Unit / Integration 결과가 기입되어 있음
+- [ ] API/스키마/배치 영향이 반영되었거나 없음을 명시함
+- [ ] 로그/메트릭/trace 확인 내용을 적었거나 불필요 사유를 적음
+- [ ] 문서 또는 후속 이슈가 업데이트되었거나 불필요 사유를 적음
+
diff --git a/.github/workflows/harness-pr-guardrail.yml b/.github/workflows/harness-pr-guardrail.yml
index 2ee7665..b4e5caf 100644
--- a/.github/workflows/harness-pr-guardrail.yml
+++ b/.github/workflows/harness-pr-guardrail.yml
@@ -12,7 +12,7 @@ jobs:
     name: Validate PR Contract
     runs-on: ubuntu-latest
     steps:
-      - name: Check plan link, validation evidence, and AI review loop
+      - name: Check validation evidence and risk section
         env:
           PR_BODY: ${{ github.event.pull_request.body }}
           PR_IS_DRAFT: ${{ github.event.pull_request.draft }}
@@ -25,15 +25,10 @@ jobs:
           fi
 
           if [ "${PR_IS_DRAFT:-false}" = "true" ]; then
-            echo "Draft PR detected; skipping strict merge-ready checks."
+            echo "Draft PR detected; skipping strict checks."
             exit 0
           fi
 
-          if ! echo "$PR_BODY" | grep -Eiq 'docs/plans/completed/[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9._-]+\.md'; then
-            echo "Missing completed plan doc path (docs/plans/completed/YYYY-MM-DD-<slug>.md)."
-            exit 1
-          fi
-
           if ! validation_errors="$(printf '%s\n' "$PR_BODY" | awk -F'|' '
             function trim(s) { gsub(/^[ \t]+|[ \t]+$/, "", s); return s }
             {
@@ -84,94 +79,10 @@ jobs:
             exit 1
           fi
 
-          if ! ai_review_errors="$(printf '%s\n' "$PR_BODY" | awk -F'|' '
-            function trim(s) { gsub(/^[ \t]+|[ \t]+$/, "", s); return s }
-            {
-              reviewer = trim($2)
-              round = trim($3)
-              result = trim($4)
-              evidence = trim($5)
-
-              if (reviewer == "Codex" || reviewer == "CodeRabbitAI") {
-                found[reviewer] = 1
-
-                if (round == "") {
-                  empty_round[reviewer] = 1
-                }
-
-                if (result == "") {
-                  empty_result[reviewer] = 1
-                }
-
-                if (evidence == "" || evidence == "-") {
-                  empty_evidence[reviewer] = 1
-                }
-
-                if (result ~ /^Not run/ || result ~ /^미실행/) {
-                  if (result !~ /^Not run[[:space:]]*\([^()[:space:]].+\)$/ &&
-                      result !~ /^미실행[[:space:]]*\([^()[:space:]].+\)$/) {
-                    invalid_not_run[reviewer] = result
-                  }
-                }
-              }
-            }
-            END {
-              bad = 0
-              required[1] = "Codex"
-              required[2] = "CodeRabbitAI"
-
-              for (i = 1; i <= 2; i++) {
-                r = required[i]
-                if (!(r in found)) {
-                  print "Missing AI review row for: " r
-                  bad = 1
-                } else if (r in empty_round) {
-                  print "Missing AI review round for: " r
-                  bad = 1
-                } else if (r in empty_result) {
-                  print "Missing AI review result for: " r
-                  bad = 1
-                } else if (r in empty_evidence) {
-                  print "Missing AI review evidence link for: " r
-                  bad = 1
-                } else if (r in invalid_not_run) {
-                  print "Invalid AI not-run format for " r ": " invalid_not_run[r]
-                  bad = 1
-                }
-              }
-
-              exit bad
-            }
-          ')"; then
-            echo "$ai_review_errors"
-            echo "AI review loop evidence must include round/result/evidence for Codex and CodeRabbitAI."
-            echo "If not run, use: Not run(<reason>) or 미실행(<사유>)."
-            exit 1
-          fi
-
-          if ! echo "$PR_BODY" | grep -Fq -- "- [x] Codex/CodeRabbit final re-reviews completed"; then
-            echo "Merge Ready Gate missing checked item: Codex/CodeRabbit final re-reviews completed."
-            exit 1
-          fi
-
-          if ! echo "$PR_BODY" | grep -Fq -- "- [x] All review findings triaged (fixed or justified)"; then
-            echo "Merge Ready Gate missing checked item: All review findings triaged (fixed or justified)."
-            exit 1
-          fi
-
-          if ! echo "$PR_BODY" | grep -Fq -- '- [x] Plan moved to `docs/plans/completed/...` in this PR'; then
-            echo "Merge Ready Gate missing checked item: Plan moved to docs/plans/completed in this PR."
-            exit 1
-          fi
-
-          if ! echo "$PR_BODY" | grep -Fq -- "- [x] Risk and rollback section updated"; then
-            echo "Merge Ready Gate missing checked item: Risk and rollback section updated."
-            exit 1
-          fi
-
           if ! echo "$PR_BODY" | grep -Eiq 'Risk and Rollback|Rollback|리스크 및 롤백|롤백'; then
             echo "Missing risk/rollback section."
             exit 1
           fi
 
           echo "PR contract passed."
+

From 3a5f37f1a06d756de5bd58ca3afb1a9ba3b9d2c6 Mon Sep 17 00:00:00 2001
From: hyoseok <alexization@gmail.com>
Date: Sun, 8 Mar 2026 20:42:14 +0900
Subject: [PATCH 2/2] chore: remove legacy harness PR guardrail

---
 .github/workflows/harness-pr-guardrail.yml | 88 ----------------------
 1 file changed, 88 deletions(-)
 delete mode 100644 .github/workflows/harness-pr-guardrail.yml

diff --git a/.github/workflows/harness-pr-guardrail.yml b/.github/workflows/harness-pr-guardrail.yml
deleted file mode 100644
index b4e5caf..0000000
--- a/.github/workflows/harness-pr-guardrail.yml
+++ /dev/null
@@ -1,88 +0,0 @@
-name: Harness PR Guardrail
-
-on:
-  pull_request:
-    types: [opened, edited, reopened, synchronize, ready_for_review]
-    branches:
-      - main
-      - develop
-
-jobs:
-  pr-contract:
-    name: Validate PR Contract
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check validation evidence and risk section
-        env:
-          PR_BODY: ${{ github.event.pull_request.body }}
-          PR_IS_DRAFT: ${{ github.event.pull_request.draft }}
-        run: |
-          set -eu
-
-          if [ -z "${PR_BODY:-}" ]; then
-            echo "PR body is empty."
-            exit 1
-          fi
-
-          if [ "${PR_IS_DRAFT:-false}" = "true" ]; then
-            echo "Draft PR detected; skipping strict checks."
-            exit 0
-          fi
-
-          if ! validation_errors="$(printf '%s\n' "$PR_BODY" | awk -F'|' '
-            function trim(s) { gsub(/^[ \t]+|[ \t]+$/, "", s); return s }
-            {
-              type = trim($2)
-              result = trim($4)
-
-              if (type == "Build" || type == "Unit" || type == "Integration") {
-                found[type] = 1
-
-                if (result == "") {
-                  empty_result[type] = 1
-                }
-
-                if (result ~ /^Not run/ || result ~ /^미실행/) {
-                  if (result !~ /^Not run[[:space:]]*\([^()[:space:]].+\)$/ &&
-                      result !~ /^미실행[[:space:]]*\([^()[:space:]].+\)$/) {
-                    invalid_not_run[type] = result
-                  }
-                }
-              }
-            }
-            END {
-              bad = 0
-              required[1] = "Build"
-              required[2] = "Unit"
-              required[3] = "Integration"
-
-              for (i = 1; i <= 3; i++) {
-                t = required[i]
-                if (!(t in found)) {
-                  print "Missing validation table row for: " t
-                  bad = 1
-                } else if (t in empty_result) {
-                  print "Missing validation result for: " t
-                  bad = 1
-                } else if (t in invalid_not_run) {
-                  print "Invalid not-run format for " t ": " invalid_not_run[t]
-                  bad = 1
-                }
-              }
-
-              exit bad
-            }
-          ')"; then
-            echo "$validation_errors"
-            echo "Validation evidence must include non-empty results for Build/Unit/Integration."
-            echo "If not run, use: Not run(<reason>) or 미실행(<사유>)."
-            exit 1
-          fi
-
-          if ! echo "$PR_BODY" | grep -Eiq 'Risk and Rollback|Rollback|리스크 및 롤백|롤백'; then
-            echo "Missing risk/rollback section."
-            exit 1
-          fi
-
-          echo "PR contract passed."
-