From c236f4912a3a08ea76fd98aba1b0aa8774921aaf Mon Sep 17 00:00:00 2001 From: kyeongmin Date: Wed, 1 Apr 2026 17:25:48 +0900 Subject: [PATCH] Refine issue drafts for direct Gitea issue pasting --- issues/ISSUE-TEMPLATE.md | 55 -------------------- issues/README.md | 19 +++---- issues/Step-1-Input-Review.md | 61 +++++++++++------------ issues/Step-2-Interpretation.md | 61 +++++++++++------------ issues/Step-3-Content-Structuring.md | 55 ++++++++++---------- issues/Step-4-Execution-Planning.md | 55 ++++++++++---------- issues/Step-5-Execution.md | 55 ++++++++++---------- issues/Step-6-Validation-and-Recording.md | 59 +++++++++++----------- 8 files changed, 171 insertions(+), 249 deletions(-) delete mode 100644 issues/ISSUE-TEMPLATE.md diff --git a/issues/ISSUE-TEMPLATE.md b/issues/ISSUE-TEMPLATE.md deleted file mode 100644 index 4a00bfe..0000000 --- a/issues/ISSUE-TEMPLATE.md +++ /dev/null @@ -1,55 +0,0 @@ -# Issue Template - -## 제목 -run-XXX - [입력 제목] / [핵심 목적] - -## 입력 -- 파일: -- 목적: -- 제약: - -## Step 1 입력 확인 -- 결과 요약: -- 판정: pass / revise / fail -- 실패 원인 분류: - -## Step 2 Kei 기준 해석 -- 결과 요약: -- 판정: pass / revise / fail -- 실패 원인 분류: - -## Step 3 콘텐츠 구조화 -- 결과 요약: -- 판정: pass / revise / fail -- 실패 원인 분류: - -## Step 4 실행 계획 -- 결과 요약: -- 판정: pass / revise / fail -- 실패 원인 분류: - -## Step 5 실제 수행 -- 실행 경로: -- 산출물 경로: -- 판정: pass / revise / fail -- 실패 원인 분류: - -## Step 6 검증 및 기록 -- 검증 결과 요약: -- 최종 판정: pass / revise / fail -- 실패 원인 분류: - -## 현황 정리 -- 현재 상태: -- 핵심 문제: -- 유지할 것: - -## 개선 방향 -1. -2. -3. - -## 다음 run 반영 사항 -- -- -- diff --git a/issues/README.md b/issues/README.md index 47605a8..de8b154 100644 --- a/issues/README.md +++ b/issues/README.md @@ -1,14 +1,9 @@ -# Step Issue Usage +# Issues -이 폴더의 문서들은 Gitea `이슈` 탭에 그대로 붙여 넣기 위한 step별 이슈 본문 초안이다. +이 폴더의 파일은 Gitea `이슈` 탭에 붙여 넣기 위한 초안이다. -## 사용 방식 -1. Step별 새 이슈를 만든다. -2. 해당 step 문서 내용을 붙여 넣는다. -3. 실제 실행 결과는 이슈 코멘트로 남긴다. - -## 공통 원칙 -- 모든 step 이슈는 KPI 기반 성공/실패 기준을 가진다. -- `pass / revise / fail` 판정 규칙을 포함한다. -- 실패 분류와 수정 액션 가이드를 포함한다. -- 실제 결과와 판정은 코멘트로 누적한다. +사용 방법: +1. 새 이슈를 만든다. +2. 파일명에 맞는 제목을 직접 입력한다. +3. 파일 본문 내용을 복사해서 붙여 넣는다. +4. 실제 실행 결과는 이슈 코멘트로 기록한다. diff --git a/issues/Step-1-Input-Review.md b/issues/Step-1-Input-Review.md index 8365e4e..ec82756 100644 --- a/issues/Step-1-Input-Review.md +++ b/issues/Step-1-Input-Review.md @@ -1,23 +1,20 @@ -## 제목 -Step 1 / 입력 확인 +목적 +- 입력 문서를 실행 가능한 단위로 식별하고, 작업 목적, 범위, 제약을 확정한다. -## 목적 -입력 문서를 실행 가능한 단위로 식별하고, 작업 목적과 범위와 제약을 확정한다. - -## 입력 +입력 - 입력 폴더: - 입력 파일명: - 입력 파일 경로: - 관련 산출물 경로: -## 실행 방법 +실행 방법 1. 입력 문서를 읽는다. -2. 아래 `필수 산출 항목` 6개를 작성한다. +2. 아래 필수 산출 항목 6개를 작성한다. 3. 각 항목의 충족 여부를 체크한다. -4. `판정 규칙`에 따라 pass / revise / fail을 결정한다. -5. 실패 시 `수정 액션`을 기록한다. +4. 판정 규칙에 따라 pass / revise / fail을 결정한다. +5. 실패 시 수정 액션을 기록한다. -## 필수 산출 항목 +필수 산출 항목 - A1. 입력 파일 경로 1개 - A2. 문서 제목 1개 - A3. 작업 목적 1문장 @@ -25,14 +22,14 @@ Step 1 / 입력 확인 - A5. 주요 제약 3개 이상 - A6. 확인 필요 사항 0개 이상 -## 성공 기준 +성공 기준 - A1~A6 전부 작성됨 - 작업 목적은 1문장으로 끝남 - 작업 범위는 1~3개 항목으로 제한됨 - 주요 제약은 최소 3개 기록됨 - 산출물이 지정 경로에 저장됨 -## 실패 기준 +실패 기준 - 입력 파일 경로 미기록 - 문서 제목 미기록 - 작업 목적 미기록 또는 2문장 이상으로 장황함 @@ -40,27 +37,27 @@ Step 1 / 입력 확인 - 주요 제약 2개 이하 - 산출물 파일 미생성 -## KPI / 판정 규칙 +KPI / 판정 규칙 - 충족률 = 충족 항목 수 / 6 -- `pass`: 충족률 100% and 치명 항목(A1, A2, A3) 모두 충족 -- `revise`: 충족률 83% 이상 100% 미만 and 치명 항목 모두 충족 -- `fail`: 충족률 83% 미만 or 치명 항목 1개 이상 누락 +- pass: 충족률 100% and 치명 항목(A1, A2, A3) 모두 충족 +- revise: 충족률 83% 이상 100% 미만 and 치명 항목 모두 충족 +- fail: 충족률 83% 미만 or 치명 항목 1개 이상 누락 -## 실패 분류 -- `Input-Path`: 입력 파일 식별 실패 -- `Input-Purpose`: 작업 목적 정리 실패 -- `Input-Scope`: 범위 정의 실패 -- `Input-Constraint`: 제약 추출 부족 -- `Input-Artifact`: 산출물 저장 실패 +실패 분류 +- Input-Path: 입력 파일 식별 실패 +- Input-Purpose: 작업 목적 정리 실패 +- Input-Scope: 범위 정의 실패 +- Input-Constraint: 제약 추출 부족 +- Input-Artifact: 산출물 저장 실패 -## 수정 액션 가이드 -- `Input-Path`: 입력 파일 경로를 1개로 특정하고 링크/경로를 다시 기록 -- `Input-Purpose`: 목적을 1문장으로 다시 축약 -- `Input-Scope`: 범위를 1~3개로 다시 제한 -- `Input-Constraint`: 제약을 최소 3개까지 보강 -- `Input-Artifact`: 산출물 파일 저장 경로 확인 후 재생성 +수정 액션 가이드 +- Input-Path: 입력 파일 경로를 1개로 특정하고 링크/경로를 다시 기록 +- Input-Purpose: 목적을 1문장으로 다시 축약 +- Input-Scope: 범위를 1~3개로 다시 제한 +- Input-Constraint: 제약을 최소 3개까지 보강 +- Input-Artifact: 산출물 파일 저장 경로 확인 후 재생성 -## 실제 결과 +실행 결과 기록 - 입력 요약: - 문서 제목: - 작업 목적: @@ -72,10 +69,10 @@ Step 1 / 입력 확인 - 실패 분류: - 수정 액션: -## 판정 +판정 - pass / revise / fail -## 다음 단계 전달물 +다음 단계 전달물 - Step 2에서 참고할 입력 요약 - 제약 목록 - 확인 필요 사항 목록 diff --git a/issues/Step-2-Interpretation.md b/issues/Step-2-Interpretation.md index 9571f43..892e207 100644 --- a/issues/Step-2-Interpretation.md +++ b/issues/Step-2-Interpretation.md @@ -1,61 +1,58 @@ -## 제목 -Step 2 / 기준 해석 +목적 +- 입력 문서의 핵심 목적, 의미 보존 기준, 실패 패턴, 검증 기준을 해석 가능한 형태로 확정한다. -## 목적 -입력 문서의 핵심 목적, 의미 보존 기준, 실패 패턴, 검증 기준을 해석 가능한 형태로 확정한다. - -## 입력 +입력 - Step 1 결과 경로: - 입력 문서 경로: -## 실행 방법 +실행 방법 1. Step 1 산출물을 읽는다. -2. 아래 `필수 산출 항목` 5개를 작성한다. +2. 아래 필수 산출 항목 5개를 작성한다. 3. 각 항목 충족 여부를 체크한다. -4. `판정 규칙`에 따라 pass / revise / fail을 결정한다. -5. 실패 시 `수정 액션`을 기록한다. +4. 판정 규칙에 따라 pass / revise / fail을 결정한다. +5. 실패 시 수정 액션을 기록한다. -## 필수 산출 항목 +필수 산출 항목 - B1. 핵심 목적 1문장 - B2. 의미 보존 기준 3개 이상 - B3. 실패 패턴 3개 이상 - B4. 검증 기준 3개 이상 - B5. 핵심 정보 / 보조 정보 구분 각 1개 이상 -## 성공 기준 +성공 기준 - B1~B5 전부 작성됨 - 핵심 목적은 1문장으로 끝남 - 의미 보존 기준, 실패 패턴, 검증 기준이 각각 최소 3개 이상임 - 핵심/보조 구분이 모두 존재함 -## 실패 기준 +실패 기준 - 핵심 목적 미기록 - 의미 보존 기준 2개 이하 - 실패 패턴 2개 이하 - 검증 기준 2개 이하 - 핵심/보조 구분 누락 -## KPI / 판정 규칙 +KPI / 판정 규칙 - 충족률 = 충족 항목 수 / 5 -- `pass`: 충족률 100% and 치명 항목(B1, B2, B4) 모두 충족 -- `revise`: 충족률 80% 이상 100% 미만 and 치명 항목 모두 충족 -- `fail`: 충족률 80% 미만 or 치명 항목 1개 이상 누락 +- pass: 충족률 100% and 치명 항목(B1, B2, B4) 모두 충족 +- revise: 충족률 80% 이상 100% 미만 and 치명 항목 모두 충족 +- fail: 충족률 80% 미만 or 치명 항목 1개 이상 누락 -## 실패 분류 -- `Interpret-Purpose`: 핵심 목적 정의 실패 -- `Interpret-Preserve`: 의미 보존 기준 부족 -- `Interpret-Risk`: 실패 패턴 정의 부족 -- `Interpret-Verify`: 검증 기준 정의 부족 -- `Interpret-Split`: 핵심/보조 구분 실패 +실패 분류 +- Interpret-Purpose: 핵심 목적 정의 실패 +- Interpret-Preserve: 의미 보존 기준 부족 +- Interpret-Risk: 실패 패턴 정의 부족 +- Interpret-Verify: 검증 기준 정의 부족 +- Interpret-Split: 핵심/보조 구분 실패 -## 수정 액션 가이드 -- `Interpret-Purpose`: 핵심 목적을 1문장으로 다시 작성 -- `Interpret-Preserve`: 원문에서 반드시 유지할 의미를 최소 3개로 보강 -- `Interpret-Risk`: 오해/왜곡/누락 위험을 최소 3개로 보강 -- `Interpret-Verify`: 이후 검증에서 볼 체크 항목을 최소 3개로 보강 -- `Interpret-Split`: 핵심과 보조 정보를 다시 분리 +수정 액션 가이드 +- Interpret-Purpose: 핵심 목적을 1문장으로 다시 작성 +- Interpret-Preserve: 원문에서 반드시 유지할 의미를 최소 3개로 보강 +- Interpret-Risk: 오해/왜곡/누락 위험을 최소 3개로 보강 +- Interpret-Verify: 이후 검증에서 볼 체크 항목을 최소 3개로 보강 +- Interpret-Split: 핵심과 보조 정보를 다시 분리 -## 실제 결과 +실행 결과 기록 - 핵심 목적: - 의미 보존 기준: - 실패 패턴: @@ -67,10 +64,10 @@ Step 2 / 기준 해석 - 실패 분류: - 수정 액션: -## 판정 +판정 - pass / revise / fail -## 다음 단계 전달물 +다음 단계 전달물 - Step 3에서 사용할 해석 결과 - 핵심/보조 구분표 - 검증 기준 초안 diff --git a/issues/Step-3-Content-Structuring.md b/issues/Step-3-Content-Structuring.md index d8634fa..1178cb6 100644 --- a/issues/Step-3-Content-Structuring.md +++ b/issues/Step-3-Content-Structuring.md @@ -1,62 +1,59 @@ -## 제목 -Step 3 / 콘텐츠 구조화 +목적 +- 원문을 바로 생성하지 않고, 중심 메시지와 보조 정보를 분리해 구조와 우선순위를 확정한다. -## 목적 -원문을 바로 생성하지 않고, 중심 메시지와 보조 정보를 분리해 구조와 우선순위를 확정한다. - -## 입력 +입력 - Step 2 결과 경로: - 입력 문서 경로: -## 실행 방법 +실행 방법 1. 중심 메시지 1개를 확정한다. 2. 보조 메시지를 분리한다. 3. 섹션 구조를 작성한다. 4. body/sidebar/footer 배치 가정을 작성한다. 5. 중복 여부와 누락 여부를 점검한다. -## 필수 산출 항목 +필수 산출 항목 - C1. 중심 메시지 1개 - C2. 보조 메시지 2개 이상 - C3. 섹션 구조 3~4단계 - C4. body/sidebar/footer 배치 가정 모두 작성 - C5. 중복 항목 0개 확인 -## 성공 기준 +성공 기준 - C1~C5 전부 충족 - 중심 메시지가 1개로 고정됨 - 보조 메시지가 최소 2개 이상 존재함 - 배치 가정이 3개 영역 모두 작성됨 - 중복 정보가 확인되지 않음 -## 실패 기준 +실패 기준 - 중심 메시지 없음 - 보조 메시지 1개 이하 - 섹션 구조 없음 또는 5단계 이상으로 과도함 - body/sidebar/footer 중 1개 이상 누락 - 동일 정보가 여러 영역에 중복 배치됨 -## KPI / 판정 규칙 +KPI / 판정 규칙 - 충족률 = 충족 항목 수 / 5 -- `pass`: 충족률 100% and 치명 항목(C1, C3, C4) 모두 충족 -- `revise`: 충족률 80% 이상 100% 미만 and 치명 항목 모두 충족 -- `fail`: 충족률 80% 미만 or 치명 항목 1개 이상 누락 +- pass: 충족률 100% and 치명 항목(C1, C3, C4) 모두 충족 +- revise: 충족률 80% 이상 100% 미만 and 치명 항목 모두 충족 +- fail: 충족률 80% 미만 or 치명 항목 1개 이상 누락 -## 실패 분류 -- `Structure-Core`: 중심 메시지 설정 실패 -- `Structure-Support`: 보조 메시지 분리 부족 -- `Structure-Section`: 섹션 구조 설계 실패 -- `Structure-Layout`: 영역 배치 가정 실패 -- `Structure-Duplication`: 중복 정보 존재 +실패 분류 +- Structure-Core: 중심 메시지 설정 실패 +- Structure-Support: 보조 메시지 분리 부족 +- Structure-Section: 섹션 구조 설계 실패 +- Structure-Layout: 영역 배치 가정 실패 +- Structure-Duplication: 중복 정보 존재 -## 수정 액션 가이드 -- `Structure-Core`: 중심 메시지를 1개로 재정의 -- `Structure-Support`: 보조 메시지를 최소 2개 이상 재분리 -- `Structure-Section`: 섹션 구조를 3~4단계로 재정리 -- `Structure-Layout`: 3개 영역 배치 가정을 모두 작성 -- `Structure-Duplication`: 중복 정보 제거 후 영역 재배치 +수정 액션 가이드 +- Structure-Core: 중심 메시지를 1개로 재정의 +- Structure-Support: 보조 메시지를 최소 2개 이상 재분리 +- Structure-Section: 섹션 구조를 3~4단계로 재정리 +- Structure-Layout: 3개 영역 배치 가정을 모두 작성 +- Structure-Duplication: 중복 정보 제거 후 영역 재배치 -## 실제 결과 +실행 결과 기록 - 중심 메시지: - 보조 메시지: - 섹션 구조: @@ -67,9 +64,9 @@ Step 3 / 콘텐츠 구조화 - 실패 분류: - 수정 액션: -## 판정 +판정 - pass / revise / fail -## 다음 단계 전달물 +다음 단계 전달물 - Step 4에서 사용할 구조화 결과 - 영역 배치 가정표 diff --git a/issues/Step-4-Execution-Planning.md b/issues/Step-4-Execution-Planning.md index a8ee10a..b0d4468 100644 --- a/issues/Step-4-Execution-Planning.md +++ b/issues/Step-4-Execution-Planning.md @@ -1,21 +1,18 @@ -## 제목 -Step 4 / 실행 계획 수립 +목적 +- 실제 실행을 어떤 stage 순서로 진행할지 정리하고, 검증 및 재시도 기준을 확정한다. -## 목적 -실제 실행을 어떤 stage 순서로 진행할지 정리하고, 검증 및 재시도 기준을 확정한다. - -## 입력 +입력 - Step 3 결과 경로: - 관련 위키 경로: -## 실행 방법 +실행 방법 1. 필요한 stage를 나열한다. 2. 각 stage의 입력과 출력을 적는다. 3. 각 stage의 검증 포인트를 적는다. 4. 재시도 기준과 fallback 경로를 적는다. 5. 실행 누락 stage가 없는지 점검한다. -## 필수 산출 항목 +필수 산출 항목 - D1. stage 목록 1개 이상 - D2. stage별 입력 정의 100% - D3. stage별 출력 정의 100% @@ -23,39 +20,39 @@ Step 4 / 실행 계획 수립 - D5. 재시도 기준 명시 - D6. fallback 경로 명시 -## 성공 기준 +성공 기준 - D1~D6 전부 충족 - 모든 실행 stage에 입력/출력/검증이 연결됨 - 재시도 기준과 fallback 경로가 존재함 -## 실패 기준 +실패 기준 - stage 누락 - 입력/출력 정의 누락 stage 존재 - 검증 포인트 없는 stage 존재 - 재시도 기준 누락 - fallback 경로 누락 -## KPI / 판정 규칙 +KPI / 판정 규칙 - 충족률 = 충족 항목 수 / 6 -- `pass`: 충족률 100% and 치명 항목(D2, D3, D4) 모두 충족 -- `revise`: 충족률 83% 이상 100% 미만 and 치명 항목 모두 충족 -- `fail`: 충족률 83% 미만 or 치명 항목 1개 이상 누락 +- pass: 충족률 100% and 치명 항목(D2, D3, D4) 모두 충족 +- revise: 충족률 83% 이상 100% 미만 and 치명 항목 모두 충족 +- fail: 충족률 83% 미만 or 치명 항목 1개 이상 누락 -## 실패 분류 -- `Plan-Stage`: stage 구성 누락 -- `Plan-IO`: 입력/출력 정의 부족 -- `Plan-Verify`: 검증 포인트 부족 -- `Plan-Retry`: 재시도 기준 누락 -- `Plan-Fallback`: fallback 경로 누락 +실패 분류 +- Plan-Stage: stage 구성 누락 +- Plan-IO: 입력/출력 정의 부족 +- Plan-Verify: 검증 포인트 부족 +- Plan-Retry: 재시도 기준 누락 +- Plan-Fallback: fallback 경로 누락 -## 수정 액션 가이드 -- `Plan-Stage`: 빠진 stage 추가 -- `Plan-IO`: 누락된 입력/출력 정의 보강 -- `Plan-Verify`: stage별 검증 포인트 추가 -- `Plan-Retry`: 재시도 조건과 횟수 정의 -- `Plan-Fallback`: 대체 경로 명시 +수정 액션 가이드 +- Plan-Stage: 빠진 stage 추가 +- Plan-IO: 누락된 입력/출력 정의 보강 +- Plan-Verify: stage별 검증 포인트 추가 +- Plan-Retry: 재시도 조건과 횟수 정의 +- Plan-Fallback: 대체 경로 명시 -## 실제 결과 +실행 결과 기록 - stage 목록: - stage별 입력/출력: - 검증 포인트: @@ -66,9 +63,9 @@ Step 4 / 실행 계획 수립 - 실패 분류: - 수정 액션: -## 판정 +판정 - pass / revise / fail -## 다음 단계 전달물 +다음 단계 전달물 - Step 5에서 사용할 실행 계획 - stage별 실행 체크리스트 diff --git a/issues/Step-5-Execution.md b/issues/Step-5-Execution.md index 4b20930..f1b8f61 100644 --- a/issues/Step-5-Execution.md +++ b/issues/Step-5-Execution.md @@ -1,60 +1,57 @@ -## 제목 -Step 5 / 실제 수행 +목적 +- 계획에 따라 실제 실행을 수행하고 산출물을 저장한다. -## 목적 -계획에 따라 실제 실행을 수행하고 산출물을 저장한다. - -## 입력 +입력 - Step 4 결과 경로: - 실행에 사용할 코드/스크립트: -## 실행 방법 +실행 방법 1. 계획된 stage를 순서대로 수행한다. 2. stage별 산출물을 저장한다. 3. 경고와 재시도 이력을 남긴다. 4. 최종 결과물 경로를 연결한다. 5. 저장 누락과 실행 중단 여부를 점검한다. -## 필수 산출 항목 +필수 산출 항목 - E1. 실제 실행 경로 기록 - E2. 산출물 파일 1개 이상 생성 - E3. 중간 또는 최종 결과 경로 기록 - E4. 경고 사항 기록 - E5. 재시도 이력 기록 (없으면 없음으로 표기) -## 성공 기준 +성공 기준 - E1~E5 전부 작성됨 - 산출물 파일이 실제로 존재함 - 실행 경로가 추적 가능함 - 경고/재시도 이력이 남음 -## 실패 기준 +실패 기준 - 실행 중단 - 산출물 미생성 - 실행 경로 미기록 - 경고/재시도 이력 미기록 -## KPI / 판정 규칙 +KPI / 판정 규칙 - 충족률 = 충족 항목 수 / 5 -- `pass`: 충족률 100% and 치명 항목(E1, E2, E3) 모두 충족 -- `revise`: 충족률 80% 이상 100% 미만 and 치명 항목 모두 충족 -- `fail`: 충족률 80% 미만 or 치명 항목 1개 이상 누락 +- pass: 충족률 100% and 치명 항목(E1, E2, E3) 모두 충족 +- revise: 충족률 80% 이상 100% 미만 and 치명 항목 모두 충족 +- fail: 충족률 80% 미만 or 치명 항목 1개 이상 누락 -## 실패 분류 -- `Exec-Run`: 실행 중단 -- `Exec-Artifact`: 산출물 생성 실패 -- `Exec-Trace`: 실행 경로 추적 불가 -- `Exec-Warn`: 경고/재시도 기록 누락 -- `Exec-Tool`: 도구/스크립트 문제 +실패 분류 +- Exec-Run: 실행 중단 +- Exec-Artifact: 산출물 생성 실패 +- Exec-Trace: 실행 경로 추적 불가 +- Exec-Warn: 경고/재시도 기록 누락 +- Exec-Tool: 도구/스크립트 문제 -## 수정 액션 가이드 -- `Exec-Run`: 중단 지점 재확인 후 해당 stage 재실행 -- `Exec-Artifact`: 산출물 경로와 저장 로직 점검 후 재생성 -- `Exec-Trace`: 사용한 스크립트/명령/입력을 다시 기록 -- `Exec-Warn`: 경고와 재시도 이력을 보강 -- `Exec-Tool`: 도구 오류 분리 후 수정 +수정 액션 가이드 +- Exec-Run: 중단 지점 재확인 후 해당 stage 재실행 +- Exec-Artifact: 산출물 경로와 저장 로직 점검 후 재생성 +- Exec-Trace: 사용한 스크립트/명령/입력을 다시 기록 +- Exec-Warn: 경고와 재시도 이력을 보강 +- Exec-Tool: 도구 오류 분리 후 수정 -## 실제 결과 +실행 결과 기록 - 사용한 실행 경로: - 생성된 산출물: - 경고: @@ -64,8 +61,8 @@ Step 5 / 실제 수행 - 실패 분류: - 수정 액션: -## 판정 +판정 - pass / revise / fail -## 다음 단계 전달물 +다음 단계 전달물 - Step 6에서 사용할 실행 결과와 산출물 경로 diff --git a/issues/Step-6-Validation-and-Recording.md b/issues/Step-6-Validation-and-Recording.md index 3c68314..d86191d 100644 --- a/issues/Step-6-Validation-and-Recording.md +++ b/issues/Step-6-Validation-and-Recording.md @@ -1,14 +1,11 @@ -## 제목 -Step 6 / 검증 및 기록 +목적 +- 최종 결과가 목적과 제약에 맞는지 검증하고, 다음 run을 위한 개선 방향을 기록한다. -## 목적 -최종 결과가 목적과 제약에 맞는지 검증하고, 다음 run을 위한 개선 방향을 기록한다. - -## 입력 +입력 - Step 5 결과 경로: - 최종 산출물 경로: -## 실행 방법 +실행 방법 1. 목적 적합성을 평가한다. 2. 내용 보존을 평가한다. 3. 렌더링/측정 결과를 평가한다. @@ -16,7 +13,7 @@ Step 6 / 검증 및 기록 5. 다음 액션과 되돌림 지점을 기록한다. 6. 실패 원인을 분류한다. -## 필수 산출 항목 +필수 산출 항목 - F1. 목적 적합성 평가 - F2. 내용 보존 평가 - F3. 렌더링/측정 평가 @@ -25,42 +22,42 @@ Step 6 / 검증 및 기록 - F6. 다음 액션 1개 이상 - F7. 되돌림 지점 명시 -## 성공 기준 +성공 기준 - F1~F7 전부 작성됨 - 최종 판정이 명확함 - 실패 시 실패 원인과 수정 방향이 분명함 - 다음 run으로 넘길 개선 사항이 존재함 -## 실패 기준 +실패 기준 - 평가 항목 누락 - 최종 판정 누락 - 실패 원인 분류 누락 - 다음 액션 없음 - 되돌림 지점 없음 -## KPI / 판정 규칙 +KPI / 판정 규칙 - 충족률 = 충족 항목 수 / 7 -- `pass`: 충족률 100% and 치명 항목(F1, F2, F3, F4) 모두 충족 -- `revise`: 충족률 86% 이상 100% 미만 and 치명 항목 모두 충족 -- `fail`: 충족률 86% 미만 or 치명 항목 1개 이상 누락 +- pass: 충족률 100% and 치명 항목(F1, F2, F3, F4) 모두 충족 +- revise: 충족률 86% 이상 100% 미만 and 치명 항목 모두 충족 +- fail: 충족률 86% 미만 or 치명 항목 1개 이상 누락 -## 실패 분류 -- `Verify-Purpose`: 목적 적합성 불충분 -- `Verify-Preserve`: 내용 보존 실패 -- `Verify-Render`: 렌더/측정 실패 -- `Verify-Judgement`: 최종 판정 불명확 -- `Verify-Action`: 다음 액션 부족 -- `Verify-Rollback`: 되돌림 지점 미정 +실패 분류 +- Verify-Purpose: 목적 적합성 불충분 +- Verify-Preserve: 내용 보존 실패 +- Verify-Render: 렌더/측정 실패 +- Verify-Judgement: 최종 판정 불명확 +- Verify-Action: 다음 액션 부족 +- Verify-Rollback: 되돌림 지점 미정 -## 수정 액션 가이드 -- `Verify-Purpose`: 중심 메시지와 결과물의 일치 여부 재검토 -- `Verify-Preserve`: 누락/과잉 생성/왜곡 항목 보강 -- `Verify-Render`: overflow 또는 배치 문제 수정 -- `Verify-Judgement`: pass/revise/fail 판정 근거를 다시 명시 -- `Verify-Action`: 다음 run 개선 항목을 최소 1개 이상 추가 -- `Verify-Rollback`: 어느 step으로 되돌릴지 명시 +수정 액션 가이드 +- Verify-Purpose: 중심 메시지와 결과물의 일치 여부 재검토 +- Verify-Preserve: 누락/과잉 생성/왜곡 항목 보강 +- Verify-Render: overflow 또는 배치 문제 수정 +- Verify-Judgement: pass/revise/fail 판정 근거를 다시 명시 +- Verify-Action: 다음 run 개선 항목을 최소 1개 이상 추가 +- Verify-Rollback: 어느 step으로 되돌릴지 명시 -## 실제 결과 +실행 결과 기록 - 목적 적합성: - 내용 보존: - 렌더링/측정: @@ -72,8 +69,8 @@ Step 6 / 검증 및 기록 - 충족률: - 수정 액션: -## 판정 +판정 - pass / revise / fail -## 다음 단계 전달물 +다음 단계 전달물 - 다음 run 시작 전에 참고할 검증 결과와 개선 사항