💡 핵심 요약 (Executive Summary)
본 가이드는 llm harness init 핵심 가이드 및 실전 아키텍처의 핵심 개념, 실전 구성 명령어 및 아키텍처 베스트 프랙티스를 다룹니다. 클라우드 네이티브 및 인프라 엔지니어링 실무에 즉시 활용 가능하도록 체계적으로 정리했습니다.
📑 Table of Contents
개요
Harness는 Claude Code의 에이전트 팀 시스템을 활용하여 복잡한 작업을 전문 에이전트 팀으로 분해·조율하는 아키텍처 도구다. “하네스 구성해줘”라고 말하면, 사용자의 도메인에 맞는 에이전트 정의(.claude/agents/)와 스킬(.claude/skills/)을 자동 생성한다.
Claude 외
원본 harness vs harness-init (Cursor 환경)의 차이점
Reference & Guidelines (NOTE)
harness-init은 리포지토리를 에이전트 친화적(Agent-ready)으로 만들어주는 초기화 스캐폴딩(Scaffolding) 도구입니다. Cursor에서 실행했을 때 원본과 달라지거나 제한되는 지점은 다음과 같습니다.
📁 설정 파일 인식 경로의 차이
- Claude Code:
.claude/agents/,.claude/skills/,CLAUDE.md규칙을 시스템 레벨에서 직접 읽고 해석합니다. - Cursor: 기본적으로
.cursorrules파일이나.cursor/디렉토리를 컨텍스트 시스템으로 사용합니다.
🛠️ 실행 루프 및 도구(Tooling) 제약
harness프레임워크의 본질은 단순히 마크다운 문서를 만드는 게 아니라, 터미널 명령어를 치고, 에러가 나면 스스로 고치고(Self-Correction),git명령어로 롤백하는 터미널 기반 실행 루프(Execution Loop)입니다.- Claude Code는 CLI 환경에서 완전히 자율적인 셸 명령 권한을 가지고 격리된 파이프라인을 돌리지만, Cursor의 Agent(Composer 등)는 IDE 컨텍스트 기반으로 움직이기 때문에 하네스가 요구하는 강력한 시스템 통제나 자동 래칫(Ratchet) 메커니즘이 중간에 끊기거나 다르게 동작할 수 있습니다.
Cursor Pre-Setup
bash
project_home="$(pwd)"
workspace_home="$HOME/workspace"
cd $workspace_home
git clone https://github.com/Gizele1/harness-init
cd $project_home
mkdir -p .cursor/rules/harness-init
cd .cursor/rules/harness-init
cp -r "$workspace_home/harness-init/skills/harness-init/SKILL.md" .
cp -r "$workspace_home/harness-init/skills/harness-init/references" .Common Post-Setup
text to
- “harness init this repo”
- “make this repo agent-ready”
- “set up architecture boundaries”
Leave a Reply