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줄을 삽입한다: 
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 판정 기준)

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

5.6 KiB Raw Blame History

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

1. 목표 및 달성 현황

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

Step 1 — .gitignore의 scripts/ 패턴 수정 (리뷰 발견 1)

Step 2 — 사본 안내 공통 주석 삽입 (리뷰 발견 2, Rev.4 개정)

Step 3 — 커밋

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

4. 대상 파일

부록 — 이전 리비전 이력

5.6 KiB

Raw Blame History

Step 1 — `.gitignore`의 `scripts/` 패턴 수정 (리뷰 발견 1)