# context-package — 단일 컴파일러(context_package.py --compile)가 발급한 스켈레톤.
# spawn 전: 아래 placeholder를 채우고 `python3 .claude/hooks/context_package.py hyeonworks/state/context-packages/hyeonworks-vnext-v1-direction/DES-VISUAL-20260718T113209Z.pkg.yaml` 가
# exit 0(통과)이어야 워커를 spawn한다. 스키마·규칙: org-os/06-agent-work/context-package-spec.yaml
# 아직 채워야 하는 필드(발급 시점):
#   - 필수 필드 비어있음(placeholder 미충전): objective
#   - 필수 필드 비어있음(placeholder 미충전): allowed-tools
#   - 필수 필드 비어있음(placeholder 미충전): task-boundaries
#   - 필수 필드 비어있음(placeholder 미충전): must-read
#   - 필수 필드 비어있음(placeholder 미충전): acceptance-tests
#   - 필수 필드 비어있음(placeholder 미충전): non-goals
#   - 필수 필드 비어있음(placeholder 미충전): evidence-plan
workflow-id: hyeonworks-vnext-v1-direction
task-id: direction-ledger-studio
mode: divergent
tier: standard
model: sonnet
effort: medium
assigned-lens: null
target-role-agent: DES-VISUAL
workspace: hyeonworks
target-repo: hyeonworks
objective: >-
  ledger-studio 전용 격리 run으로 dual-entry-shared-lab 대표 화면을 검토·완성한다.
  편집형 기술 저널과 causal ledger 문법을 유지하면서 두 입구가 동일 Lost Update Lab으로
  합류한다는 사실, 학습 깊이, 접근성을 실제 coded slice와 concept artifact로 증명한다.
output-format: report.yaml (report-header BLUF로 시작) + 최종 메시지로 report-path + 1줄 bottom-line
  반환
allowed-tools: [Read, apply_patch, exec_command, view_image]
task-boundaries: >-
  hyeonworks/design-direction/hyeonworks-vnext-v1/directions/ledger-studio 안의 index.html과
  concept.yaml만 소유한다. 제공된 ledger-studio 방향 브리프 밖의 조형 언어를 섞지 않고,
  화면 코드를 검토하여 필요한 품질 수정 후 근거와 reference cluster를 concept.yaml에 기록한다.
non-goals:
  - signal-trace 또는 field-manual 산출물·미리보기 열람이나 차용
  - 제품 전략·시나리오 값·공통 학습 루프 변경
  - 앱 전체 구현, 디자인 시스템화, 외부 네트워크·배포
must-read:
  - hyeonworks/design/hyeonworks-vnext-v1/direction-input-brief.yaml
  - hyeonworks/completion-records/hyeonworks-vnext-v1-direction/DES-DIRECTOR-20260718T111440Z.report.yaml
  - hyeonworks/design-direction/hyeonworks-vnext-v1/direction-briefs/ledger-studio.yaml
inherited-decisions: []
acceptance-tests:
  - criterion: "concept.yaml이 visual thesis, 3~6개 reference cluster, layout/interaction/type/primitive 문법을 구체적으로 기록한다."
    verify: "test -f hyeonworks/design-direction/hyeonworks-vnext-v1/directions/ledger-studio/concept.yaml"
  - criterion: "대표 HTML이 두 한국어 진입 라벨, tx-lost-update-01, Predict/Observe/Compare/Explain/Transfer, guided scenario 경계를 모두 포함한다."
    verify: "rg -n '개념을 알고 있어요|증상만 알고 있어요|tx-lost-update-01|Predict|Guided scenario' hyeonworks/design-direction/hyeonworks-vnext-v1/directions/ledger-studio/index.html"
  - criterion: "360px responsive CSS, focus-visible, reduced-motion 대안이 존재한다."
    verify: "rg -n '@media|max-width|focus-visible|prefers-reduced-motion' hyeonworks/design-direction/hyeonworks-vnext-v1/directions/ledger-studio/index.html"
evidence-plan:
  - claim: "대표 화면이 실제 코드로 구현되고 필수 학습 구조를 포함한다."
    grade: E4
    receipt: hyeonworks/design-direction/hyeonworks-vnext-v1/directions/ledger-studio/index.html
  - claim: "1280 및 390 viewport에서 브라우저 렌더가 생성된다."
    grade: E5
    receipt: hyeonworks/design-direction/hyeonworks-vnext-v1/previews/ledger-desktop.png
method-selection:
  method-id: art-direction
design-brief:
  brief-phase: pre-direction
  brief:
    what: "두 진입과 공통 Lost Update 실험을 한 편집형 기술 저널 화면으로 구현"
    who: "개념 또는 증상 단서에서 시작해 내부 인과를 깊게 학습하려는 개발자"
    must-accomplish: "다른 두 입구, 동일 시나리오, 예측에서 전이까지의 학습 루프를 첫 화면에서 이해시킨다"
  references:
    - {name: "scientific lab notebook", signal: "가설·관찰·결과가 선과 여백 주석으로 연결", why-relevant: "학습을 수동 독서가 아닌 검증 기록으로 만든다"}
    - {name: "long-form technical journal", signal: "큰 serif 논제와 절제된 본문 위계", why-relevant: "단일 주제의 깊이를 카탈로그 규모보다 앞세운다"}
    - {name: "double-entry ledger", signal: "초기·기대·관찰 값을 같은 기준선에서 비교", why-relevant: "덮어쓴 값을 시각적으로 감사 가능하게 한다"}
  tokens:
    - {name: paper, value: "#f5f1e8", intent: "집중 읽기용 바탕", boundary: "장식 gradient로 쓰지 않음"}
    - {name: evidence-coral, value: "#bb4d3b", intent: "관찰 결과와 증상 단서", boundary: "일반 본문이나 모든 CTA에 쓰지 않음"}
    - {name: ledger-rule, value: "1px solid #17201f", intent: "인과·비교 경계", boundary: "모든 요소를 카드화하지 않음"}
  decisions:
    - {question: "serif와 mono를 언제 쓰나", rule: "논제·설명은 serif, id·값·evidence annotation만 mono"}
    - {question: "entry를 분리할 때", rule: "orientation 카피만 2열, 합류 이후는 단일 ledger로 표시"}
  donts: ["보라 SaaS gradient", "glass card grid", "neon terminal", "거대한 가짜 Atlas map", "증상 경로의 확정 진단 표현", "두 entry의 별도 Lab", "색만으로 세션 구분", "드래그 전용 상호작용"]
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