diff --git a/issues/README.md b/issues/README.md index de8b154..843cc75 100644 --- a/issues/README.md +++ b/issues/README.md @@ -1,9 +1,9 @@ -# Issues +# Issues -이 폴더의 파일은 Gitea `이슈` 탭에 붙여 넣기 위한 초안이다. +These files are step-level issue body drafts for the Gitea issue tab. -사용 방법: -1. 새 이슈를 만든다. -2. 파일명에 맞는 제목을 직접 입력한다. -3. 파일 본문 내용을 복사해서 붙여 넣는다. -4. 실제 실행 결과는 이슈 코멘트로 기록한다. +Workflow +1. Read the `Reference Wiki` section first. +2. Then inspect `Reference Artifacts` and optional code/scripts. +3. Record actual execution results as issue comments. +4. Feed Step 6 validation and failure classes into the next loop. diff --git a/issues/Step-1-Input-Review.md b/issues/Step-1-Input-Review.md index ec82756..0080889 100644 --- a/issues/Step-1-Input-Review.md +++ b/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 입력 - 입력 폴더: diff --git a/issues/Step-2-Interpretation.md b/issues/Step-2-Interpretation.md index 892e207..4f9a2a4 100644 --- a/issues/Step-2-Interpretation.md +++ b/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 결과 경로: diff --git a/issues/Step-3-Content-Structuring.md b/issues/Step-3-Content-Structuring.md index 1178cb6..3d30594 100644 --- a/issues/Step-3-Content-Structuring.md +++ b/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 결과 경로: diff --git a/issues/Step-4-Execution-Planning.md b/issues/Step-4-Execution-Planning.md index b0d4468..e8c46c8 100644 --- a/issues/Step-4-Execution-Planning.md +++ b/issues/Step-4-Execution-Planning.md @@ -1,5 +1,38 @@ -목적 -- 실제 실행을 어떤 stage 순서로 진행할지 정리하고, 검증 및 재시도 기준을 확정한다. +Purpose +- 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 결과 경로: diff --git a/issues/Step-5-Execution.md b/issues/Step-5-Execution.md index 60353ae..32e2c35 100644 --- a/issues/Step-5-Execution.md +++ b/issues/Step-5-Execution.md @@ -1,5 +1,32 @@ -목적 -- 계획된 stage를 실제로 실행하고, 검증에 필요한 실행 패키지를 완전하게 남긴다. +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 결과 경로: diff --git a/issues/Step-6-Validation-and-Recording.md b/issues/Step-6-Validation-and-Recording.md index ebeb162..45ffaa9 100644 --- a/issues/Step-6-Validation-and-Recording.md +++ b/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 결과 경로: