Files
company-haness/hyeonworks/state/context-packages/hyeonworks-vnext-v1-direction/DES-VISUAL-20260718T113223Z.pkg.yaml
T

89 lines
5.7 KiB
YAML

# context-package — 단일 컴파일러(context_package.py --compile)가 발급한 스켈레톤.
# spawn 전: 아래 placeholder를 채우고 `python3 .claude/hooks/context_package.py hyeonworks/state/context-packages/hyeonworks-vnext-v1-direction/DES-VISUAL-20260718T113223Z.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-signal-trace
mode: divergent
tier: standard
model: sonnet
effort: medium
assigned-lens: null
target-role-agent: DES-VISUAL
workspace: hyeonworks
target-repo: hyeonworks
objective: >-
signal-trace 전용 격리 run으로 dual-entry-shared-lab 대표 화면을 검토·완성한다.
밝은 계측 rail과 transaction trace 문법으로 시간적 인과를 명확히 하되 terminal/hacker
미학을 피하고, 두 진입이 동일 reducer·시나리오로 합류함을 coded slice로 증명한다.
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/signal-trace 안의 index.html과
concept.yaml만 소유한다. signal-trace 브리프의 rail·band·probe 문법 안에서 품질을 검토·수정한다.
non-goals:
- ledger-studio 또는 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/signal-trace.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/signal-trace/concept.yaml"
- criterion: "대표 HTML이 두 한국어 진입 라벨, tx-lost-update-01, 공통 학습 루프, guided scenario 경계를 포함한다."
verify: "rg -n '개념을 알고 있어요|증상만 알고 있어요|tx-lost-update-01|Predict|GUIDED' hyeonworks/design-direction/hyeonworks-vnext-v1/directions/signal-trace/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/signal-trace/index.html"
evidence-plan:
- claim: "대표 화면이 실제 코드로 구현되고 필수 학습 구조를 포함한다."
grade: E4
receipt: hyeonworks/design-direction/hyeonworks-vnext-v1/directions/signal-trace/index.html
- claim: "1280 및 390 viewport에서 브라우저 렌더가 생성된다."
grade: E5
receipt: hyeonworks/design-direction/hyeonworks-vnext-v1/previews/signal-desktop.png
method-selection:
method-id: art-direction
design-brief:
brief-phase: pre-direction
brief:
what: "두 입력 신호가 한 transaction trace로 합류하는 기술 학습 화면"
who: "시간 순서와 상태 변화로 동시성 원인을 이해하려는 개발자"
must-accomplish: "입구의 차이와 공통 실험의 동일성, 100→150/70 실행 순서를 즉시 판독하게 한다"
references:
- {name: "railway signal diagram", signal: "독립 입력선이 명시적 junction에서 단일 선로로 합류", why-relevant: "두 입구·하나의 Lab을 구조로 설명"}
- {name: "logic analyzer trace", signal: "시간축 행과 채널별 상태를 정렬", why-relevant: "read/write 선후관계를 빠르게 비교"}
- {name: "industrial instrument panel", signal: "숫자 probe와 라벨이 장식 없이 상태를 표시", why-relevant: "initial/expected/observed 비교의 정밀성"}
tokens:
- {name: trace-blue, value: "#176c8a", intent: "session A와 concept 입력", boundary: "본문 배경 장식 금지"}
- {name: trace-red, value: "#a24a3f + hatch", intent: "session B와 overwrite 충돌", boundary: "색 단독 의미 전달 금지"}
- {name: merge-green, value: "#165f54", intent: "공통 Lab junction", boundary: "일반 CTA 남용 금지"}
decisions:
- {question: "band와 rail 구분", rule: "진입 전은 2개 band, 합류 후는 하나의 trace table만 사용"}
- {question: "animation 사용", rule: "현재 실행 segment 강조만 허용하고 reduced-motion에서는 굵기·패턴으로 교체"}
donts: ["neon terminal", "검은 hacker console", "glow effect", "dashboard KPI grid", "색만으로 채널 구분", "실제 모니터링 제품 암시", "형제 방향의 editorial folio", "드래그 전용 trace"]
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