Initial commit: Add project files

2026-08-02 05:15:36 +09:00
commit dcd1322d41
636 changed files with 122352 additions and 0 deletions
@@ -0,0 +1,44 @@
+# 바이브코딩·홀루시네이션 통제
+
+## 1. 기본 원칙
+
+AI는 구현 초안을 만든다. 정책·증거·리스크·승격은 사람이 승인한다. 채팅, 자동완성, 생성 코드 자체는 Source of Truth가 아니다.
+
+## 2. 모든 변경의 4분류
+
+- `SOURCE`: 첨부 기준서, 승인 ADR, 계약, 데이터 증거에 직접 근거.
+- `ASSUMPTION`: 착수 편의를 위한 가정. 만료일과 승인자가 필요.
+- `UNKNOWN`: 자료로 판단할 수 없음.
+- `DECISION_REQUIRED`: 코딩 전 결정이 필요한 차단 항목.
+
+## 3. AI 작업 패킷
+
+AI에 전달하는 작업은 최소 다음을 포함한다.
+
+1. Requirement ID / Slice ID.
+2. 사용자 결과와 비목표.
+3. Policy ID와 단위·우선순위.
+4. Data source/PIT/revision/quality.
+5. API/DB/Event/Job/UI 계약.
+6. Given/When/Then과 실패상태.
+7. 금지 패턴.
+8. 검증 명령과 완료 증거.
+
+## 4. PR 차단 규칙
+
+- Source/Assumption/Unknown 표기가 없음.
+- 새 library/pattern/table/threshold에 ADR이 없음.
+- Migration fresh/upgrade/re-run evidence가 없음.
+- Golden/OOS/Architecture/Data/E2E test가 없음.
+- 실행하지 않은 test를 통과로 기록함.
+- 실고객 데이터·계좌·token·secret가 prompt/log/fixture에 포함됨.
+- 자동주문 Capability를 우회하거나 기본 ON으로 변경함.
+
+## 5. 리팩터링 원칙
+
+- 동작 보존 refactoring과 정책 변경을 한 PR에 섞지 않는다.
+- 먼저 Characterization/Golden test를 만든다.
+- God Service를 Endpoint/Application/Policy/Adapter로 분리한다.
+- Generic Repository로 Dapper SQL 의미를 숨기지 않는다.
+- 중복은 의미와 변경축이 같을 때만 추상화한다.
+- 기술부채는 등록, owner, impact, repayment trigger, deadline을 가진다.