llm-wiki/raw/branch-notes/feature-implementation-readiness-scorecard.md

title, source_type, status, id, kind, project, work_item, inherits, refines, overrides, depends_on, contract_packet, branch, parent_branch, related_projects, governing_docs, tags, created, target_merge, status_label, contract_packet_sha256

title	source_type	status	id	kind	project	work_item	inherits	refines	overrides	depends_on	contract_packet	branch	parent_branch	related_projects	governing_docs	tags	created	target_merge	status_label	contract_packet_sha256
branch / feature-implementation-readiness-scorecard	branch-note	raw	BR-CA-SKELETON-OPERATIONAL-CONTRACT-043	project-work-item	ca-skeleton-operational-contract	WI-CA-SKELETON-OPERATIONAL-CONTRACT-043	DEC-CA-SKELETON-OPERATIONAL-CONTRACT-BOOTSTRAP-001@1				1	feature-implementation-readiness-scorecard		ca-skeleton	wiki/projects/ca-tmpl/skeleton-governance-registry-verification-test-scorecard	branch ca-skeleton readiness scorecard quality-gate multi-module	2026-05-22		in-progress	e252546bb4c59f376e3cbf19938076de6880c5e01703fe37525ea1aea80a8c03

branch: feature-implementation-readiness-scorecard

Layer: raw/branch-notes/ — skeleton이 실제 도메인을 받을 준비가 됐는지 binary readiness gate로 판정합니다.

부모 (필수)

• Parent project (canonical SSOT): raw/project-notes/ca-skeleton-operational-contract

ca-skeleton 은 별도 root branch 없이 project-note 가 SSOT 역할. 본 feature branch 는 project-note 의 readiness scorecard 영역을 multi-module Clean Architecture 기준으로 정제한다.

브랜치 계약 패킷

• 생성 시 프로젝트 개정: 1
• 패킷 스키마: contract_packet: 1
• 완료 조건: readiness 각 항목이 binary evidence link로 판정된다

상속한 프로젝트 결정

Decision Ref	Project Summary	Branch Application	Source
DEC-CA-SKELETON-OPERATIONAL-CONTRACT-BOOTSTRAP-001@1	신규 환경의 default 진입 명령은 ./gradlew bootstrap이다	bootstrap을 포함한 skeleton readiness를 binary evidence로 판정한다	raw/project-notes/ca-skeleton-operational-contract

브랜치 지역 결정

Decision ID	Decision	Relation	Supporting Claims	Status
D1	readiness를 binary gate로 판정한다	local	raw/project-notes/ca-skeleton-operational-contract	proposed
D2	미통과 항목이 있으면 canonical 승급을 차단한다	local	raw/project-notes/ca-skeleton-operational-contract	proposed
D3	자동 계산기와 별개로 수동 evidence mapping을 요구한다	local	raw/project-notes/ca-skeleton-operational-contract	proposed
D4	모든 readiness area가 통과해야 최종 pass한다	local	raw/project-notes/ca-skeleton-operational-contract	proposed
D5	real-domain dry-run evidence는 onboarding owner를 소비한다	local	raw/project-notes/ca-skeleton-operational-contract	proposed
D6	sample-off readiness는 sample-removal evidence를 소비한다	local	raw/project-notes/ca-skeleton-operational-contract	proposed

선언한 예외

Override ID	Overrides	Reason	Approval	Status

없음.

목표

문서가 많아질수록 “좋아 보임”과 “바로 구현 가능함”이 섞입니다. 이 branch는 skeleton이 실제 도메인을 받아도 되는지 판정하는 최종 점검표를 제공합니다. Phase C2 기본값이 Gradle multi-module로 바뀌었으므로 readiness도 단일 package slice가 아니라 module boundary, architecture rule, onboarding checklist, sample-off smoke를 함께 봐야 합니다.

• 이슈:
• PR:

범위

포함 범위

• binary readiness scorecard.
• branch canonical 승급 기준.
• multi-module architecture enforcement evidence.
• sample-portfolio 검증 기준.
• sample-off 검증 기준.
• real domain onboarding dry-run 검증 기준.

제외 범위

• 실제 점수 자동 계산기 구현.
• project management dashboard.
• business-specific acceptance criteria.
• 새 도메인 module slice 정의 중복 작성. 해당 SSOT는 feature-domain-feature-onboarding-contract.

근거 (필수, 최소 1개+)

Source	정당화하는 결정
raw/official-docs/scorecard-aws-well-architected	질문 기반 HRI flag와 지속 개선형 review 모델 비교
raw/official-docs/scorecard-opentelemetry-maturity	signal stability/lifecycle 모델 비교
raw/official-docs/scorecard-cis-benchmarks-slsa	CIS/SLSA의 점진적 maturity scoring 비교
raw/branch-notes/feature-skeleton-package-blueprint-contract	scorecard 구조 영역의 module blueprint SSOT
raw/branch-notes/feature-architecture-enforcement-rules	architecture boundary pass/fail evidence owner
raw/branch-notes/feature-domain-feature-onboarding-contract	real-domain dry-run checklist SSOT
raw/branch-notes/feature-sample-removal-adoption-contract	sample-off smoke와 sample runtime isolation verification owner

TODO

각 항목 옆에 증거 등급 표기: actually-implemented | locally-verified | prod-verified | documented-only | planned | needs-confirmation

