2025-12-22

나는25년 3월부터 AI Driven Work로 개발자/비개발자 구분 없이 Claude Code로 조직 개편 하는 일을 해왔어.

GitHub - popup-studio-ai/AI-driven-work: POPUP STUDIO의 AI Agent를 활용한 업무 프로세스 개선 프로젝트입니다.

🚀 빠른 시작

완전 초보자이신가요?

터미널, Node.js, Git 같은 용어가 낯설다면 초보자 가이드를 먼저 읽어보세요:

👉 완전 초보자를 위한 시작 가이드

✅ 터미널이 뭔지 모르는 분
✅ 프로그램 설치가 처음인 분
✅ 스크린샷과 단계별 설명이 필요한 분

이미 기술에 익숙하신가요?

아래 내용을 계속 읽으세요 👇

프로젝트 개요

Claude Code를 AI Agent로 활용하여 Jira, Confluence와 연동하고, 전 직원이 표준화된 방식으로 효율적인 업무를 진행할 수 있도록 지원합니다.

목적

업무 관리 자동화: AI Agent가 프로젝트별 담당자, 이슈 처리 현황, 진행 상황을 자동으로 파악
관리 공수 절감: 반복적인 관리 작업을 AI가 처리하여 실질적인 업무에 집중
전사적 표준화: GitHub 리포지토리를 통한 일관된 업무 프로세스 구축
정보 중앙화: Confluence를 단일 진실 공급원으로 삼아 산재된 정보를 통합 관리
지식 공유 활성화: 문서화를 통한 조직 지식 축적 및 접근성 향상

기술 스택

AI Agent: Claude Code
프로젝트 관리: Jira
문서화: Confluence
통합: MCP (Model Context Protocol) 서버
- mcp-atlassian: Jira/Confluence 연동
- 향후 확장 예정: Slack, GitHub, Notion 등 추가 MCP 서버 통합 계획

해결하고자 하는 문제

현재 문제점

Slack 업무 지시의 한계
- 티켓 미발행으로 인한 Task 추적 어려움
- 개개인의 Task 관리 능력에 의존
- 업무 지시 내용이 휘발되어 검색 및 추적 불가
Notion 프로젝트 관리의 비효율
- 관리를 위한 추가 공수 발생
- 낮은 활용도 (사용하는 사람만 사용)
- Jira와 중복된 관리 포인트
정보의 산재 (Information Fragmentation)
- Google Drive: 문서, 스프레드시트가 개인별로 분산 저장
- Notion: 일부 팀원만 사용하는 프로젝트 노트
- Slack: 중요한 의사결정이 대화 속에 묻힘
- 로컬: 개인 PC에만 존재하는 기술 문서
- 결과: 정보 접근성 저하, 중복 작업 발생, 지식 공유 어려움

해결 방안

1. 업무 관리 통합

AI Agent를 통해 Jira/Confluence 정보를 자동으로 수집하고 분석하여, 별도의 관리 도구 없이 효율적인 업무 진행이 가능하도록 지원합니다.

2. 문서화 중앙화

Confluence를 단일 진실 공급원(Single Source of Truth)으로 확립
자동 마이그레이션: AI Agent가 산재된 정보를 식별하고 Confluence로 이관 제안
정보 구조화: 프로젝트별, 팀별 명확한 페이지 구조
검색 가능성: 모든 문서가 한 곳에서 검색 가능
접근 권한 관리: 프로젝트별 적절한 권한 설정

3. 문서화 자동화

Slack의 중요 스레드를 Confluence 페이지로 자동 변환
Jira 이슈와 Confluence 문서 자동 연결
주간 보고서 자동 생성 및 아카이빙
Google Drive 문서의 Confluence 동기화 워크플로우

프로젝트 구성

문서화

Jira 운영 규칙

이슈 타입 구분: Story, Epic, Task, Sub-Task 사용 가이드
자율적 이슈 관리:
- 누구나 자유롭게 이슈 티켓 생성
- 매일 업무 시작 전 Claude Code로 미할당 이슈 확인
- 자율적으로 담당자 지정하여 업무 선택
주간 업무 공유: 주간 보고서 작성 및 기록 방법

Claude Code - Jira 작업 규칙

AI Agent 전용 규칙: Claude Code가 Jira 작업을 처리할 때 따라야 할 지침
이슈 타입 판단 기준: Epic, Story, Task, Sub-Task 자동 구분 로직
담당자 지정 원칙: Epic/Story는 책임자, Task/Sub-Task는 실행 담당자
자동화 작업 가이드: /daily-standup, /weekly-report, /assign-me 처리 규칙
커뮤니케이션 원칙: 명확하고 일관된 응답 방식

Claude Code 가이드

