From 8e4639cc1d10b9980b667c1273f3f389c5734961 Mon Sep 17 00:00:00 2001 From: kyeongmin Date: Tue, 7 Apr 2026 09:25:20 +0900 Subject: [PATCH] Clarify generalized content-family pipeline docs --- Home.md | 4 ++++ Prompt.md | 19 +++++++++++++++++-- README.md | 3 +++ 3 files changed, 24 insertions(+), 2 deletions(-) diff --git a/Home.md b/Home.md index 77ce724..3a36366 100644 --- a/Home.md +++ b/Home.md @@ -3,12 +3,16 @@ 이 인덱스는 Gitea 위키에 올릴 문서의 읽기 순서를 정리한다. 권장 읽기 순서는 `Prompt -> 위키 1 -> 위키 2 -> 위키 3`이다. +이 위키는 특정 샘플 슬라이드 3개를 맞추기 위한 문서가 아니라, **어떤 MDX가 와도 content family를 분류하고 적절한 layout family를 골라 슬라이드로 만드는 파이프라인 기준서**다. + ## 읽기 원칙 - `Prompt`는 실제 실행 지시서다. - 위키 1은 판단 기준이다. - 위키 2는 상위 운영 절차다. - 위키 3은 상세 실행 파이프라인이다. - 실제 입력, 중간 산출물, 검증 결과는 위키가 아니라 이슈와 run 폴더에 남긴다. +- 원문은 가능한 한 많이 보존하고, 큰 표/긴 사례/상세 근거는 popup으로 이동한다. +- family가 다른 문서는 같은 skeleton에 억지로 넣지 않는다. ## Execution - Prompt diff --git a/Prompt.md b/Prompt.md index 68783aa..68d6731 100644 --- a/Prompt.md +++ b/Prompt.md @@ -22,6 +22,14 @@ - 실행 결과를 step별로 평가하고, 결과를 Gitea 이슈 코멘트용 본문으로 작성한다. - 중간 산출물과 최종 결과물을 반드시 저장소 안에 남긴다. - 마지막에 전체 현황, 실패 원인, 다음 수정 우선순위를 정리한다. +- 가장 중요한 목표는 특정 샘플을 맞추는 것이 아니라, 어떤 MDX가 와도 내용에 맞는 slide pipeline을 실행하는 것이다. + +## 절대 원칙 +- 원문은 가능한 한 많이 유지한다. 큰 표, 큰 이미지, 긴 사례를 제외하면 텍스트의 약 85% 이상 보존을 목표로 한다. +- Step 1 ~ Step 3에서 임의 요약, 임의 소제목, 임의 순서 변경을 최소화한다. +- 넘치는 내용은 삭제보다 popup으로 이동한다. +- family가 다른 문서는 같은 layout skeleton에 억지로 넣지 않는다. +- layout은 내용을 바꾸는 수단이 아니라, 내용을 더 잘 보이게 재배치하는 수단이다. ## 읽기 순서 1. `Home` @@ -32,7 +40,7 @@ 6. 필요 시 관련 `Wiki-3-x` 7. 저장소의 `issues/Step-*.md` 8. 저장소의 `docs/run-xxx/` -9. 필요 시 `design_agent` 코드와 `scripts/run_from_artifacts.py` +9. 필요 시 저장소의 `templates/`, `scripts/run_from_artifacts.py`, `scripts/auto_loop_runner.py` ## 실행 순서 ### 1. Run 식별 @@ -42,18 +50,21 @@ ### 2. Step 1 수행 - `Step-1-Input-Review` 이슈 본문과 `Wiki-2-1-Input-Review`를 기준으로 입력을 해석한다. +- 이 단계의 최우선 목표는 요약이 아니라 원문 block, 제목, 순서, 표/이미지/사례 위치를 식별하는 것이다. - 결과를 `docs/run-xxx/01-input/`에 기록하거나 갱신한다. - pass / revise / fail, 실패 분류, 수정 액션을 정리한다. - Gitea 이슈 코멘트용 본문을 작성한다. ### 3. Step 2 수행 - `Step-2-Interpretation` 이슈 본문과 `Wiki-2-2-Kei-Interpretation`을 기준으로 핵심 목적, 의미 보존 기준, 실패 패턴, 검증 기준을 정리한다. +- 이 단계에서는 content family 후보와 popup 후보를 정리한다. - 결과를 `docs/run-xxx/02-kei-interpretation/`에 기록하거나 갱신한다. - pass / revise / fail, 실패 분류, 수정 액션을 정리한다. - Gitea 이슈 코멘트용 본문을 작성한다. ### 4. Step 3 수행 - `Step-3-Content-Structuring` 이슈 본문과 `Wiki-2-3-Content-Structuring`을 기준으로 중심 메시지, 보조 메시지, 섹션 구조, 배치 가정을 정리한다. +- 이 단계에서는 원문 block을 `가시 본문 / popup / 결론`으로 나누고, content family를 확정한다. - 결과를 `docs/run-xxx/03-structure/`에 기록하거나 갱신한다. - pass / revise / fail, 실패 분류, 수정 액션을 정리한다. - Gitea 이슈 코멘트용 본문을 작성한다. @@ -61,13 +72,14 @@ ### 5. Step 4 수행 - `Step-4-Execution-Planning` 이슈 본문과 `Wiki-2-4-Execution-Planning`, 필요한 `Wiki-3` 문서를 기준으로 실행 계획을 수립한다. - Stage별 입력, 출력, 검증 지점을 명확히 적는다. +- family에 맞는 zone/container/layout family를 결정한다. - 필요한 수동 보강 산출물이 있으면 `docs/run-xxx/04-plan/`에 기록하거나 갱신한다. - pass / revise / fail, 실패 분류, 수정 액션을 정리한다. - Gitea 이슈 코멘트용 본문을 작성한다. ### 6. Step 5 수행 - `Step-5-Execution` 이슈 본문과 `Wiki-2-5-Execution`, 필요한 `Wiki-3` 문서를 기준으로 실제 실행한다. -- 가능하면 기존 후반부 코드와 저장소 내 산출물을 사용한다. +- 가능하면 기존 stage 흐름, 템플릿 자산, 저장소 내 산출물을 사용한다. - 결과를 `docs/run-xxx/05-execution/`에 저장한다. - pass / revise / fail, 실패 분류, 수정 액션을 정리한다. - Gitea 이슈 코멘트용 본문을 작성한다. @@ -110,6 +122,9 @@ - 실패 분류 - 수정 액션 - 다음 단계 전달물 +- content family 판정 +- popup으로 이동한 block 요약 +- layout family 선택 이유 ## 중단 조건 - 입력 파일이 없음 diff --git a/README.md b/README.md index c1e004a..cf2aa7c 100644 --- a/README.md +++ b/README.md @@ -6,8 +6,11 @@ - Kei 기준 문서 - design_agent 상위 작업 절차 - design_agent 상세 파이프라인 +- content family / layout family / popup 전략을 포함한 실행 기준서 ## 운영 원칙 - 위키는 실행 기준서다. - 위키에는 이번 작업의 개별 결과를 적지 않는다. - 개별 결과는 이슈와 run 폴더에 남긴다. +- 위키는 특정 샘플 3개용 설명서가 아니라, 임의의 MDX를 처리하기 위한 일반 파이프라인 기준서다. +- 원문 85% 보존, popup 이동, content family 분류, layout family 선택 원칙을 계속 유지한다.