Skillget

Harness-Engineering

agent
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • No description — Repository has no description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This is an AI coding agent template designed for educational applications. It provides a structured framework and workflow for AI agents, allowing developers to automatically plan, build, and verify educational features like quizzes and student dashboards.

Security Assessment
Overall Risk: Low. The code scan of 12 files found no dangerous patterns and detected no hardcoded secrets. The tool does not request any dangerous system permissions. However, because it is a shell-based agent, it inherently executes system commands to run its 7-step workflow and automated verification loops. Users should be aware that as an AI agent, it will read and modify local project files based on natural language prompts, though it does not make unauthorized external network requests.

Quality Assessment
The repository is quite new and has low community visibility, currently sitting at only 5 GitHub stars. It lacks a description in its metadata, but the included README is exceptionally detailed and well-documented. The project is actively maintained, with its most recent push occurring today. It is fully open-source under the standard MIT license, making it safe for integration and modification.

Verdict
Safe to use, but expect a early-stage project with minimal community validation.
README.md

EduHarness Foundation

교육자를 위한 AI 코딩 에이전트 하네스 템플릿

English version →

하네스 엔지니어링이란?

AI에게 매번 맥락을 설명하는 대신, AI가 일관된 품질로 일할 수 있는 환경 자체를 설계하는 작업입니다.

프롬프트 엔지니어링 하네스 엔지니어링
방식 매번 맥락을 새로 설명 규칙·구조로 미리 위임
결과 일관성 유지 어려움 구조적으로 일관된 품질

하네스의 4대 구성 요소

구성 요소 역할 파일
📜 헌법 AI가 따를 규칙과 원칙 CLAUDE.md, AGENTS.md
🏗 작업 구조 무엇을 어떻게 만들지 설계도 architecture.md, progress.md
✅ 검증 결과물 품질 판단 기준 .husky/pre-commit, docs/verification-rubric.md
🔄 실행 루프 수정→검증→반복 자동화 .claude/skills/execution-loop/

빠른 시작 (5분)

1단계: 템플릿 가져오기

GitHub "Use this template" 버튼 → 새 리포지토리 생성

2단계: 하네스 초기화

/edu-harness-init

질문 2개(프로젝트명 + 교육 앱 여부) → 나머지는 package.json 자동 감지 + 첫 기능 구현 시 자동 추론

지연 채움(Lazy-fill): 기술 스택·사용자 설명은 첫 /edu-harness 요청 문장에서 자동으로 읽어옵니다.

3단계: 첫 기능 구현

/edu-harness 학생 퀴즈 응시 기능을 만들어줘. 형성평가로 설계해줘.

슬래시 커맨드 없이 자연어로도 트리거됩니다.
"퀴즈 기능 만들어줘", "교사 성적 화면 추가해줘" → 자동으로 /edu-harness 워크플로우 실행.

/edu-harness 7단계 사이클

이 한 줄이 아래 7단계를 자동으로 실행합니다.

계획 → 완료 조건 합의 → 교육 설계 → 구현 → 교육학 검토 → 검증 → 하네스 진화
단계 핵심 이유
1. 계획 영향 파일·위험 요소 파악 코드 작성 전 설계도
2. 완료 조건 합의 스프린트 계약 — "완료"의 기준 명시 AI와 사람의 기대치 사전 정렬
3. 교육 설계 형성/총괄 구분, 피드백 메시지 설계 코드 구조가 교육 목적에 맞는지 확인
4. 구현 단위 테스트 + 접근성 테스트 포함 실제 코드 작성
5. 교육학 검토 API↔프론트 shape 교차 확인 정답 노출·재시도 정책 검증
6. 검증 verify.sh 6차원 자동 측정 점수 기반 APPROVED/REJECTED
7. 하네스 진화 CLAUDE.md 규칙 자동 누적 루프가 돌수록 AI 품질 향상

루프가 돌수록 HARNESS_CHANGELOG.md에 규칙이 쌓이고, 루브릭 허점을 발견하면 수정을 제안합니다.
코드 수정은 AI에게 위임하고, 루브릭은 사람이 최종 승인하는 구조가 Goodhart's Law 함정을 막습니다.

바로 써보기

# 퀴즈 응시 (형성평가)
/edu-harness 학생이 객관식 퀴즈를 응시하는 기능을 만들어줘. 형성평가로 설계해줘.

# 퀴즈 응시 (총괄평가)
/edu-harness 기말고사 형식의 퀴즈 응시 기능을 만들어줘. 총괄평가로 설계해줘.

# 교사 성적 관리
/edu-harness 교사가 학생 성적을 조회하고 수정하는 화면을 만들어줘.

# 학생 로그인/회원가입
/edu-harness 학생 로그인과 회원가입 기능을 만들어줘. 만 14세 미만 보호자 동의 플로우 포함해줘.