기본 개념: rules, instructions, skill, slash command
공통 Slash Commands:
- /daily-standup: 미할당 이슈 확인 + 내 할당 이슈 현황
- /weekly-report: 주간 보고서 생성 (완료 이슈 기반)
- /assign-me <issue-key>: 이슈 담당자로 자신을 지정
- /save-slack-thread: Slack 스레드를 Confluence 페이지로 변환
mcp-atlassian 설정 방법

Confluence 운영 규칙

문서화 대상 정의
페이지 구조 및 관리 방법

Workflow 예시

신입 직원 온보딩 플로우
일일/주간 업무 루틴 예시

Configuration 관리

Infrastructure as Code 접근으로 전 직원의 업무 환경을 표준화합니다:

.claude/ 디렉토리: 공통 slash commands
mcp-config.json: mcp-atlassian 설정 템플릿
setup.sh: 초기 환경 설정 스크립트

디렉토리 구조

AI-driven-work/
├── README.md
├── docs/
│   ├── jira-guidelines.md           # Jira 운영 규칙 (전 직원용)
│   ├── confluence-guidelines.md     # Confluence 운영 규칙
│   ├── claude-code-guide.md         # Claude Code 사용법
│   ├── mcp-server-selection-guide.md # MCP Server 선택 가이드
│   └── workflow-examples.md         # 업무 플로우 예시
├── .claude/
│   ├── instructions/
│   │   └── jira-rules.md            # Claude Code - Jira 작업 규칙 (AI Agent용, 자동 적용)
│   └── commands/
│       ├── daily-standup.md
│       ├── weekly-report.md
│       ├── assign-me.md
│       └── save-slack-thread.md
├── config/
│   ├── mcp-atlassian-config.json
│   └── README.md                    # 설정 방법 설명
└── scripts/
    ├── setup.sh                     # 환경 설정 스크립트 (macOS/Linux)
    ├── setup.ps1                    # 환경 설정 스크립트 (Windows)
    ├── jira-rules-setup.sh          # Jira 기능 추가 스크립트 (macOS/Linux)
    ├── jira-rules-setup.ps1         # Jira 기능 추가 스크립트 (Windows)
    ├── github-workflow-setup.sh     # GitHub 워크플로우 추가 스크립트 (macOS/Linux)
    └── github-workflow-setup.ps1    # GitHub 워크플로우 추가 스크립트 (Windows)

시작하기

자동 설정 (권장)

가장 빠르고 쉬운 방법은 자동 설정 스크립트를 사용하는 것입니다.

macOS / Linux 사용자

# 1. 리포지토리 클론
git clone https://github.com/popupstudio/AI-driven-work.git
cd AI-driven-work

# 2. 자동 설정 스크립트 실행
./scripts/setup.sh

Windows 사용자

PowerShell을 관리자 권한으로 실행한 후:

# 1. 리포지토리 클론
git clone https://github.com/popupstudio/AI-driven-work.git
cd AI-driven-work

# 2. PowerShell 실행 정책 확인 (최초 1회)
Get-ExecutionPolicy

# 3. 실행 정책이 Restricted라면 변경 (최초 1회)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 4. 자동 설정 스크립트 실행
.scriptssetup.ps1

참고: Windows에서는 .ps1 PowerShell 스크립트를 사용합니다.

자동 설정 스크립트가 처리하는 작업:

환경 확인
- Node.js 18+ 설치 확인
- Docker 설치 확인 (mcp-atlassian 선택 시)
Claude Code 설치
- 미설치 시 자동 설치 제안
- 버전 확인
MCP Server 선택
- 비개발자: Rovo MCP Server (OAuth, 2분 설정)
- 개발자: mcp-atlassian (Docker, API 토큰, 15분 설정)
자동 구성
- Atlassian API 토큰 입력 (또는 기존 설정 재사용)
- 환경 변수 파일 생성 (~/.mcp-atlassian/.env)
- Claude Code CLI 자동 등록 (claude mcp add)
- 사용 범위 선택 (모든 프로젝트 vs 현재 프로젝트만)
- 연결 테스트 자동 수행
Slash Commands 복사
- /daily-standup, /weekly-report, /assign-me, /save-slack-thread

설정 완료 후:

# Claude Code 실행
claude

# 연결 테스트
> Jira 프로젝트 목록 보여줘

# 첫 slash command 실행
> /daily-standup

수동 설정

직접 설정하고 싶다면 다음 가이드를 참고하세요:

비개발자 (Rovo): docs/claude-code-guide.md
개발자 (mcp-atlassian): reference/mcp-atlassian.md
MCP Server 선택 가이드: docs/mcp-server-selection-guide.md

다음 단계

