[사내AX] 🔧 Linear를 진짜 SSOT로 만들기 — MCP가 부족해서 직접 스킬 5개 만든 후기

이니셔티브 (Initiative)
├── 프로젝트 A (Project)
│   ├── 이슈 1, 2, 3...
│   └── 프로젝트 업데이트 (매주 작성)
├── 프로젝트 B
│   ├── 이슈 4, 5, 6...
│   └── 프로젝트 업데이트
└── 이니셔티브 업데이트 (프로젝트 업데이트들을 종합)

## 배경
[왜 해야 하는지]

## 상세내용
[구체적 맥락, 관련 데이터, 참고 문서]

## To Do
- [ ] 할 일 1
- [ ] 할 일 2

> /create-issue 파트너스 자격 검토 로직 개선

이슈를 생성합니다. 확인해주세요:

- **프로젝트**: 지피터스 커뮤니티 유지 및 관리
- **제목**: 파트너스 자격 검토 로직 개선
- **담당자**: 송다혜 (기본: 나)
- **상태**: Todo

**Description 미리보기:**

## 배경
현재 파트너스 자격 검토가 수동으로 진행되어 누락이 발생하고 있음

## 상세내용
- 스터디장 2회 이상 조건 확인 필요
- 18기부터 초대 누락자 존재
- 에어테이블 기여활동 테이블과 연동 필요

## To Do
- [ ] 자격 조건 자동 체크 로직 구현
- [ ] 누락자 일괄 초대 처리

진행할까요?

> /devlog-to-issue ./DEVLOG.md

DEVLOG 분석 완료! 다음 이슈들을 생성할게요:

📋 **완료된 작업** (기존 이슈 업데이트)
- [EDU-1234] 파트너스 초대이력 파싱 → To Do 체크 업데이트

📋 **후속 작업** (새 이슈 생성)

1️⃣ 기여활동 대시보드 구축
   - 배경: 파트너스 기여 현황을 한눈에 볼 수 없음
   - 프로젝트: 커뮤니티 유지 및 관리 (추천)
   
2️⃣ 운영진 관리 시스템 구축
   - 배경: 40개 오픈채팅방 운영진 현황 파악 안됨
   - 프로젝트: 커뮤니티 유지 및 관리 (추천)

프로젝트 추천이 맞나요? (변경하려면 말씀해주세요)

> 응 맞아

이슈 3개 생성 완료!

| 이슈 | 제목 | 프로젝트 | 사이클 |
|------|------|----------|--------|
| [EDU-1234](링크) | 파트너스 초대이력 파싱 | 커뮤니티 유지 | Cycle 5 |
| [EDU-1235](링크) | 기여활동 대시보드 구축 | 커뮤니티 유지 | Cycle 5 |
| [EDU-1236](링크) | 운영진 관리 시스템 구축 | 커뮤니티 유지 | Cycle 6 |

> /update-proj

내가 리드/멤버인 프로젝트 목록:

1. 지피터스 커뮤니티 유지 및 관리 (Lead)
2. AI스터디 20기 준비 및 운영 (Member)
3. 사내 AX 도입 (Lead)

번호를 입력해주세요: 

> 1

📊 Cycle 5 (1/27 - 2/2) 업데이트 초안:

---

## 🔧 [파트너스] 자격 관리 체계 전면 개편

**한 줄 요약**: 1년반 방치된 파트너스 자격 관리를 시스템화

**기존 문제**
- 누가 파트너인지 명단 파악 불가
- 18기부터 초대 누락 누적

**변경 사항**
| 구분 | AS-IS | TO-BE |
|------|-------|-------|
| 명단 관리 | 폼 수동 제출 | **카톡 파싱 자동화** |
| 기여 트래킹 | 없음 | **에어테이블 자동 기록** |

**완료된 작업**
- 카톡 2만 줄 파싱 → 68명 멤버 추출
- 기여활동 테이블 생성 (4가지 유형)

---

## 📋 [파트너스] 유예 정책 시행

**목표**: 미달성자에게 기회 부여

- [ ] 2월 내 1회 기여 → 4월까지 유지
- [ ] 3~4월 1회 추가 → 9/1 연장

---

Health: 🟢 onTrack / 🟡 atRisk / 🔴 offTrack 중 선택해주세요:

> 온트랙

