메뉴
대화 맥락이나 발견한 버그·작업거리를 팀 컨벤션(AGENT.md)에 맞는 GitHub 이슈로 등록한다. 라벨·담당자 배정까지 한 번에. "이슈 등록해줘", "이거 이슈로 만들어", 남의 영역 버그를 발견했을 때 사용.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
디자인 브릿지(JSON)를 읽어 코드 생성 계획서 plan.md를 만든다. 컴포넌트 분해, 파일 구조, 디자인 토큰 매핑, 구현 순서를 정리한다. 딸깍 파이프라인 2단계, 또는 사용자가 bridge JSON으로 계획을 세울 때 사용.
Figma MCP 또는 기록된 MCP 캐시를 사용해 Figma 디자인을 무손실 플랫폼 중립 Bridge IR(JSON)로 산출한다. 스타일·토큰·레이아웃·적응형 화면 조건·constraints·자산·텍스트 동작을 캡처하고 스크린샷과 교차검증한다. 웹, React, React Native, iOS, Android로 이어지는 딸깍 파이프라인 1단계에서 사용.
Figma URL을 받아 코드까지 한 번에(딸깍) 뽑는 전체 파이프라인을 실행한다. design.md → 디자인 브릿지(JSON) → plan.md → code → 검증을 순서대로 돌린다. 기본은 각 단계 사이에서 [skip / 계속]을 사용자에게 확인하는 gated 모드이고, `--auto`(자동 모드)를 주면 게이트 없이 끝까지 이어서 돌린다. 사용자가 "figma에서 코드 뽑아줘", "딸깍 돌려줘", "자동으로 돌려줘" 같이 전체 흐름을 원할 때 사용.
생성된 코드가 Figma 디자인과 같은지 LLM 없이 정적 visual verification engine으로 검증한다. Playwright 캡처, 기준 screenshot 픽셀 diff, bridge bbox 영역별 mismatch로 판정하고, DOM computed style check는 advisory evidence로 리포트한다. 딸깍 파이프라인 4단계, 또는 사용자가 구현이 디자인과 맞는지 확인할 때 사용.
plan.md를 읽어 실제 코드를 생성한다. 파일 계획·구현 순서를 따르고, 컴포넌트 재사용을 우선하며 디자인 토큰을 코드 스타일로 매핑한다. 있으면 design.md 팀 컨벤션을 따르고 없어도 동작한다. verify 리포트가 있으면 짚어진 불일치만 규칙대로 고치는 fix 모드로도 동작한다. 딸깍 파이프라인 3단계, 또는 사용자가 plan.md로 구현을 요청하거나 verify 결과를 반영해달라 할 때 사용.
검증 리포트를 바탕으로 파이프라인을 마무리한다. 남은 불일치 수정 여부를 확인하고, 산출물을 정리하며 최종 요약을 낸다. 딸깍 파이프라인 5단계에서 사용.
| name | issue |
| description | 대화 맥락이나 발견한 버그·작업거리를 팀 컨벤션(AGENT.md)에 맞는 GitHub 이슈로 등록한다. 라벨·담당자 배정까지 한 번에. "이슈 등록해줘", "이거 이슈로 만들어", 남의 영역 버그를 발견했을 때 사용. |
대화에서 나온 버그·작업거리를 컨벤션에 맞는 GitHub 이슈로 만든다.
컨벤션 SSOT: 프로젝트 루트 AGENT.md (제목 프리픽스, 라벨, R&R 표) — 먼저 읽는다.
.github/ISSUE_TEMPLATE/의 해당 양식을 채운다:
bug.md, 작업·기능이면 work.md. 섹션 목록의 단일 출처는 그 양식 파일이다.[bug] / [work] / [doc] / feat(<영역>): 프리픽스 + 한 줄 요약..github/labeler.yml의 영역 매핑에 대조해 영역 라벨 결정, 성격 라벨(bug/enhancement) 추가.AGENT.md의 R&R 표에서 소유 경로 기준으로 담당을 정한다.
--assignee 생략하고 본문에 담당: <닉네임>을 적는다.gh issue create --title "<제목>" --label "<라벨,라벨>" [--assignee <핸들>] --body "<본문>"
gh issue list --search "<키워드>"로 중복 이슈가 없는지 확인한다. 있으면 새로 만들지 말고 그 이슈에 코멘트를 남긴다./ddalkak:hunt <번호>를 안내한다.