Clarify generalized content-family pipeline docs

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

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 선택 이유
 
 ## 중단 조건
 - 입력 파일이 없음

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 선택 원칙을 계속 유지한다.