Codepresso
Claude Code용 팀 워크플로우 플러그인 — Notion 작업 동기화, 스프린트 워크플로우 자동화, PR 연동 git 활동 추적, Gmail + Google Chat 받은편지함 작업 트래커, 평일 Google Chat 북엔드, Figma → 프론트엔드 scaffold 자동화, 개인 LLM Wiki, 선택적 배포 연동, 온콜 관리까지.
주요 기능
- Notion 작업 선택기: 세션 시작 시 Notion 작업을 고르면 상태가 자동으로 "진행 중"으로 바뀌고, PR 제목에 작업 ID가 강제됩니다.
- PR 제목 강제:
gh pr create 시 선택한 작업의 unique ID(예: TSK-9945)가 없으면 차단합니다. Notion의 GitHub 연동이 PR을 자동으로 작업에 연결해 줍니다.
- Git 활동 추적: 활성 PR에서의
git commit을 감지해 gh pr comment로 커밋 코멘트를 자동 게시합니다.
- PR 머지 → Notion 상태 전이:
gh pr merge를 감지해 연결된 Notion 작업(그리고 에픽의 마지막 작업이라면 에픽까지)을 완료 상태로 전환합니다.
- 스프린트 워크플로우: 세션 시작 시 Sprint → Epic → Task 계층을 가져오고, 에픽의 모든 작업이 끝나면 에픽도 자동 완료 처리합니다.
- 🆕 받은편지함 작업 트래커: Gmail과 Google Chat에 묻혀 잊혀지는 작업 요청을 매일 아침 자동으로 스캔합니다. AI가 후보를 골라주면 한 번의 클릭으로 마감일 있는 Notion 작업으로 변환되며, 아침 인사 메시지에는 마감 임박/지난 작업이 함께 표시됩니다.
- 🆕 Figma → 프론트엔드 scaffold (v0.2.9): Figma URL + node-id + PAT만 주면 디자인 시스템 토큰이 매핑된 Vue/React scaffold를 자동 생성합니다. Codepresso 검증 결과 픽셀 일치율 87
97%, 하드코딩 hex 0건, 토큰 준수율 6× 향상, 퍼블리셔 시간 7585% 절감.
- 🆕 보안 진단 (v0.2.12):
/codepresso:security-audit — OWASP Top 10:2025와 2025–2026 최신 웹 보안 사고를 근거로 코드·인프라를 스캔하고(기술 스택 무관), 선택 시 개발자 머신의 로컬 자격증명까지 점검한 뒤, 인터뷰를 거쳐 점수가 매겨진 리메디에이션 리포트를 생성합니다. 시크릿 값은 절대 출력하지 않습니다.
- 평일 Google Chat 북엔드 (월–금): 첫 세션 시작 시 진행 중 작업 + 내 오픈 PR + 리뷰 요청 PR을 아침 인사로 전송, 18시에는 오늘의 커밋/머지된 PR/진행 중 작업을 Claude Haiku로 요약해 마감 메시지로 전송합니다.
- 배포 연동 (선택): ECS, CodePipeline, GitHub Actions, 커스텀 명령어 중 원하는 방식으로 Claude Code에서 배포를 트리거할 수 있습니다.
- 온콜 관리 (선택): DynamoDB + Google Calendar 기반 온콜 스케줄 조회/교체/생성, 런북 검색까지 Claude에서 한 번에.
- 🆕 LLM Wiki (v0.2.13) (선택): 개인 지식 베이스를 LLM이 유지·관리합니다. 소스를 ingest하면 서로 연결된 마크다운 페이지로 쌓이고(compounding), query/lint로 활용·점검합니다. 각자 자기 vault(Obsidian + git)를 가지므로 내용은 공유되지 않습니다.
- 🆕 AIDLC 스캐폴더: 임의의 저장소를 "AI 에이전트가 일하기 좋은 구조"(AGENTS.md·ADR·문서정책·CI·코드구조 인덱스 등 16항목)에 맞춰 진단하고, 없는 것만 비파괴로 깔아줍니다. 진단 → 인터뷰 → 미리보기 → 생성 → 재진단. 외부 연동 없이 동작하며, 모노레포면 하위 프로젝트별로 맞춰 생성합니다.
- OMC 호환: oh-my-claudecode와 충돌 없이 함께 동작합니다.
- 모노레포 / 서브모듈 지원: 모노레포 루트에서 작업할 때 서브모듈의 활성 PR을 자동 감지합니다.
무엇이 편리해지나요?
🔁 반복 작업이 사라집니다
- PR ↔ Notion 연결: 매번 Notion 작업을 PR에 손으로 붙이던 일이 제목 강제로 자동화 → 클릭 3~4번이 0번으로.
- 커밋 진행 상황 공유: 커밋마다 PR에 코멘트 다는 일을 git 훅이 대신 → 리뷰어가 따라가기 쉬워집니다.
- 작업 완료 처리: PR 머지 후 Notion에 가서 상태 바꾸는 일을 잊지 않아도 됩니다 (자동 전이).
- 에픽 자동 완료: 에픽의 마지막 작업이 끝나면 에픽까지 자동으로 완료로 표시.
📥 잊혀지는 작업이 없어집니다
- Gmail/Chat 자동 triage: 받은편지함과 채팅의 작업 요청이 알림 너머로 사라지지 않습니다. 매일 아침 AI가 후보를 추려 보여줍니다.
- 마감일 추적: 마감일이 지난 작업과 오늘 마감인 작업이 아침 인사에 묶여 → 우선순위 정리가 자동으로.
- 30일 dedup: 한 번 거절한 메시지는 30일간 다시 추천되지 않아 같은 알림에 시달리지 않습니다.
🪟 컨텍스트 전환이 줄어듭니다
- 한 화면에서 시작: 스프린트 진행 상황, 내 PR, 리뷰 대기 PR, 받은편지함 작업을 Google Chat 한 곳에서 → 아침에 여러 탭을 켤 필요가 없습니다.
- 자동 회고: 평일 18시에 자동 요약을 받아 → "오늘 뭐 했지?" 회고가 무료로 생깁니다.
- 터미널에서 끝: 작업 선택, PR 생성, 머지, 배포, 온콜 조회 모두 Claude Code 내에서 처리.
🎨 퍼블리셔 작업이 줄어듭니다 (v0.2.9 🆕)
- Figma → AI scaffold: Figma URL + 본인 PAT만 주면 디자인 시스템 토큰에 매핑된 Vue/React 컴포넌트를 자동 생성합니다.
- 추정 시간 절감 75-85%: 0부터 1,400줄 작성 (1-2일) → AI scaffold 받아 데이터 연결/미세 조정 (1-2시간).
- 하드코딩 hex 0건 보장:
$color-* / $space-* / $radius-* 토큰을 자동으로 적용합니다.
- 검증된 결과: Codepresso 평가리포트 페이지 3개로 검증, 픽셀 일치율 HIGH 86.62% / MID 96.87% / LOW 96.71%.
🧠 지식이 휘발되지 않습니다 (v0.2.13 🆕)
- 대화를 넘어 남습니다: 한 번 배운 것(AWS/인프라 패턴, 언어 함정, 팀 프로세스, 조사한 개념)을 위키 페이지로 캡처 → 다음 세션·다른 repo에서 그대로 재사용.
- 쌓일수록 똑똑해집니다 (compounding): ingest할 때마다 페이지가 서로 연결되어 위키가 점점 풍부해집니다.
- 인용 포함 답변: query 시 어떤 페이지에서 나온 답인지 출처를 함께 보여줘 → 신뢰할 수 있는 개인 지식 베이스.
- 개인 vault, 도구만 공유: 각자 자기 Obsidian + git vault를 가지므로 내용은 공유되지 않으며, private remote를 붙이면 여러 컴퓨터에서 동기화됩니다.
👥 팀과의 가시성이 좋아집니다
- 비동기 추적: 모든 활동이 PR 코멘트와 Notion 상태로 흐릅니다. 팀원이 회의 없이 진행 상황을 따라갈 수 있습니다.
- 공유 채널: Google Chat 스페이스에서 아침/저녁 자동 메시지로 → 작업 현황 공유에 추가 작업이 들지 않습니다.
- 자동 라벨링: PR에 자동으로
ai-assisted 라벨이 붙어 → AI 협업 비율 파악에 도움.
🆕 LLM Wiki (개인 지식 베이스, v0.2.13)
LLM이 유지·관리하는 개인 위키. Karpathy의 LLM Wiki 패턴 기반이며, 각자 자기 vault를 가집니다 (내용은 공유되지 않고, 도구만 공유).
/codepresso:llm-wiki init # 내 vault 생성 (Obsidian + git, 기본 ~/Documents/Obsidian/llm-wiki)
/codepresso:llm-wiki ingest <url|메모> # 소스를 캡처해 연결된 페이지로 통합
/codepresso:llm-wiki query <질문> # 위키에서 인용 포함 답변
/codepresso:llm-wiki lint # 모순/오래된 내용/고아 페이지 점검
vault 위치는 ~/.codepresso/config.json의 wiki.vaultPath로 바뀝니다. 여러 컴퓨터에서 쓰려면 vault에 private git remote를 직접 연결하세요. 자연어로 "이거 내 위키에 넣어줘"라고 해도 자동으로 동작합니다.
원격(upstream)이 설정되어 있으면 세션 시작 시 백그라운드에서 git fetch를 실행하고, vault가 원격보다 뒤처져 있으면 첫 번째 도구 사용 시 알림을 표시합니다. 자동 병합은 절대 하지 않으며, pull 여부는 항상 사용자가 결정합니다. 이 기능을 끄려면 wiki.autoFetch: false로 설정하세요.
🆕 AIDLC 스캐폴더 (aidlc-init / aidlc-doctor)
임의의 저장소를 팀의 "AI-native 저장소" 16항목 템플릿에 맞춰 진단·구성하는 도구. 플러그인을 codepresso 전용을 넘어 어느 프로젝트에나 적용할 수 있게 합니다.
