강의 생성용 하네스

[주인장]

/harness

다음 Phase를 설계해줘.

Phase 이름:
2-day1-content

목표:
공무원을 위한 하네스 엔지니어링 2일 14시간 과정 중
Day 1의 7개 교시 강의 콘텐츠를 완성한다.

현재까지 완료된 Phase:

- 0-foundation
- 1-web-foundation
- 1b-repo-connect

먼저 다음 파일을 반드시 읽어라.

- CLAUDE.md
- docs/PRD.md
- docs/ARCHITECTURE.md
- docs/ADR.md
- docs/UI_GUIDE.md
- docs/COURSE_MAP.md
- docs/LEARNING_OBJECTIVES.md
- docs/HARNESS_ELEMENTS.md
- docs/PRACTICE_CASES.md
- docs/PRACTICE_DESIGN.md
- docs/CONTENT_GUIDE.md
- docs/PROMPT_GUIDE.md
- docs/TOOL_GUIDE.md
- docs/QUALITY_CHECKLIST.md
- docs/SOURCE_REGISTER.md
- docs/OPEN_QUESTIONS.md
- course.yaml
- content/day1/01.mdx

특히 이미 Human Review를 통과한
content/day1/01.mdx를 Day 1 강의 페이지의 기준 exemplar로 사용한다.

단, D1-01을 그대로 복제하지 말고
각 교시의 학습목표와 실습 목적에 맞게 구성한다.

Day 1은 COURSE_MAP과 course.yaml을 단일 기준으로 사용하고
총 7시간 / 7개 교시 구조를 유지한다.

각 교시는 가능한 한 다음 학습 흐름을 갖도록 설계한다.

- 학습목표
- 왜 배우는가
- 핵심 개념
- 강사 시연
- 수강생 따라하기
- AI 도움받기 / Prompt Card
- 실습
- 예상 결과
- 잘못된 결과 예시 또는 주의사항
- 문제 해결
- 확인 질문 또는 체크
- 이번 교시에서 Harness가 어떻게 변화했는지
- 다음 교시 연결

수강생은 AI 초보자도 포함한다.

따라서 Prompt Card는
단순히 정답을 대신 만들어주는 용도가 아니라
학습을 보조하도록 설계한다.

가능하면 다음 단계 구조를 사용한다.

Level 1:
그대로 복사해서 사용

Level 2:
[대괄호] 부분을 수정해서 사용

Level 3:
수강생이 직접 작성

Day 1에서는 특히 다음 개념이 점진적으로 연결되어야 한다.

Prompt
→ Instructions
→ Context
→ Eval‎s
→ Harness

"긴 프롬프트 = Harness"라는 오해가 생기지 않게 한다.

공무원 교육이지만
실제 개인정보나 실제 민원 데이터는 사용하지 않는다.
실습은 합성 데이터와 교육용 예제를 사용한다.

ChatGPT Plus를 기본 환경으로 한다.

Codex는 Day 1 핵심 과정에 억지로 넣지 말고
실제로 학습효과가 있는 경우에만 OPTIONAL로 제안한다.

웹사이트는 현재 Astro 구조를 유지한다.
새 프레임워크를 도입하지 않는다.

현재 validator, registry, external-links,
Prompt Card, Instructor Notes 구조를 재사용하고
기존 규칙을 우회하지 않는다.

각 step은 작고 독립적으로 설계하고
allowed_paths를 명확하게 지정한다.

중간에 일부러 validator가 실패하는 단계가 필요하다면
그 이유와 해소되는 후속 step을 명시한다.

Human Review 지점을 적절히 둔다.

특히 Day 1 전체를 한 번에 만든 뒤 검토하지 말고
교육 설계상 의미 있는 단위에서
사람 검토가 가능하도록 설계한다.

최종 Acceptance Criteria에는 최소한 다음을 포함한다.

- npm run verify
- course validator 오류 0
- Day 1의 7개 교시 존재
- course.yaml과 실제 콘텐츠 일치
- 필요한 Prompt Card 존재
- 필요한 Instructor Notes 존재
- Open Question/TBD 추적 정상
- 내부 링크/외부 링크 검증
- Production build 성공

아직 Phase 파일을 생성하지 마라.

먼저 다음만 보여줘.

1. Day 1 전체 제작 전략
2. 제안하는 step 목록
3. 각 step의 목적
4. 각 step의 주요 수정 파일
5. Human Review 위치
6. 예상되는 blocker / Open Question
7. Day 1 완료 판정 기준
8. 현재 Harness에서 추가로 보완해야 할 규칙이 있는지

내가 설계를 승인한 뒤에만
phases/2-day1-content를 생성한다.