# Implementation Plan — SLIDE.md 특강 자료 보완 (Rev.4 / Job 5874d3da)

> **Rev.4 변경 요약 (Creator 이의제기 반영, Challenge Report 91a2e3e9)**
> Rev.3 Step 2의 "사본에만 안내 주석 추가 + 검증 기준 완화" 방식을 폐기하고 **대안 A(양쪽 파일에 완전히 동일한 공통 주석 삽입)**를 채택했다.
> - 근거 1 — 동기화 유실: 본 저장소의 동기화 원칙은 `cp SLIDE.md paper_draft/SLIDE.md` 단순 복사이므로, 사본에만 존재하는 주석은 다음 동기화에서 즉시 덮어씌워져 소실된다.
> - 근거 2 — 검증 단순성: "주석 1줄 제외 동일" 기준은 단순 `diff`/hash 비교를 깨뜨려 커스텀 비교 로직을 강요한다. 공통 주석이면 100% 바이트 동일성이 유지되어 `diff -q` 한 줄로 검증이 끝난다.
> - 이에 따라 Step 2와 완료 기준 2번을 갱신했다. 그 외 항목은 Rev.3과 동일하다.

> **Rev.3 요지 (유지)**: 본 태스크의 주 목표는 이미 달성되어 리뷰까지 통과했다(Job 1cafc914, [VERDICT: PASS], 완료 기준 9/9 충족). 본 리비전은 재작업 계획이 아니라 **(A) 달성 상태의 기록**과 **(B) 리뷰에서 지적된 비차단 후속 조치 2건 + 마무리(커밋)**만을 범위로 한다. SLIDE.md 본문 구조에 대한 추가 변경은 계획하지 않으며, Worker는 아래 Step 1~3만 수행하면 된다.

## 1. 목표 및 달성 현황

원 목표: `assets/slides/lecture_summary.md`의 흐름(5개 구성 항목)에 맞춘 `SLIDE.md` 보완.

| 항목 | 상태 |
|---|---|
| 1. AI 에이전트 구현 3대 핵심 엔지니어링 기법 (프롬프트/컨텍스트/하네스) | ✅ 완료 (§1 신규 작성) |
| 2. AI Agent 기능 확장: MCP & SKILL | ✅ 완료 (MCP §2 재배치 + Host-Client-Server/3대 요소 보강) |
| 3. 멀티 에이전트 협업 체계/인프라 (TMUX·crewAI·LangGraph) | ✅ 완료 (TMUX 신규, What We Need?를 §3 마감 브릿지로 배치 — Challenge 91a08208 반영) |
| 4. ACP, A2A 표준 | ✅ 완료 (표준 필요성 도입부 + 요구사항 1·2 콜백) |
| 5. AIoT 및 gRPC 기술 동향 | ✅ 완료 (AIoT 도입부, 요구사항 4·5 콜백, 기술 동향 요약 신규) |
| 최종 요약 슬라이드, marp title 갱신, paper_draft 동기화 | ✅ 완료 |

리뷰(Job 1cafc914) 검증 완료: 5개 장 순서 일치, 콘텐츠 유실 없음, 사실관계 일치, 이미지 자산 13개 실존, 두 SLIDE.md 사본 동일.

## 2. 잔여 작업 (Worker 지시사항)

### Step 1 — `.gitignore`의 `scripts/` 패턴 수정 (리뷰 발견 1)
- 현재 `.gitignore`에 `scripts/` 패턴이 있으나 `scripts/notify_mattermost.py`는 직전 커밋(9e4f286)에서 의도적으로 추가된 **추적 파일**이다. 이 패턴은 이후 scripts/에 추가될 파일을 조용히 누락시킨다.
- 조치: `.gitignore`에서 `scripts/` 행을 **삭제**한다. (특정 하위 산출물만 무시해야 할 필요가 확인되면 그때 구체 경로로 다시 추가)

### Step 2 — 사본 안내 공통 주석 삽입 (리뷰 발견 2, Rev.4 개정)
- 배경: `paper_draft/`에는 `assets/`가 없어 사본 위치 기준으로 이미지 상대경로가 해석되지 않는다(원본부터 존재하던 조건).
- 조치 (**대안 A — 양쪽 공통 주석**):
  1. 루트 `SLIDE.md`의 front-matter 종료(`---`) 직후에 아래 HTML 주석 1줄을 삽입한다:
     `<!-- NOTE: 이 문서의 동기화 사본이 paper_draft/SLIDE.md에 존재합니다. 이미지 상대경로는 루트 기준이므로 렌더링은 루트 SLIDE.md로 수행하세요. -->`
  2. 그 후 `cp SLIDE.md paper_draft/SLIDE.md`로 재동기화하여 두 파일의 **100% 바이트 동일성**을 유지한다.
- 금지: 사본에만 다른 내용 추가, 심볼릭 링크, 이미지 경로 재작성. 동일성 검증은 예외 없이 `diff -q` 완전 일치 기준.

### Step 3 — 커밋
- 대상: `SLIDE.md`, `paper_draft/SLIDE.md`, `.gitignore`(Step 1 수정 포함), `.env.example`, `implementation_plan.md`. (`AGENTS.md`는 이번 태스크 산출물이 아니므로 커밋 대상에서 제외하고 보류)
- 커밋 메시지(제안): `docs: restructure SLIDE.md lecture deck around 5-part outline with bridge structure`
- 커밋 전 최종 확인: `git diff --stat`으로 의도한 파일만 스테이징되었는지 검토.

## 3. 완료 기준 (Reviewer 판정 기준)

1. `.gitignore`에 `scripts/` 패턴이 없다.
2. 루트 `SLIDE.md`와 `paper_draft/SLIDE.md` **양쪽 모두**에 동일한 사본 안내 주석이 있고, 두 파일이 `diff -q` 기준 완전히 동일하다.
3. SLIDE.md 본문의 구조·내용은 리뷰 통과본(PASS 시점)에서 주석 1줄 삽입 외에 변경되지 않았다.
4. 커밋이 존재하며 의도한 파일만 포함한다 (`AGENTS.md` 미포함).

## 4. 대상 파일

- 수정: `.gitignore`, `SLIDE.md`(공통 주석 1줄), `paper_draft/SLIDE.md`(루트본 재복사)
- 커밋: 상기 + `.env.example`, `implementation_plan.md`
- 변경 금지: `SLIDE.md` 본문 구조, `assets/slides/lecture_summary.md`

## 부록 — 이전 리비전 이력

- Rev.1 (Job 19a175f2): 5개 장 재구성 8단계 계획 수립.
- Rev.2 (Job 174bd649): Creator 이의제기 수용 — What We Need?를 §3 마감 브릿지로 재배치, §4/§5 콜백 신설.
- 구현 (Creator: agy) 및 리뷰 (Job 1cafc914): PASS, 비차단 발견 2건 → Rev.3 Step 1·2로 반영.
- Rev.3 (Job a5a403e3): 잔여 작업 3단계 스코프 확정.
- Rev.4 (Job 5874d3da): Creator 이의제기(91a2e3e9) 수용 — Step 2를 사본 단독 주석에서 양쪽 공통 주석(대안 A)으로 개정, 100% 동일성·단순 diff 검증 원칙 복원.
