메뉴
워크숍 진행 상태를 Airtable에 공유합니다. 초기 설정(키 등록), 단계별 상태 보고, 전체 현황 조회, 진행자용 테이블 생성을 모두 포함합니다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
워크숍 사전 준비 가이드(packages/guide/site/ 의 index.html + guide-images/)를 S3에 싱크하고 CloudFront 캐시를 무효화해 배포한다. "가이드 배포", "가이드 올려줘", "S3에 싱크", "CloudFront invalidate", "가이드 사이트 업데이트", "캐시 무효화", "가이드 반영" 같은 요청이나, packages/guide/site/ 의 HTML·이미지를 수정한 뒤 라이브에 반영하려는 모든 상황에서 반드시 이 스킬을 사용한다. CDK 전체 스택(deploy/destroy)을 건드리지 않고 콘텐츠만 빠르게 밀어넣는 경량 경로다. 버킷명·배포 ID는 CloudFormation 스택 출력에서 자동 조회하므로 사용자가 ID를 외울 필요가 없다.
Nuxt/Vue 기반 웹 화면을 chrome-devtools-mcp 플러그인으로 직접 보고 고치는 비주얼 디버깅 워크플로. 사용자가 화면이 이상하다고 말하거나, 스크린샷·콘솔에러·레이아웃·반응형·접근성·네트워크·성능 문제를 보고할 때, 또는 단순히 "화면 봐줘", "지금 어떻게 보여?", "PRD/ADR 대로 됐는지 확인해줘" 같은 요청을 받으면 반드시 이 스킬을 트리거한다. localhost dev 서버(보통 :3000)에서 동작하는 PoC 를 디버깅하기 위해 만들어졌고, 추측으로 코드를 고치지 않고 **브라우저 실제 상태를 먼저 확인한 뒤** 수정하도록 강제한다.
프로젝트 루트의 DESIGN.md(디자인 시스템 단일 소스 오브 트루스)를 만들고 유지한다. 웹 패키지(packages/web)에서 색상, 타이포, 간격, 테마, 컴포넌트 스타일, 다크모드, 디자인 토큰, Tailwind 설정 등 **UI 외형과 관련된 어떤 변경 요청이든** 받으면 반드시 이 스킬을 먼저 트리거해서 DESIGN.md를 먼저 업데이트하고 사용자 확인을 받은 뒤에 실제 코드를 수정한다. "버튼 색 바꿔줘", "폰트 키워줘", "다크모드 톤 조정", "카드 radius 좀 둥글게", "primary 컬러를 파랑으로" 같은 요청은 겉보기엔 단순 CSS 수정이지만 전부 디자인 시스템 변경이므로 이 스킬이 관여해야 한다. DESIGN.md가 아직 없으면 이 스킬이 프로젝트를 스캔해 초안을 만든다. Google Stitch DESIGN.md(2026 오픈소스) 스펙을 따른다.
| name | workshop-status |
| description | 워크숍 진행 상태를 Airtable에 공유합니다. 초기 설정(키 등록), 단계별 상태 보고, 전체 현황 조회, 진행자용 테이블 생성을 모두 포함합니다. |
Airtable MCP 서버(airtable-mcp-server)를 사용하여 워크숍 진행 상태를 정형적으로 관리한다.
워크숍 참여자가 실제로 거치는 실행 과정 기준으로 마일스톤을 정의한다.
| Phase | Milestone ID | Milestone | 기록 방식 |
|---|---|---|---|
| 환경설정 | SETUP-DONE | Environment Ready | setup 모드에서 기록 |
| 리서치 | RESEARCH-DONE | Deep Research Done | hook 자동 — pdf-reader 가 docs/ PDF 읽음 |
| PRD | PRD-START | PRD Started | hook 자동 — alps-writer Section 1 저장 |
| PRD | PRD-FEATURES | PRD Features Defined | hook 자동 — alps-writer Section 6 저장 |
| PRD | PRD-DONE | PRD Complete | hook 자동 — alps-writer export 호출 |
| 스캐폴딩 | SCAFFOLD-DONE | UI Scaffold Done | 랩 3 시작 시 Claude가 기록 (start-dev-server) |
| 피쳐 개발 | F1-DONE | F1 Complete | Feature 1 구현 완료 보고 시 Claude가 기록 |
| 피쳐 개발 | F2-DONE | F2 Complete | Feature 2 구현 완료 보고 시 Claude가 기록 |
| 피쳐 개발 | FN-DONE | FN Complete | Feature N 구현 완료 보고 시 Claude가 기록 |
| 완료 | DEMO-READY | Demo Ready | 사용자가 명시적으로 보고 |
.work-status모든 마일스톤은 프로젝트 루트의 .work-status 에 append-only 로 기록된다. 한 줄당 MILESTONE_ID<TAB>ISO8601 포맷. 이 파일은 .gitignore 에 포함되어 참여자 로컬에만 존재한다.
scripts/workshop-hook.mjs)이 PostToolUse 로 자동 기록 + Airtable 전송.work-status.template (setup 시 Skill이 복사 생성)appRMKLzA13xbxrZEtbloe5rOJpVy5tYpP (테이블명: Progress)Name → 참여자 이름 (Participant)Phase → 단계 (Single Select)Milestone_ID → 마일스톤 IDMilestone → 마일스톤 표시명Timestamp → ISO 8601 시각Notes → 상세 정보 (Details).mcp.json에 airtable MCP 서버가 설정되어 있어야 한다AIRTABLE_API_KEY가 설정되어 있어야 한다 (미설정 시 setup 모드로 안내)사용자 입력에 따라 아래 4가지 모드 중 하나를 실행한다.
setup, 설정, 키 등록, 키가 미설정일 때)절차:
사용자에게 아래 세 가지를 한 번에 물어본다 (개별 질문 금지, 한 메시지로 요청):
pat...로 시작) — 진행자에게 전달받은 값사용자에게 보여줄 안내 예시:
아래 세 가지를 번호와 함께 입력해주세요 (줄바꿈: Mac Shift+Enter / Windows Ctrl+Enter):
1. Airtable API Key 2. FAL_KEY 3. 닉네임
예)
1. patXXXXXX
2. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx
3. 커피중독PM
중요: AskUserQuestion 도구나 팝업 UI를 사용하지 않는다. 일반 텍스트 메시지로 질문하고, 사용자가 채팅으로 답변하면 파싱한다.
.mcp.json은 이미 환경변수 참조 방식(${AIRTABLE_API_KEY}, ${FAL_KEY})으로 설정되어 있으므로 읽거나 수정하지 않는다. 만약 사용자가 .mcp.json에 문제가 있다고 보고할 때만 확인한다.
프로젝트 로컬 설정 .claude/settings.local.json에 API Key 환경변수들을 등록한다:
.claude/settings.local.json 파일을 읽어서 env 필드에 AIRTABLE_API_KEY와 FAL_KEY를 추가한다.
env 필드가 있으면 해당 키만 추가/교체한다.gitignore에 등록되어 있어 커밋되지 않는다{
"env": {
"AIRTABLE_API_KEY": "pat_사용자가입력한값",
"FAL_KEY": "사용자가입력한값"
}
}
닉네임을 프로젝트 루트에 .workshop-participant 파일로 저장한다 (한 줄, 닉네임만).
.work-status 가 없으면 .work-status.template 을 복사해 생성한다 (없으면 빈 헤더만 있는 파일 생성).
안내: "API Key가 설정되었습니다. /mcp 명령어를 실행하여 airtable, asset-generator 서버 옆의 🔄 reconnect를 눌러주세요."
MCP 리로드 후 Airtable MCP tool (list_bases)로 연결을 확인한다.
list_bases 결과에서 Base ID (예: appXXXXXXXX)를 추출하여 .claude/settings.local.json의 env에 AIRTABLE_BASE_ID를 추가 저장한다. 이 값은 scripts/workshop-hook.mjs가 PostToolUse hook에서 Airtable에 자동 전송할 때 사용한다.
연결이 확인되면 SETUP-DONE 마일스톤을 확인 없이 바로 기록한다 (.work-status append + Airtable upsert). 기록 후 결과만 알려준다.
현재 진행 상태를 Airtable에 정형적으로 기록한다.
인자가 있는 경우 (예: /workshop-status PRD-DONE, /workshop-status F2 완료):
F2-DONE / F2 Complete로 정규화인자가 없는 경우 — 프로젝트의 현재 실제 상태를 판단하여 즉시 기록한다:
.workshop-participant 파일 확인 → 없으면 setup 안내docs/ 에 PDF 또는 리서치 결과물이 존재 → RESEARCH-DONEPRD-STARTPRD-FEATURESPRD-DONEpackages/web/src/ 에 컴포넌트/페이지 파일이 존재하고 dev server 실행 가능 → SCAFFOLD-DONEF{N}-DONEDEMO-READYF2-DONESCAFFOLD-DONEDEMO-READY.work-status 에 이미 있는 마일스톤이면 중복 전송하지 않고 알림만 표시아래 상황에서는 사용자가 /workshop-status 를 치지 않아도 Claude 가 먼저 이 스킬을 실행한다. hook으로 잡히지 않는 마일스톤 전용 규약이다.
SCAFFOLD-DONEF{N}-DONEDEMO-READY이미 저널에 있으면 skip. 참여자가 명시적으로 "상태 공유하지 마" 라고 하면 이번 세션 동안 자동 트리거를 멈춘다.
.work-status 에 해당 MILESTONE_ID 가 이미 있는지 확인 → 있으면 skip.work-status 에 MILESTONE_ID<TAB>ISO8601 한 줄 appendappRMKLzA13xbxrZE, tableId: tbloe5rOJpVy5tYpP):
search_records 로 참여자 이름 검색update_records, 없으면 create_recordfields:
Name: (.workshop-participant 에서 읽은 이름)
Phase: "환경설정" / "리서치" / "PRD" / "스캐폴딩" / "피쳐 개발" / "완료"
Milestone_ID: "PRD-DONE" 등
Milestone: "PRD Complete" 등
Timestamp: (현재 시각, ISO 8601)
Notes: (상세 정보)
전송 후: "진행 상태가 공유되었습니다: [Phase] — [Milestone]"
현황, status, 다른 사람, 전체)절차:
list_records로 Progress 테이블의 전체 레코드를 가져온다| 참여자 | Phase | Milestone | 시간 |
| -------- | --------- | ---------------- | ------ |
| 커피중독PM | 피쳐 개발 | F2 Complete | 14:35 |
| 픽셀요정 | PRD | PRD Features | 14:20 |
| 야근탈출러 | 환경설정 | Env Ready | 13:50 |
진행자, facilitator, 테이블 만들기)안내 & 자동 생성 지원:
진행자가 원하면 Airtable MCP의 create_table tool로 직접 테이블을 생성해준다.
| Field | Type | Description |
|---|---|---|
| Participant | Single line text | 참여자 이름 |
| Phase | Single select | 환경설정, 리서치, PRD, 스캐폴딩, 피쳐 개발, 완료 |
| Milestone_ID | Single line text | SETUP-DONE, PRD-START 등 |
| Milestone | Single line text | Environment Ready, PRD Started 등 |
| Timestamp | Single line text | ISO 8601 시각 |
| Details | Long text | 상세 정보 |
Phase (Single Select) 옵션:
환경설정 — 셋업 스크립트 실행, dev server 확인리서치 — 딥리서치 실행, PDF 다운로드PRD — ALPS 문서 작성스캐폴딩 — UI 뼈대 생성피쳐 개발 — F1, F2, ... 구현완료 — 데모 준비 완료schema.bases:read, data.records:read, data.records:writepat_...)을 참여자에게 전달Airtable API Key: pat_xxxxx
FAL_KEY: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx
Claude Code에서 /workshop-status setup 실행 후 위 키들을 입력하세요.
키는 .claude/settings.local.json에 환경변수로 저장됩니다 (git에 커밋되지 않음).
.workshop-participant, .work-status는 .gitignore에 포함되어 커밋되지 않는다.mcp.json에는 ${AIRTABLE_API_KEY} 환경변수 참조만 포함하고, 실제 키는 .claude/settings.local.json의 env에 저장한다.work-status 저널에서 중복 여부를 확인하고, 중복이면 Airtable 에도 전송하지 않는다 (hook 과 skill 양쪽 모두)