Files
company-haness/hyeonworks/state/context-packages/hyeonworks-vnext-v2/ux-researcher-20260720T115952Z.pkg.yaml
T

81 lines
4.3 KiB
YAML

workflow-id: hyeonworks-vnext-v2
task-id: evidence-pack-user
mode: divergent
tier: standard
model: sonnet
effort: medium
assigned-lens: LENS-CUSTOMER
target-role-agent: ux-researcher
workspace: hyeonworks
target-repo: hyeonworks
objective: >-
이번 discovery의 **공통 evidence pack 중 user 부분**을 만든다. 고정된 문제공간(복잡한 시스템 동작을
정적 문서만으로 이해하기 어렵거나, 증상·결과를 내부 상태 변화와 인과에 연결하기 어려운 개발자)에서
실제 학습 painful job과 현재 대처 방식을 외부 근거로 접지하고, 고정 옵션 집합 A/B/C(+조건부 D)를
LENS-CUSTOMER(사용자 문제 적합성·학습성과) 관점에서 동일하게 평가한다. 선택하지 않는다.
output-format: report.yaml (report-header BLUF로 시작) + 최종 메시지로 report-path + 1줄 bottom-line
반환
allowed-tools: [Read, Grep, Glob, Write, WebSearch, WebFetch]
allowed-paths:
- hyeonworks/completion-records/hyeonworks-vnext-v2
- hyeonworks/design/hyeonworks-vnext-v2
task-boundaries: >-
ground-boundary.yaml의 fixed-problem-space를 침범하지 않는다(실장애 확정·운영로그·원격DB·AI자동진단
제품으로 확장 제안 금지). v1의 dual-entry와 5단계 고정 루프는 baseline일 뿐 전제가 아니다 —
사용자 근거가 지지하지 않으면 지지하지 않는다고 쓴다. **옵션별 별도 중복 조사를 하지 않는다.**
사용자 실측 데이터가 없으므로 E2 상한·confidence Med 이하를 지키고 '실측했다'고 주장하지 않는다.
보고서는 hyeonworks/completion-records/hyeonworks-vnext-v2/UX-RESEARCHER-20260720T115855Z.report.yaml
**한 개만** 쓴다.
non-goals: [옵션 선택·수렴, information architecture, wireframe, 시각 방향, 디자인 시스템, 프로토타입,
구현, 하나의 안 옹호, 옵션별 중복 조사, 실측 없는 정량 주장]
must-read:
- hyeonworks/design/hyeonworks-vnext-v2/ground-boundary.yaml
- hyeonworks/completion-records/hyeonworks-vnext-v2/EXEC-CEO-20260720T110525Z.report.yaml
- hyeonworks/completion-records/hyeonworks-vnext-v1/EXEC-CEO-20260718T111108Z.report.yaml
- hyeonworks/app/README.md
- hyeonworks/design/hyeonworks-vnext-v1/direction-input-brief.yaml
inherited-decisions:
- {decision-id: EXEC-CEO-20260720T110525Z, summary: "v2 intake — mode=divergent, tier=standard, 문제공간 고정·해결공간 개방"}
acceptance-tests:
- criterion: >-
학습 painful job이 외부 근거(개발자 학습 행태·기존 학습자료의 실패 지점)에 접지되고,
v1의 dual-entry 전제가 사용자 근거로 지지되는지 여부가 명시적으로 판정된다.
verify: "python3 .claude/hooks/validate_report.py hyeonworks/completion-records/hyeonworks-vnext-v2/UX-RESEARCHER-20260720T115855Z.report.yaml"
- criterion: >-
A/B/C(+조건부 D) 각 옵션에 대해 'target user와 painful job' / '학습성과 가설' /
'evidence refs' / 'unresolved assumptions'가 채워져 있다.
verify: "python3 .claude/hooks/validate_report.py hyeonworks/completion-records/hyeonworks-vnext-v2/UX-RESEARCHER-20260720T115855Z.report.yaml"
evidence-plan:
- {claim: "개발자가 동시성·시스템 동작을 학습할 때 겪는 실제 실패 지점", grade: E2, receipt: "외부 학습자료·커뮤니티 논의 URL + 확인 시점"}
- {claim: "v1이 dual-entry를 미검증 상태로 확정했다는 사실", grade: E3, receipt: "EXEC-CEO-20260718T111108Z dissent 항목 인용"}
- {claim: "옵션별 학습성과 가설", grade: E2, receipt: "학습과학·외부 사례에서 도출한 가설 — 실측 아님을 명시"}
expected-output:
report-header:
bottom-line: ''
decision-needed:
needed: false
approver: null
confidence:
value: Med
derived-from: evidence
risks: []
evidence: []
token-budget:
max-input-tokens: 60000
max-output-tokens: 8000
max-tool-calls: 80
max-attempts: 2
max-cumulative-tokens: 136000
rehydration:
max-summary-input: 16000
full-read-triggers:
- tier-heavy
- critical-claim
- dissent-present
- confidence-low
- reviewer-request
- projection-conflict
rehydration-policy: projection-first-expand-on-trigger
method-selection:
method-id: user-research