공정성 가이드

1) 핵심 원칙: 공개(Transparency)

• 모든 작업 내용은 참가자 모두가 언제든지 볼 수 있는 GitHub 저장소를 통해 공개합니다.
• “결과물만 공개”가 아니라, 결정 과정과 변경 이력까지 공개하는 것을 원칙으로 합니다.

공개의 범위

• 기획/설계/의사결정(범위 변경, 핵심 트레이드오프, 위험/가정)
• 구현(코드, 설정, 인프라 구성)
• 검증(테스트, 빌드, 실행 방법)
• 출처(외부 코드/에셋/데이터 및 라이선스)

2) 단일 진실원(SSOT): 저장소 기준

공정성을 위해 다음을 권장합니다.

• 작업의 “최종 근거”는 저장소 내 문서(README/SPEC/ADR 등) 로 남깁니다.
• DM/구두로 정리한 결정이 있다면, 최소한의 요약을 이슈/문서/커밋 메시지로 환원합니다.

3) 커밋 로그 규약(필수)

커밋 로그는 해카톤의 “진행 증빙”이자 “재현 가능한 설명서”입니다. 아래 규약을 준수해 주세요.

3.1 커밋 단위

• 1 커밋 = 1 의도(Why) = 1 변화(What)
• 가능한 한 작고 자주 커밋하여 타임라인을 투명하게 만듭니다.
• WIP, temp, try 같은 의미 없는 메시지는 지양합니다.

3.2 커밋 메시지 포맷(권장)

제목은 한 줄 요약으로, 본문에는 근거/검증/참조를 남깁니다.

저장소에 포함된 커밋 템플릿(.gitmessage)을 사용할 수 있습니다.

Copygit config commit.template .gitmessage

Copytype(scope): 한 줄 요약
 
Why:
- 변경 배경/문제
 
What:
- 핵심 변경 사항
 
Verify:
- pnpm lint
- pnpm typecheck
- pnpm test:e2e
 
Refs:
- #이슈번호 또는 링크

권장 type: feat, fix, docs, refactor, test, chore, ci

3.3 AI 도구 사용 기록(권장)

AI 도구 사용은 허용/권장되지만, 공정성을 위해 다음을 남기길 권장합니다.

• 커밋 메시지/PR 본문에 AI 사용 여부와 “무엇을 위임했고 무엇을 검증했는지”를 짧게 기록합니다.
• 민감정보(키/토큰/개인정보/비공개 자료) 는 프롬프트에 포함하지 않습니다.

4) 제출(Submission)

제출은 아래 중 하나를 선택합니다.

4.1 스킬로 제출(권장)

Codex 스킬을 설치한 뒤, 채팅에서 스킬을 호출해 제출 템플릿을 생성/검증합니다.

CopyCODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
python3 "$CODEX_HOME/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --url https://github.com/okky-lab/vibe-coding-hackathon/tree/main/skills/hackathon-submission

설치 후 Codex를 재시작하고, 채팅에 아래처럼 요청합니다.

• “hackathon-submission 스킬로 프로젝트 제출 등록을 진행해 주세요.”

4.2 수동으로 제출

저장소의 Project Submission 이슈 템플릿을 사용해 등록합니다.

• GitHub 저장소 → Issues → New issue
• Project Submission 선택 → 양식 작성 → 등록

5) 최소 체크리스트

• 작업 저장소가 참가자에게 공개되어 있고, 최신 변경사항이 push 되어 있습니다.
• 빌드/실행/테스트 방법이 README에 있습니다.
• 커밋 로그에 Why/Verify가 남아 있습니다.
• 외부 자료 사용 시 출처/라이선스가 문서화되어 있습니다.