be-harness

be-harness project profile(.claude/be-harness.local.md)의 설정 값을 조회하고 키 단위로 수정한다. '프로필 설정 확인해줘', '설정 값 바꿔줘', '{키} 값 뭐야', '{키}를 {값}으로 바꿔줘' 요청 시, init 재실행 없이 값 하나만 보거나 고칠 때 사용. 파일 생성·환경 진단은 하지 않는다 (init·doctor 담당).

프로젝트 컨벤션 위배 사항을 검사하고 보고한다 (보고 전용 — 코드를 수정하지 않음). 커밋/PR 전 점검, '컨벤션 검사해줘' 요청 시 사용. --init으로 적용 컨벤션 선택, --doctor로 설정 진단.

be-harness 범용 개발 가이드라인 (컨벤션 참조 문서). convention-check가 검사 기준으로 로드하며, 코드 작성 원칙이 궁금할 때도 사용. 프로젝트별 세부 컨벤션은 CLAUDE.md 또는 profile의 projectConventions에서 로드한다.

be-harness 환경 상태를 진단한다. profile 유효성, 명령 실행 가능성, Git 상태, convention 설정을 점검. 워크플로우가 SKIP을 내거나 설정이 의심될 때, '환경 진단해줘' 요청 시 사용.

기능 추가/수정 후 연관 HTTP API를 실제 요청으로 E2E 테스트한다. 'API 실제로 테스트해줘', 구현 검증이 필요할 때 사용. profile의 runServerCommand/serverUrl 기반, Bash+curl로 요청하고 Python/POSIX 실행 잠금을 사용.

E2E 테스트 → 이슈 수정 → 재테스트를 반복한다 (최대 5회). 종료 시 정직한 자기 점검 md 리포트를 스크립트로 생성한다. 기능 구현 후 'E2E 돌려줘', '테스트 통과할 때까지 고쳐줘' 요청 시 사용. start-workflow 품질 루프에서 자동 호출됨.

be-harness 플러그인의 project profile(.claude/be-harness.local.md)을 대화형으로 생성/갱신한다. 플러그인 최초 설정, '초기화해줘', doctor가 MISSING을 보고할 때 사용. Go/Node 프리셋 지원.

작업 유형별(생성/수정/검토/디버깅) 단계적 질문을 통해 실행 가능한 Technical Spec을 생성한다. 'API 만들어줘', '스펙 정리해줘', 요구사항이 모호해 명세가 필요할 때 사용. start-workflow Phase 1에서 자동 호출됨.

변경 코드의 단순화 후보를 4관점 리뷰 Workflow 루프로 수렴할 때까지 반복 적용한다 (최대 10회, Workflow tool 미지원 시 빌트인 /simplify 반복 폴백). 구현 직후 코드 단순화 정리, '심플리파이 돌려줘', '코드 간소화' 요청 시 사용. start-workflow 품질 루프에서 자동 호출됨.

전체 개발 워크플로우를 자동화한다. Build 모드(기본): 요청 분석 → 구현 → 품질 루프 → PR. Analyze 모드(--analyze): 코드 분석 보고서. Verify 모드(--verify): 보안·성능·버그·안정성 검증. '워크플로우 시작', '기능 구현해줘(전 과정 자동)', '코드 분석/검증해줘' 요청 시 사용.

Spec의 추적 ID(AC/EC/RC)를 근거로 단위 테스트를 필요한 만큼만 작성하고 실행한다. '테스트 작성해줘', '유닛 테스트 돌려줘', 구현 전 실패 테스트를 먼저 만들 때 사용. start-workflow Phase 6.1에서 자동 호출됨.