85 lines
4.2 KiB
YAML
85 lines
4.2 KiB
YAML
schema-version: 1
|
|
verdict: PASS
|
|
score: 96
|
|
scores:
|
|
project-specificity:
|
|
score: 5
|
|
evidence:
|
|
- "overview: Java 21, Spring Boot 4.0.0, 19개 모듈과 Gradle·ArchUnit 경계를 저장소 근거로 특정한다."
|
|
- "project-value: STRICT dependency lock과 sampleOffTest처럼 ca-tmpl 고유의 계약을 전면에 둔다."
|
|
reader-journey:
|
|
score: 5
|
|
evidence:
|
|
- "overview → value → architecture → quick-start → adoption → verification → documentation 순서가 평가·실행·전환 흐름을 따른다."
|
|
- "각 상세 항목은 독자의 다음 행동인 실행, 코드 배치, sample 제거, 전체 검증으로 이어진다."
|
|
technical-explanation:
|
|
score: 4
|
|
evidence:
|
|
- "architecture: Gradle 모듈 정책과 ArchUnit 코드 정책을 구분하고 의존 방향을 Mermaid와 모듈 표로 설명한다."
|
|
- "중간 길이 정책에 맞춰 세부 운영 계약은 소유 문서로 넘기므로 README 자체는 의도적으로 개요 수준을 유지한다."
|
|
task-usability:
|
|
score: 5
|
|
evidence:
|
|
- "quick-start: prerequisite, 실행 위치, bootstrap 부작용, 성공 endpoint, Compose 종료 명령이 한 흐름에 있다."
|
|
- "verification: 일반 테스트·아키텍처·sample 제거·전체 계약을 목적별로 선택할 수 있다."
|
|
prose-clarity:
|
|
score: 5
|
|
evidence:
|
|
- "긴 기능 나열을 피하고 강제 영역/선택 영역 표와 짧은 도입 순서로 압축했다."
|
|
- "production-ready 같은 근거 없는 표현 없이 적용 한계와 별도 검증 책임을 명시한다."
|
|
visual-judgment:
|
|
score: 5
|
|
evidence:
|
|
- "architecture: 구성요소가 여섯 개인 의존 관계에만 Mermaid를 사용하고 런타임 호출도가 아님을 바로 설명한다."
|
|
- "나머지 섹션은 표·명령·목록이 더 적합하다는 outline 근거에 따라 추가 시각물을 배제했다."
|
|
hard-gates:
|
|
passed: true
|
|
failures: []
|
|
reader-simulations:
|
|
30-seconds:
|
|
outcome: PASS
|
|
evidence:
|
|
- "제목과 첫 두 문단에서 기술 기준, 템플릿의 차별점, 목적을 확인할 수 있다."
|
|
- "개요의 적합/비적합 문장으로 채택 후보인지 빠르게 판단할 수 있다."
|
|
5-minutes:
|
|
outcome: PASS
|
|
evidence:
|
|
- "강제/선택 표, 아키텍처, bootstrap, 성공 신호, 적용 한계가 첫 읽기 경로에 모두 있다."
|
|
contributor:
|
|
outcome: PASS
|
|
evidence:
|
|
- "모듈 표와 도입 5단계가 코드 배치 및 sample 교체 경로를 제공한다."
|
|
- "검증 명령과 목적별 상세 문서 링크가 다음 작업으로 연결된다."
|
|
findings:
|
|
- id: QR-003
|
|
severity: minor
|
|
category: repository-contract
|
|
section: quick-start
|
|
message: 저장소 테스트가 요구하는 README 호환성 literal 두 개가 최초 후보에서 누락됐다.
|
|
evidence:
|
|
- "sampleOffTest 실제 실행에서 DeveloperExperienceContractTest.java:62가 실패했다."
|
|
- "테스트가 요구하는 세 literal을 readme-contract fact로 추가하고 execution gate가 검사하도록 개선했다."
|
|
- "후보에 비가시적 호환성 marker를 추가해 독자용 문구를 왜곡하지 않았다."
|
|
route-to: FACTS_EXTRACTED
|
|
status: resolved
|
|
- id: QR-001
|
|
severity: minor
|
|
category: command-boundary
|
|
section: quick-start
|
|
message: bootstrap 내부 Docker preflight 설명이 직접 실행 명령처럼 추출될 수 있었다.
|
|
evidence:
|
|
- "첫 기술 게이트가 inline docker info를 repository-facts에 없는 문서 명령으로 차단했다."
|
|
- "수정 후 설명을 Docker CLI와 daemon 연결 확인이라는 서술로 바꾸고 재검증했다."
|
|
route-to: README_DRAFTED
|
|
status: resolved
|
|
- id: QR-002
|
|
severity: minor
|
|
category: architecture-clarity
|
|
section: overview
|
|
message: 초기 레이어 나열의 화살표가 의존 방향으로 오해될 여지가 있었다.
|
|
evidence:
|
|
- "초기 domain → application → adapter → bootstrap 표기를 중립적인 책임 목록으로 변경했다."
|
|
- "실제 의존 방향은 architecture Mermaid에서 별도로 명시한다."
|
|
route-to: README_DRAFTED
|
|
status: resolved
|