Skip to content

docs: 심사·포트폴리오 관점 README 성과 중심 개편 - #50

Merged
hywznn merged 2 commits into
mainfrom
agent/readme-portfolio-highlights
Aug 10, 2026
Merged

docs: 심사·포트폴리오 관점 README 성과 중심 개편#50
hywznn merged 2 commits into
mainfrom
agent/readme-portfolio-highlights

Conversation

@hywznn

@hywznn hywznn commented Aug 10, 2026

Copy link
Copy Markdown
Collaborator

연결 Issue

Closes #49

변경 내용

기존 프로젝트 소개와 Hugging Face 강조 영역은 그대로 유지하고, 그 아래를 심사·포트폴리오 관점의 결과 중심 구조로 개편했습니다.

  • 7개 Intent, 8개 Workflow, 데이터 1,340건 등 핵심 성과를 첫 표에 배치
  • 검수 전·최종 데이터 분리와 124건 라벨 변경 이력 강조
  • Train 1,072 / Validation 268 grouped split과 template leakage 방지 설명
  • 공식 필요서류·제조업 업종 데이터의 수집·정규화 흐름 설명
  • BERT·A.X QLoRA·Cascade의 역할과 선택 근거 정리
  • Cascade를 단순 정확도 향상이 아닌 복잡·경계 요청 라우팅 설계로 설명
  • Schema·SHA-256·PII·중복·누락·CI 검증 항목 명시
  • 독립 Gold Test 부재와 모델/data version 차이 등 한계 유지
  • 실행 방법·저장소 구조·주요 문서를 하단에 배치

변경 이유

기존 README는 현재 파일 위치와 상태를 찾기에는 적합했지만, 심사위원이나 데이터·모델링·IT 직무 면접관이 프로젝트의 문제 정의, 정량 결과, 설계 판단과 검증 수준을 빠르게 파악하기 어려웠습니다.

검증

  • 기존 소개·Hugging Face 영역 원문 유지
  • make check
  • Knowledge validation
  • 18 tests
  • 로컬 Markdown 링크 14개 확인
  • 누락 링크 0개
  • git diff --check

영향 및 제한사항

  • README 한 파일만 변경합니다.
  • 데이터·모델·Knowledge·인프라 파일은 변경하지 않습니다.
  • 모델 성능 수치는 기존 내부 Validation 기록만 사용하며 최종 Test 성능으로 표현하지 않습니다.

리뷰 포인트

  • 핵심 성과가 과장 없이 충분히 잘 보이는지
  • BERT와 A.X의 선택 근거가 직무 면접 관점에서 이해되는지
  • 기술 상세와 읽기 쉬운 분량의 균형이 적절한지

@hywznn
hywznn marked this pull request as ready for review August 10, 2026 15:39
@hywznn
hywznn merged commit c64f791 into main Aug 10, 2026
2 checks passed
@hywznn
hywznn deleted the agent/readme-portfolio-highlights branch August 10, 2026 15:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: 심사·포트폴리오 관점 README 성과 중심 개편

1 participant