3.5 KiB
3.5 KiB
하네스 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.pyevidence 자동등급: command+exit-code 0 → E5(테스트/실행), 도구산출 → E4, 문서참조 → E3 이하. 자기신고 grade는 아티팩트로 검증.- 라이브 관통: 작은 요청 1건을
/ceo-intake → plan-wave → run-wave → review-output흐름으로 돌려 completion-record 생성 →stop_validate가 실제 게이팅하는지 확인.
성공 기준
- 62 role-profiles(관점/시야/책임/evidence-basis) + 26 agent가 그 알맹이로 재생성(generic 문구 아님).
- report-templates.yaml + CLAUDE.md 존재, 7개 문서 삭제 후 정합성 게이트·에이전트 richness 무손실.
- evidence 자동등급 테스트 통과.
- 라이브 1건 관통 + 산출물 hook 검증 통과.
- 기존 org-os 정합성 게이트(62/26/11/tier/mode) + enforcement 테스트 무회귀.
범위 밖
실제 회사 콘텐츠(01~05,07 실물 채우기), MCP 연동, hook 라이브 상시활성(템플릿 제공).