Skip to content

feat(harness): add interview-driven HRD workflow and HITL architecture review gates#10

Open
leebaro wants to merge 1 commit intorevfactory:mainfrom
leebaro:feat/harness-interview-hrd-workflow
Open

feat(harness): add interview-driven HRD workflow and HITL architecture review gates#10
leebaro wants to merge 1 commit intorevfactory:mainfrom
leebaro:feat/harness-interview-hrd-workflow

Conversation

@leebaro
Copy link
Copy Markdown

@leebaro leebaro commented Apr 29, 2026

Summary

  • Phase 1을 단순 도메인 분석에서 인터뷰 기반 요구사항 정의로 개선
  • HRD (Harness Requirements Document) 불변 스냅샷 체계 도입으로 설계 이력 추적 가능
  • HITL Gate 1 (아키텍처 승인) / HITL Gate 2 (스킬 설계 승인) 추가로 사용자 확인 없는 파일 생성 방지
  • references/hrd-template.md, references/interview-guide.md 신규 추가

Motivation

기존 harness 스킬은 도메인을 자동으로 분석하고 바로 에이전트/스킬 파일을 생성했습니다. 이로 인해 사용자의 실제 요구와 다른 구조가 생성되거나, 중간에 방향을 수정하기 어려운 문제가 있었습니다.

이번 변경으로:

  • 5축 인터뷰 프레임(도메인/작업유형/입출력/품질기준/재사용성)으로 요구사항을 체계적으로 수집
  • 6-상태 감지 테이블로 중단된 작업을 자동으로 재개 지점에서 재시작
  • HITL Gate를 통과하기 전에는 .claude/agents/, .claude/skills/ 파일을 생성하지 않음

Scope

변경 파일은 skills/harness/ 하위에 한정됩니다:

  • skills/harness/SKILL.md — Phase 1 재정의, HRD 상태 감지 로직, HITL Gate 1/2 추가
  • skills/harness/references/hrd-template.md — 신규: HRD 파일 규칙, 불변 스냅샷 원칙, HITL Gate 프로토콜
  • skills/harness/references/interview-guide.md — 신규: 5축 인터뷰 가이드, 질문 형식, Fast Path
  • skills/harness/references/orchestrator-template.md_workspace/ 초기 생성 설명 단순화

Tests

  • 로컬에서 claude plugin link ./harness 후 신규 하네스 구성 요청 시 인터뷰 → HRD 생성 → Gate 1/2 흐름 동작 확인
  • 기존 하네스 구성 재시작 시 6-상태 감지로 중단 지점 복귀 동작 확인

CHANGELOG

  • 이 변경은 CHANGELOG 항목이 필요합니다 (feat: → minor version bump)

SemVer Impact

feat:minor version bump (하위 호환, 기능 추가)

🤖 Generated with Claude Code

…e review gates

- Phase 1을 도메인 분석에서 인터뷰 & 요구사항 정의로 개선
- 5축 인터뷰 프레임(도메인/작업유형/입출력/품질기준/재사용성) 도입
- HRD(Harness Requirements Document) 불변 스냅샷 체계 추가
- 아키텍처 승인(HITL Gate 1) 및 스킬 설계 승인(HITL Gate 2) 게이트 추가
- 6-상태 감지 테이블로 재개(resume) 지점 자동 판별
- references/hrd-template.md, references/interview-guide.md 신규 추가

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant