시그니처 코딩 절대규칙 표준

0. 적용 범위

본 표준은 설계, 구현, 수정, 리팩터링, 리뷰, 문서화, 테스트 계획 전 단계에 동일하게 적용한다. 어떠한 사유로도 예외를 두지 않는다.

1. Fake Implementation 전면 금지

다음 유형의 구현, 지시, 표현, 산출물은 전면 금지한다.

1.1 금지 대상

• TODO, 추후 구현, 실제 구현 시, 나중에 등 구현 유예 표현

• 간단하게, 빠르게, 핵심만, 몇 개만, 주요만 등 축약·부분처리 유도 표현

• 파일이 길다/크다/제한이 있다 등의 이유로 일부만 읽기, 일부만 처리, 일부만 확인하는 방식

• mock, dummy, stub, placeholder, sample 등 실데이터 미연동 방식

• 주석처리, 우회처리, 제거처리로 정상처럼 보이게 만드는 방식

1.2 허용 조건

• 실데이터 연동, 실제 흐름 완결, 실제 산출물 생성이 보장되는 Real Implementation만 허용한다.

2. Real Implementation만 허용

요청 수행 시 아래 항목을 반드시 충족해야 한다.

2.1 목적과 존재 이유

• 왜 존재하는지: 목적, 필요, 제약을 명시한다.

2.2 책임과 경계

• 무엇을 만드는지: 역할, 책임, 입력/출력, 경계(소유 범위)를 명확히 한다.

2.3 동작 방식과 흐름

• 어떻게 동작하는지: 데이터 흐름, 호출 관계, 예외 및 실패 전략, 보안 및 성능 요건을 명시한다.

2.4 결과물과 검증 기준

• 무엇이 생성/변경되는지: DB, 파일, API 응답, UI 상태 등 실제 산출물을 명확히 한다.

• 검증 기준을 산출물 기준으로 정의한다.

2.5 흐름 완결 요건

• 입력 → 처리 → 저장/전달 → 로드/표현까지 전체 파이프라인이 실제로 연결되어야 한다.

• 작동한다고 가정, 나중에 연결 같은 결론은 금지한다.

3. 확인 없는 추론 및 관념적 답변 금지

다음 행위는 전면 금지한다.

3.1 금지 행위

• 파일명/폴더명/관례만 보고 추론하거나 상상하여 결정하는 행위

• 보통 이렇게 한다, 일반적으로, 관념적으로 등 일반론으로 결론을 확정하는 행위

• 웹검색 없이 외부 사실(버전, 정책, 동작)을 단정하는 행위

• 실제 근거 없이 우회, 주석, 제거로 해결하는 행위

3.2 확정 허용 조건

• 코드, 스키마, 명세, 실데이터, 공식 문서 등 검증 가능한 근거가 확보된 경우에만 확정한다.

• 근거가 불충분하면 확정하지 않으며, 필요한 근거 항목을 명시한다.

4. 빌드로 에러 확인 방식 금지

다음 방식은 분석 및 해결 절차로 사용하지 않는다.

4.1 금지 행위

• 빌드/컴파일/실행을 먼저 돌려 에러를 확인하는 접근

• 일단 돌려보고 판단하는 접근

4.2 허용되는 검증 형태

• 코드/타입/스키마/명세/의존성/계약 기반의 사전 구조 검증을 우선한다.

• 실행이 필요하더라도 에러 확인이 아니라 계약/흐름 충족 여부 검증으로 설계되어야 한다.

5. 임의 해석·판단·결정·행동 금지

다음 행위는 전면 금지한다.

5.1 금지 항목

• 임의 해석, 임의 판단, 임의 결정, 임의 행동 처리

• 임의 추론, 임의 상상

• 구조 확인 없이 확정하는 행위

5.2 일반론 기반 덮어쓰기 금지

• 보통은, 일반적으로, 관례상, 대개는, 흔히는 등 일반론을 근거로 요구된 의도/설계/흐름/계약을 대체하거나 덮어쓰는 행위는 즉시 위반이다.

• 더 나은 접근이라는 이유로 요구된 설계/흐름을 무시하고 다른 접근을 강행하여 불일치를 만드는 행위는 즉시 위반이다.

5.3 의도·설계 최우선

• 요구된 의도/설계/흐름/계약이 최상위 우선순위다.

• 접근 변경, 최적화, 재설계는 동일 결과, 동일 계약, 동일 흐름이 근거로 증명되는 경우에만 허용한다.

• 증명 없이 변경해 불일치를 만들면 즉시 위반이다.

5.4 결론 확정 전 필수 게이트

결론을 확정하기 전에 아래 3개가 모두 충족되어야 한다.

1. 근거: 코드/스키마/명세/공식문서/실데이터 등 검증 가능한 근거 제시

2. 일치성: 요구된 의도·설계·흐름·계약과의 일치 확인

3. 산출물: 변경/생성 결과물(DB/API/UI/파일) 명확화

6. 인라인 즉흥 생성 금지 및 중앙화 필수

다음 행위는 전면 금지한다.

6.1 금지 행위

• 인라인으로 타입 정의, 로직 생성, 유틸 생성, 뷰 컴포넌트 즉흥 작성

• 동일 책임의 코드가 여러 위치에 분산되는 중복 구조

• 역할, 의미, 범위를 명확히 드러내지 못하는 네이밍

6.2 강제 요건

• 중앙화: 타입/계약/유틸/도메인 로직/컴포넌트는 책임별로 분리하고 단일 소스로 관리한다.

• 중복 금지: 동일 책임/기능의 중복 구현을 금지한다.

• 네이밍 규칙: 역할-이름-부여가 드러나야 하며, 호출 지점/범위/책임이 이름만으로 식별 가능해야 한다.

7. 위반 판정 기준

아래 중 하나라도 해당하면 즉시 위반이다.

• 축약, 부분처리, 추후 구현, mock/dummy 등으로 Real Implementation을 회피

• 근거 없이 확정

• 구조 확인 없이 유추

• 빌드로 에러 확인을 분석 절차로 사용

• 인라인 즉흥 생성으로 중앙화/중복 금지/네이밍 규칙을 위반