Jira 운영 규칙 숙지: docs/jira-guidelines.md
Claude Code - Jira 작업 규칙 확인: .claude/instructions/jira-rules.md (AI Agent 동작 이해)
Confluence 운영 규칙 숙지: docs/confluence-guidelines.md
업무 플로우 예시: docs/workflow-examples.md
일일 업무 시작: /daily-standup 실행

다른 프로젝트에 Jira 기능 추가하기

AI-driven-work 프로젝트가 아닌 다른 프로젝트에서도 Jira 관련 기능을 사용하고 싶다면, 자동 설정 스크립트를 사용하세요.

사용 방법

macOS / Linux

# AI-driven-work 프로젝트에서 실행
cd ~/Documents/GitHub/popup/AI-driven-work

# 다른 프로젝트에 Jira 기능 추가
./scripts/jira-rules-setup.sh <타겟_프로젝트_경로>

# 예시
./scripts/jira-rules-setup.sh ~/projects/my-web-app
./scripts/jira-rules-setup.sh ~/work/frontend-project

Windows

# AI-driven-work 프로젝트에서 실행 (PowerShell)
cd C:UsersYourNameDocumentsGitHubpopupAI-driven-work

# 다른 프로젝트에 Jira 기능 추가
.scriptsjira-rules-setup.ps1 C:projectsmy-web-app

# 예시
.scriptsjira-rules-setup.ps1 C:projectsmy-web-app
.scriptsjira-rules-setup.ps1 C:workfrontend-project

Dry-run 모드 (미리보기)

실제 변경 없이 어떤 작업이 수행될지 미리 확인할 수 있습니다:

macOS / Linux

./scripts/jira-rules-setup.sh ~/projects/my-web-app --dry-run

Windows

.scriptsjira-rules-setup.ps1 C:projectsmy-web-app -DryRun

스크립트가 수행하는 작업

Slash Commands 복사
- /daily-standup, /weekly-report, /assign-me, /save-slack-thread
- 타겟 프로젝트의 .claude/commands/ 디렉토리로 복사
- 파일 충돌 시 선택 옵션 제공 (덮어쓰기/건너뛰기/이름변경/차이점 보기)
Jira 지침 복사
- .claude/instructions/jira-rules.md 복사
- Claude Code가 Jira 작업을 자동으로 처리할 수 있도록 설정
기존 지침과 통합
- 타겟 프로젝트에 다른 instructions 파일이 있다면 자동 감지
- 각 파일에 jira-rules.md 참조 추가하여 모든 지침이 함께 적용되도록 설정
자동 백업
- 덮어쓰기 전 자동으로 백업 생성 (.claude/.backup-YYYYMMDD-HHMMSS/)
- 문제 발생 시 복구 가능

적용 후 사용

타겟 프로젝트로 이동하여 Claude Code를 실행하면 Jira 기능을 바로 사용할 수 있습니다:

# 타겟 프로젝트로 이동
cd ~/projects/my-web-app

# Claude Code 실행
claude

# Jira 기능 테스트
> /daily-standup
> Jira에서 미할당 이슈 보여줘

주의사항

MCP Server 설정 필요: jira-rules-setup.sh는 slash commands와 지침만 복사합니다. MCP Server 설정은 setup.sh로 미리 완료되어 있어야 합니다.
프로젝트별 독립 실행: 각 프로젝트에서 Claude Code를 실행하면 해당 프로젝트의 지침이 적용됩니다.

다른 프로젝트에 GitHub 워크플로우 추가하기

다른 프로젝트에서도 표준화된 Git 브랜치 전략과 PR 워크플로우를 사용하고 싶다면, 자동 설정 스크립트를 사용하세요.

사용 방법

macOS / Linux

# AI-driven-work 프로젝트에서 실행
cd ~/Documents/GitHub/popup/AI-driven-work

# 다른 프로젝트에 GitHub 워크플로우 추가
./scripts/github-workflow-setup.sh <타겟_프로젝트_경로>

# 예시
./scripts/github-workflow-setup.sh ~/projects/my-web-app
./scripts/github-workflow-setup.sh ~/work/backend-api

Windows

# AI-driven-work 프로젝트에서 실행 (PowerShell)
cd C:UsersYourNameDocumentsGitHubpopupAI-driven-work

# 다른 프로젝트에 GitHub 워크플로우 추가
.scriptsgithub-workflow-setup.ps1 C:projectsmy-web-app

# 예시
.scriptsgithub-workflow-setup.ps1 C:projectsmy-web-app
.scriptsgithub-workflow-setup.ps1 C:workbackend-api

Dry-run 모드 (미리보기)

실제 변경 없이 어떤 작업이 수행될지 미리 확인할 수 있습니다:

macOS / Linux

./scripts/github-workflow-setup.sh ~/projects/my-web-app --dry-run

Windows

