feat: Opus 5.5 하네스 정리 + 손그림 다이어그램 스킬 + 워드마크 교정 (v0.1.19)

[HyeonsangKim]

Summary

Opus 5.5 출시에 맞춰 과잉 지시를 걷어내고, 사용자·Claude 모두에게 보이지 않던 게이트 경고 버그와 위험 명령 훅 오탐을 고쳤습니다. 잘리고 밋밋하던 다이어그램 스킬은 손그림 렌더러로 새로 만들었습니다.

Changes

하네스

• SessionStart 게이트 경고가 stderr + exit 0이라 아무에게도 안 보이던 버그 수정 → JSON stdout
• 효과 없던 훅 3개 삭제 (PostToolUse·Stop의 일반 stdout은 디버그 로그에만 기록됨)
• 위험 명령 훅 오탐 수정: heredoc 본문(데이터)은 검사 제외, 셸로 실행되는 heredoc은 계속 검사. 테스트 10건 추가

에이전트 · 커맨드 (Opus 5.5 대응)

• 빌드 계열 7개 에이전트 effort: high 삭제 → 세션 effort 사용 (5.5의 medium ≥ Opus 5의 high)
• ai-agent 556→71줄, architecture-decision 503→약 90줄: 낡은 모델 ID·일반론 삭제, WIGTN 규칙만 유지
• team-build-coordinator: 초 단위 타임아웃 → 시간 신호, 병렬 조건 단일화
• /implement: Phase 요약 후 멈추지 않기 규칙 추가
• design-system-reference: 현재 모델의 기본 스타일 5종을 금지 목록에 추가
• backend-architect: 존재하지 않는 스킬 참조 삭제

architecture-diagram (handdrawn-diagram 대체)

• JSON 스펙 → 브라우저 글자 측정 → ELK 레이아웃 → rough.js 손그림 SVG/PNG (clean 옵션)
• 레이어 제목 잘림 해결, 폰트를 SVG에 내장, 레이아웃 검사(넘침·겹침·관통) exit 1, 잘못된 입력 exit 2
• 폰트 다운로드 SHA 고정 + 해시 검증, 설치 잠금

wigtn-ppt

• 워드마크 폴백을 실제 로고 WIGTn.(n은 대문자 높이)에 맞게 교정

문서 · 버전

• README 3개 언어 훅 표를 실제 훅 4개로 교체, 스킬 설명·CLAUDE.md 갱신
• 0.1.19

Type

• feat — new agent / command / skill / capability
• fix — bug fix
• docs — documentation only
• refactor / chore

Checklist

• 새 agent/command/skill을 plugin.json에 등록했다 (해당 시)
• 카운트를 모두 동기화했다 — plugin.json, marketplace.json, README.{md,ko,cn} 배지/표, CLAUDE.md (해당 시)
• python3 .github/scripts/validate_plugin.py 통과
• 버전 변경 시 marketplace.json ↔ plugin.json ↔ README/CLAUDE.md 일치
• 사용자 노출 콘텐츠는 한국어 (커밋 메시지는 최근 레포 관행대로 한국어)

Test plan

• CI 스크립트 6개 로컬 통과 (validate_plugin, check_contracts, test_gate, test_knowledge_wiki, test_danger_hook 52/52, test_context_scripts)
• 위험 명령 훅 테스트를 macOS awk / mawk / gawk(Ubuntu 24.04 컨테이너)에서 모두 통과
• 다이어그램: 정상 스펙 7종 렌더 exit 0, 잘못된 스펙 8종 exit 2, npm 설치 실패 시뮬레이션 exit 2
• 렌더 결과 PNG를 직접 보고 확인 (사선·제목 관통 없음)
• effort 하향 효과는 .github/evals로 아직 측정하지 않음

Related issue

🤖 Generated with Claude Code

[wigtn-contact]

판정: 승인

변경된 파일:

• .claude-plugin/marketplace.json
• .claude-plugin/plugin.json
• .github/ISSUE_TEMPLATE/bug_report.yml
• .github/scripts/test_danger_hook.sh
• CLAUDE.md
• README.cn.md
• README.ko.md
• README.md
• plugins/wigtn-plugins/.claude-plugin/plugin.json
• plugins/wigtn-plugins/agents/ai-agent.md
• plugins/wigtn-plugins/agents/architecture-decision.md
• plugins/wigtn-plugins/agents/backend-architect.md
• plugins/wigtn-plugins/agents/design-discovery.md
• plugins/wigtn-plugins/agents/frontend-developer.md
• plugins/wigtn-plugins/agents/mobile-developer.md
• plugins/wigtn-plugins/agents/team-build-coordinator.md
• plugins/wigtn-plugins/commands/implement.md
• plugins/wigtn-plugins/hooks/hooks.json
• plugins/wigtn-plugins/skills/architecture-diagram/SKILL.md
• plugins/wigtn-plugins/skills/architecture-diagram/examples/layered-architecture.json
• plugins/wigtn-plugins/skills/architecture-diagram/examples/pipeline-flow.json
• plugins/wigtn-plugins/skills/architecture-diagram/scripts/render.cjs
• plugins/wigtn-plugins/skills/architecture-diagram/scripts/render.sh
• plugins/wigtn-plugins/skills/design-system-reference/SKILL.md
• plugins/wigtn-plugins/skills/handdrawn-diagram/SKILL.md
• plugins/wigtn-plugins/skills/wigtn-ppt/SKILL.md
• plugins/wigtn-plugins/skills/wigtn-ppt/references/brand.md
• plugins/wigtn-plugins/skills/wigtn-ppt/references/design-guide.md

확인한 내용:

• 기존 handdrawn-diagram 스킬을 architecture-diagram으로 교체하고, JSON 스펙 검증·브라우저 텍스트 측정·ELK 배치·SVG/PNG 렌더링·레이아웃 검사를 포함한 구현을 확인했습니다.
• 에이전트 프롬프트를 현재 하네스에 맞게 축약하고, 위험 명령 훅의 heredoc 데이터 처리와 커밋 게이트 문서·구성을 확인했습니다.
• 매니페스트와 README의 버전·스킬 참조가 일치합니다.
• 차단할 동작 문제는 찾지 못했습니다.

검증

• 방법: CI
• 명령/체크: Validate plugin manifests & counts
• 결과: 통과
• 근거: https://github.com/wigtn/wigtn-plugins/actions/runs/36605090269/job/109531960105

검토한 head SHA: 2d84ca8eca7c94140095df2b796cc9d3e3388faa

이 리뷰가 도움이 됐으면 👍, 지적이 틀렸으면 👎 를 눌러주세요. 오탐 집계에 씁니다.

[wigtn-contact]

변경 파일과 검증 결과는 요약 코멘트를 확인해 주세요.