Runtime Contract - Schema Validation Code Generator

기존 타입/인터페이스를 분석하여 런타임 스키마 검증 코드를 자동 생성하는 스킬.

Overview

TypeScript는 컴파일 타임에 타입 안전성을 보장하지만, 런타임에 외부에서 유입되는 데이터(API 요청, 설정 파일, 환경변수, 서드파티 응답)는 타입 시스템의 보호 범위 밖이다. Python의 타입 힌트도 동일한 한계를 가진다.

컴파일 타임 + 런타임 검증 결합의 가치:

• 컴파일 타임: 개발자 실수를 조기 차단 (타입 불일치, 누락 필드)
• 런타임: 신뢰할 수 없는 외부 데이터를 실제 실행 시점에 검증
• 결합 효과: 개발 중에는 타입 시스템이, 프로덕션에서는 스키마 검증이 방어 계층을 형성

"TypeScript ensures type safety during development, while Zod validates untrusted data at runtime" - zod.dev/v4

이 스킬은 기존 코드의 타입 정의를 분석하고, 신뢰 경계(Trust Boundary)에 검증 코드를 자동 삽입하여 두 계층의 방어를 통합한다.

지원 도구