# task-830.1: Superpowers 프레임워크 심층 분석 + 우리 시스템 적용 방안

## 제이회장님 지시
깃헙 자료 심층 분석. 이미 한 번 학습했지만 재확인 필요.

## 대상 깃헙 레포
- **URL**: https://github.com/obra/superpowers
- **설명**: Agentic skills framework — Claude Code/Cursor 등 코딩 에이전트용 개발 방법론 + 스킬 프레임워크
- **Star**: 105k+, **Fork**: 8.4k+

## ★ 분석 깊이 규칙 (필수 준수)
- **표면적 요약 금지**. 파일 내부까지 분석, 체계적·심도있는 A to Z 정리
- 우리 시스템에 어떻게 적용할지까지 구체적 방안 도출
- Top-level README뿐 아니라 **skills/, agents/, commands/, hooks/, docs/** 내부 파일 전체 분석

## 작업 범위

### Phase 1: 레포 전체 심층 분석

1. **디렉토리 구조 분석**
   - skills/ 하위 모든 파일: 각 스킬의 목적, 트리거 조건, 핵심 로직
   - agents/ 하위 모든 파일: 에이전트 설정 구조
   - commands/ 하위 모든 파일: 커맨드 구현 패턴
   - hooks/ 하위 모든 파일: 훅 통합 방식
   - docs/ 하위 모든 파일: 문서화 패턴

2. **7-Phase 개발 워크플로우 상세 분석**
   - Brainstorming: Socratic 질의 패턴, 청킹 방식
   - Git Worktree: 격리 환경 자동 설정
   - Writing Plans: 2-5분 단위 작업 분해 방법론
   - Subagent-Driven Development: fresh agent 디스패치, 2단계 리뷰
   - TDD: RED-GREEN-REFACTOR 강제 방식
   - Code Review: severity 기반 이슈 리포팅
   - Finishing: 머지/PR/디스카드 옵션, 자동 정리

3. **스킬 시스템 아키텍처**
   - 스킬 자동 활성화 메커니즘 (context-based triggering)
   - 스킬 간 의존성/조합 패턴
   - 커스텀 스킬 작성 가이드라인
   - CLAUDE.md/plugin 구조

4. **TDD 강제 메커니즘**
   - testing anti-patterns reference 내용
   - 프리-테스트 코드 삭제 정책
   - RED-GREEN-REFACTOR 사이클 구현 방식

5. **Subagent 디스패치 패턴**
   - 병렬 에이전트 워크플로우
   - 2단계 리뷰 프로세스 (spec compliance → code quality)
   - 에이전트 간 컨텍스트 전달 방식

### Phase 2: 우리 시스템과의 비교 분석

1. **현재 우리 시스템 (dispatch.py + 팀 구조)**
   - 유사점/차이점 대조표
   - superpowers가 더 나은 점, 우리가 더 나은 점

2. **적용 가능한 패턴 전체 리스트**
   - 즉시 도입 가능 (low effort, high impact)
   - 중기 도입 (설계 변경 필요)
   - 장기 검토 (아키텍처 변경 필요)

3. **우리 시스템 개선 제안**
   - dispatch.py 개선점 (superpowers 패턴 참고)
   - 스킬 시스템 강화 방안
   - TDD 강제 메커니즘 도입 방안
   - 2단계 리뷰 프로세스 도입 가능성
   - Git Worktree 활용 패턴 (멀티봇 충돌 방지)

### Phase 3: 학습 보고서 작성

1. **핵심 인사이트 정리** (10개 이상)
2. **실행 가능한 액션 아이템** (우선순위별)
3. **참고 파일 경로 맵** (중요 파일 → 역할 → 참고할 점)

## 참고 경로
- 우리 dispatch.py: `/home/jay/workspace/dispatch.py`
- 팀 프롬프트: `/home/jay/workspace/prompts/`
- 조직도: `/home/jay/workspace/memory/organization-structure.json`
- 기존 superpowers 학습 자료 (있으면): `memory/research/` 하위 검색

## 산출물
1. `/home/jay/workspace/memory/research/superpowers-deep-analysis.md` — 전체 심층 분석 보고서
2. `/home/jay/workspace/memory/research/superpowers-our-system-comparison.md` — 비교 분석 + 적용 방안
3. `/home/jay/workspace/memory/reports/task-830.1.md` — 완료 보고서

## 보고
- 완료 시 `/home/jay/workspace/memory/reports/task-830.1.md` 작성
- `.done` 파일 생성: `/home/jay/workspace/memory/events/task-830.1.done`

## task-timer
- 완료 시: `python3 /home/jay/workspace/memory/task-timer.py end task-830.1`