---
title: 자동 렌더링 경로와 프리팹 대량 처리 보강
date: 2026-11-03T05:14:05.408Z
version: v1.0.3
status: 작업 중
state: progress
project: entityforge
type: 작업 메뉴얼
report_kind: manual
category: 순차 작업 · 반복 QA
summary: 불필요한 시뮬레이션과 프레임별 복사를 분리하고 생성·해제 경로를 개선합니다.
format: tracefolio-v2
priority: normal
manual_id: entityforge-runtime-fastpath-20261103
round: 2
manual_state: active
payload: ../assets/submissions/2026-11-03-manual-entityforge-runtime-fastpath-20261103-20261103051405408-v1.0.3.json
---

## 목표와 완료 기준

현재 자동 모드의 반복 처리/메모리 할당과 프리팹 생성·해제 비용을 줄일 구조를 구현

완료 기준: 프록시/시뮬레이션 분리, 재사용 렌더 버퍼와 대량 생성·해제, 생명주기 회귀/현재 소스 컴파일/패키지 대조 및 실제 성능 확인 범위 구분

후속 2회차 · 순차 진행 · 전체 5개 · 이번 실행 T04, T05

## 순차 작업 메뉴얼

| 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 |
| --- | --- | --- | --- | --- | --- |
| T01 | 자동 프록시와 ECS 시뮬레이션 분리 | 렌더 쿼리/동작 쿼리 분리와 재사용 버퍼·Burst 행렬 준비 | 프록시에는 동작 잡이 실행되지 않고 매 프레임 데이터 배열 복사 제거 | 현재 코드 경로·컴파일·데이터 규약 검증 | 완료 |
| T02 | 대량 생성·해제와 진단 | 엔티티 일괄 생성/해제, 밀집 등록 저장소 및 런타임 카운터 | 전체 소스 반복 탐색 제거, 죽은 소스 정리와 원래 렌더러 복원 | 실제 저장소 소스 실행 테스트와 컴파일·생명주기 경로 대조 | 완료 |
| T03 | 비GUI 회귀와 패키지 반영 | 컴파일·순수 로직 실행·문서/번역·소스/패키지 대조 | 실행한 검증만 근거로 기록 | 소스 해시와 테스트 출력·패키지 원본 바이트 비교 | 완료 |
| T04 | 네이티브 회귀와 실제 성능 비교 | 같은 부하의 변환 ON/OFF로 프레임 시간·메모리·동작 비교 | 원래 행동 동등성과 실제 비용 감소 확인 | 실제 플레이어에서 동일 조건 비교와 프로파일러 근거 확보 | 진행 |
| T05 | 빌드 기록 카드 정리 | 기존 결과 카드 스타일로 버튼·목록·상세 묶기 | 모든 기록 요소가 같은 박스 안에 표시 | 실제 Unity 테마 전환·기록 선택·목록과 상세 부모 대조 | 완료 |

## QA 반복 기록

### Q01 · step · 2026-11-03T04:08:04.833Z

첫 정적 검사 스크립트의 호출 대상 문자열이 실제 소스와 달라 실패; 제품 코드 실패로 판정하지 않음

- T01 r1 · pass: 새 쿼리/버퍼 구현의 현재 소스 컴파일 통과 · 근거: ../assets/runtime-fastpath-20261103/verification.json
- T02 r1 · pass: 실제 밀집 저장소 소스의 1만 항목 추가·제거·재등록과 재사용 테스트 통과 · 근거: ../assets/runtime-fastpath-20261103/registry-tests.txt
- T03 r1 · fail: checker expected manager.DestroyEntity but implementation uses world.EntityManager.DestroyEntity; checker corrected without changing product · 근거: ../assets/runtime-fastpath-20261103/verification-attempt1.txt
### Q02 · step · 2026-11-03T04:08:53.463Z

현재 소스와 순수 로직 검증 통과, 네이티브 실행 미실행

- T01 r1 · pass: 7개 어셈블리 현재 소스 컴파일과 구조/버퍼/의존성 대조 · 근거: ../assets/runtime-fastpath-20261103/verification.json
- T02 r1 · pass: 실제 ForgeDenseRegistry 코드의 1만 개 임의 삭제·재등록·반복 초기화 테스트 통과 · 근거: ../assets/runtime-fastpath-20261103/verification.json
- T03 r1 · pass: 7개 현재 소스 컴파일·9개 문서 및 402개 에셋 패키지 내용/해시 대조 통과 · 근거: ../assets/runtime-fastpath-20261103/verification.json
- T04 r1 · blocked: 사용자 실행 금지로 네이티브 미실행 · 근거: 미실행/차단 근거 없음
### Q03 · step · 2026-11-03T04:58:56.5297786+00:00

사용자 재허용 후 실제 실행

- T04 r2 · fail: 기능은 통과했으나 이 부하의 개선율 -1.62%, 추가 성능 검증 필요 · 근거: ../assets/native-validation-20261103/verification.json
### Q04 · step · 2026-11-03T05:06:01.3550422+00:00

추가 CI 상태 오류 수정·재빌드

- T03 r1 · pass: 현재 7개 어셈블리와 최종 402개 패키지 대조. 새 프로젝트 설치 후 최종 빌드 오류0 및 succeeded 로그 확인 · 근거: ../assets/ci-final-state-20261103/verification.json
### Q05 · step · 2026-11-03T05:13:48.942Z

빌드 기록 영역 카드화

- T05 r1 · pass: 실제 Unity에서 같은 카드 내부 목록/로그 표시 및 테마 전환·기록 선택 확인 · 근거: ../assets/history-card-20261103/after.jpg

## 남은 작업과 다음 반복

실제 자동 변환과 네이티브 기능/설치는 통과. 성능 개선 미통과: 동일 조건 추가 프로파일링과 CPU/GPU·메모리 비교 필요. 전체 언어/테마·창 최소화/리로드 회귀와 문서 캡처는 남음. 일반 MonoBehaviour 자동 번역 및 동적 로더는 후속 범위. 교훈 검토: 측정 결과를 확대 해석하지 않는 기존 전역 지침 유지, 전역 변경 없음.

이전 회차: [메뉴얼 열기](../../../projects/entityforge/reports/2026-11-03-manual-entityforge-runtime-fastpath-20261103-20261103050625958-v1.0.2.html)

## 작업 시간

- 제안 시간: 3~5분 · 시작 2026-11-03 14:10:29 KST
- 실제로 완료된 시간: UI 적용·실제 확인 약 3분 · 2026-11-03 14:13:20 KST. 공개 배포는 이후 확인.
- XERJ: 실패 — XERJ node is not running. rg와 현재 소스로 확인.