Replay to Replica (관찰 → 재현)
관찰된 제품 동작을 구현 가능하고 독립적으로 표현된 계약으로 변환한 다음, 동일한 사용자 태스크를 재실행하여 새 구현을 검증합니다. 시각적 유사성이나 코드 모방보다 행동 명확성을 최적화합니다.
경계
이 스킬은 허가된 블랙박스 관찰과 클린룸 방식의 핸드오프를 지원합니다. 이 자체로 법적 규정 준수를 보장하지는 않습니다. 라이선스, 이용 약관, 특허, 개인정보 보호 및 계약상 제한을 준수하십시오. 다음을 수행하지 마십시오:
- 인증, 결제, 속도 제한, 암호화 또는 기술적 통제를 우회하는 행위;
- 사용자가 접근 권한이 없는 데이터나 기능에 접근하는 행위;
- 소스 코드, 디컴파일된 코드, 독점 자산, 상표, 카피라이팅, 숨겨진 식별자 또는 기밀 데이터를 구현 패키지에 복사하는 행위;
- 동일한 사람이나 에이전트가 보호된 구현 세부 사항을 보았을 때 엄격한 법적 클린룸 분리를 주장하는 행위.
엄격한 분리가 중요한 경우 작업을 나누십시오: 관찰 역할이 정규화된 동작 패키지를 생성하고, 별도의 구현 역할이 해당 패키지만 수신합니다.
원하는 결과 선택
어떤 결과가 필요한지 명확히 하십시오:
- 동작 패키지만 — 명세서 및 승인 시나리오
- 구현 핸드오프 — 동작 패키지 + 빌드 준비 작업 및 인터페이스
- 검증된 복제본 — 독립적 구현 + 재실행된 패리티 테스트
사용자가 구현을 요청하지 않았다면 "이 제품 분석"을 복제본 구축으로 확장하지 마십시오.
다음 명령으로 작업 패키지를 초기화합니다:
python3 scripts/init_replica_pack.py <output-directory> --product "<관찰된 제품>" --replica "<새 제품>"
단계 1: 범위 및 권한 정의
기록:
- 승인된 대상 및 접근 방법;
- 의도된 독립 제품 및 사용자;
- 보존할 동작;
- 제외할 동작, 브랜딩, 데이터 및 자산;
- 지원되는 플랫폼 및 테스트 환경;
- 런타임 상호작용 또는 계정 작업에 새로운 동의가 필요한지 여부;
- 패리티 임계값: 정확한 계약, 기능적으로 동등, 또는 의도적으로 변경.
"전체 앱 복사"가 아닌 작업 기반 범위를 생성합니다. 가장 작고 가치 있는 여정부터 시작하십시오.
단계 2: 사용자로서 관찰
각 여정에 대해 다음을 캡처합니다:
- 시작 상태 및 전제 조건;
- 사용자 작업;
- 즉시 관찰 가능한 응답;
- 결과 상태 및 유지된 데이터;
- 오류, 지연, 한계 및 복구 경로;
- 증거 경로 및 환경;
- 인식론적 레이블:
observed(관찰됨),derived(유도됨), 또는inferred(추론됨).
상태가 동작에 영향을 미칠 수 있는 경우 실행 간에 대상을 재설정합니다. 변동이 있거나 타이밍에 민감한 동작은 한 번의 샘플을 규칙으로 간주하지 않고 범위를 식별할 수 있을 만큼 충분히 반복합니다.
관찰 증거에는 녹화, 스크린샷, 접근성 트리, 공개 네트워크 동작, 내보낸 파일, 사용자에게 표시되는 로그 및 문서화된 API가 포함될 수 있습니다. 승인된 범위 내에서만 사용 가능한 검사 도구를 사용하십시오. 내부 구현 세부 사항은 동작 계약에 필요하지 않습니다.
동작 패키지를 작성할 때 참조/observation-and-spec.md를 읽으십시오.
단계 3: 동작 계약으로 정규화
원래 인터페이스나 표현과 독립적으로 동작을 설명합니다. 계약은 다음을 정의해야 합니다:
- 행위자 및 권한;
- 엔티티, 식별자 및 관계;
- 상태 및 유효한 전환;
- 작업, 입력, 출력, 부작용 및 불변 조건;
- 검증 및 실패 동작;
- 지속성, 순서, 타이밍 및 동시성 규칙 (보이는 경우);
- 외부 통합 경계;
- 접근성 및 플랫폼 기대 사항;
- 의도된 차이점.
중요한 규칙마다 증거 참조 또는 명시적 추론 레이블이 필요합니다. 충돌하는 관찰은 테스트될 때까지 해결되지 않은 상태로 남습니다. 편리한 해석을 조용히 선택하지 마십시오.
단계 4: 깔끔한 구현 핸드오프 생성
구현 핸드오프에는 다음이 포함될 수 있습니다:
behavior-spec.yaml
state-model.md
data-contracts.md
acceptance-scenarios.md
implementation-handoff.md
source-observations.csv
새 제품에 맞게 이름, 텍스트, 시각적 아이덴티티 및 도메인 예제를 다시 작성합니다. 원본 자산 및 내부 식별자는 제외합니다. 추정된 소스 아키텍처가 아닌 인터페이스와 결과를 지정합니다.
패키지를 구현 에이전트에 전달하기 전에 참조/clean-room-handoff.md를 읽으십시오.
단계 5: 독립적으로 구현
원래 스택에 대한 추측이 아닌 새 제품의 제약 조건에서 기술을 선택합니다. 다른 아키텍처, 알고리즘, 시각적 디자인 및 데이터 구조를 허용하면서 동작 계약을 유지합니다.
의도적인 차이점에 대한 구현 결정 로그를 유지합니다. 실패하는 구현이 규정을 준수하는 것처럼 보이게 하기 위해 동작 사양을 변경하지 마십시오. 새로운 관찰이 사양을 반증하거나 사용자가 제품 변경을 승인한 경우에만 사양을 업데이트합니다.
단계 6: 재실행 및 비교
승인 시나리오를 실행 가능한 테스트로 전환합니다. 동일한 정규화된 작업을 원본과 복제본에 대해 실행한 다음 사용자가 관찰 가능한 결과를 비교합니다.
각 시나리오를 분류합니다:
match(일치) — 필요한 모든 관찰 가능 항목이 선언된 허용 오차 내에서 일치합니다.acceptable-difference(허용 가능한 차이) — 의도적으로 다르며 승인/문서화됨.mismatch(불일치) — 동작 계약과 모순됨.unverified(미확인) — 한쪽을 실행할 수 없거나 증거가 불충분함.
구조화된 이벤트 추적의 경우 다음을 사용합니다:
python3 scripts/compare_traces.py original.json replica.json --output parity-report.md
정규화, 허용 오차 또는 릴리스 게이트를 설계할 때 참조/parity-testing.md를 읽으십시오.
완료 조건
다음 조건을 충족하지 않으면 복제본을 완료라고 부르지 마십시오:
- 모든 릴리스 차단 시나리오가
match또는 승인된acceptable-difference입니다. - 해결되지 않은 추론된 규칙이 공개되었습니다.
- 새 제품에 복사된 보호 자산이나 아이덴티티가 포함되어 있지 않습니다.
- 사용자가 의도된 환경에서 핵심 여정을 실행할 수 있습니다.
- 패리티 보고서가 검사 가능한 증거에 연결됩니다.
최종 보고서는 범위, 권한 경계, 관찰된 적용 범위, 추론, 의도된 차이점, 불일치, 미확인 영역 및 테스트된 정확한 구현 아티팩트를 명시해야 합니다.