# Phase J: 블록 선택 권한 구조 재정의 + 최종 검토 Kei 전환 > 상태: ✅ 완료 — Phase N에서 코드 레벨 강제로 강화, Phase O에서 Step B 자체를 제거. > > Phase I 실행 후 결과물 3회 비교에서 확인된 근본 문제. > **핵심: Sonnet(팀장)이 Opus(실장) 추천을 엎고, 자기가 만든 문제를 자기가 검토하는 구조.** > 해결: 블록 선택 권한을 실장에게, 최종 검토를 Kei에게. > > **후속 변경:** > - Phase N: 프롬프트 "존중" → 코드 레벨 강제 (kei_confirmed_blocks 덮어쓰기) > - Phase O: Step B(Sonnet) 자체를 제거. Kei(A-2) + 코드로 직접 layout 생성. STEP_B_PROMPT 삭제. --- ## 문제 진단 (7건) ### J-1: Sonnet(팀장)이 Opus(실장) 추천을 엎음 **현상:** - Opus 추천: 6개 블록 (quote-big-mark, card-tag-image x2, topic-left-right, compare-2col-split, banner-gradient) - Sonnet 실제: `section-header-bar` 추가 (Opus 추천에 없음), `card-tag-image` → `card-icon-desc` 교체 - 3번 실행 모두 동일 — Sonnet이 일관되게 Opus를 무시 **원인:** STEP_B_PROMPT에 "Opus 추천이 있으면 **참고**하되, **최종 선택은 팀장 판단**"이라고 명시 → Sonnet이 자유롭게 변경 --- ### J-2: section-header-bar가 body에 들어가서 제목 3중 중복 **현상:** - header zone: "건설산업 DX의 올바른 이해" (slide-title) - body 첫 블록: "건설산업 DX의 올바른 이해" (section-header-bar) - HTML title: "건설산업 DX의 올바른 이해" **원인:** Sonnet이 Opus 추천에 없는 `section-header-bar`를 자체 판단으로 추가. body에 section-header-bar를 넣으면 안 되는 규칙이 없음. **영향:** body 높이 +70px 초과의 직접 원인 (600px > 490px) --- ### J-3: card-icon-desc(이모지 블록)가 용어 정의에 사용됨 **현상:** sidebar에 🏗️📐🔄🎯 이모지 카드 → 비즈니스 기획서에 부적절 **원인 체인:** 1. STEP_B_PROMPT purpose 가이드: `용어정의 → card-icon-desc (정의+출처)` ← 이모지 블록 추천 2. catalog.yaml keyword-circle-row not_for: `용어 정의 → card-icon-desc 사용` ← catalog도 추천 3. Sonnet이 두 가이드를 따라 card-icon-desc 선택 4. card-icon-desc 템플릿의 icon 슬롯이 이모지 사용 구조 --- ### J-4: quote-big-mark의 source에 출처 대신 꼭지 제목 **현상:** `
— 용어의 혼용
` — 출처가 아닌 꼭지 주제 **원인:** slot_desc에 "출처 (예: 국토교통부, 2024). 꼭지 제목이 아님!"이라고 명시했으나 Kei 편집자가 무시. 3번 실행 모두 동일. --- ### J-5: body 높이 600px > 490px — 매번 초과 **현상:** section-header-bar(70) + quote-big-mark(150) + topic-left-right(70) + compare-2col-split(250) + gap(60) = 600px **원인:** J-2(section-header-bar 불필요 추가)의 직접 결과. 제거하면 530px → 여전히 초과지만 110px → 40px으로 대폭 개선. --- ### J-6: sidebar에 3열/4열 카드가 35% 너비에 들어감 **현상:** - card-tag-image: `--ct-count: 3` (3열) → 35% sidebar에서 읽을 수 없음 - card-icon-desc: `--ci-count: 4` (4열) → 더 읽을 수 없음 **원인:** STEP_B_PROMPT에 "sidebar에는 카드 1열"이라고 했지만 Sonnet이 3열/4열 그대로 선택. 또한 블록 자체가 열 수를 데이터에서 결정하는 구조라 Sonnet의 char_guide로 제어 불가. --- ### J-7: Stage 5 재검토(팀장)가 실질적으로 무의미 **현상:** - 매번 2회 루프 다 돌고 "최대 재조정 횟수 도달. 현재 결과로 확정" - overflow 감지는 하지만 해결 못함 - body 600px > 490px 초과인 채로 확정 **원인:** Sonnet이 자기가 만든 문제를 자기가 검토 → 같은 판단 기준으로 같은 결론. 구조적 문제(잘못된 블록 선택)는 shrink/expand로 해결 불가. --- ## 근본 원인 분석 ``` Sonnet(팀장)에게 너무 많은 권한: ├ 블록 선택 권한 → Opus 추천을 무시하고 자기 판단 ├ 블록 추가 권한 → 불필요한 section-header-bar 추가 ├ 최종 검토 권한 → 자기 결과를 자기가 검토 (무의미) └ purpose 가이드 + catalog이 잘못된 블록 추천 → Sonnet이 따름 실장(Kei/Opus)이 할 수 있는데 안 하는 것: ├ 블록 최종 선택 → Opus가 추천했는데 "참고"로만 전달 ├ 최종 검토 → Kei가 콘텐츠 중요도를 알지만 검토 기회 없음 └ sidebar 열 수 판단 → Kei가 콘텐츠 양을 알지만 반영 안 됨 ``` --- ## 해결 방향 ### 1. 블록 선택: 실장(Opus) 확정, 팀장(Sonnet)은 존중 **현재:** "Opus 추천 **참고**, 최종 선택은 **팀장 판단**" **변경:** "Opus 추천 블록을 **기본 채택**. 팀장은 **명확한 높이 초과 사유** 없이 변경 금지" ``` STEP_B_PROMPT 변경: 현재: "Opus 추천이 있으면 참고하되, 최종 선택은 팀장 판단." 변경: "Opus 추천 블록을 기본 사용한다. 높이 예산 초과 등 명확한 사유가 없으면 변경하지 마라. 변경 시 반드시 reason에 Opus 추천과 다른 이유를 명시하라." ``` ### 2. purpose 가이드 + catalog 수정 **STEP_B_PROMPT purpose 가이드:** ``` 현재: 용어정의 → card-icon-desc (정의+출처), card-numbered (순서 있으면) 변경: 용어정의 → card-numbered (정의 나열), dark-bullet-list (핵심 포인트) ``` **catalog.yaml:** ``` 현재: keyword-circle-row not_for: "용어 정의 → card-icon-desc 사용" 변경: keyword-circle-row not_for: "용어 정의 → card-numbered 사용" ``` ### 3. section-header-bar body 사용 금지 body zone에서 section-header-bar 사용을 코드 레벨에서 금지. header zone에 이미 slide-title이 있으므로 body에 중복 제목 블록은 불필요. ```python # BODY_FORBIDDEN_MAP에 추가 BODY_FORBIDDEN_MAP = { "section-title-with-bg": "topic-center", "section-header-bar": None, # body에서 사용 시 제거 (교체 아닌 삭제) } ``` ### 4. sidebar 열 수 강제 sidebar(35% 너비)에 배치되는 카드 블록은 `--ct-count: 1`, `--ci-count: 1`로 강제. ```python # renderer.py 또는 design_director.py에서 if block.get("area") == "sidebar": # 카드 블록의 열 수를 1로 강제 if block_type in ("card-tag-image", "card-icon-desc", "card-image-3col", ...): block["data"]["column_count"] = 1 ``` ### 5. Stage 5 최종 검토: Sonnet → Kei **현재:** Sonnet이 검토 → 자기 결과를 자기가 검토 (무의미) **변경:** Kei(Opus)가 최종 검토 → 콘텐츠 중요도 기반 판단 ``` Stage 5 변경: 현재: _review_balance() → Sonnet이 HTML 보고 판단 변경: _review_balance_kei() → Kei API로 HTML + 블록 데이터 보내서 판단 Kei가 검토하는 항목: 1. 콘텐츠 흐름이 맞는가 (오해→사례→정의→관계→결론) 2. 각 블록이 해당 콘텐츠에 적합한가 3. 중요한 내용이 빠지거나 축소되지 않았는가 4. 높이 초과 시: trim/restructure 판단 (이미 I-9에서 구현한 것 재사용) ``` ### 6. source 슬롯 편집자 강화 slot_desc만으로 부족. 편집자 프롬프트에 **금지 규칙** 직접 추가: ``` EDITOR_PROMPT 추가: "## source 슬롯 규칙 (절대 규칙) - source 슬롯에는 반드시 정보원(출처)을 넣는다 - 꼭지 제목, 주제어, 섹션명을 source에 넣지 마라 - 출처가 원본에 없으면 source 슬롯을 비워라 (빈 문자열) - 올바른 예: '국토교통부, 2020', 'IBM, 2011' - 잘못된 예: '용어의 혼용', 'DX와 BIM 개념'" ``` --- ## 실행 항목 총괄 | # | 항목 | 파일 | 변경 성격 | |---|------|------|----------| | J-1 | STEP_B_PROMPT "Opus 추천 존중" 규칙 강화 | design_director.py | 프롬프트 수정 | | J-2 | section-header-bar body 사용 금지 | design_director.py | BODY_FORBIDDEN_MAP 추가 | | J-3a | purpose 가이드 용어정의 매핑 수정 | design_director.py | 프롬프트 수정 | | J-3b | catalog.yaml 용어정의 안내 수정 | catalog.yaml | not_for 수정 | | J-4 | source 슬롯 금지 규칙 추가 | content_editor.py | EDITOR_PROMPT 수정 | | J-5 | (J-2 해결로 자동 개선) | — | — | | J-6 | sidebar 카드 열 수 1열 강제 | design_director.py 또는 renderer.py | 코드 추가 | | J-7 | Stage 5 최종 검토 Kei 전환 | pipeline.py + kei_client.py | 핵심 구조 변경 | --- ## 실행 순서 ### Phase J-A: 팀장 권한 제한 (즉시) 1. J-1: STEP_B_PROMPT Opus 존중 규칙 2. J-2: section-header-bar body 금지 3. J-3a: purpose 가이드 수정 4. J-3b: catalog.yaml 수정 5. J-6: sidebar 1열 강제 ### Phase J-B: 편집자 강화 6. J-4: source 슬롯 금지 규칙 ### Phase J-C: 최종 검토 Kei 전환 (핵심) 7. J-7: Stage 5 _review_balance() → Kei API 호출로 전환 --- ## 예상 효과 | 문제 | 해결 방안 | 효과 | |------|----------|------| | 제목 3중 중복 | section-header-bar body 금지 | **제거** | | 이모지 블록 | purpose 가이드 수정 + Opus 존중 | **card-numbered로 교체** | | source 오입력 | 편집자 금지 규칙 | **출처 또는 빈칸** | | body 높이 초과 | section-header-bar 제거 → -70px | **대폭 개선** | | sidebar 다열 | 1열 강제 | **가독성 확보** | | 재검토 무의미 | Kei가 검토 | **콘텐츠 기반 실질 검토** | --- ## 검증 매트릭스 | 항목 | Kei API | Sonnet | 하드코딩 | 회귀 | |------|---------|--------|---------|------| | J-1 | — | 프롬프트 수정 | 없음 | 없음 | | J-2 | — | — | BODY_FORBIDDEN_MAP 상수 | 없음 | | J-3 | — | 프롬프트 수정 | 없음 | 없음 | | J-4 | — | — | 없음 (프롬프트) | 없음 | | J-6 | — | — | 코드 규칙 | 없음 | | J-7 | **Kei** (신규 검토) | 제거 | 없음 | Stage 5 구조 변경 | --- ## 구현 상세 (기술 조사 + 충돌 검토 반영) ### J-1: STEP_B_PROMPT Opus 존중 규칙 **위치:** `design_director.py` 743~744행 (user_prompt) **현재:** ```python f"Opus 추천이 있으면 참고하되, 최종 선택은 팀장 판단.\n" ``` **변경:** ```python f"Opus 추천 블록을 기본 사용한다. 높이 초과 등 명확한 사유 없이 변경하지 마라. 변경 시 reason에 사유를 반드시 명시하라.\n" ``` **충돌:** 없음. 문자열 1행 교체. --- ### J-2: section-header-bar body 금지 **위치:** `design_director.py` 898행 (BODY_FORBIDDEN_MAP) + 957~966행 (교체 로직) **BODY_FORBIDDEN_MAP 변경:** ```python BODY_FORBIDDEN_MAP = { "section-title-with-bg": "topic-center", "section-header-bar": None, # body에서 제거 (교체 아닌 삭제) } ``` **교체 로직 변경 (957~966행):** `None`이면 삭제 처리. 루프 중 리스트 수정 방지를 위해 별도 필터링. ```python # 금지 블록 처리 (교체 또는 삭제) blocks_to_remove = [] for block in blocks: area = block.get("area", "body") block_type = block.get("type", "") if area != "header" and block_type in BODY_FORBIDDEN_MAP: replacement = BODY_FORBIDDEN_MAP[block_type] if replacement is None: blocks_to_remove.append(block) logger.warning(f"[금지 블록 삭제] {block_type} (area={area})") else: block["type"] = replacement logger.warning(f"[금지 블록 교체] {block_type} → {replacement} (area={area})") for block in blocks_to_remove: blocks.remove(block) ``` **충돌 주의:** 루프 중 리스트 삭제 → 별도 `blocks_to_remove` 리스트로 해결. **zone_blocks 재구성 필요:** 삭제 후 zone_blocks도 갱신해야 후속 pill-pair/높이 체크가 정확. --- ### J-3a: purpose 가이드 수정 **위치:** `design_director.py` 504행, 506행 ``` 504행 현재: "- 근거사례 → quote-big-mark (출처 포함), card-icon-desc (항목 나열)" 504행 변경: "- 근거사례 → quote-big-mark (출처 포함), card-numbered (항목 나열)" 506행 현재: "- 용어정의 → card-icon-desc (정의+출처), card-numbered (순서 있으면)" 506행 변경: "- 용어정의 → card-numbered (정의 나열), dark-bullet-list (핵심 포인트)" ``` **PURPOSE_FALLBACK도 수정 (884~894행):** ```python 현재: "용어정의": "card-icon-desc", 변경: "용어정의": "card-numbered", ``` **회귀 체크:** I-1에서 미존재 블록 제거 목적으로 수정. J-3a는 부적절 블록 교체 목적. 방향이 다르므로 회귀 아님. --- ### J-3b: catalog.yaml 수정 **위치:** `catalog.yaml` 376행 ``` 현재: not_for: '아이콘+설명 → card-icon-desc 사용. 용어 정의 → card-icon-desc 사용.' 변경: not_for: '아이콘+설명 → card-icon-desc 사용. 용어 정의 → card-numbered 사용.' ``` --- ### J-4: source 슬롯 금지 규칙 **위치:** `content_editor.py` EDITOR_PROMPT (55행 이전) **추가 위치:** 기존 `## JSON 형식으로만 응답한다.` 바로 앞에 삽입 ```python "## source 슬롯 규칙 (절대 규칙)\n" "- source 슬롯에는 반드시 정보원(출처)을 넣는다\n" "- 꼭지 제목, 주제어, 섹션명을 source에 넣지 마라\n" "- 출처가 원본에 없으면 source 슬롯을 비워라 (빈 문자열)\n" "- 올바른 예: '국토교통부, 2020', 'IBM, 2011'\n" "- 잘못된 예: '용어의 혼용', 'DX와 BIM 개념'\n\n" ``` **Kei vs Sonnet:** 이 프롬프트는 Kei API(편집자, session_id: `design-agent-editor`)에 전달됨. Sonnet 아님. --- ### J-6: sidebar 1열 강제 **방법:** 템플릿에 `column_override` 지원 추가 + design_director에서 sidebar 블록에 값 주입 **템플릿 변경 (2개):** `card-tag-image.html` 9행: ```html 현재:
변경:
``` `card-icon-desc.html` 9행: ```html 현재:
변경:
``` **design_director.py — sidebar 블록에 column_override 주입:** `_validate_height_budget()` 함수 내, 금지 블록 처리 이후에 삽입: ```python # sidebar 카드 블록 1열 강제 (J-6) CARD_BLOCKS = { "card-tag-image", "card-icon-desc", "card-image-3col", "card-dark-overlay", "card-compare-3col", "card-image-round", "card-stat-number", } for block in blocks: if block.get("area") == "sidebar" and block.get("type") in CARD_BLOCKS: if "data" not in block: block["data"] = {} block["data"]["column_override"] = 1 ``` **충돌:** 없음. `column_override`는 새 키. `default(cards|length)`로 body에서는 기존대로. **회귀:** 없음. 기존 렌더링 동작 변경 없음. --- ### J-7: Stage 5 최종 검토 Kei 전환 **방법:** `kei_client.py`에 `call_kei_final_review()` 신규 함수 추가 + `pipeline.py`에서 호출 **kei_client.py 신규 함수:** ```python KEI_REVIEW_PROMPT = """당신은 11년 경력의 기획 실장이다. 디자인 팀장이 조립한 슬라이드를 최종 검수한다. ## 검수 관점 1. 핵심 메시지(core_message)가 시각적으로 명확히 전달되는가? 2. 콘텐츠 흐름(문제제기→사례→정의→관계→결론)이 블록 배치와 일치하는가? 3. 각 블록이 해당 꼭지의 purpose에 적합한가? 4. 중요한 내용이 빠지거나 과도하게 축소되지 않았는가? 5. 높이 초과: 각 zone의 블록+텍스트가 예산을 초과하는가? - 텍스트 축약으로 해결 가능 → shrink - 콘텐츠가 본질적으로 큼 → overflow_detected ## 조정 action - expand: 텍스트 늘림 (target_ratio, 예: 1.3) - shrink: 텍스트 줄임 (target_ratio, 예: 0.7) - rewrite: 텍스트 재작성 (detail에 방향) - overflow_detected: 높이 초과, 콘텐츠 판단 필요 (zone과 블록 명시) ## 출력 (JSON만) {"needs_adjustment": true/false, "issues": ["이슈1"], "adjustments": [{"block_area": "...", "action": "...", "target_ratio": 1.3, "detail": "..."}]} """ async def call_kei_final_review( html: str, block_summary: list[str], zone_budget_text: str, overflow_hint_text: str, analysis: dict[str, Any], ) -> dict[str, Any] | None: """Kei(Opus)가 최종 검수한다. 반드시 Kei API 경유. Sonnet 사용 절대 금지. session_id: design-agent-final-review """ kei_url = getattr(settings, "kei_api_url", "http://localhost:8000") core_message = analysis.get("core_message", "") if analysis else "" topics_summary = "" if analysis: topics_summary = "\n".join( f"- 꼭지 {t.get('id')}: {t.get('title', '')} [{t.get('purpose', '')}]" for t in analysis.get("topics", []) ) prompt = ( KEI_REVIEW_PROMPT + "\n\n" f"## 핵심 메시지\n{core_message}\n\n" f"## 꼭지 목록\n{topics_summary}\n\n" f"## 블록별 데이터 양\n" + "\n".join(block_summary) + zone_budget_text + overflow_hint_text + f"\n\n## 조립 HTML (요약)\n{html[:3000]}\n\n" f"위 결과물을 검수하고 조정이 필요한지 판단해. JSON만." ) try: async with httpx.AsyncClient(timeout=None) as client: async with client.stream( "POST", f"{kei_url}/api/message", json={ "message": prompt, "session_id": "design-agent-final-review", "mode_hint": "chat", }, timeout=None, ) as response: if response.status_code != 200: logger.warning(f"Kei 최종 검수 HTTP {response.status_code}") return None full_text = await stream_sse_tokens(response) if full_text: result = _parse_json(full_text) if result and "needs_adjustment" in result: logger.info(f"[Kei 최종 검수] needs_adjustment={result['needs_adjustment']}") return result return None except Exception as e: logger.warning(f"Kei 최종 검수 실패: {e}") return None ``` **pipeline.py 변경:** - import: `from src.kei_client import ... call_kei_final_review` - `_review_balance()` 내부: Sonnet API 호출 → `call_kei_final_review()` 호출로 교체 - 기존 `block_summary`, `zone_budget_text`, `overflow_hint_text` 구성 로직은 유지 (pipeline에 남음) - `anthropic.AsyncAnthropic` + `client.messages.create` 코드 제거 - `import anthropic`은 Stage 4(`_adjust_design`)에서 아직 사용하므로 유지 **출력 스키마:** 기존과 100% 동일 → `_apply_adjustments()`, `_convert_kei_judgment()` 변경 불필요. **overflow 처리:** 기존 Stage 5 루프의 overflow_detected → Kei overflow 호출 흐름 그대로 유지. --- ## 실행 프로세스 (의존 관계 + 순서) ``` Phase J-A: 팀장 권한 제한 + 가이드 수정 ├── J-1: STEP_B_PROMPT Opus 존중 규칙 (design_director.py 744행) ├── J-2: section-header-bar body 금지 (BODY_FORBIDDEN_MAP + 교체 로직) ├── J-3a: purpose 가이드 수정 (504, 506행 + PURPOSE_FALLBACK) ├── J-3b: catalog.yaml 수정 (376행) └── J-6: sidebar 1열 강제 (템플릿 2개 + design_director 주입) ↓ (J-A 완료 후) Phase J-B: 편집자 강화 └── J-4: source 슬롯 금지 규칙 (EDITOR_PROMPT) ↓ (J-B 완료 후) Phase J-C: 최종 검토 Kei 전환 └── J-7: call_kei_final_review() 신규 + pipeline Stage 5 교체 ↓ 검증: import + 서버 기동 + 결과물 비교 ``` ### Phase J-A 내부 의존 관계 - J-2는 `_validate_height_budget()` 수정 → J-6도 같은 함수 안에 삽입 → **J-2 먼저, J-6 이후** - J-1, J-3a, J-3b는 서로 독립 → 순서 무관 ### Phase J-C 의존 - J-7은 J-A/J-B와 독립이지만, **J-A 수정된 결과물로 검증해야 의미** → J-A/J-B 완료 후 실행 --- ## 변경 파일 총괄 | 파일 | 항목 | 변경 성격 | |------|------|----------| | `src/design_director.py` | J-1, J-2, J-3a, J-6 | 프롬프트 + BODY_FORBIDDEN_MAP + PURPOSE_FALLBACK + sidebar column_override | | `src/content_editor.py` | J-4 | EDITOR_PROMPT에 source 규칙 추가 | | `src/kei_client.py` | J-7 | KEI_REVIEW_PROMPT + call_kei_final_review() 신규 | | `src/pipeline.py` | J-7 | _review_balance() 내부 Sonnet → Kei 교체 + import 추가 | | `templates/catalog.yaml` | J-3b | not_for 1건 수정 | | `templates/blocks/cards/card-tag-image.html` | J-6 | column_override 지원 | | `templates/blocks/cards/card-icon-desc.html` | J-6 | column_override 지원 | --- ## 충돌/회귀/오류 최종 검증 | 항목 | 충돌 | 회귀 | Kei/Sonnet | 하드코딩 | 단발성 | 주의 사항 | |------|:---:|:---:|:----------:|:------:|:-----:|----------| | J-1 | 없음 | 없음 | Sonnet(기존) | 없음 | 아님 | — | | J-2 | **주의** | 없음 | — | 상수 | 아님 | 루프 중 삭제 → 별도 필터링 + zone_blocks 재구성 | | J-3a | 없음 | I-1과 다른 목적 | Sonnet(기존) | 없음 | 아님 | PURPOSE_FALLBACK도 같이 수정 | | J-3b | 없음 | I-2와 다른 목적 | — | 없음 | 아님 | — | | J-4 | 없음 | I-5와 보완 | **Kei**(편집자) | 없음 | 아님 | — | | J-6 | **주의** | 없음 | — | 범용 키 | 아님 | 템플릿 2개 수정 + data 주입 | | J-7 | **주의** | 프로세스 재설계 유지 | **Kei**(신규) | 없음 | 아님 | pipeline import + Sonnet 코드 제거 | **Sonnet 신규 투입: 0건** **Kei API 사용: J-4(기존 편집자), J-7(신규 최종 검수)** **하드코딩: 0건** **회귀: 0건** **단발성: 0건** --- ## 실행 결과 상세 ### Phase J-A: 팀장 권한 제한 + 가이드 수정 (5개) ✅ | 항목 | 파일 | 반영 내용 | |------|------|----------| | J-1 | `src/design_director.py` 744행 | `"Opus 추천이 있으면 참고하되, 최종 선택은 팀장 판단"` → `"Opus 추천 블록을 기본 사용한다. 높이 초과 등 명확한 사유 없이 변경하지 마라. 변경 시 reason에 사유를 반드시 명시하라."` | | J-2 | `src/design_director.py` 899행 | `BODY_FORBIDDEN_MAP`에 `"section-header-bar": None` 추가. 금지 블록 처리 로직 변경: `None`이면 교체가 아닌 삭제. `blocks_to_remove` 별도 리스트로 루프 중 삭제 안전 처리. 삭제 후 `zone_blocks` 재구성 추가. | | J-3a | `src/design_director.py` 504행, 506행 | purpose 가이드: `근거사례 → card-icon-desc` → `card-numbered`, `용어정의 → card-icon-desc` → `card-numbered, dark-bullet-list`. `PURPOSE_FALLBACK` 892행: `"용어정의": "card-icon-desc"` → `"card-numbered"` | | J-3b | `templates/catalog.yaml` 376행 | `not_for: '용어 정의 → card-icon-desc 사용'` → `'용어 정의 → card-numbered 사용'` | | J-6 | `templates/blocks/cards/card-tag-image.html` 9행 | `--ct-count: {{ cards\|length }}` → `--ct-count: {{ column_override \| default(cards\|length) }}` | | J-6 | `templates/blocks/cards/card-icon-desc.html` 9행 | `--ci-count: {{ cards\|length }}` → `--ci-count: {{ column_override \| default(cards\|length) }}` | | J-6 | `src/design_director.py` `_validate_height_budget()` 내 | sidebar 카드 블록에 `block["data"]["column_override"] = 1` 주입. CARD_BLOCKS 상수로 대상 블록 정의. | ### Phase J-B: 편집자 강화 (1개) ✅ | 항목 | 파일 | 반영 내용 | |------|------|----------| | J-4 | `src/content_editor.py` EDITOR_PROMPT | `## source 슬롯 규칙 (절대 규칙)` 섹션 추가. 출처만 허용, 꼭지 제목/주제어 금지, 없으면 빈 문자열. 올바른/잘못된 예시 포함. Kei API(편집자)에 전달됨. | ### Phase J-C: 최종 검토 Kei 전환 (1개) ✅ | 항목 | 파일 | 반영 내용 | |------|------|----------| | J-7 | `src/kei_client.py` | `KEI_REVIEW_PROMPT` 상수 신규: 11년 경력 기획 실장 관점, 핵심 메시지 전달/콘텐츠 흐름/purpose 적합성/높이 초과 검수. `call_kei_final_review()` 함수 신규: session_id `"design-agent-final-review"`, Kei API SSE 스트리밍, 출력 스키마 기존과 100% 동일. | | J-7 | `src/pipeline.py` import | `call_kei_final_review` import 추가 | | J-7 | `src/pipeline.py` `_review_balance()` | Sonnet API(`anthropic.AsyncAnthropic` + `client.messages.create`) 코드 제거. `call_kei_final_review(html, block_summary, zone_budget_text, overflow_hint_text, analysis)` 호출로 교체. block_summary/zone_budget_text/overflow_hint_text 구성 로직은 pipeline에 유지. | --- ## 검증 체크리스트 (실행 완료) ### 팀장 권한 제한 - [x] J-1: STEP_B_PROMPT에 "Opus 추천 기본 사용, 변경 금지" 명시 - [x] J-2: BODY_FORBIDDEN_MAP에 section-header-bar: None. 삭제 로직 + zone_blocks 재구성 - [x] J-3a: purpose 가이드 용어정의/근거사례에서 card-icon-desc 제거 → card-numbered - [x] J-3a: PURPOSE_FALLBACK 용어정의 → card-numbered - [x] J-3b: catalog.yaml "용어 정의 → card-numbered" - [x] J-6: 템플릿 2개 column_override 지원 + sidebar 블록에 column_override=1 주입 ### 편집자 강화 - [x] J-4: EDITOR_PROMPT에 source 슬롯 금지 규칙 추가 (Kei API 편집자 경유) ### 최종 검토 Kei 전환 - [x] J-7: call_kei_final_review() 함수 신규 (kei_client.py) - [x] J-7: _review_balance() → Sonnet 코드 제거, Kei API 호출로 교체 - [x] J-7: Stage 5에 Sonnet 모델 참조 0건 확인 ### 기술 검증 - [x] 모든 모듈 import 성공 - [x] FastAPI 앱 로드 성공 (8 routes) - [x] BLOCK_SLOTS 38/38, slot_desc 38/38 (Phase I 회귀 없음) - [x] BODY_FORBIDDEN_MAP: section-header-bar=None 확인 - [x] PURPOSE_FALLBACK 용어정의=card-numbered 확인 ### 절대 규칙 준수 - [x] Sonnet 신규 투입 0건 — Stage 5가 Kei API만 사용 - [x] 하드코딩 0건 - [x] 단발성 수정 0건 - [x] Phase I 회귀 0건 - [x] persona_agent 수정 0건 --- ## 이력 | 날짜 | 내용 | |------|------| | 2026-03-26 | Phase I 완료 후 결과물 3회 비교. 7개 문제 진단. Phase J 계획 수립. | | 2026-03-26 | 기술 조사 + 충돌/회귀/오류 검토 완료. 구현 상세 + 실행 프로세스 확정. | | 2026-03-26 | **Phase J 실행 완료.** 7개 항목 전수 구현. 검증 전항목 통과. Stage 5 Kei 전환 확인. |