• binary readiness model 정의 — 등급: documented-only
• 15 area evidence owner mapping 정의 — 등급: documented-only
• real-domain dry-run SSOT를 onboarding branch로 확정 — 등급: documented-only
• scorecard evidence table에 실제 file path / test name 채우기 — 등급: actually-implemented
• ca-tmpl repo에서 readiness gate 자동/수동 검증 실행 및 결과 기록 — 등급: locally-verified (Gradle + shell gates 통과, hosted CI/provenance는 needs-confirmation)
• scorecard owner slug 3건 drift 정정 반영 확인 (§Audit A1) — 등급: locally-verified

진행 중 메모

• 2026-05-28: 기존 단일 package dry-run 표기는 폐기한다. scorecard는 feature-domain-feature-onboarding-contract의 New Domain Module Slice + Read/Write Difference Table을 consume only 한다.
• 본 branch는 readiness 판정 책임자이지 도메인 onboarding checklist 작성자가 아니다.
• 2026-06-15 (/branch-spec): governing_docs 지정 + Decision Evidence Map 선택 조건 열 + §구현 가이드 + §엣지·실패·의존 추가. scorecard owner slug 3건 drift 정정(§Audit A1), adapter-identifier 모듈 누락(§Audit A2), area 표 16행 vs 선언 15 불일치(§Audit A3) surface. 기존 본문은 verbatim 보존.
• 2026-06-26 (implementation): Readiness Scorecard에 실제 file path/test name evidence column을 추가했다. 16행 drift는 오류+예외를 오류/예외로 합쳐 15 area로 reconcile했고, adapter-identifier dry-run row를 추가했다. shell-only CI matrix/supply-chain scripts와 Gradle verifyCleanArchitectureDependencies, check verifyPublicPathSnapshot, :app-bootstrap:sampleOffTest를 로컬에서 통과 확인했다.

결정 사항

• 2026-05-22: readiness pass는 문서 완성도가 아니라 contract 강제력과 도메인 적용 가능성으로 판정. / 이유: 보기 좋은 문서와 구현 가능한 skeleton을 분리 / 검토한 대안: maturity 점수식 / 근거: raw/official-docs/scorecard-aws-well-architected
• 2026-05-22: scorecard 미통과 항목이 있으면 canonical 승급하지 않음. / 이유: 미검증 계약을 canonical 사실로 승급하지 않기 위함 / 검토한 대안: known issue로 승급 / 근거: project decision
• 2026-05-22: 자동 계산기는 optional이지만 수동 산식과 branch evidence mapping은 필수. / 이유: 자동화 전에도 재현 가능한 판정이 필요 / 검토한 대안: 구현 후 자동화만 인정 / 근거: raw/official-docs/scorecard-cis-benchmarks-slsa
• 2026-05-22: readiness pass는 15개 area가 각각 Pass일 때만 부여한다. / 이유: 하나의 회귀가 skeleton adoption 실패로 이어질 수 있음 / 검토한 대안: 부분 점수 누적 / 근거: project decision
• 2026-05-28: area #15의 real-domain dry-run evidence는 onboarding branch의 New Domain Module Slice + Read/Write Difference Table 통과로 판정한다. / 이유: checklist SSOT 충돌 방지 / 검토한 대안: scorecard 내부 checklist 유지 / 근거: raw/branch-notes/feature-domain-feature-onboarding-contract

결정-근거 매핑

각 결정이 어떤 raw source claim 으로 뒷받침되는지 명시한다. 선택 조건 열(R2): "이 조건일 때 이 결정, 다른 조건이면 어떤 대안". 분기 없으면 N/A.

Decision ID	Decision	선택 조건 (언제 이 결정 / 언제 대안)	Supporting Claims	Evidence Strength	Open Risk
D1	readiness pass = contract 강제력 + 도메인 적용 가능성 binary gate	판정 목적이 skeleton 도입 go/no-go 단일 결정이면 binary gate. 지속 운영 품질을 시계열로 추적해야 하면 maturity score(AWS WAR/OTel/SLSA 류) — governing doc §27: scorecard 는 도입 gate 한정, 운영 SLO·코드 품질 maturity 도구 아님	raw/official-docs/scorecard-aws-well-architected.md#SC-AWS-WAR-C2, raw/official-docs/scorecard-opentelemetry-maturity.md#SC-OTEL-C1	official-vendor-doc comparison + project-decision	외부 모델은 지속 개선/maturity tracking에 가깝고 ca-tmpl binary gate를 직접 권장하지 않음
D2	미통과 항목이 있으면 canonical 승급하지 않음	미검증 계약을 canonical 사실로 올리면 안 될 때(기본) 차단. 후속 추적이 보장된 known-issue 프로세스가 있으면 조건부 승급 — ca-tmpl 엔 그런 추적 프로세스 부재 → 차단 채택	raw/official-docs/scorecard-aws-well-architected.md#SC-AWS-WAR-C4	official-vendor-doc comparison + project-decision	HRI flag와 release-blocking gate의 의미가 다름
D3	자동 계산기는 optional, 수동 evidence mapping은 필수	자동화 전에도 재현 가능한 판정이 필요하면 manual evidence 필수. 자동 계산기가 구현·검증되면 추가 인정하되, manual table 부재 시 자동만으로는 불인정	raw/official-docs/scorecard-cis-benchmarks-slsa.md#SC-CIS-C1	official-standard comparison	scorecard CI step / badge / branch↔area 자동검증은 아직 planned
D4	15 area 모두 Pass일 때만 readiness pass	한 영역 회귀가 skeleton adoption 실패로 직결되는 전체 도입 gate 용도이면 all-pass. 부분 진척 자체가 의미 있는 maturity 추적이면 부분 점수 누적 — 본 용도는 전자	raw/branch-notes/feature-contract-verification-test-suite.md, raw/branch-notes/feature-ci-quality-gates-contract.md	project-decision (consume: owner-branch Decision)	hosted CI 결과는 별도 확인 필요
D5	real-domain dry-run checklist는 onboarding branch를 consume	checklist SSOT 가 onboarding branch 에 이미 있으면 consume-only(중복 작성 금지). onboarding branch 부재 시에만 내부 checklist — 현재 존재하므로 consume	raw/branch-notes/feature-domain-feature-onboarding-contract.md, raw/branch-notes/feature-skeleton-package-blueprint-contract.md	project-decision (consume: owner-branch Decision)	onboarding branch가 변경되면 scorecard area #15도 함께 갱신 필요
D6	sample-off readiness는 sample-removal branch evidence를 consume	sample runtime isolation owner branch 가 별도로 있으면 그 evidence consume. owner 부재 시에만 내부 정의 — 현재 sample-removal branch가 owner	raw/branch-notes/feature-sample-removal-adoption-contract.md	project-decision (consume: owner-branch Decision)	GitHub-hosted CI run은 아직 확인되지 않음

