메뉴
EduHarness 첫 실행 진입점. "quickstart", "시작", "처음 시작", "어떻게 시작", "setup", "init", "get started", "how do I start", "처음 써요", "clone 했어", "방금 받았어"가 포함된 요청에서 반드시 이 스킬을 사용합니다. 환경 점검 → CLAUDE.md 초기화 → 첫 검증까지 one-shot으로 처리합니다. 다른 스킬을 먼저 고를 필요 없습니다. 항상 여기서 시작하세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
구현 후 REJECTED 판정이 나오거나 '/execution-loop'을 입력하면 반드시 이 스킬을 사용할 것. 'fix it', 'retry', 'auto-fix', 'keep trying', 'iterate until passing', 'loop until approved'가 포함된 요청도 해당. 합격 기준 충족까지 수정→검증→반복을 자동화한다. 최대 5회 반복, 루프 상태를 .execution-loop-state 파일에 기록한다.
'만들어줘', '구현해줘', '추가해줘', '설계해줘', 'build', 'implement', 'add feature', 'create', 'design', 'make'가 포함된 모든 교육 앱 기능 요청에 반드시 이 스킬을 사용할 것. 퀴즈·레슨·학습 진도·교사 관리·평가·피드백·학생 인증 / quiz, lesson, progress tracking, teacher dashboard, assessment, feedback, student auth 모두 해당. 계획→교육설계→구현→교육학검토→검증→하네스진화 전체 사이클을 실행한다.
verify 점수를 올리거나 수치 목표 달성이 필요할 때 반드시 이 스킬을 사용할 것. 'REJECTED를 APPROVED로', 'improve score', 'raise score', 'fix REJECTED', 'optimize to pass', 'SCORE 80 이상', 'meet the threshold', 'get to APPROVED'가 포함된 요청 모두 해당. 코드와 하네스(rubric)를 동시에 진화시키며 Goodhart's Law 방어 내장.
기능 구현이 완료되거나 '/verify 기능명'이 입력되면 반드시 이 스킬을 사용할 것. 'verify', 'check', 'validate', 'run verification', 'is this passing?', 'check quality'가 포함된 요청도 해당. 6개 차원(기술/평가무결성/심리안전/접근성/데이터보호/성능)에서 교육 앱 코드를 검증한다. isCorrect API 노출, 형성/총괄 혼용, 부정적 피드백 메시지 감지에 특화.
새 프로젝트 시작 시 하네스를 초기화합니다. 2가지 질문만 하고, 나머지는 package.json 자동 감지 + 지연 채움으로 처리합니다. clone 직후 가장 먼저 실행하세요.
| name | quickstart |
| description | EduHarness 첫 실행 진입점. "quickstart", "시작", "처음 시작", "어떻게 시작", "setup", "init", "get started", "how do I start", "처음 써요", "clone 했어", "방금 받았어"가 포함된 요청에서 반드시 이 스킬을 사용합니다. 환경 점검 → CLAUDE.md 초기화 → 첫 검증까지 one-shot으로 처리합니다. 다른 스킬을 먼저 고를 필요 없습니다. 항상 여기서 시작하세요. |
EduHarness 하나뿐인 시작점. 복잡한 스킬 선택 불필요 — 이 스킬이 알아서 분기합니다.
bash .claude/hooks/system-check.sh --brief
package.json과 src/ 존재 여부로 자동 분기합니다.
| 상태 | 분기 |
|---|---|
package.json 없음 + src/ 없음 | → 신규 템플릿 (Step 3으로) |
package.json 있음 또는 src/ 있음 | → 기존 프로젝트 (Step 6으로) |
Q1. 프로젝트 이름은? (예: EduQuiz Mini, LearnTrack Pro)
What's your project name? (e.g. EduQuiz Mini, LearnTrack Pro)
Q2. 교육 앱인가요? Y/N
Is this an education app? Y/N
Y → CLAUDE.md 교육 도메인 섹션 유지
N → CLAUDE.md에서 교육 도메인 섹션 전체 제거
질문은 이것으로 끝입니다. 기술 스택, 명령어, 배포 환경은 아래에서 자동 처리합니다.
답변과 파일 감지 결과로 플레이스홀더를 교체합니다.
| 플레이스홀더 | 처리 방식 |
|---|---|
[YOUR_PROJECT_NAME] | Q1 답변 |
[YOUR_DEV_COMMAND] | package.json scripts.dev 감지, 없으면 lazy-fill |
[YOUR_TEST_COMMAND] | package.json scripts.test 감지 |
[YOUR_LINT_COMMAND] | package.json scripts.lint 감지 |
[YOUR_TYPECHECK_COMMAND] | package.json scripts.typecheck 감지 |
[YOUR_BUILD_COMMAND] | package.json scripts.build 감지 |
| 교육 도메인 섹션 | Q2=N이면 전체 제거 |
| 대상 사용자, 핵심 기능, 배포 환경 | # lazy-fill 주석으로 표시 (커밋 허용) |
architecture.md도 프로젝트명과 감지된 스택으로 업데이트합니다.
package.json이 없으면 사용자에게 안내합니다:
📦 아직 Next.js 프로젝트가 없습니다.
다음 명령어로 생성하세요:
npx create-next-app@latest . --typescript --tailwind --app
생성 후 다시 /quickstart를 실행하거나, 바로 /edu-harness로 기능 개발을 시작하세요.
안내만 하고 직접 실행하지 않습니다 (사용자 선택권 보장).
bash .claude/skills/verify/verify.sh
결과를 그대로 출력합니다.
VERDICT에 따라 다른 안내를 합니다.
✅ 하네스 초기화 완료!
채워진 항목: [N]개
지연 채움 예정: [N]개 (첫 /edu-harness 실행 시 자동 추론)
다음 단계:
1. Next.js 프로젝트 생성 (위 Step 5 참고)
2. git commit -m "harness: [프로젝트명] 초기 하네스 설정"
3. /edu-harness [만들 기능]을 만들어줘
✅ 하네스 준비 완료! VERDICT=[결과]
바로 개발을 시작할 수 있습니다:
→ /edu-harness [만들 기능]을 만들어줘
⚠️ 검증 실패 항목이 있습니다. VERDICT=REJECTED
실패 항목:
[CRITICAL_FAIL, HIGH 미통과 항목 나열]
먼저 이 항목을 수정하거나, /edu-harness로 기능 개발을 진행하면서 함께 수정할 수 있습니다.
/edu-harness-init/edu-harness [기능명]을 만들어줘bash .claude/skills/verify/verify.shbash .claude/hooks/harness-health.sh