process: prevent recurring PR workflow failures on governance traceability #414

New Issue

agentson · 2026-03-04T23:02:36+09:00

agentson commented

2026-03-04 23:02:36 +09:00

Summary

PR 생성/업데이트 시 CI가 반복적으로 실패하며, 원인이 코드 변경 자체보다 워크플로우/프로세스 누락(특히 PR 본문 거버넌스 필드) 에서 자주 발생합니다.

Observed Pattern

최근 PR에서 validate_governance_assets 단계가 REQ-ID / TASK-ID / TEST-ID 누락으로 실패
구현/테스트는 통과했지만 PR 메타데이터 누락으로 파이프라인 전체가 실패
동일 유형 실수가 반복되어 개발 속도 저하

Problem Statement

현재 워크플로우는 "실패 후 수정" 방식이라, PR 생성 시점에 필요한 거버넌스 필드를 강제/가이드하는 장치가 부족합니다.

Proposal

PR 템플릿 상단에 필수 Traceability 섹션(REQ/TASK/TEST)을 더 명확히 고정
tea pr create 전에 실행 가능한 preflight 스크립트 추가
- 예: scripts/validate_pr_body.py + 거버넌스 필드 체크 통합
CI 실패 메시지에 누락된 필드를 자동으로 예시 출력
필요 시 scripts/에 PR 본문 생성 래퍼 추가(heredoc 기반)

Acceptance Criteria

PR 생성 직후(로컬/CI 모두) Traceability 누락을 즉시 감지 가능
동일 유형 실패(REQ/TASK/TEST 누락) 재발률 유의미하게 감소
문서(docs/workflow.md, docs/commands.md)에 표준 절차 반영

## Summary PR 생성/업데이트 시 CI가 반복적으로 실패하며, 원인이 코드 변경 자체보다 **워크플로우/프로세스 누락(특히 PR 본문 거버넌스 필드)** 에서 자주 발생합니다. ## Observed Pattern - 최근 PR에서 `validate_governance_assets` 단계가 `REQ-ID / TASK-ID / TEST-ID` 누락으로 실패 - 구현/테스트는 통과했지만 PR 메타데이터 누락으로 파이프라인 전체가 실패 - 동일 유형 실수가 반복되어 개발 속도 저하 ## Problem Statement 현재 워크플로우는 "실패 후 수정" 방식이라, PR 생성 시점에 필요한 거버넌스 필드를 강제/가이드하는 장치가 부족합니다. ## Proposal 1. PR 템플릿 상단에 **필수 Traceability 섹션**(REQ/TASK/TEST)을 더 명확히 고정 2. `tea pr create` 전에 실행 가능한 **preflight 스크립트** 추가 - 예: `scripts/validate_pr_body.py` + 거버넌스 필드 체크 통합 3. CI 실패 메시지에 누락된 필드를 자동으로 예시 출력 4. 필요 시 `scripts/`에 PR 본문 생성 래퍼 추가(heredoc 기반) ## Acceptance Criteria - PR 생성 직후(로컬/CI 모두) Traceability 누락을 즉시 감지 가능 - 동일 유형 실패(REQ/TASK/TEST 누락) 재발률 유의미하게 감소 - 문서(`docs/workflow.md`, `docs/commands.md`)에 표준 절차 반영 ## Related - #411 - #409

agentson referenced this issue from a commit

2026-03-04 23:27:17 +09:00

fix: #412/#413/#414 runtime stability and PR governance preflight

agentson referenced a pull request that will close this issue

2026-03-04 23:27:49 +09:00

fix: #412/#413/#414 runtime stability and PR governance preflight #415

jihoson closed this issue

2026-03-04 23:43:36 +09:00

Sign in to join this conversation.