구현 가이드

결정 (Decisions) 이 "무엇 을 할 것인가" 라면, 본 §는 "어디에 어떻게 판정·운영될 것인가" 의 사전 명세. 본 branch 의 산출물은 코드가 아니라 markdown gate artifact + 수동 판정 절차다. 구체 표는 바로 뒤의 Readiness Scorecard · Dry-Run Evidence · Manual Score Formula 가 SSOT 로 보유한다.

3-rule meta principle: 각 sub-section 은 본 branch 의 Decision ID + Supporting Claim 을 reference(R1). 근거 없는 detail 은 UNSUPPORTED_IMPL_DECISION 라벨(R2). 본 branch 결정 범위 밖 cell 은 §Audit 으로 이관(R3).

1. Readiness gate artifact & 수동 판정 메커니즘

Trace: D1(binary gate) + D2(미통과 시 승급 차단) + D3(수동 필수·자동 optional) + D4(15-area all-pass). Supporting: SC-AWS-WAR-C2/C4, SC-CIS-C1, SC-OTEL-C1.

• UNSUPPORTED_IMPL_DECISION: ① scorecard artifact 의 물리적 위치 — 현재 본 branch-note 의 Readiness Scorecard 표가 SSOT(별도 파일/badge 미작성). 근거 raw 는 "binary gate 가 있어야 한다"만 권고, 어디에 둘지는 임의 → trade-off: 자동화 전 단계에서 markdown 한 곳에 두는 편이 review·diff 가능. ② "Unknown = Not ready" 의 Unknown 정의(evidence cell 공란 또는 owner branch 미존재) — governing doc 미권고, 본 branch 운영 정의.

• 판정 단위: area 별 Pass / Fail / Unknown. area Pass ⇔ 해당 owner branch 의 required evidence가 (a) 존재하고 (b) green. 하나라도 Fail 또는 Unknown ⇒ readiness Not ready (부분 점수 대체 금지 — D4).
• 승급 게이트(D2): readiness Not ready 인 area 의 owner branch 는 canonical(wiki/projects/) 승급 금지. known-issue 우회 없음.
• 자동화(D3): scorecard CI step / badge / branch↔area 매핑 자동검증은 planned — 미작성. manual evidence table은 file path/test name까지 채웠고, shell-only matrix/supply-chain gate 및 Gradle local gate는 통과했다. 단 hosted CI/provenance 결과는 needs-confirmation.

2. Area → owner-branch evidence 매핑

Trace: D4(15-area) + D5/D6(consume owner evidence). 각 area 는 sibling branch 1개를 evidence owner 로 지목(governing doc §27: 1:1 branch evidence). 구체 표 = Readiness Scorecard.

• UNSUPPORTED_IMPL_DECISION: 각 area 의 required evidence 종류(어떤 test class / arch rule 이 "Pass" 증거로 카운트되는가)는 owner branch 의 결정 영역에서 도출되나, 15-area 분류 partition 자체(어떤 관심사를 어느 area 로 묶는가)는 governing doc 이 "15 area" 만 권고하고 enumerate 하지 않음 → 본 branch 의 설계 선택. §Audit A3(16행 vs 15)은 2026-06-26에 오류/예외 병합으로 해소했다.
• drift 정정(§Audit A1): owner slug 3건이 실제 sibling branch 명과 불일치하여 Readiness Scorecard 에서 정정함: feature-env-driven-configuration-contract → feature-env-driven-runtime-configuration, feature-outbound-http-client-contract → feature-outbound-http-client-baseline, feature-persistence-failure-contract → feature-persistence-failure-baseline.

3. Real-domain dry-run evidence (consume-only)

Trace: D5 — onboarding branch 의 New Domain Module Slice + Read/Write Difference Table 을 consume. 본 branch 는 module row 별 evidence 의 존재 만 게이트하고, checklist 내용은 재작성하지 않음(중복 금지, §범위 Out of scope). 구체 표 = Dry-Run Evidence.

• UNSUPPORTED_IMPL_DECISION: 없음(consume SSOT). module row 집합은 ca-tmpl src/<module>/ ground truth 에 정합. 기존 누락이던 adapter-identifier row는 2026-06-26에 추가했다.

4. Sample-off readiness (consume-only)

Trace: D6 — sample-removal branch evidence consume. sample-off smoke = CI 의 sample-on/sample-off 두 profile job. 구체 계약 = 테스트 계약.

• UNSUPPORTED_IMPL_DECISION: 없음(consume owner). sample-off CI job과 gate matrix row는 .github/workflows/ci-quality-gates.yml 및 .github/ci-gate-matrix.yml에 존재한다. 본 branch는 hosted run 결과가 아니라 evidence 존재와 local gate 결과만 consume한다.

