# 하네스 95% 완성 설계 (접지 + 완성 + 증명)

- 작성일: 2026-07-05
- 목표: 하네스 기계 완성 + 에이전트 알맹이 접지 + **라이브 1건 관통 증명**
- 결정: subagent 26 유지, 7개 root 문서는 **추출 후 삭제**, git 미사용
- 95% 정의: 기계가 완성되고 알맹이가 채워져 실제로 한 바퀴 돎. 실제 회사 콘텐츠(비전/제품 실물)는 "운영"이라 제외(골격·샘플 1건만).

## 문제
생성된 26 agent가 generic 껍데기다 — 각 역할의 관점/시야/책임/근거가 안 담겼다. 그 richness의 원천인 7개 문서를 삭제 예정이므로, **먼저 추출해 org-os에 흡수한 뒤 삭제**해야 한다.

## 1단계 — 에이전트 접지
### 신규 `org-os/00-role-registry/role-profiles.yaml`
62역할 각각: `role-id, role-name, perspective(관점), scope(시야), responsibilities[], evidence-basis[]`.
- 출처: `직무별 관점 시야 책임 정리.md`(관점/시야/책임) + `IT 대기업 직무 성장 분석.md` + `IT 대기업 비즈니스 직무 분석.md`(GTM).
- `evidence-basis`: 각 역할이 무엇을 근거로 작업하나 — org-os 산출물/지표/lens에 연결(신설).
- roles.yaml의 62 role-id 전부 정확히 1개 profile. 문서에 없는 역할은 인접에서 파생하고 표시.

### `gen_agents.py` 업그레이드
각 family를 소속 member roles의 profile로 조립 → 에이전트 body에 "이 family가 대표하는 역할별 관점/시야/책임 + 공통 근거기준" 포함. 26개 재생성.

## 2단계 — 흡수 + CLAUDE.md + 삭제
- 신규 `org-os/06-agent-work/report-templates.yaml`: `직무별 보고서 템플릿 및 소통 체계.md`의 핵심 보고 구조(AI Work Report, Executive Decision Packet, completion-record, blocked-report, decision-brief)를 BLUF-first 스키마로 흡수.
- 신규 root `CLAUDE.md`: 하네스 개요(Org OS 구조, families/lenses/tiers/modes, hooks, 실행법, 규칙). 매 세션 로드되는 메모리.
- **흡수 검증**: 추출 산출물이 존재·정합하면 7개 root 문서 삭제.
  - 삭제 대상: `Claude Code 구성 명세.md`, `deep-research-report.md`, `IT 대기업 비즈니스 직무 분석.md`, `IT 대기업 직무 성장 분석.md`, `직무별 보고서 템플릿 및 소통 체계.md`, `직무별 관점 시야 책임 정리.md`, `보고서.md`.

## 3단계 — 기계 완성 + 라이브 증명
- 오케스트레이션 command(`.claude/commands/`): `plan-wave`(Magentic 듀얼 원장 plan.md+progress.yaml + stall/round 한도), `run-wave`, `review-output`, `release-check`.
- `validate_report.py` evidence 자동등급: command+exit-code 0 → E5(테스트/실행), 도구산출 → E4, 문서참조 → E3 이하. 자기신고 grade는 아티팩트로 검증.
- **라이브 관통**: 작은 요청 1건을 `/ceo-intake → plan-wave → run-wave → review-output` 흐름으로 돌려 completion-record 생성 → `stop_validate`가 실제 게이팅하는지 확인.

## 성공 기준
1. 62 role-profiles(관점/시야/책임/evidence-basis) + 26 agent가 그 알맹이로 재생성(generic 문구 아님).
2. report-templates.yaml + CLAUDE.md 존재, 7개 문서 삭제 후 정합성 게이트·에이전트 richness 무손실.
3. evidence 자동등급 테스트 통과.
4. 라이브 1건 관통 + 산출물 hook 검증 통과.
5. 기존 org-os 정합성 게이트(62/26/11/tier/mode) + enforcement 테스트 무회귀.

## 범위 밖
실제 회사 콘텐츠(01~05,07 실물 채우기), MCP 연동, hook 라이브 상시활성(템플릿 제공).