aio-01d4-stu/Last3Mon/78/LAB-01-A-QUALITY-RULES.md

Lab 01 · 품질 규칙 · 눈으로 검사하고, 규칙으로 바꾸기

강사용 정답본 · 학생 저장소에는 수업이 끝난 뒤 올립니다. 학생용 문제는 LAB-01-Q-QUALITY-RULES.md. 요청문은 예시이며 CLI 에이전트로 보내 재지는 않았습니다. 결과 숫자는 실습을 5개로 늘린 뒤 정답 워크플로우를 학생 순서대로 2026-11-01에 1회씩 실행한 값입니다 (강사 Mac). 판정은 규칙대로라 누가 돌려도 같습니다. 명령 · 출력 전부: answers/LAB-TEST-RESULT.md.

예제 1 · 결과 (에이전트 없이, answers/01)

줄	id	내 눈	기준 검사	규칙
3 · 5 · 8	FAQ-103 · 105 · 108	나쁨	✔ 잡음	title_missing · answer_missing · keywords_missing
4	FAQ-10	나쁨	놓침	id_format
6	FAQ-106	나쁨	놓침	answer_too_long
7	FAQ-102 (둘째)	나쁨	놓침	duplicate_in_batch
9	FAQ-109	나쁨	놓침	pii (010-1234-5678)
10	FAQ-110	나쁨	놓침	external_link (bit.ly)
11 · 12	FAQ-003 · 112	이미 있는 FAQ를 봐야	통과	과제 1
13	FAQ-113	뜻이 다름	통과	Lab 02 예제 2 (LLM)

• 기준: 13줄 중 10줄 통과(빈 값 셋만). 눈: 분명히 나쁜 8줄 + 판단 보류 3줄 → 좋은 줄 2줄.
• 풀이 때: "기준이 틀렸나?" → 아니오, 규칙이 셋뿐. 가장 위험한 놓침은 FAQ-109(개인 전화번호)와 FAQ-110(단축 링크) — 73일차 보안과 이어서.

예제 2 · 요청문 예

my-work/faq-check.json 을 새로 만들어 줘. 웹훅 POST my-faq-check, 이름 "78 FAQ check (my)".
Is a list?(IF): 본문 items 가 목록이 아니면 Reject body 로 HTTP 400 {"error": "items must be a list"}.
Check rows(Code) 하나에서 줄마다 AGENTS.md 3절 FAQ 품질 규칙대로 errors 를 붙인다. 공백만 있는 값은 빈 값, 글자 수는 앞뒤 공백을 뺀 뒤 센다.
pii 는 하이픈 없는 휴대전화도, external_link 는 호스트가 정확히 intra.example.com 이 아니면.
결과 {batch, total, valid, invalid, rows: [{id, ok, errors, warnings}], codes}, rows 는 들어온 순서 그대로. LLM 은 쓰지 않는다. 기대 결과 cases/lab01.json.

빈칸 답 (Q 문서 ▶ 빈칸 채우기 ____①~____④)

빈칸	답	왜
①	my-faq-check	AGENTS.md 3절 계약 · 테스트 파일의 webhook
②	400	목록이 아닌 본문은 줄을 셀 수 없음 — 기준 검사는 여기서 500으로 멈춤
③	앞뒤 공백을 뺀 뒤	공백 세 칸짜리 제목이 '있는 제목'으로 통과하지 않게 (예제 3의 경계)
④	정확히 intra.example.com	intra.example.com.evil.io처럼 앞만 같은 바깥 주소를 막음

정답: reference/lab01-example2-check.json

11/01 결과
고치기 전 (answers/02, 기준에 같은 테스트)	1/5 · 빈 값만 ✔, 형식 · 중복 · 개인정보 · 링크 없음, B-2 valid 10, 목록이 아닌 본문 500
고친 뒤 (answers/03)	5/5 · B-1 13줄 중 5줄 통과 · 8줄 나쁨 (눈과 같은 8줄), 목록이 아닌 본문 400, 0.1초

예제 3 · 결과 (에이전트 없이, answers/04)

경계	내 검사	기준	기준이 틀린 까닭
40자 · 41자	✔ 통과 · title_too_long	✘ 둘 다 통과	길이 규칙 없음
공백만	✔ title_missing	✘ 통과	!r.title — 공백은 "있음"
10자 · 9자	✔ 통과 · answer_too_short	✘ 둘 다 통과	길이 규칙 없음
01012345678 · 02-123-4567	✔ pii · 통과	✘ 둘 다 통과	전화 규칙 없음
intra.example.com/help · intra.example.com.evil.io	✔ 통과 · external_link	✘ 둘 다 통과	링크 규칙 없음
faq-410	✔ id_format	✘ 통과	형식 규칙 없음

• 내 검사 6/6, 기준 0/6. 강사의 첫 판(10/18 판 reference)은 evil.io를 통과시켰음 — (?!intra\.example\.com)만 보고 호스트가 끝나는지는 안 봄. 지금 판은 (?!intra\.example\.com(?![\w.-])). 학생 판이 FAQ-409에서 ✘라면 좋은 토론거리.

과제 1 · 요청문 예

my-work/faq-check.json 에 이미 있는 데이터와 맞춰 보기를 더해 줘.
Is a list? 와 Check rows 사이에 Get FAQ(HTTP GET http://data-api:8800/faq-all) 를 둔다.
이미 있는 id 면 errors 에 exists_id, 이미 있는 제목이면 same_title.
이미 있는 FAQ 가 쓰는 키워드는 errors 가 아니라 warnings 에 keyword_used:<낱말> (대소문자 무시) — 통과는 시킨다.
앞의 규칙은 그대로. 기대 결과 cases/lab01-challenge.json, cases/lab01.json 도.

빈칸 답

빈칸	답	왜
①	faq-all	처음 6개 + 오늘 더한 FAQ 전체
②	same_title	제목이 같으면 검색에서 두 답이 겹침
③	warnings	키워드가 겹치는 것은 흔하고 나쁘지 않음 — 알려만 줌
④	그대로	같은 Code에 더함. lab01 5/5가 그대로여야 함

정답: answers/78-lab01-challenge-existing.json

11/01 결과
고치기 전 (answers/05)	0/4 · exists_id · same_title 없음, 통과 5
고친 뒤 (answers/06)	4/4 · FAQ-003 exists_id, FAQ-112 same_title + 경고 keyword_used:vpn, 통과 3, 막 더한 FAQ-201도 exists_id. lab01 5/5

과제 2 · 요청문 예

my-work/faq-check.json 의 결과에 보낸 사람에게 돌려줄 고침 목록을 더해 줘.
fix_list: 통과하지 못한 줄만 줄 순서대로 {row (1부터), id, codes (그 줄의 errors), fix}.
fix 는 코드마다 AGENTS.md 3절 "고침 목록" 표의 말을 그대로 쓴다 (LLM 으로 만들지 않는다).
message: "<batch>: <total>줄 중 <valid>줄 통과, <invalid>줄 고칠 것".
나쁜 줄을 고쳐 주지는 않는다 — 고치는 것은 사람. 앞의 칸은 그대로. 기대 결과 cases/lab01-challenge2.json, lab01 · lab01-challenge 도.

빈칸 답

빈칸	답	왜
①	줄 순서대로	보낸 사람이 자기 파일의 몇째 줄인지 바로 찾게 (row는 1부터)
②	그대로	같은 코드에 늘 같은 말. LLM으로 만들면 매번 말이 달라짐
③	고칠 것	테스트가 message를 글자 그대로 봄
④	사람	워크플로우가 고쳐 넣으면 무엇이 틀렸는지 아무도 모름 (README 원칙)

정답: answers/78-lab01-challenge2-fix-list.json

11/01 결과
고치기 전 (answers/07)	1/5 · fix_list · message 없음 ("앞의 칸은 그대로"만 ✔)
고친 뒤 (answers/08)	5/5 · B-1 고칠 줄 10 (3째 FAQ-103 ~ 12째 FAQ-112), B-1: 13줄 중 3줄 통과, 10줄 고칠 것, B-2 FAQ-209 하나. lab01 5/5 · lab01-challenge 4/4 · lab01-edges 6/6

• 풀이 때: "고침 말을 LLM으로 만들면?" — 같은 코드에 날마다 다른 말, 돈, 그리고 지어낸 조언. 표 하나면 충분.