하네스 보강용 프롬프트

[주인장]

현재 프로젝트에서 다음 Phase를 준비하고 있다.

Phase 이름:
2-day1-content

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

중요:
아직 /harness를 실행하거나 Phase 파일을 만들지 마라.
먼저 "설계 보강 리뷰"만 수행한다.

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

- 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
- docs/DEPLOYMENT.md
- course.yaml
- content/day1/01.mdx

그리고 현재 web-foundation과 repo-connect에서 만들어진
validator, registry, external-links, Prompt Card,
Instructor Notes, Human Review 구조도 확인하라.

현재 상태에서 Day 1 콘텐츠 제작에 들어가기 전에
아래 관점으로 설계의 빠진 점과 약한 점을 찾아라.

1. Day 1 교육 흐름
- 7개 교시가 단순한 주제 나열이 아니라
  이전 교시의 결과물이 다음 교시에 재사용되는 구조인지 확인한다.
- 각 교시마다
  "무엇을 배운다"뿐 아니라
  "하네스가 어떻게 하나씩 완성되는가"가 보여야 한다.
- Prompt → Instructions → Context → Eval‎s → Harness
  흐름이 점진적으로 연결되는지 확인한다.
- "긴 프롬프트 = Harness"라는 오해가 생기지 않는지 확인한다.

2. 초보자 학습 부담
- AI를 처음 사용하는 수강생도 따라갈 수 있는지 본다.
- 한 교시 안에 새 개념이 너무 많이 들어가지 않는지 본다.
- 설명 → 시연 → 따라하기 → 실습 → 확인
  흐름이 적절한지 본다.
- 초보자가 자주 막힐 부분에
  troubleshooting, expected result,
  잘못된 결과 예시가 필요한지 확인한다.

3. Prompt Card 설계
- Prompt Card가 단순 복붙 답안지가 되지 않게 한다.
- 가능하면
  Level 1: 그대로 복사
  Level 2: [대괄호] 수정
  Level 3: 직접 작성
  의 단계가 적용되도록 한다.
- 어느 교시에서 어느 Prompt Card가 필요한지 점검한다.
- Prompt Card를 과도하게 많이 넣지 않도록 한다.

4. 실습 설계
- 실제 개인정보, 실제 민원 데이터는 사용하지 않는다.
- 합성 데이터 또는 교육용 예제를 사용한다.
- 각 교시 실습 결과물이 다음 교시에서 다시 사용될 수 있는지 본다.
- 실습마다
  입력 자료,
  수행 행동,
  기대 결과,
  실패 사례,
  검증 방법이 있는지 확인한다.

5. Harness 6요소
Day 1에서 다음 요소 중 무엇을 어디까지 다루는지 명확해야 한다.

- Instructions
- Context
- Tools
- Eval‎s
- Guardrails
- Observability

Day 1에서 전부 완성해야 한다고 가정하지 마라.
Day 2로 넘겨야 하는 요소는 명확하게 구분한다.

6. ChatGPT Plus 기준
- 기본 실습 환경은 ChatGPT Plus다.
- 초보자가 메뉴나 기능을 찾지 못할 가능성을 고려한다.
- ChatGPT Projects 등 실제 기능 의존성이 있는 내용은
  OPEN_QUESTIONS나 TOOL_GUIDE와 충돌하지 않는지 확인한다.
- Codex는 Day 1 핵심 과정에 억지로 넣지 않는다.
- 실제 학습효과가 있을 경우에만 OPTIONAL로 둔다.

7. 수강생용과 강사용 분리
- 수강생 페이지에 불필요한 운영 지침이 섞이지 않는지 확인한다.
- 강사용 설명은 Instructor Notes에 두는 구조가 적절한지 본다.
- 강사가 시연할 내용과 수강생이 직접 수행할 내용을 구분한다.

8. 시간 설계
- 각 교시가 실제 1시간 안에 가능한지 확인한다.
- 설명 시간이 과도하거나 실습 시간이 부족한 교시를 찾는다.
- 각 교시마다
  설명 / 시연 / 따라하기 / 실습 / 정리
  시간 배분이 필요한지 판단한다.