# 레슨 목록 페이지
/edu-harness 학생이 수강 가능한 레슨 목록 페이지를 만들어줘. 진도율 표시 포함.

# 학습 진도 대시보드
/edu-harness 학생 학습 진도 대시보드를 만들어줘. 성장 중심 표현으로 설계해줘.

교육 앱이 아닌 경우

EduHarness의 기반 구조(헌법·검증·실행 루프)는 모든 프로젝트에 사용할 수 있습니다.

/edu-harness-init 초기화 시 Q2에 N으로 답하면 CLAUDE.md에서 교육 도메인 섹션을 자동으로 제거합니다.
verify.sh의 [EDU-DOMAIN] 검사들은 관련 파일(퀴즈·피드백 컴포넌트)이 없을 때 자동으로 통과됩니다.

/edu-harness-init
# Q2: 교육 앱인가요? → N
# → CLAUDE.md 교육 도메인 섹션 삭제, 코딩 규칙·검증 구조 유지

파일 구조

edu-harness/
├── CLAUDE.md              # 📜 헌법 — AI 핵심 규칙 (프로젝트 목적 + 코딩 규칙 + 교육 도메인)
├── AGENTS.md              # 📜 헌법 — 에이전트 7개 역할 + 도구 권한 매트릭스
├── architecture.md        # 🏗 설계 — 기술 스택, 디렉토리, 데이터 모델
├── progress.md            # 🏗 진행 — 현재 상태, 다음 할 일, 컨텍스트 앵커
├── HARNESS_CHANGELOG.md   # 하네스 진화 이력 (커밋 시 자동 기록)
├── LICENSE                # MIT License
│
├── docs/
│   ├── example-walkthrough.md   # ⭐ 실전 워크스루 (처음이라면 여기부터)
│   ├── education-principles.md  # 교육학 원칙 참조
│   ├── verification-rubric.md   # 6차원 검증 루브릭 (Dim1~Dim6)
│   ├── decision-log.md          # 아키텍처 결정 기록 (ADR)
│   ├── harness-audit.md         # 분기별 하네스 감사 체크리스트
│   ├── harness-audit-results.md # 감사 결과 기록
│   ├── wcag-checklist.md        # WCAG 접근성 체크리스트
│   ├── harness-guide.ko.md      # 하네스 상세 가이드 (한국어)
│   └── harness-guide.en.md      # Harness detailed guide (English)
│
├── .claude/
│   ├── hooks/
│   │   ├── harness-health.sh    # 🩺 전체 상태 대시보드
│   │   ├── system-check.sh      # 🔧 환경 진단 (19항목)
│   │   ├── harness-checkpoint.sh # 💾 Level 2 자기 복구 (git stash)
│   │   └── harness-evolve.sh    # 📝 규칙 변경 자동 기록
│   └── skills/
│       ├── edu-harness/         # 🎓 메인 진입점 (7단계 사이클)
│       ├── edu-harness-init/    # 🔧 하네스 초기화 (2질문)
│       ├── harness-init/        # 🔧 비교육용 초기화
│       ├── execution-loop/      # 🔄 합격 기준까지 반복
│       ├── objective-loop/      # 🎯 수치 목표까지 반복 + 하네스 진화
│       └── verify/              # ✅ 6차원 검증

스킬 카탈로그

스킬 용도 사용 시점
/edu-harness-init 하네스 초기 설정 (교육/범용 앱) 클론 직후 1회
/harness-init 비교육 앱 초기화 클론 직후 (비교육)
/edu-harness 7단계 기능 구현 워크플로우 모든 기능 구현
/execution-loop 합격 기준 충족까지 자동 반복 REJECTED 시
/objective-loop 수치 목표 달성 + 하네스 진화 점수 개선 목표 시
/verify 6차원 품질 검증 단독 검증

주요 명령어

bash .claude/hooks/harness-health.sh          # 🩺 전체 상태 한눈에 보기
bash .claude/skills/verify/verify.sh          # 📊 코드 품질 점수 (빠름)
bash .claude/skills/verify/verify.sh --full   # 📊 전체 검증 (lint+tsc+test)
bash .claude/hooks/system-check.sh            # 🔧 환경 진단

하네스 강도 선택

강도 상황 AI 자율성
엄격 결제·인증, 학생 데이터, 총괄평가 낮음 — 매 단계 승인
균형 일반 교육 기능 개발 권장
느슨 아이디어 스케치, 초기 프로토타입 높음

더 알아보기

기여하기

  1. ⭐ Star를 눌러주세요
  2. 개선 사항은 Issue로 제안해주세요
  3. 교육 현장 사용 경험은 Discussions에 공유해주세요

MIT License

Yorumlar (0)

Sonuc bulunamadi