C.E.L_Slide_test2/IMPROVEMENT-PHASE-J.md

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에 출처 대신 꼭지 제목

현상: <div class="qb-source">— 용어의 혼용</div> — 출처가 아닌 꼭지 주제

원인: 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에 중복 제목 블록은 불필요.

# 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로 강제.

# 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)

현재:

f"Opus 추천이 있으면 참고하되, 최종 선택은 팀장 판단.\n"

변경:

f"Opus 추천 블록을 기본 사용한다. 높이 초과 등 명확한 사유 없이 변경하지 마라. 변경 시 reason에 사유를 반드시 명시하라.\n"

충돌: 없음. 문자열 1행 교체.

---

J-2: section-header-bar body 금지

위치: design_director.py 898행 (BODY_FORBIDDEN_MAP) + 957~966행 (교체 로직)

BODY_FORBIDDEN_MAP 변경:

BODY_FORBIDDEN_MAP = {
    "section-title-with-bg": "topic-center",
    "section-header-bar": None,  # body에서 제거 (교체 아닌 삭제)
}

교체 로직 변경 (957~966행): None이면 삭제 처리. 루프 중 리스트 수정 방지를 위해 별도 필터링.

# 금지 블록 처리 (교체 또는 삭제)
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행):

현재: "용어정의": "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 형식으로만 응답한다. 바로 앞에 삽입

"## 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행:

현재: <div class="block-card-tag" style="--ct-count: {{ cards|length }}">
변경: <div class="block-card-tag" style="--ct-count: {{ column_override | default(cards|length) }}">

card-icon-desc.html 9행:

현재: <div class="block-card-icon" style="--ci-count: {{ cards|length }}">
변경: <div class="block-card-icon" style="--ci-count: {{ column_override | default(cards|length) }}">

design_director.py — sidebar 블록에 column_override 주입: _validate_height_budget() 함수 내, 금지 블록 처리 이후에 삽입:

# 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 신규 함수:

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에 유지.

---

검증 체크리스트 (실행 완료)

팀장 권한 제한

• J-1: STEP_B_PROMPT에 "Opus 추천 기본 사용, 변경 금지" 명시
• J-2: BODY_FORBIDDEN_MAP에 section-header-bar: None. 삭제 로직 + zone_blocks 재구성
• J-3a: purpose 가이드 용어정의/근거사례에서 card-icon-desc 제거 → card-numbered
• J-3a: PURPOSE_FALLBACK 용어정의 → card-numbered
• J-3b: catalog.yaml "용어 정의 → card-numbered"
• J-6: 템플릿 2개 column_override 지원 + sidebar 블록에 column_override=1 주입

편집자 강화

• J-4: EDITOR_PROMPT에 source 슬롯 금지 규칙 추가 (Kei API 편집자 경유)

최종 검토 Kei 전환

• J-7: call_kei_final_review() 함수 신규 (kei_client.py)
• J-7: _review_balance() → Sonnet 코드 제거, Kei API 호출로 교체
• J-7: Stage 5에 Sonnet 모델 참조 0건 확인

기술 검증

• 모든 모듈 import 성공
• FastAPI 앱 로드 성공 (8 routes)
• BLOCK_SLOTS 38/38, slot_desc 38/38 (Phase I 회귀 없음)
• BODY_FORBIDDEN_MAP: section-header-bar=None 확인
• PURPOSE_FALLBACK 용어정의=card-numbered 확인

절대 규칙 준수

• Sonnet 신규 투입 0건 — Stage 5가 Kei API만 사용
• 하드코딩 0건
• 단발성 수정 0건
• Phase I 회귀 0건
• persona_agent 수정 0건

---

이력

날짜	내용
2026-03-26	Phase I 완료 후 결과물 3회 비교. 7개 문제 진단. Phase J 계획 수립.
2026-03-26	기술 조사 + 충돌/회귀/오류 검토 완료. 구현 상세 + 실행 프로세스 확정.
2026-03-26	Phase J 실행 완료. 7개 항목 전수 구현. 검증 전항목 통과. Stage 5 Kei 전환 확인.