{"id":48934721,"url":"https://github.com/leee880619-commits/claudecode-harness-setup-assistant","last_synced_at":"2026-04-23T04:02:02.419Z","repository":{"id":351933750,"uuid":"1212738599","full_name":"leee880619-commits/ClaudeCode-Harness-Setup-Assistant","owner":"leee880619-commits","description":"Meta-tool plugin for Claude Code. Builds a complete harness (CLAUDE.md, rules, agents, playbooks, hooks) via a 9-phase orchestrated workflow.","archived":false,"fork":false,"pushed_at":"2026-04-17T10:20:14.000Z","size":405,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-17T11:35:31.914Z","etag":null,"topics":["agent-team","claude-code","harness","meta-tool","orchestrator","plugin","scaffolding"],"latest_commit_sha":null,"homepage":"https://github.com/leee880619-commits/ClaudeCode-Harness-Setup-Assistant#readme","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leee880619-commits.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-16T17:22:50.000Z","updated_at":"2026-04-17T10:20:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/leee880619-commits/ClaudeCode-Harness-Setup-Assistant","commit_stats":null,"previous_names":["leee880619-commits/claudecode-harness-setup-assistant"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/leee880619-commits/ClaudeCode-Harness-Setup-Assistant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leee880619-commits%2FClaudeCode-Harness-Setup-Assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leee880619-commits%2FClaudeCode-Harness-Setup-Assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leee880619-commits%2FClaudeCode-Harness-Setup-Assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leee880619-commits%2FClaudeCode-Harness-Setup-Assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leee880619-commits","download_url":"https://codeload.github.com/leee880619-commits/ClaudeCode-Harness-Setup-Assistant/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leee880619-commits%2FClaudeCode-Harness-Setup-Assistant/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32165201,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-23T02:19:40.750Z","status":"ssl_error","status_checked_at":"2026-04-23T02:17:55.737Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-team","claude-code","harness","meta-tool","orchestrator","plugin","scaffolding"],"created_at":"2026-04-17T11:01:51.545Z","updated_at":"2026-04-23T04:02:02.404Z","avatar_url":"https://github.com/leee880619-commits.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# harness-architect\n\n[![ci](https://github.com/leee880619-commits/ClaudeCode-Harness-Setup-Assistant/actions/workflows/ci.yml/badge.svg)](https://github.com/leee880619-commits/ClaudeCode-Harness-Setup-Assistant/actions/workflows/ci.yml)\n[![release](https://img.shields.io/github/v/release/leee880619-commits/ClaudeCode-Harness-Setup-Assistant?include_prereleases\u0026sort=semver)](https://github.com/leee880619-commits/ClaudeCode-Harness-Setup-Assistant/releases)\n[![license](https://img.shields.io/github/license/leee880619-commits/ClaudeCode-Harness-Setup-Assistant)](./LICENSE)\n\n\u003e 프로젝트를 분석해 완벽한 Claude Code 하네스를 9단계로 구축하는 메타-도구 플러그인.\n\n\u003e 🌐 소개 페이지: [harness-architect 사용 가이드](https://leee880619-commits.github.io/ClaudeCode-Harness-Setup-Assistant/) · 📖 영어 버전: [README_EN.md](./README_EN.md) · 🧭 아키텍처 상세: [ARCHITECTURE.md](./ARCHITECTURE.md) · 📜 변경 이력: [CHANGELOG.md](./CHANGELOG.md)\n\n## 배경 (Why this exists)\n\n저는 개발자가 아닙니다. Claude Code와 **하네스 엔지니어링(harness engineering)**\n— CLAUDE.md, settings, rules, agents, hooks, MCP를 조합해 Claude를 특정\n프로젝트에 최적화하는 작업 — 을 접하면서, 매 프로젝트마다 똑같은 세팅 과정을\n반복하느라 낭비되는 시간과 인지 부하가 너무 크다는 것을 느꼈습니다.\n\n\"어떤 규칙이 필요하지?\", \"권한을 어디까지 열어야 하지?\", \"훅은 뭘 걸어야 하지?\",\n\"이 프로젝트는 에이전트 팀이 필요한가, 단일 스킬로 충분한가?\" 매번 동일한 질문에\n다시 답하고, 공식 문서를 다시 뒤지고, 지난 프로젝트의 실수를 반복합니다.\n\n이 플러그인은 그 비효율을 줄이기 위해 만들어졌습니다. Claude Code **공식 문서**와,\n여러 프로젝트에서 **실제로 잘 작동했던 패턴들**을 바탕으로, 프로젝트를 스캔하고\n필요한 질문만 던진 뒤 하네스 전체를 단계적으로 구축합니다.\n\n## 30초 퀵스타트\n\n```bash\n# 1) 플러그인 설치 (한 번만)\n/plugin marketplace add leee880619-commits/ClaudeCode-Harness-Setup-Assistant\n/plugin install harness-architect@harness-architect-marketplace\n\n# 2) 하네스를 만들 프로젝트 디렉터리에서 Claude 실행\ncd /path/to/your/project\nclaude\n\n# 3) 슬래시 커맨드 실행\n/harness-architect:harness-setup\n```\n\n**완료 후 생성되는 파일:**\n\n```\nyour-project/\n├── CLAUDE.md                    ← Claude의 프로젝트 이해 기반\n├── .claude/\n│   ├── settings.json            ← 권한·환경변수·훅·MCP\n│   ├── rules/                   ← 항상 적용되는 규칙\n│   ├── agents/                  ← 에이전트 정의 (에이전트 프로젝트)\n│   └── skills/                  ← 재사용 가능한 스킬\n└── docs/{요청명}/               ← 설계 산출물 (참고용)\n```\n\n**예상 소요 시간:**\n\n| 프로젝트 유형 | 경로 | 예상 소요 |\n|---|---|---|\n| 솔로 웹앱·CLI (자동 판별) | 경량 트랙 Phase L | 25–35분 |\n| 솔로 웹앱·CLI (`--fast` 명시) | Fast Track | 10–15분 |\n| 팀 웹앱 | 표준 | 20–45분 |\n| 에이전트 파이프라인 | Fast-Forward | 30–40분 |\n\n(사용자 응답 속도·프로젝트 복잡도에 따라 달라질 수 있습니다)\n\n실제 예시 파일: [`examples/generated/`](./examples/generated/)\n기여자라면: [CLAUDE.md](./CLAUDE.md) 참조\n\n## 언제 쓰면 좋은가\n\n- **처음부터 제대로** 된 Claude Code 하네스를 구축하고 싶을 때\n- **매 프로젝트 세팅**에 드는 인지 부하를 줄이고 싶을 때\n- 단순한 에이전트 팀이 아닌 **풀 하네스**(CLAUDE.md + settings + rules + agents + playbooks + hooks + MCP)가 필요할 때\n- 설계 중간에 **독립적 비판 리뷰**(red-team)가 필요한 복잡 프로젝트에 쓸 때\n\n## revfactory/harness 와의 차이\n\n| 항목 | harness-architect (본 플러그인) | [revfactory/harness](https://github.com/revfactory/harness) |\n|------|---------------------------------|--------------------------|\n| 범위 | 전체 하네스 (settings/rules/agents/playbooks/hooks/MCP) | 에이전트/스킬 팀 중심 |\n| 입력 | 프로젝트 경로 스캔 + 대화식 인터뷰 | 사용자 서술식 요청 |\n| 워크플로우 | 9-Phase 오케스트레이션 + Phase Gate + 재개 | 단일 대화 6단계 |\n| 설계 리뷰 | Red-team Advisor (매 Phase 독립 비판) + 생성 하네스에 파이프라인 리뷰 게이트(도메인 특화) 자동 주입 | 내장 없음 |\n| 핵심 패턴 | Agent-Playbook 분리 (WHO/HOW), Pure Orchestrator | 사용자 주도 설계 |\n\n**포지셔닝**: revfactory/harness는 에이전트/스킬 팀을 **빠르게** 만들고 싶을 때. harness-architect는 **한 번 제대로** 세팅해 두고 재개·검증 가능한 하네스를 원할 때.\n\n## 설치\n\nClaude Code 세션에서 슬래시 커맨드로 설치합니다.\n\n```\n# 1) 플러그인 마켓플레이스 등록 (한 번만)\n/plugin marketplace add leee880619-commits/ClaudeCode-Harness-Setup-Assistant\n\n# 2) 플러그인 설치\n/plugin install harness-architect@harness-architect-marketplace\n```\n\n\u003e 공식 Anthropic 마켓플레이스 제출은 진행 중입니다. 그 전까지는 위 GitHub-hosted 마켓플레이스 경로로 설치하세요.\n\n### 개발자 설치 (이 레포에서 직접)\n\n```bash\ngit clone https://github.com/leee880619-commits/ClaudeCode-Harness-Setup-Assistant\ncd ClaudeCode-Harness-Setup-Assistant\nclaude --plugin-dir .\n```\n\n## 업데이트\n\n이 플러그인은 자동 업데이트되지 않습니다. 새 버전을 받으려면 Claude Code 세션에서 다음 두 단계를 순서대로 실행하세요.\n\n```\n# 1) 마켓플레이스 캐시 새로고침 (GitHub에서 marketplace.json 재다운로드)\n/plugin marketplace update harness-architect-marketplace\n\n# 2) 플러그인 관리 TUI 열기\n/plugin update\n```\n\n`/plugin update` 를 인자 없이 입력하면 플러그인 목록 TUI가 나옵니다. 거기서\n**Installed → `harness-architect` → `Update now`** 를 선택하면 업데이트가 적용됩니다.\n\n\u003e `/plugin update harness-architect` 처럼 바로 실행했을 때 \"already at the latest version (0.1.0)\" 이 뜬다면, 1번 마켓플레이스 업데이트를 먼저 실행하지 않았거나 캐시가 남아 있는 경우입니다. 위 2단계 절차를 그대로 따르세요.\n\n## 사용법\n\n설치 후, 하네스를 만들 **대상 프로젝트에서** Claude Code 세션을 열고 슬래시 커맨드로 시작합니다.\n\n```bash\ncd /path/to/your/project\nclaude\n```\n\n세션 내에서:\n\n```\n/harness-architect:harness-setup\n```\n\n경로를 미리 정해놓았다면 **인자로 전달**할 수 있습니다. 이 경우 Phase 0의 \"프로젝트 경로\" 질문이 생략되어 바로 인터뷰로 진입합니다:\n\n```\n/harness-architect:harness-setup /path/to/your/project\n```\n\n오케스트레이터가 Phase 0부터 진행합니다. 필요한 의사결정(프로젝트 유형, 팀 여부, 훅 범위 등)은 `AskUserQuestion`으로 묶어 묻고, 설정 파일·에이전트·플레이북·훅을 단계별로 생성합니다.\n\n세션이 중단되어도 `docs/{요청명}/`에 저장된 Phase 산출물로부터 자동 재개할 수 있습니다. 재개 시 이전 세션의 Advisor BLOCK·ASK 미해결 항목도 함께 복원해 묻습니다 — 상세는 [ARCHITECTURE.md §5](./ARCHITECTURE.md).\n\n### v0.9.0~ 두 시나리오 UX\n\n사용자 관점에서 이 플러그인의 사용 흐름은 **두 가지**입니다:\n\n| 시나리오 | 커맨드 | 설명 |\n|---|---|---|\n| **A. 완전 신규 설치** | `/harness-architect:harness-setup` | 9-Phase 하네스 구축. Phase 9 자기완결 게이트(Runtime Spot Check) 포함 — 빌드 직후 추가 감사 불필요 |\n| **B. 기존 하네스 점검** | `/harness-architect:audit` | 3개 auditor(구성·런타임·적합성) 병렬 실행 + 단일 통합 보고서 |\n\nv0.9.2 부터 슬래시 autocomplete 에는 위 2개 + `/harness-architect:help` 총 **3개만** 노출됩니다. 개별 auditor(구성·런타임·적합성) 는 `/harness-architect:audit` 내부에서 자동 병렬 호출됩니다. 특정 축만 실행이 필요하면 해당 auditor 에이전트(`harness-auditor` / `ops-auditor` / `fit-auditor`) 를 자연어로 직접 소환하세요.\n\n## 9-Phase 워크플로우 (요약)\n\n| Phase | 내용 | 담당 에이전트 |\n|-------|------|---------------|\n| 0 | 대상 프로젝트 경로 수집 + 요청명 생성 + **기본 성능 수준(경제/균형/고성능) 힌트** 수집 | (Orchestrator) |\n| 1-2 | 스캔 + 인터뷰 + 기본 하네스 | `phase-setup` |\n| 2.5 | 도메인 리서치 (옵션) | `phase-domain-research` |\n| 3 | 워크플로우 설계 | `phase-workflow` |\n| 4 | 파이프라인 설계 | `phase-pipeline` |\n| 5 | 에이전트 팀 편성 + 모델 티어 매트릭스 배정 | `phase-team` |\n| 6 | SKILL/playbook 작성 | `phase-skills` |\n| 6+ | **Model Confirmation Gate** — 에이전트-모델-스킬 통합 표로 최종 1회 승인 | (Orchestrator) |\n| 7-8 | 훅/MCP 설치 | `phase-hooks` |\n| 9 | 최종 검증 | `phase-validate` |\n| 매 Phase | 독립 비판 리뷰 | `red-team-advisor` |\n\n### Phase 1-2 경로 분기\n\n- `fresh-setup`: 신규 프로젝트 하네스 구성\n- `cursor-migration`: Cursor IDE 설정을 Claude Code로 변환\n- `harness-audit`: 기존 Claude Code 설정 진단 및 개선\n\n### Phase 2.5 — 도메인 리서치 (옵션)\n\n프로젝트의 핵심 도메인(딥 리서치 / 웹사이트 제작 / 웹툰 제작 / 유튜브 콘텐츠 / 코드 리뷰 / 기술 문서 / 데이터 파이프라인 / 마케팅 캠페인 / 프론트엔드 디자인 등)이 특정되면, Phase 1-2 Escalation에서 사용자가 도메인을 확인한 뒤 `phase-domain-research` 에이전트가 소환됩니다. 이 에이전트는 (1) `knowledge/domains/` 아래 **큐레이션 KB 9종**(6종 full + 3종 stub)과 (2) `WebSearch`/`WebFetch`로 도메인 업계의 표준 워크플로우·역할 분업·도구 스택·안티패턴을 수집해 `docs/{요청명}/02b-domain-research.md`에 저장합니다.\n\n- 후속 Phase 3-6 playbook은 이 산출물이 있으면 **자동으로 Read**해 설계 시 도메인 레퍼런스를 인용합니다.\n- 모든 외부 주장에 **출처 URL + 발췌일**이 강제되고, Advisor가 URL 샘플 검증까지 수행합니다.\n- \"해당 없음\" / 공백 / `--fast` / \"빠르게\" 키워드면 Phase 2.5를 자동 스킵하고 Phase 3로 직행합니다.\n- 라이브 검색 budget은 WebSearch 최대 6회 · WebFetch 최대 3회로 제한되며, 대상 프로젝트 식별 정보를 쿼리에 포함하지 않습니다(데이터 유출 방지).\n\n### 복잡 코딩 프로젝트 프리셋\n\n`.claude/templates/workflows/strict-coding-6step/`에 엄격한 6단계 코딩\n워크플로우(연구 → 질문 초안 → 설계·레드팀 → 구현·계획 → 구현 → 화이트/블랙박스\nQA)의 프리셋(에이전트 8 + 플레이북 8)이 포함되어 있어, 해당 유형의 프로젝트에\n자동 복사됩니다.\n\n### 프론트엔드 디자인 프리셋\n\nReact / Vue / Svelte + Tailwind 등 UI 레이어 중심 프로젝트로 감지되면, Phase 1-2 Escalation에서 사용자 확인 후 `frontend-designer` + `frontend-ux-reviewer` 에이전트 페어와 진입점 스킬이 자동 주입됩니다.\n\n- **자가 완결** — 외부 스킬 추가 설치 없이 OKLCH·APCA Lc≥60·WCAG AA·2계층 토큰·60-30-10·색맹 대응 색상 규칙이 스킬에 내장됩니다.\n- **생성-리뷰 페어 의무화** — `frontend-designer`의 모든 생성 작업은 `frontend-ux-reviewer`의 8차원(D1~D8) 감사를 반드시 거칩니다. 3회차 에스컬레이션 래더(1회 자동 재작업 → 2회 사용자 3선택 → 3회 중단) 내장.\n- **소유권 보호** — 주입된 프리셋 파일은 Phase 5·6 및 경량 트랙에서 재작성·덮어쓰기가 금지됩니다.\n\n### 오케스트레이터 라우팅 프로토콜\n\n생성된 하네스의 CLAUDE.md에는 **오케스트레이터 라우팅 프로토콜**이 자동 포함됩니다. 사용자 요청 규모(S/M/L)에 따라 메인 세션이 직접 처리할지, 전체 파이프라인을 태울지를 판단하도록 안내합니다. 코드 확인이 필요한 경우 메인 세션이 직접 Read하지 않고 `code-researcher` 에이전트를 먼저 호출하는 원칙도 포함되어, 실측 $18 이상의 불필요한 비용 오버런을 방지합니다.\n\n### 완성된 하네스 사후 감사 (v0.9.0 UX)\n\n**통합 감사** (권장):\n\n```\n/harness-architect:audit\n```\n\n3개 auditor 를 한 응답에 병렬 소환해 단일 통합 보고서를 받습니다 — 구성 정합성(anti-pattern·JSON·매핑) + 런타임 부채(세션 연속성·실패 복구·이중 관리·덮어쓰기·Jaccard·라우팅, 6 Dimension) + 프로젝트 적합성(트랙·아키타입·에이전트 규모·권한 경로·도메인 정체성·MCP/훅, 7 Dimension). 통합 severity(Critical/High/Medium/Low/Aligned)로 매핑되며 SSoT 충돌 시 ops-audit 판정 우선, 원본 등급도 항목별 병기. 파일 수정 없이 read-only.\n\n**개별 축 실행** (고급): v0.9.2 부터 단일 축 슬래시커맨드는 autocomplete 에서 제거되었고, `/harness-architect:audit` 으로 통합되었습니다. 단일 축만 실행하려면 해당 auditor 에이전트를 자연어로 직접 소환:\n\n- \"harness-auditor 에이전트를 대상 경로 {경로} 로 실행해\" — 구성 정합성만 (CRITICAL/HIGH/MEDIUM/LOW)\n- \"ops-auditor 에이전트를 대상 경로 {경로} 로 실행해\"     — 런타임 부채만 (RISK-HIGH/MED/LOW)\n- \"fit-auditor 에이전트를 대상 경로 {경로} 로 실행해\"     — 프로젝트 적합성만 (MAJOR-DRIFT-CRITICAL/MED · MINOR-DRIFT · ALIGN)\n\n설계 철학·구성·Escalation 프로토콜의 상세는 [ARCHITECTURE.md](./ARCHITECTURE.md)를 보세요.\n\n## 가드레일\n\n- **대상 프로젝트 작업 중**: 이 플러그인 자체 파일을 수정하지 않음 (`ownership-guard.sh` 훅이 `PreToolUse(Write|Edit)`로 차단)\n- **보안**: `Bash(*)`, `sudo rm *` 등 위험 패턴은 플러그인 기본 설정에서 차단 권장\n- **비밀값**: API 키·토큰은 `settings.local.json` (gitignored)으로 안내\n- **메타 누수 방지**: 생성 파일이 이 플러그인 자체의 규칙이나 Claude Code 아키텍처 설명을 포함하지 않도록 `meta-leakage-guard` 규칙과 체크리스트로 검증\n\n## 기여\n\n이슈/PR 환영합니다. 시작하기 전에 [CONTRIBUTING.md](./CONTRIBUTING.md)를 읽어주세요.\n\n## 개인정보 / 프라이버시\n\n이 플러그인은 어떤 개인정보도 수집·전송하지 않습니다. 전문은 [PRIVACY.md](./PRIVACY.md).\n\n## 라이선스\n\n[Apache-2.0](./LICENSE) · Copyright © 2026 leee880619-commits\n\n`knowledge/*.md`는 Claude Code 공식 문서(https://docs.claude.com/en/docs/claude-code)를 기반으로 한 파생 해설물입니다. 각 파일 상단의 `Source:` 주석이 원 섹션을 명시합니다.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleee880619-commits%2Fclaudecode-harness-setup-assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleee880619-commits%2Fclaudecode-harness-setup-assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleee880619-commits%2Fclaudecode-harness-setup-assistant/lists"}