✅ Linear에 등록 완료!
https://linear.app/gpters/project/community/.../update/...

> /update-init

내가 리드인 이니셔티브 목록:

1. 커뮤니티 성장 (Active)
2. AI스터디 확장 (Planned)

번호를 입력해주세요:

> 1

📊 커뮤니티 성장 이니셔티브 - Cycle 5 업데이트 초안:

---

## 📊 이니셔티브 현황

**Health**: 🟢 onTrack (하위 프로젝트 모두 onTrack)

---

### ✅ 이번 Cycle 핵심 성과

- [커뮤니티 유지] 파트너스 자격 관리 체계 구축 완료 (63명 전원 파악)
- [AI스터디 20기] 스터디장 모집 마감, 40명 확정
- [사내 AX] Linear Toolkit 5개 스킬 배포

### ⚠️ 주요 이슈/리스크

- 파트너스 미달성자 25명 → 유예 정책으로 대응 중

### 📋 다음 Cycle 중점

- 파트너스 유예자 기여 독려
- AI스터디 20기 OT 준비

---

### 프로젝트별 상세
| 프로젝트 | Health | 핵심 진행 |
|----------|--------|-----------|
| 커뮤니티 유지 | 🟢 | 파트너스 시스템 구축 |
| AI스터디 20기 | 🟢 | 스터디장 40명 확정 |
| 사내 AX | 🟢 | Linear Toolkit 배포 |

---

Linear에 바로 올릴까요?

> 응

✅ 이니셔티브 업데이트 등록 완료!
https://linear.app/gpters/initiative/.../update/...

> /upload-doc ./docs/파트너스_운영문서_v2.md "커뮤니티 유지"

다음 문서를 Linear에 추가합니다:

- **제목**: 파트너스 운영문서 v2
- **프로젝트**: 지피터스 커뮤니티 유지 및 관리
- **미리보기**: 
  # 파트너스 운영 규칙
  
  ## 초대 조건
  - AI스터디 스터디장 2회 이상 완주...

진행할까요? (제목 변경하려면 새 제목 입력)

> 진행해

✅ 문서 추가 완료!
Document ID: doc_abc123

Linear 프로젝트 Resources 탭에서 확인하세요.

📁 커뮤니티 유지 및 관리
├── 📄 파트너스 운영문서 v2     ← 새로 추가됨
├── 📄 스터디장 가이드
└── 📄 ...

┌─────────────────────────────────────────────┐
│              Linear Toolkit 스킬            │
├─────────────────────────────────────────────┤
│                                             │
│   조회 ──────────────> Linear MCP           │
│   (프로젝트, 이슈, 이니셔티브)               │
│                                             │
│   생성/수정 ─────────> SDK 스크립트          │
│   (projectUpdateCreate,                     │
│    initiativeUpdateCreate,                  │
│    documentCreate)                          │
│                                             │
│   이슈 상태 조회 ────> SDK 스크립트          │
│   (MCP state 필드 버그 우회)                 │
│                                             │
└─────────────────────────────────────────────┘

plugin-name/
├── .claude-plugin/
│   └── plugin.json          # 필수: 플러그인 메타데이터
├── commands/                 # 슬래시 커맨드
├── agents/                   # 서브에이전트
├── skills/                   # 스킬 (자동 발견)
│   └── skill-name/
│       └── SKILL.md
└── scripts/

linear-toolkit/
├── .claude-plugin/
│   └── plugin.json          # ✅ 있음
├── skills/                   # ✅ 5개 스킬
│   ├── create-issue/
│   ├── devlog-to-issue/
│   ├── update-proj/
│   ├── update-init/
│   └── upload-doc/
├── install.sh               # 심링크 생성 스크립트
└── README.md

# install.sh 핵심 로직
for skill in create-issue devlog-to-issue update-proj update-init upload-doc; do
  ln -s "$PLUGIN_DIR/skills/$skill" "$HOME/.claude/skills/$skill"
done

# Claude Code 명령어
claude mcp add linear -- npx -y @tacticlaunch/mcp-linear

git clone https://github.com/daht-mad/linear-toolkit.git ~/.claude/plugins/linear-toolkit
~/.claude/plugins/linear-toolkit/install.sh

# 토큰 발급: https://linear.app/settings/api
echo "LINEAR_API_TOKEN=lin_api_xxxxx" >> ~/.env