9. 검증 구조
각 교시마다 최소한 다음을 검증할 수 있어야 한다.

- 학습목표 달성 여부
- 페이지 구성 규칙 준수
- Prompt Card 규칙 준수
- Instructor Notes 존재 여부
- registry / external-links 일관성
- Open Question / TBD 추적
- 내부 링크 / 외부 링크
- npm run verify
- course validator

필요하다면 새 validator 규칙을 제안하되
중복 규칙이나 과도한 자동화를 만들지 마라.

10. Human Review
Day 1 전체를 다 만든 뒤 한 번만 검토하는 구조가 적절한지 검토한다.

가능하면
- 교육 흐름 검토
- 중간 교시 검토
- Day 1 전체 검토

중 어떤 지점이 실제로 필요한지 제안한다.

Human Review를 너무 많이 넣어서
작업이 자주 중단되는 구조도 피한다.

11. 출처와 사실 관리
- 법령, 공공기관 지침, ChatGPT 기능 등
  외부 사실이 들어가는 교시는 SOURCE_REGISTER와 연결되어야 한다.
- 확정되지 않은 사실은 추정하지 않는다.
- 필요한 경우 CONFIRMED / PROVISIONAL / TBD /
  CURRENT-AS-OF 상태를 사용한다.
- 동일한 외부 정보를 여러 교시에 중복 기록하지 않는다.

12. 콘텐츠 중복 방지
- 같은 설명, 표, 링크, Prompt Card를
  여러 교시에 복붙하지 않게 한다.
- registry, shared component, shared template로
  관리해야 할 항목을 찾아라.
- 단, 재사용 구조가 너무 복잡해져
  강의 콘텐츠 작성이 어려워지지 않게 한다.

13. 웹사이트 구조
- 현재 Astro 구조를 유지한다.
- 새로운 프레임워크를 도입하지 않는다.
- D1-01을 exemplar로 사용하되
  모든 교시를 동일한 모양으로 강제하지 않는다.
- 디자인 세부 개선보다
  교육 흐름과 콘텐츠 구조를 우선한다.

14. 완료 기준
Day 1 완료가 단순히
"7개 파일이 존재한다"가 되지 않도록 한다.

최종적으로 다음을 확인할 수 있어야 한다.

- 7개 교시 모두 존재
- course.yaml과 실제 콘텐츠 일치
- 각 교시 학습목표 명확
- 필요한 Prompt Card 존재
- 필요한 Instructor Notes 존재
- 각 실습의 expected result 존재
- 실습 흐름이 교시 간 연결
- Open Question / TBD 정상 추적
- 출처 관리 정상
- npm run verify 성공
- validator 오류 0
- Astro production build 성공
- Human Review 통과

이제 현재 설계를 비판적으로 검토하고
다음 형식으로 결과를 보여줘.

A. 현재 잘 설계된 부분
B. Day 1 제작 전에 반드시 보강해야 할 부분
C. 있으면 좋은 보강 항목
D. 불필요하거나 과도한 규칙
E. 새로 필요한 Harness 규칙
F. 수정이 필요한 기존 문서와 수정 이유
G. 새 문서가 정말 필요한지 여부
H. Day 1 교시별 예상 위험요소
I. Human Review 권장 위치
J. 2-day1-content /harness 설계에 반드시 반영해야 할 규칙

각 문제는 가능하면 다음 형식으로 표시해라.

- 문제
- 왜 문제인가
- 영향
- 수정 제안
- 관련 파일
- 우선순위: MUST / SHOULD / OPTIONAL

중요:

- 아직 파일을 수정하지 마라.
- phases/2-day1-content를 만들지 마라.
- /harness를 실행하지 마라.
- 콘텐츠를 생성하지 마라.
- 현재 Harness를 우회하는 임시 해결책을 제안하지 마라.

마지막에는
"2-day1-content 설계에 들어가도 되는가"를

READY
또는
NEEDS-FIX

중 하나로 표시하고,
NEEDS-FIX이면 무엇을 먼저 고쳐야 하는지만 요약해라.