.scriptsgithub-workflow-setup.ps1 C:projectsmy-web-app -DryRun

스크립트가 수행하는 작업

GitHub Workflow 지침 복사
- .claude/instructions/github-workflow.md 복사
- 브랜치 전략, 머지 전략, PR 워크플로우 가이드
GitHub 설정 파일 생성
- .github/CODEOWNERS - 코드 소유자 자동 지정
- .github/ISSUE_TEMPLATE/bug_report.md - 버그 리포트 템플릿
- .github/ISSUE_TEMPLATE/feature_request.md - 기능 제안 템플릿
기존 지침과 통합
- 타겟 프로젝트의 다른 instruction 파일 자동 감지
- 각 파일에 github-workflow.md 참조 추가
자동 백업
- 덮어쓰기 전 자동으로 백업 생성 (.claude/.backup-YYYYMMDD-HHMMSS/)

적용 후 설정

스크립트 실행 후 GitHub 저장소에서 Branch Protection Rules를 설정하세요:

GitHub 저장소 설정: Settings → Branches
main 브랜치 보호:
- PR 필수
- 최소 1명 승인 필요
- Code Owners 승인 필수
develop 브랜치 보호:
- PR 필수
- 최소 1명 승인 필요

자세한 내용은 생성된 .claude/instructions/github-workflow.md 파일을 참고하세요.

MCP 서버 확장 계획

이 프로젝트는 지속적으로 발전하며, 필요에 따라 다양한 MCP 서버를 추가할 예정입니다.

현재 통합된 MCP 서버

mcp-atlassian: Jira/Confluence 연동

향후 추가 예정 MCP 서버

업무 효율성을 더욱 높이기 위해 다음 MCP 서버 통합을 검토 중입니다:

Slack MCP Server
- Slack 메시지 자동 검색 및 분석
- 중요 대화를 Confluence로 자동 마이그레이션
- 채널별 업무 현황 모니터링
GitHub MCP Server
- PR 자동 리뷰 및 머지 관리
- Issue와 Jira 자동 연동
- 커밋 히스토리 분석 및 보고서 생성
Notion MCP Server
- Notion 페이지를 Confluence로 마이그레이션
- 데이터베이스 자동 동기화
- 정보 통합 및 중복 제거
Google Drive MCP Server
- 문서 검색 및 Confluence 동기화
- 스프레드시트 데이터 분석
- 파일 권한 관리 자동화
Linear MCP Server
- Linear 이슈와 Jira 동기화
- 통합 프로젝트 관리 대시보드
- 진행 상황 자동 리포팅

MCP 서버 추가 시 자동 배포

새로운 MCP 서버가 추가되면:

setup.sh 스크립트가 자동으로 업데이트됩니다
기존 사용자는 setup.sh를 다시 실행하여 새 MCP 서버를 선택적으로 추가할 수 있습니다
각 MCP 서버는 독립적으로 활성화/비활성화 가능합니다

제안 및 피드백

업무에 필요한 MCP 서버가 있다면 이슈로 제안해주세요. 팀의 실제 니즈에 맞춰 우선순위를 조정하여 추가할 예정입니다.

기여 방법

POPUP STUDIO 전 직원이 이 리포지토리를 참고하여 업무를 진행합니다. 개선 사항이나 제안이 있다면 이슈를 등록하거나 Pull Request를 생성해주세요.

기여 가이드라인

이슈 등록: 버그 리포트나 기능 제안을 GitHub Issue로 등록
Fork & Branch: 리포지토리를 포크하고 feature 브랜치 생성
개발: .claude/instructions/github-workflow.md 참고하여 작업
Pull Request: develop 브랜치로 PR 생성
리뷰: popup-kay의 승인 후 머지

자세한 내용은 .claude/instructions/github-workflow.md를 참고하세요.

라이선스

이 프로젝트는 MIT License로 배포됩니다.

MIT License란?

✅ 상업적 사용 가능
✅ 수정 및 배포 자유
✅ 사적 사용 허용
✅ 파생 작업물 생성 가능

자세한 내용은 LICENSE 파일을 참고하세요.

사용 예시

이 프로젝트를 자유롭게 사용할 수 있습니다:

# 1. 리포지토리 클론
git clone https://github.com/popup-studio-ai/AI-driven-work.git

# 2. 자신의 팀/회사에 맞게 커스터마이징
cd AI-driven-work
# ... 수정 작업 ...

# 3. 개선사항을 커뮤니티에 기여 (선택사항)
git checkout -b feature/my-improvement
# ... PR 생성 ...

저작권 고지

MIT License

Copyright (c) 2025 POPUP STUDIO

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...

전체 라이선스 내용은 LICENSE 파일을 참고하세요.

Made with ❤️ by POPUP STUDIO