C.E.L._slide_test/issues/Step-5-Execution.md

Purpose

• Execute the planned stages and leave a complete execution package for validation.

Reference Wiki

• Home
• Prompt
• Wiki-2-5-Execution
• Wiki-3-DesignAgent-Detailed-Pipeline-Overview
• optional: Wiki-3-7-Stage-2-HTML-Generation
• optional: Wiki-3-8-Stage-2-Validation-and-Retry
• optional: Wiki-3-9-Stage-3-Render-and-Measurement
• optional: Wiki-3-10-Stage-4-Quality-Gate-and-Finalization

Reference Artifacts

• docs/run-xxx/04-plan/execution-plan.md
• docs/run-xxx/04-plan/stage-1a-topics.json
• docs/run-xxx/04-plan/stage-1b-refined-concepts.json
• docs/run-xxx/05-execution/

Optional Code / Scripts

• scripts/run_from_artifacts.py
• scripts/auto_loop_runner.py
• scripts/gitea_issue_sync.py

?? ? ??? ??/????

• scripts/run_from_artifacts.py
• scripts/auto_loop_runner.py
• scripts/gitea_issue_sync.py

입력

• Step 4 결과 경로:
• 실행에 사용할 코드/스크립트:

실행 방법

1. Step 4에서 확정한 실행 계획과 입력 산출물을 사용해 실제 실행을 수행한다.
2. 아래 필수 산출 항목을 모두 생성하거나 기록한다.
3. 실행 종료 코드, 예외 유무, 산출물 파일 존재 여부를 확인한다.
4. measurement.json과 context.json이 다음 단계에서 재검증 가능할 정도로 완전한지 확인한다.
5. 판정 규칙에 따라 pass / revise / fail을 결정한다.
6. 실패 시 실패 분류와 수정 액션을 함께 기록한다.

필수 산출 항목

• E1. 실행 명령 또는 실행 스크립트 1개
• E2. 입력 파일 경로 1개
• E3. final.html 생성
• E4. generated_html.json 생성
• E5. measurement.json 생성
• E6. context.json 생성
• E7. 경고/재시도/예외 기록 1개 이상 (없음 포함)
• E8. Step 6으로 넘길 핵심 리스크 또는 확인 포인트 1개 이상 (없음 포함)

성공 기준

• E1~E8 전부 작성됨
• final.html, generated_html.json, measurement.json, context.json 네 파일이 모두 실제로 존재하고 0 byte가 아님
• 실행 종료 코드가 0임
• 처리되지 않은 예외(unhandled exception)가 없음
• measurement.json에 최소 slide, zones.body, zones.sidebar, zones.footer가 존재함
• 다음 단계에서 재검증 가능한 실행 추적 정보가 남아 있음

실패 기준

• 실행 종료 코드가 0이 아님
• 필수 산출물 4종 중 1개 이상 미생성 또는 0 byte
• measurement.json 파싱 실패 또는 필수 키 누락
• context.json 누락으로 재검증 불가
• 실행 명령/스크립트 또는 입력 경로가 기록되지 않음
• 예외가 발생했는데 기록이 없음

KPI / 판정 규칙

• 충족률 = 충족 항목 수 / 8
• 치명 항목 = E1, E2, E3, E4, E5, E6
• pass: 충족률 100% and 치명 항목 모두 충족 and 실행 종료 코드 0 and 필수 산출물 4종이 모두 유효함
• revise: 충족률 87.5% 이상 100% 미만 and 치명 항목 모두 충족 and 실행은 완료되었으나 경고/재시도/리스크 기록 보강이 필요함
• fail: 충족률 87.5% 미만 or 치명 항목 1개 이상 누락 or 실행 종료 코드 비정상 or 필수 산출물 4종 중 1개 이상 무효

실패 분류

• Exec-Exit: 실행 종료 코드 비정상
• Exec-Artifact: 산출물 파일 생성 실패 또는 0 byte
• Exec-Measurement: measurement.json 누락/파싱 실패/필수 키 누락
• Exec-Context: context.json 누락 또는 재검증 정보 부족
• Exec-Trace: 실행 명령, 입력, 경고 이력 추적 불가
• Exec-Tool: 도구/스크립트 자체 오류

수정 액션 가이드

• Exec-Exit: 실패한 stage와 stderr를 확인하고 해당 stage부터 재실행
• Exec-Artifact: 산출물 저장 경로와 쓰기 로직을 점검하고 파일 재생성
• Exec-Measurement: 렌더/측정 단계를 재실행하고 필수 키 존재 여부 재검사
• Exec-Context: 컨텍스트 저장 로직을 복구하고 입력/분석 정보 재저장
• Exec-Trace: 사용한 스크립트, 명령, 입력 경로, 경고 이력을 다시 기록
• Exec-Tool: 실행 스크립트 또는 코드 오류를 수정 후 재실행

실행 결과 기록

• 사용한 실행 명령 또는 스크립트:
• 입력 파일 경로:
• 생성된 산출물 경로:
• 실행 종료 코드:
• 경고:
• 재시도 이력:
• 예외:
• Step 6 전달 리스크/확인 포인트:
• 충족 항목 수:
• 충족률:
• 실패 분류:
• 수정 액션:

판정

• pass / revise / fail

다음 단계 전달물

• Step 6에서 사용할 final.html
• Step 6에서 사용할 generated_html.json
• Step 6에서 사용할 measurement.json
• Step 6에서 사용할 context.json