Skip to content

채점 루브릭 정교화 및 optional(선택항목) tier 도입 - #10

Merged
serithemage merged 3 commits into
mainfrom
feat/issue-9-scoring-rubric-optional-tier
Jun 17, 2026
Merged

채점 루브릭 정교화 및 optional(선택항목) tier 도입#10
serithemage merged 3 commits into
mainfrom
feat/issue-9-scoring-rubric-optional-tier

Conversation

@serithemage

Copy link
Copy Markdown
Contributor

Closes #9

변경 요약

1. 채점 루브릭 정교화 (refactor)

  • 문서화 수준: CONTRIBUTING.md를 필수 만점 요건에서 제외 → 선택/가산(타이브레이커) 요소로 변경
  • 하네스 엔지니어링: 확장 신호에서 commands 제외 (최근 skills로 대체되는 추세 반영)
  • 코덱스 리뷰 반영: reasonable/good/comprehensive/충실히 등 주관어를 관찰 가능한 카운트·아티팩트 기준으로 교체, 100점 밴드를 프로젝트 유형(라이브러리·CLI·서비스·모노레포) 조건부로 명시

2. optional(선택항목) tier 도입 (feat)

설정 파일로 채점 항목을 채용 / 미채용 / 선택항목 3가지 상태로 조정 가능.

상태 방법 동작
채용 categories에 포함 정상 채점 (가중평균 반영)
미채용 배열에서 제거 분석·채점 제외
선택항목 tier: "optional" + bonusCap 가산점 전용, 등급 영향 없음
  • optional 가산점 = (점수/100) × bonusCap, 총점은 100으로 clamp
  • 가중치 정규화에서 optional 제외 (weight 대신 bonusCap 사용)
  • optional은 F여도 페널티(등급 C 제한) 대상 아님
  • 리포터 3종 출력(터미널/마크다운/비교)에 "선택" tier 표시
  • .vibeready.example.jsonREADME.md/README.ko.md 갱신

테스트

  • 신규: scorer 4건(가산점/등급 영향 없음/100 clamp/페널티 제외), config 4건(bonusCap 검증/정규화 제외/tier 검증)
  • 전체 113개 통과, 빌드 성공 (pre-commit 훅 검증 포함)

🤖 Generated with Claude Code

serithemage and others added 3 commits June 18, 2026 08:38
- 문서화 수준: CONTRIBUTING.md를 필수 만점 요건에서 제외, 선택/가산 요소로 변경
- 하네스 엔지니어링: 확장 신호에서 commands 제외 (skills 대체 추세 반영)
- 코덱스 리뷰 반영: 주관어(reasonable/good/comprehensive/충실히 등)를
  관찰 가능한 카운트·아티팩트 기준으로 교체, 100점 밴드를 프로젝트 유형 조건부로 명시
- 출력 요건에 optional tier 허용 명시

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
설정 파일로 채점 항목을 채용/미채용/선택항목으로 조정할 수 있게 한다.

- CategoryTier에 optional 추가, JSON 스키마 enum 갱신
- optional 카테고리는 등급에 영향 없이 점수 비례 가산점(최대 bonusCap)만 부여
  - 가산점 = (점수/100) × bonusCap, 총점은 100으로 clamp
  - 가중치 정규화에서 제외 (weight 대신 bonusCap 사용)
  - F여도 페널티(등급 C 제한) 대상 아님
- 리포터 3종 출력(터미널/마크다운/비교)에 "선택" tier 표시
- .vibeready.example.json을 기본 7개 카테고리 전부 + optional 예시로 갱신
- README.md/README.ko.md에 채용/미채용/선택 규칙 문서화
- scorer 4건 + config 4건 테스트 추가

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
코드 리뷰 반영: optional 가산점은 총점에 더해져 등급을 올릴 수 있으므로
"등급에 영향 없음"은 부정확. "등급을 낮추지 않음"으로 정정한다.

- reporter.ts / README.md / README.ko.md 문구 정정
- 가중평균 88(B) + 가산점 5 = 93 → A 경계 테스트 추가

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@serithemage

Copy link
Copy Markdown
Contributor Author

코드 리뷰 반영

code-reviewer가 지적한 결함 1건을 수정했습니다.

결함: optional 가산점은 totalScore에 더해져 totalGrade에 반영되므로 등급 경계를 넘으면 등급을 올릴 수 있다. 그러나 reporter/README 문구가 "등급에 영향 없음"으로 단언되어 동작과 모순.

해결: 의도는 "미보유 시 불이익 없음, 보유 시 보너스"이므로 코드 동작이 맞고, 문구를 "등급을 낮추지 않음"으로 정정.

  • reporter.ts / README.md / README.ko.md 문구 정정
  • 가중평균 88(B) + 가산점 5 = 93 → A 경계 테스트 추가 (114개 통과)

커밋: 2e898dd

@serithemage
serithemage merged commit 956fdf2 into main Jun 17, 2026
3 checks passed
@serithemage
serithemage deleted the feat/issue-9-scoring-rubric-optional-tier branch June 17, 2026 23:58
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.

채점 루브릭 정교화 및 optional(선택항목) tier 도입

1 participant