# Upstage 제출 가이드

## 무엇을 어디에 내나

- **채용 지원서 포트폴리오 항목:** `AGENT_RELIABILITY_PORTFOLIO_KO_R2_20260718.pdf`
- **GitHub/코드 공유:** 이 저장소 전체 또는 최종 제출 ZIP의 `agent-reliability-demo/`
- **선택 첨부:** 최종 제출 ZIP은 업로드 칸이 허용할 때만 사용

채용 페이지가 PDF 제출을 요구하므로 PDF가 주 제출물이고, GitHub 링크는 PDF 또는 지원서의 포트폴리오 링크 칸에 함께 적는 구성이 가장 이해하기 쉽습니다.

## GitHub 공개 전 5분 체크

1. GitHub에 새 공개 저장소를 만듭니다.
2. 본인 이름·연락 링크·라이선스 정책을 확정합니다.
3. `UPSTAGE_API_KEY`, `.env`, `.demo-data`, SQLite DB가 없는지 확인합니다.
4. 공개 웹주소가 정상적으로 열리는지 확인합니다. CMD 실행이나 개인 키 입력은 필요 없습니다.
5. 로컬 재검증이 필요할 때만 Windows ZIP의 압축을 완전히 푼 뒤 `START_HERE_UPSTAGE_LIVE_DEMO.cmd`를 실행하고 본인 Secret key를 입력합니다.

## 지원서용 프로젝트 설명

“Upstage Solar의 문서 구조화 결과를 deterministic workflow control plane에 연결한 agent reliability 프로젝트입니다. 사람 승인 전 실행 차단, persistent checkpoint 복구, 제한된 재시도, idempotency와 결과 재사용, 독립 검증기를 구현했습니다. 봉인된 core는 432개 고유 시험과 Windows/Linux·Python 3.11–3.13 matrix에서 검증했고, 웹 데모에서 응답 유실과 중복 방지를 직접 확인할 수 있습니다.”

## 짧은 전달 문구

“포트폴리오 PDF와 실행 가능한 GitHub 저장소를 함께 제출드립니다. PDF는 문제·설계·검증 결과를 비개발자 관점에서 요약하고, 저장소의 데모는 문서 분석 → 사람 승인 → checkpoint 재개 → 중복 없는 기록을 재현합니다. 실제 개인정보와 운영 시스템은 사용하지 않았습니다.”

## 주의

- API 키를 채팅, Git, PDF, 스크린샷에 넣지 않습니다.
- 기술 증거 원본 archive는 크고 내부 실행 경로를 포함하므로 공개 저장소에는 넣지 않습니다.
- `evidence/technical_validation_summary.json`처럼 sanitization한 요약만 공개합니다.
- GitHub URL이 확정된 뒤 PDF 또는 지원서 링크 칸에 실제 URL을 넣습니다.