Readiness Scorecard

area	pass condition	primary evidence owner	required evidence	actual file path / test name	status
구조	Gradle multi-module blueprint와 dependency direction이 일치	feature-skeleton-package-blueprint-contract, feature-architecture-enforcement-rules	Gradle dependency rule + ArchUnit test	src/build.gradle verifyCleanArchitectureDependencies; src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/architecture/CleanArchitectureTest.java rules domain_is_pure, application_does_not_depend_on_adapters_or_transport, web_adapter_does_not_depend_on_persistence_or_outbound_adapters, persistence_adapter_does_not_depend_on_web_or_outbound_adapters, identifier_adapter_does_not_depend_on_other_adapters_or_bootstrap, production_code_does_not_depend_on_sample_portfolio	locally-verified
응답	성공/실패 응답이 envelope와 OpenAPI snapshot을 따른다	feature-api-contract-baseline	response contract test	src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/EnvelopeContractTest.java success_envelope_shape, error_envelope_shape_with_validation_details, error_envelope_shape_retryable_transient; src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/api/OpenApiSnapshotTest.java api_docs_are_generated_and_describe_the_worklogs_contract	locally-verified
오류/예외	error registry 기반 mapping이 강제되고 raw exception이 adapter-web까지 새지 않는다	feature-operational-error-observability-foundation	error mapping + exception leakage test	src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ErrorCodeRegistryMappingTest.java every_enum_code_present_in_the_registry_matches_its_http_status; src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/BusinessRuleValidationContractTest.java no_client_safe_message_leaks_sql_constraint_or_internals; src/adapter-web/src/test/java/dev/caskeleton/adapter/web/error/TransportErrorHandlingTest.java	locally-verified
경계	request/application/domain/response/filter mapper 경계가 우회되지 않는다	feature-boundary-validation-mapping-contract	boundary bypass test	CleanArchitectureTest rules controllers_do_not_return_domain_or_entity_types, application_methods_do_not_accept_web_dtos, request_dtos_do_not_escape_web_adapter, response_dtos_do_not_escape_web_adapter, validation_constraints_stay_at_web_boundary, filter_config_settings_do_not_depend_on_application_or_domain; BusinessRuleValidationContractTest category/transport leakage checks	locally-verified
로그	필수 field와 금지 field가 테스트된다	feature-log-management-contract	log capture test	src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/StructuredLogFieldContractTest.java structured_appender_emits_only_registered_snake_case_fields; src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/logging/SecretMaskingMessageConverterTest.java; src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/logging/LogMaskingPatternsTest.java	locally-verified
trace	inbound/outbound/async/message trace가 연결된다	feature-distributed-tracing-contract	propagation contract test	src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DistributedTracingContractTest.java meta_traceId_is_non_null_when_trace_id_on_mdc, response_meta_traceId_component_exists_and_is_non_null_when_populated, traceparent_header_row_matches_code_contract, tracing_sampling_rate_gauge_registry_contract; src/adapter-outbound/src/test/java/dev/caskeleton/adapter/outbound/http/TraceContextPropagationInterceptorTest.java	locally-verified
env	profile별 env matrix와 fail-fast가 있다	feature-env-driven-runtime-configuration	startup smoke test	src/build.gradle verifyEnvKeys; src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/EnvProfileMatrixContractTest.java prod_unsafe_toggles_ship_disabled_in_env, prod_unsafe_toggles_carry_prod_must_be_false_constraint, profile_selector_is_spring_profiles_active_only; src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/startup/StartupSafetyValidatorTest.java	locally-verified
repo	use case capability와 persistence/outbound capability가 매칭된다	feature-application-port-usecase-contract, feature-repository-access-permission-contract	architecture/contract test	CleanArchitectureTest rules inbound_port_implementations_declare_capability, read_only_use_cases_do_not_call_repository_write_methods, bulk_write_capability_requires_write_repository_access, use_case_capability_matches_transaction_port_boundary; src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/RepositoryAccessCapabilityRegistryTest.java registry_capability_names_match_the_as_built_model_one_to_one	locally-verified
adapter	dependency failure가 같은 언어로 분류된다	feature-outbound-http-client-baseline, feature-persistence-failure-baseline	adapter failure mapping test	src/adapter-persistence-rdbms/src/test/java/dev/caskeleton/adapter/persistence/rdbms/error/PersistenceFailureMappingContractTest.java every_matrix_sqlstate_classifies_to_its_contracted_code, transient_lock_and_integrity_violation_stay_distinct; src/adapter-outbound/src/test/java/dev/caskeleton/adapter/outbound/http/OutboundHttpClientTest.java; src/adapter-outbound/src/test/java/dev/caskeleton/adapter/outbound/http/OutboundHttpResilienceTest.java	locally-verified
domain	domain-core가 framework-neutral하다	feature-domain-modeling-guardrails	forbidden import test	CleanArchitectureTest rules domain_is_pure, domain_has_no_logger, value_objects_have_no_public_no_arg_constructor, aggregate_root_setters_are_not_public, domain_events_are_records, domain_events_are_transport_free, domain_entities_do_not_carry_audit_fields; src/domain-core/src/test/java/dev/caskeleton/domain/sample/WorkLogInvariantTest.java	locally-verified
sample	sample-portfolio은 fixture/reference로 유지되고 production runtime에서 비활성화 가능하다	feature-sample-domain-contract-fixture, feature-sample-removal-adoption-contract	sample matrix + sample-off smoke	src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/sample/SampleRemovalSmokeContractTest.java production_modules_reference_sample_only_as_test_fixture_dependency, sample_off_source_set_and_task_are_declared, sample_off_ci_job_is_release_blocking, sample_class_is_absent_from_the_sample_off_test_classpath; .github/workflows/ci-quality-gates.yml job sample-off; .github/ci-gate-matrix.yml gate sample-off-build	locally-verified; hosted CI needs-confirmation
CI	contract violation이 release-blocking이다	feature-ci-quality-gates-contract	CI gate	.github/workflows/ci-quality-gates.yml jobs quality-gates, sample-off, gate-matrix-lint, breaking-change-approval, quarantine, release-gate; .github/scripts/verify-gate-matrix.sh; .github/scripts/verify-supply-chain-contract.sh; .github/scripts/test-supply-chain-scripts.sh	locally-verified; hosted CI needs-confirmation
운영	alert/runbook/metric/log/trace가 연결된다	feature-operational-runbook-contract	runbook mapping	src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/RunbookCoverageContractTest.java every_mandatory_error_code_is_covered_by_at_least_one_runbook, all_runbook_links_resolve_to_existing_files; src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/MetricsAlertingContractTest.java required-test and metric registry contract checks	locally-verified
보안	token/PII/secret/body가 노출되지 않는다	feature-security-operational-baseline	privacy/log leakage test	src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/PiiTokenBodyForbiddenContractTest.java masking_removes_every_enumerated_secret_shape, captured_log_line_carries_no_unmasked_secret, request_body_capture_is_disabled_by_default; src/build.gradle verifyPublicPathSnapshot; docs/security/public-path-snapshot.txt	locally-verified
adoption	실제 도메인 dry-run이 module checklist를 통과한다	feature-domain-feature-onboarding-contract	New Domain Module Slice + Read/Write Difference Table evidence	src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/architecture/DomainFeatureOnboardingContractTest.java read_only_onboarding_slice_has_minimum_contract_and_no_write_artifacts, write_onboarding_slice_has_minimum_contract_and_static_rules_pass; onboarding fixture files under src/*/src/test/java/dev/caskeleton/onboarding/**; migration src/adapter-persistence-postgresql/src/test/resources/db/migration/postgresql/V9000__feature_onboarding_contract.sql	locally-verified

owner slug 정정 확인 (2026-06-26, §Audit A1): env 행 owner 는 feature-env-driven-runtime-configuration, adapter 행 owner 는 feature-outbound-http-client-baseline 및 feature-persistence-failure-baseline으로 정정돼 있으며, 관련 branch-note 파일 존재를 로컬 대조로 확인했다. count 정정 (§Audit A3): 기존 별도 행 오류와 예외를 오류/예외 단일 area로 병합해 D4·Manual Score Formula의 15 area 선언과 reconcile했다.

Readiness framing은 binary pass/fail입니다. 하나라도 Fail 또는 Unknown이면 Not ready입니다. 부분 점수로 대체하지 않습니다. 로컬 evidence 기준으로 15 area는 Pass입니다. hosted CI/provenance와 scorecard 자동화는 별도 needs-confirmation/planned으로 남깁니다.

Dry-Run Evidence

onboarding row	required evidence	actual file path / test name	status
domain-core	model/value object/domain rule file path + forbidden import test	src/domain-core/src/test/java/dev/caskeleton/onboarding/domain/FeatureAggregate.java, FeatureAggregateId.java, FeatureAggregateCreated.java; CleanArchitectureTest.domain_is_pure; DomainFeatureOnboardingContractTest.write_onboarding_slice_has_minimum_contract_and_static_rules_pass	locally-verified
application-core	inbound use case + outbound port + transaction/capability contract test	src/application-core/src/test/java/dev/caskeleton/onboarding/application/ListFeatureAggregatesUseCase.java, CreateFeatureAggregateUseCase.java, FeatureAggregateSummaryQueryPort.java, FeatureAggregateWritePort.java; CleanArchitectureTest.use_case_capability_matches_transaction_port_boundary	locally-verified
adapter-web	request/response DTO + mapper + controller contract test	onboarding web fixture files under src/adapter-web/src/test/java/dev/caskeleton/onboarding/adapter/web/**; CleanArchitectureTest.controllers_do_not_return_domain_or_entity_types; CleanArchitectureTest.application_methods_do_not_accept_web_dtos	locally-verified
adapter-persistence-rdbms	persistence adapter + mapper + failure mapping test	onboarding persistence fixture files under src/adapter-persistence-rdbms/src/test/java/dev/caskeleton/onboarding/adapter/persistence/**; PersistenceFailureMappingContractTest.every_matrix_sqlstate_classifies_to_its_contracted_code	locally-verified
adapter-persistence-postgresql	vendor SQL state / migration evidence	src/adapter-persistence-postgresql/src/test/java/dev/caskeleton/adapter/persistence/postgresql/PostgreSqlSqlStateErrorMappingTest.java; src/adapter-persistence-postgresql/src/test/resources/db/migration/postgresql/V9000__feature_onboarding_contract.sql	locally-verified
adapter-outbound	external dependency adapter + timeout/retry/error mapping test when needed	src/adapter-outbound/src/test/java/dev/caskeleton/adapter/outbound/http/OutboundHttpClientTest.java, OutboundHttpTimeoutEnforcerTest.java, OutboundHttpResilienceTest.java, FailOpenDependencyLoggerTest.java	locally-verified
adapter-identifier	non-IO identifier capability and onboarding id factory evidence	src/adapter-identifier/src/test/java/dev/caskeleton/adapter/identifier/UlidCodecTest.java; src/adapter-identifier/src/test/java/dev/caskeleton/adapter/identifier/HmacUserPrincipalPseudonymizerTest.java; onboarding FeatureAggregateIdFactory fixture under src/adapter-identifier/src/test/java/dev/caskeleton/onboarding/**	locally-verified
shared-contract	skeleton-wide contract only; no business/domain concept	CleanArchitectureTest.shared_contract_contains_only_operational_contract_packages; src/shared-contract/src/test/java/dev/caskeleton/shared/contract/EnvelopeTest.java; src/shared-contract/src/test/java/dev/caskeleton/shared/contract/OperationalErrorTest.java	locally-verified
app-bootstrap	wiring/profile/startup smoke	src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/BootstrapSettingsTest.java; src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/startup/StartupSafetyValidatorTest.java; src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/OperationalContractRuntimeTest.java; src/build.gradle task sampleOffTest	locally-verified
sample-portfolio	fixture module 유지 + no production runtime dependency + sample-off smoke	src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/SampleApplicationContextTest.java; src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/api/OpenApiSnapshotTest.java; src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/sample/SampleRemovalSmokeContractTest.java	locally-verified; hosted CI needs-confirmation

§Audit A2 resolved (2026-06-26): adapter-identifier 모듈(owner: feature-resource-identifier-contract) row를 추가했다. 현재 표는 ca-tmpl runtime/test fixture module 집합을 10개 row로 추적한다.

Manual Score Formula

Readiness = Pass only if every area is Pass.
any Fail = Not ready.
any Unknown = Not ready.
automation missing is allowed only if manual evidence table is complete.
Unknown = required evidence cell 공란 OR owner branch 미존재 OR required evidence 의 구성요소(file path AND test name) 중 하나라도 누락(부분 기입). 부분 기입 = Unknown, Pass 아님.

엣지·실패·의존

R4(깊이 게이트) 캡처용. readiness 판정은 본질적으로 consume gate 이므로 실패·의존이 대부분 cross-branch 다.

• 실패·엣지 경로:
  • owner branch 미존재/오타 — area 의 owner slug 가 실제 branch 와 불일치하면 evidence 추적 불가 → 해당 area Unknown → readiness Not ready. (실제 발생: §Audit A1 3건 — 정정 완료. 재발 방지는 §테스트 계약의 registry-test mapping grep 으로 일부 포착.)
  • area partition drift 재발 — 2026-06-26에는 오류/예외 병합으로 15 area와 산식을 맞췄다. 향후 영역을 나누거나 합칠 때 D4·Manual Score Formula·Coverage row를 함께 갱신하지 않으면 readiness denominator가 다시 모호해진다.
  • 모듈 집합 drift 재발 — 2026-06-26에는 adapter-identifier row를 추가했다. onboarding SSOT 가 module 을 추가/제거하면 Dry-Run Evidence 행이 다시 어긋날 수 있으므로 dry-run area 평가 시 src/<module>/ 와 표 row 를 대조해야 한다.
  • hosted evidence 공백 — local Gradle/shell gates는 통과했지만 hosted CI/provenance artifact 확인 전에는 CI 운영 증거를 prod-verified로 올리지 않는다.
• 다른 계약 의존 (consume-only — 본 branch 는 아래 owner 의 evidence 를 판정에 인용만 하고 재정의하지 않음. 표기: owner-branch (owner Decision) ← 본 branch Decision):
  • raw/branch-notes/feature-domain-feature-onboarding-contract (그 branch D1 module slice / D3 read-only / D4 write feature / D7: dry-run checklist SSOT 결정) ← 본 branch D5 — area adoption + Dry-Run Evidence 의 SSOT. 변경 시 본 branch area #15·dry-run 표 동반 갱신.
  • raw/branch-notes/feature-sample-removal-adoption-contract (그 branch D1 production import 금지 / D2 sample-off core contract test / D3 dual-mode 검증) ← 본 branch D6 — area sample 의 sample-off smoke / runtime isolation evidence owner.
  • raw/branch-notes/feature-ci-quality-gates-contract (그 branch D1 release-blocking / D3 drift gate) + raw/branch-notes/feature-contract-verification-test-suite (그 branch D2 release-blocking / D6 11-gate) ← 본 branch D4 — area CI. governing doc 의 Verification 축은 이 branch 들이 owner(본 branch 는 delegated, §Coverage).
  • raw/branch-notes/feature-skeleton-package-blueprint-contract (그 branch D1 multi-module 구조 / D4 adapter inbound·outbound 분리) + raw/branch-notes/feature-architecture-enforcement-rules (그 branch D1 CA 경계 archtest / D2 package rule) — area 구조 의 module blueprint + boundary pass/fail evidence owner.
  • registry SSOT: ca-tmpl docs/registries/*.yaml 의 required_test 행 (§테스트 계약) — 7개 registry 의 row 가 실제 test class FQN 으로 매칭되는지가 area 다수의 evidence 전제.

검증해야 할 주장

Claim	Why uncertain	How to verify	Status
sample-portfolio contract test가 release-blocking scenario를 cover한다	local file/test evidence와 Gradle sample-off는 확인했지만 hosted CI는 미확인	SampleRemovalSmokeContractTest와 .github/workflows/ci-quality-gates.yml sample-off job 대조 후 GitHub Actions hosted result 확인	locally-verified; hosted CI needs-confirmation
sample-off smoke가 sample-on / sample-off 두 profile 모두에서 green	local sample-off는 확인했지만 hosted profile matrix 결과는 미확인	.github/scripts/verify-gate-matrix.sh + ./gradlew :app-bootstrap:sampleOffTest + GitHub Actions hosted result	locally-verified; hosted CI needs-confirmation
New Domain Module Slice의 모든 row에 evidence가 채워진다	onboarding owner branch의 향후 변경 가능	Dry-Run Evidence 섹션 row별 file path/test name 존재와 DomainFeatureOnboardingContractTest 포함 Gradle check	locally-verified
7개 yaml registry의 모든 row required_test 값이 실제 test class FQN으로 매칭된다	hosted CI는 미확인	ContractRegistrySchemaGovernanceTest required-test mapping checks와 ./gradlew check	locally-verified; hosted CI needs-confirmation
owner branch 각각이 canonical promotion artifact를 만족한다	owner branch 파일 존재는 확인했지만 각 owner의 canonical promotion deep audit은 범위 밖	branch별 Decision Evidence Map / contract test / architecture rule / adoption note 존재 검사	documented-only; owner deep audit needs-confirmation
15 area Readiness Scorecard의 evidence cell이 모두 채워진다	manual table은 본 branch가 요구하는 artifact	scorecard 표의 actual file path / test name column에 15 area 모두 file path 또는 test name 존재	actually-implemented
AWS WAR / SLSA / OTel 외부 모델과 ca-tmpl 15 area가 혼동되지 않는다	외부 taxonomy와 ca-tmpl taxonomy 단위가 다름	comparison matrix에서 external model은 보조 근거로만 표시	documented-only
area 14 evidence cell에 SLSA provenance가 실제 검증 가능한 형태로 들어간다	shell scripts는 검증했지만 hosted provenance artifact는 미확인	.github/scripts/verify-supply-chain-contract.sh, .github/scripts/test-supply-chain-scripts.sh, hosted artifact/provenance 확인	shell scripts locally-verified; hosted provenance needs-confirmation
Readiness Scorecard area 개수와 산식 선언이 일치한다	기존 §Audit A3 불일치	Readiness Scorecard 표 body 15행과 Manual Score Formula의 all-pass denominator 대조	locally-verified
Readiness Scorecard owner slug 가 모두 실재 branch 다	§Audit A1 3건 정정 후 재발 가능	owner column slug를 raw/branch-notes/<slug>.md 파일 존재와 대조	locally-verified

테스트 계약

• sample-portfolio contract test 누락: release-blocking scenario가 sample-portfolio module의 contract test class로 존재해야 함. 불일치 시 readiness=Fail.
• sample-off smoke 누락: CI workflow 또는 동등한 local gate에 sample-on / sample-off 두 profile 검증이 있어야 함. sample-off job에서 production runtime이 sample bean에 의존하면 fail.
• real domain dry-run 누락: feature-domain-feature-onboarding-contract의 New Domain Module Slice + Read/Write Difference Table row별 evidence가 비어 있으면 fail.
• registry-test mapping 누락: 7개 yaml registry 파일의 모든 row에서 required_test field가 실제 test class FQN으로 매칭되어야 함.
• canonical promotion 미통과: owner branch마다 Decision Evidence Map / contract test mapping / architecture rule mapping / runbook/log/metric mapping / adoption note / out-of-scope note가 있어야 함.
• 수동 evidence 부재: Readiness Scorecard 표의 evidence가 file path 또는 test name으로 채워져야 함. 빈 cell이 있으면 fail.

Audit & Findings

ca-tmpl ground truth(src/, docs/registries/, sibling branch slugs) 대조에서 발견한 drift. 사용자 결정 영역은 자동 rewrite 하지 않고 정합 권고만(슬러그 오타 정정은 broken reference 이므로 적용 + 기록).

ID	finding	종류	조치
A1	Readiness Scorecard owner slug 3건이 실재 branch 와 불일치: feature-env-driven-configuration-contract→feature-env-driven-runtime-configuration, feature-outbound-http-client-contract→feature-outbound-http-client-baseline, feature-persistence-failure-contract→feature-persistence-failure-baseline	STALE_OWNER (broken reference)	RESOLVED 2026-06-26. Readiness Scorecard owner column은 corrected slug만 보유하고, 파일 존재를 로컬 대조했다.
A2	adapter-identifier 모듈(owner: feature-resource-identifier-contract)이 ca-tmpl src/ 에 실재하나 기존 Dry-Run Evidence 표(8행)에 누락 — src 모듈 9개 vs 표 8행	MODULE_DRIFT	RESOLVED 2026-06-26. adapter-identifier row를 추가하고 UlidCodecTest, HmacUserPrincipalPseudonymizerTest, onboarding id factory evidence를 연결했다.
A3	기존 Readiness Scorecard 표 16행 vs D4·Manual Score Formula·governing doc §27 의 "15 area" 선언 불일치	COUNT_DRIFT	RESOLVED 2026-06-26. 오류 + 예외를 오류/예외 단일 area로 병합해 표 body 15행으로 reconcile했다.

관심사 커버리지 (coverage-auditor 자동 생성)

/coverage (coverage-auditor) 산출 — governing doc wiki/projects/ca-tmpl/skeleton-governance-registry-verification-test-scorecard 가 요구하는 관심사 대비 본 브랜치 완전성. 기준: rules/coverage-gate.md. Verdict: Covered (Blocking 0). 본 branch 는 governance 4축 중 Scorecard(§27) 축 owner, 나머지 3축은 delegated.

관심사	상태	owner	심각도	근거
[Scorecard §27] binary pass/fail gate (maturity 점수 X)	covered-here	—	—	D1; governing doc §27
[Scorecard §27] 도입 gate 한정 scope (운영 SLO·코드품질 도구 아님)	covered-here	—	—	D1 선택 조건 + §구현 가이드 §1
[Scorecard §27] 15 area 전체 Pass 시에만 readiness pass	covered-here	—	—	D4; Manual Score Formula
[Scorecard §27] 1:1 branch evidence 매핑	covered-here	—	—	D4·D5·D6; §구현 가이드 §2
[Scorecard §27] 미통과 area owner branch 는 canonical 승급 금지	covered-here	—	—	D2; §구현 가이드 §1
[Scorecard §27] 수동 evidence mapping 필수 (자동 계산기 optional)	covered-here	—	—	D3; §구현 가이드 §1
[Scorecard §27] scorecard CI step / badge / 자동 매핑 검증 (planned)	covered-here	—	—	D3; §구현 가이드 §1 (planned 명시), manual table evidence는 2026-06-26 채움
[Scorecard §27] real-domain dry-run evidence = onboarding consume	covered-here	—	—	D5; adoption area + §구현 가이드 §3
[Scorecard §27] sample-off readiness = sample-removal consume	covered-here	—	—	D6; sample area + §구현 가이드 §4
[Scorecard §27] area row 표 16행 vs 선언 15 reconcile	covered-here	—	OK	§Audit A3 resolved 2026-06-26 (오류/예외 병합, 표 body 15행)
[Registry §21] markdown SSOT + YAML generated constants + 7 yaml	delegated	raw/branch-notes/feature-contract-registry-governance	OK	governing doc §21 owner; Registry 축은 본 branch 범위 밖
[Verification §12] 11 release-blocking gate + JSON snapshot 검증	delegated	raw/branch-notes/feature-contract-verification-test-suite	OK	governing doc §12 owner; §엣지·실패·의존 D4 consume + §Coverage 위임 명시
[Test taxonomy §29 G-G] 6 level + Testcontainers/testFixtures/5min budget	delegated	raw/branch-notes/feature-test-taxonomy-fixture-contract	OK	governing doc §29 G-G owner; Test taxonomy 축은 본 branch 범위 밖

coverage-auditor finding(2026-06-15): Blocking 0 → Covered. 3축 delegation 위임 링크를 본 §에 명시해 UNLINKED_DELEGATION(Should-fix) 해소. area count(16 vs 15)는 2026-06-26에 오류/예외 병합으로 해소했다. local Gradle/shell gate 기준 15 area evidence는 통과했으며, hosted CI/provenance는 prod-verified로 승격하지 않는다.

마주친 문제

• 2026-06-26: sandbox 안에서 ./gradlew verifyCleanArchitectureDependencies를 실행하면 ~/.gradle/wrapper/dists/.../gradle-9.0.0-bin.zip.lck lock write가 막혀 실패했다. 이후 권한 상승 실행에서 verifyCleanArchitectureDependencies, check verifyPublicPathSnapshot, :app-bootstrap:sampleOffTest가 모두 통과했다. 재현/해결 메모는 raw/errors/gradle-wrapper-sandbox-lock-readiness-scorecard-2026-06-26.
• 2026-06-26: Gradle check verifyPublicPathSnapshot는 exit 0이지만 Error Prone/Gradle deprecation warnings가 출력됐다. 현재 build 실패 조건은 아니며 이 branch의 scorecard 문서 범위 밖이다.
• 2026-06-26: shell-only 검증은 완료했다. .github/scripts/verify-gate-matrix.sh, .github/scripts/verify-supply-chain-contract.sh, .github/scripts/test-supply-chain-scripts.sh 모두 exit 0.

묶음 (이 branch에서 파생된 자료)

• raw/official-docs/registry-adr-official
• raw/official-docs/scorecard-aws-well-architected
• raw/official-docs/scorecard-cis-benchmarks-slsa
• raw/official-docs/scorecard-opentelemetry-maturity

• raw/blog-topics/binary-readiness-scorecard-clean-architecture-skeleton-2026-07-02

Sub-branches (세부 작업)

• (없음 — 현재 leaf branch)

오류 기록 (이 branch 작업 중 발생)

• raw/errors/gradle-wrapper-sandbox-lock-readiness-scorecard-2026-06-26

면접 준비 (이 작업에서 나올 수 있는 면접 질문)

• (없음 — 이번 scorecard evidence 갱신에서 추출할 별도 면접 질문 없음)

강의 (이 작업을 위해 학습한 강의)

• (없음)

job-posting tie-ins (이 작업에서 파생된 글감)

• (없음 — 이번 scorecard evidence 갱신에서 추출할 별도 글감 없음)

관련 일일 노트

• raw/daily-notes/2026-05-28

완료 후 정리

• PR 링크:
• 리뷰 메모:
• 머지 결과 / 배포 환경:
• wiki 추출 대상 (verified만, wiki/projects/로만 추출):
  • actually-implemented 항목: Readiness Scorecard 15-area evidence table file path/test name 채움; Dry-Run Evidence module row evidence 채움; §Audit A2/A3 resolved 기록.
  • locally-verified 항목: ./gradlew verifyCleanArchitectureDependencies, ./gradlew check verifyPublicPathSnapshot, ./gradlew :app-bootstrap:sampleOffTest; .github/scripts/verify-gate-matrix.sh, .github/scripts/verify-supply-chain-contract.sh, .github/scripts/test-supply-chain-scripts.sh; §Audit A1 owner slug existence 대조.
  • prod-verified 항목: 없음.
• 추출하지 않을 항목 (planned / documented-only / abandoned):
  • hosted CI/provenance 결과는 needs-confirmation.
  • scorecard CI step / badge / 자동 매핑 검증은 planned.
  • readiness scorecard policy 문서화 항목은 canonical 추출 요청 전까지 raw branch-note에 유지.