Clarify issue drafts with explicit wiki references

issues/README.md

@@ -1,9 +1,9 @@
-# Issues
+# Issues
 
-이 폴더의 파일은 Gitea `이슈` 탭에 붙여 넣기 위한 초안이다.
+These files are step-level issue body drafts for the Gitea issue tab.
 
-사용 방법:
+Workflow
-1. 새 이슈를 만든다.
+1. Read the `Reference Wiki` section first.
-2. 파일명에 맞는 제목을 직접 입력한다.
+2. Then inspect `Reference Artifacts` and optional code/scripts.
-3. 파일 본문 내용을 복사해서 붙여 넣는다.
+3. Record actual execution results as issue comments.
-4. 실제 실행 결과는 이슈 코멘트로 기록한다.
+4. Feed Step 6 validation and failure classes into the next loop.

issues/Step-1-Input-Review.md

@@ -1,5 +1,20 @@
-목적
+Purpose
-- 입력 문서를 실행 가능한 단위로 식별하고, 작업 목적, 범위, 제약을 확정한다.
+- Identify the input document as an executable unit and confirm task purpose, scope, and constraints.
+
+Reference Wiki
+- Home
+- Prompt
+- Wiki-1-1-Kei-Thinking-and-Process
+- Wiki-1-2-Kei-Roles-and-Operating-Principles
+- Wiki-2-1-Input-Review
+
+Reference Artifacts
+- docs/run-xxx/01-input/
+- optional: docs/run-xxx/06-validation/validation-result.md
+
+Optional Code / Scripts
+- scripts/auto_loop_runner.py
+- scripts/run_from_artifacts.py
 
 입력
 - 입력 폴더:

issues/Step-2-Interpretation.md

@@ -1,5 +1,24 @@
-목적
+Purpose
-- 입력 문서의 핵심 목적, 의미 보존 기준, 실패 패턴, 검증 기준을 해석 가능한 형태로 확정한다.
+- Convert the input into explicit purpose, meaning-preservation rules, failure patterns, and validation criteria.
+
+Reference Wiki
+- Home
+- Prompt
+- Wiki-1-1-Kei-Thinking-and-Process
+- Wiki-1-2-Kei-Roles-and-Operating-Principles
+- Wiki-2-2-Kei-Interpretation
+- optional: Wiki-3-2-Stage-1A-Topic-Extraction
+- optional: Wiki-3-3-Stage-1B-Concept-Refinement
+
+Reference Artifacts
+- docs/run-xxx/01-input/input-review.md
+- docs/run-xxx/02-kei-interpretation/
+
+Optional Code / Scripts
+- scripts/auto_loop_runner.py
+- scripts/run_from_artifacts.py
+
+- scripts/run_from_artifacts.py
 
 입력
 - Step 1 결과 경로:

issues/Step-3-Content-Structuring.md

@@ -1,5 +1,20 @@
-목적
+Purpose
-- 원문을 바로 생성하지 않고, 중심 메시지와 보조 정보를 분리해 구조와 우선순위를 확정한다.
+- Separate primary and supporting messages, then confirm structure and priority before generation.
+
+Reference Wiki
+- Home
+- Prompt
+- Wiki-1-1-Kei-Thinking-and-Process
+- Wiki-2-3-Content-Structuring
+- optional: Wiki-3-2-Stage-1A-Topic-Extraction
+- optional: Wiki-3-3-Stage-1B-Concept-Refinement
+
+Reference Artifacts
+- docs/run-xxx/02-kei-interpretation/kei-interpretation.md
+- docs/run-xxx/03-structure/
+
+Optional Code / Scripts
+- scripts/auto_loop_runner.py
 
 입력
 - Step 2 결과 경로:

issues/Step-4-Execution-Planning.md

@@ -1,5 +1,38 @@
-목적
+Purpose
-- 실제 실행을 어떤 stage 순서로 진행할지 정리하고, 검증 및 재시도 기준을 확정한다.
+- Confirm stage order, validation checkpoints, retry rules, and fallback path before execution.
+
+Reference Wiki
+- Home
+- Prompt
+- Wiki-2-4-Execution-Planning
+- Wiki-3-DesignAgent-Detailed-Pipeline-Overview
+- optional: Wiki-3-1-Stage-0-MDX-Normalization
+- optional: Wiki-3-2-Stage-1A-Topic-Extraction
+- optional: Wiki-3-3-Stage-1B-Concept-Refinement
+- optional: Wiki-3-4-Stage-1-5a-Font-Hierarchy-and-Ratio
+- optional: Wiki-3-5-Stage-1-7-Reference-Block-Selection
+- optional: Wiki-3-6-Stage-1-5b-Design-Budget-Recalculation
+- 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/03-structure/content-structure.md
+- docs/run-xxx/04-plan/
+
+Optional Code / Scripts
+- scripts/run_from_artifacts.py
+- scripts/auto_loop_runner.py
+
+
+?? ???
+- docs/run-xxx/03-structure/content-structure.md
+- docs/run-xxx/04-plan/
+
+?? ? ??? ??/????
+- scripts/run_from_artifacts.py
+- scripts/auto_loop_runner.py
 
 입력
 - Step 3 결과 경로:

issues/Step-5-Execution.md

@@ -1,5 +1,32 @@
-목적
+Purpose
-- 계획된 stage를 실제로 실행하고, 검증에 필요한 실행 패키지를 완전하게 남긴다.
+- 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 결과 경로:

issues/Step-6-Validation-and-Recording.md

@@ -1,5 +1,30 @@
-목적
+Purpose
-- 최종 결과가 목적과 제약에 맞는지 검증하고, 다음 반복에서 무엇을 되돌려 수정해야 하는지 명확하게 결정한다.
+- Validate the final output against purpose and constraints, then decide rollback target and next actions.
+
+Reference Wiki
+- Home
+- Prompt
+- Wiki-2-6-Validation-and-Recording
+- Wiki-3-DesignAgent-Detailed-Pipeline-Overview
+- 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/05-execution/final.html
+- docs/run-xxx/05-execution/generated_html.json
+- docs/run-xxx/05-execution/measurement.json
+- docs/run-xxx/05-execution/context.json
+- docs/run-xxx/06-validation/validation-result.md
+
+Optional Code / Scripts
+- scripts/auto_loop_runner.py
+- scripts/run_from_artifacts.py
+
+
+?? ? ??? ??/????
+- scripts/auto_loop_runner.py
+- scripts/run_from_artifacts.py
 
 입력
 - Step 5 결과 경로: