help

harness-architect — 사용법

이 플러그인은 대상 프로젝트를 분석해 Claude Code 하네스(CLAUDE.md, settings, rules, agents, playbooks, hooks, MCP)를 9-Phase 오케스트레이션으로 구축합니다.

아래 내용을 사용자에게 있는 그대로 출력하세요. AskUserQuestion/Agent 소환 없이 정적 안내만 수행합니다.

중요 — 정적 출력 규약: 본 문서 전체(특히 아래 "두 가지 사용 시나리오" 의 코드 블록)는 사용자가 직접 타이핑·실행할 명령어를 보여주는 안내 텍스트입니다. help 커맨드는 어떠한 경우에도 그 안의 /harness-architect:harness-setup, /harness-architect:audit 등을 자동 실행하거나, AskUserQuestion 으로 경로를 묻거나, 에이전트를 소환하지 않습니다. 사용자가 실행을 원하면 /harness-architect:harness-setup 또는 /harness-architect:audit 를 별도의 슬래시커맨드로 다시 호출 하도록 유도만 합니다.

---

🚀 빠른 시작

/harness-architect:harness-setup
/harness-architect:harness-setup /absolute/path/to/project

• 인자 없이 호출하면 Phase 0에서 대상 프로젝트 경로를 물어봅니다.
• 인자로 절대 경로를 주면 경로 질문을 생략하고 바로 인터뷰로 진입합니다.
• "빠르게" 또는 --fast 를 초기 발화에 포함하면 도메인 리서치(Phase 2.5)를 스킵합니다.

---

📋 주요 커맨드 (모두 이 3개로 끝남)

커맨드	역할	언제 쓰는가	출력
/harness-architect:harness-setup [경로]	9-Phase 하네스 구축·재구축·재개 (메인 진입점)	신규 설치 또는 감사 결과 적용	BLOCK / ASK / NOTE
/harness-architect:audit [경로]	기존 하네스 통합 감사 — 구성 정합성 + 런타임 부채 + 프로젝트 적합성을 3개 auditor 로 병렬 실행 후 단일 통합 보고서 (read-only)	기존 하네스 점검	통합 Critical/High/Medium/Low/Aligned
/harness-architect:help	이 사용법 안내	—	—

autocomplete 단순화를 위해 노출 슬래시 커맨드는 위 3개로 제한되어 있습니다. 세부 auditor (harness-auditor / ops-auditor / fit-auditor) 는 audit 커맨드 내부에서 자동 병렬 호출되며, 단독 실행이 필요하면 /harness-architect:audit 의 "개별 auditor 단독 실행" 섹션 안내를 따르세요.

---

🧭 두 가지 사용 시나리오

시나리오 A — 신규 설치

/harness-architect:harness-setup /absolute/path/to/project

Phase 9 final-validation 이 빌드 직후 보안·실패 복구·라우팅·개방형 루프 금지 문구를 모두 검증하므로 추가 감사 없이 완결됩니다.

시나리오 B — 기존 하네스 점검 → 개선 적용

# 1) 감사 (read-only, 파일 수정 없음)
/harness-architect:audit /absolute/path/to/project

# 2) 통합 보고서 확인 후, Critical/High 가 있으면 적용:
/harness-architect:harness-setup /absolute/path/to/project
#   → Phase 0 가 기존 docs/{요청명}/ 를 감지하고 "계속 / 새로 시작?" 질문
#   → "계속" 선택 시 마지막 완료 Phase 부터 재개 (보고서 항목을 해당 Phase 산출물에 반영 후 재실행)
#   → "새로 시작" 선택 시 처음부터 9-Phase 재구축 (MAJOR-DRIFT-CRITICAL 다수일 때 권장)

# 3) 수정 완료 후 재감사로 버킷 감소 확인:
/harness-architect:audit /absolute/path/to/project