gwendall/superclaude

🔮 Claude AI로 GitHub 워크플로우를 강화하세요. AI 기반의 커밋 메시지 (commit messages), 지능적인 변경 로그 (changelogs), 자동화된 문서화 (documentation), 그리고 코드베이스를 실제로 이해하는 코드 리뷰 (code reviews)를 통해 개발 프로세스를 혁신하세요.

npm install -g superclaude

사전 요구 사항 (Prerequisites): Node.js 18+, Git, Claude Code, 그리고 선택적으로 GitHub CLI.

cd your-project
superclaude --verify # 시스템 의존성 및 인증 확인
superclaude commit # AI가 완벽한 커밋 메시지를 생성
...

지능적인 의존성 및 인증 확인.

반복적인 확인을 피하기 위해 지능적인 캐싱 (caching)을 사용하여 시스템 설정과 인증 상태를 검증합니다. Claude, Git, 그리고 GitHub 인증이 제대로 구성되었는지 확인합니다.

superclaude --verify # 전체 의존성 확인 강제 실행

작동 방식:

• Claude Code 설치 및 인증 검증
• Git 설정 및 사용자 설정 확인
• GitHub 인증 (SSH 키 또는 GitHub CLI) 확인
• 반복적인 확인을 피하기 위해 지능적인 24시간 캐싱 사용
• 누락된 의존성에 대한 상세한 피드백 제공

실제로 의미 있는 AI 기반 커밋.

Git 변경 사항을 분석하고, 문맥 (context)을 이해하며, 관습적인 커밋 메시지 (conventional commit messages)를 생성합니다. 더 이상 "fix stuff"나 "update files" 같은 메시지는 필요 없습니다. 코드의 이야기를 들려주는 의미 있는 커밋을 받으세요.

superclaude commit # 빠른 AI 커밋
superclaude commit --interactive # 커밋 전 검토
superclaude commit --verbose # AI의 사고 과정 확인
...

작동 방식:

• 모든 변경된 파일을 스캔하고 수정 사항을 이해
• 코드 패턴을 분석하여 커밋 유형 (feat/fix/refactor/etc.) 결정
• 명확한 설명을 포함한 관습적인 커밋 형식 (conventional commit format) 생성
• 커밋 메시지 생성을 안내하기 위한 추가적인 문맥 (context) 지원
• 원활한 푸시 (push) 작업을 위한 강화된 인증 검증
• 현재 브랜치에 자동으로 스테이징 (stage), 커밋 (commit), 푸시 (push) 수행

가공되지 않은 커밋 히스토리를 읽기 쉬운 프로젝트 이야기로 바꾸세요.

기술적인 소음이 아닌 사용자 영향에 집중하여 읽기 쉬운 변경 로그 (changelog)를 생성합니다. 이해관계자들에게 실제로 의미 있는 일간, 주간, 월간 요약을 생성합니다.

superclaude changelog # 지능형 변경 로그 생성
superclaude changelog --verbose # 상세 분석 프로세스 확인

작동 방식:

• AI 이해력을 바탕으로 전체 커밋 (commit) 히스토리를 분석합니다.
• 사소한 변경 사항은 필터링하고 의미 있는 업데이트에 집중합니다.
• 시간 범위와 영향도에 따라 변경 사항을 그룹화합니다.
• 다양한 변경 로그 형식 (일간/주간/월간)을 생성합니다.
• 명확하고 비기술적인 언어로 작성합니다.

스스로 작성되는 전문적인 문서화.

코드베이스 아키텍처 (architecture)를 분석하여 설치 가이드, 사용 예시, 기능 설명이 포함된 포괄적인 README 파일을 생성합니다.

superclaude readme # 프로젝트 README 생성

작동 방식:

• 프로젝트 구조를 스캔하고 주요 기술을 식별합니다.
• package.json 및 의존성 (dependencies)을 분석합니다.
• 코드 패턴과 프로젝트 목적을 이해합니다.
• 예시가 포함된 전문적인 문서를 생성합니다.
• 설치, 사용 및 기여 (contribution) 가이드를 포함합니다.

사람이 놓치는 것을 잡아내는 코드 리뷰.

보안 취약점 (security vulnerabilities), 성능 문제, 유지보수성 문제를 위해 심층적인 코드 분석을 수행합니다. 개선을 위한 실행 가능한 권장 사항을 제공합니다.

superclaude review # 포괄적인 코드 분석
superclaude review --verbose # 상세 보안 평가

작동 방식:

• 패턴과 안티 패턴 (anti-patterns)을 위해 전체 코드베이스를 분석합니다.
• 보안 취약점과 성능 병목 현상 (performance bottlenecks)을 식별합니다.
• 코드 품질 및 유지보수성 지표를 평가합니다.
• 구체적이고 실행 가능한 개선 권장 사항을 제공합니다.
• 상세 리뷰를 docs/code-review.md에 저장합니다.

개발자들이 실제로 읽는 기술 문서.

아키텍처, 컴포넌트 (components), 배포 (deployment) 및 트러블슈팅 (troubleshooting)을 다루는 포괄적인 기술 가이드를 생성합니다.

superclaude docs # 기술 문서 생성

작동 방식:

• 프로젝트 아키텍처(Architecture) 및 컴포넌트 관계를 매핑합니다.
• 데이터 흐름(Data flow) 및 시스템 상호작용을 문서화합니다.
• 배포 및 설정 가이드를 생성합니다.
• 문제 해결(Troubleshooting) 및 디버깅(Debugging) 정보를 포함합니다.
• 다음 경로에 저장합니다:
  docs/technical-docs.md

AI 기반 기능 아이디어 구상 및 개선 제안.

코드베이스(Codebase)의 역량을 분석하여 새로운 기능, 최적화 및 아키텍처 개선 사항을 제안합니다.

superclaude brainstorm # 개선 아이디어 얻기

작동 방식:

• 현재 코드베이스의 역량과 패턴을 평가합니다.
• 최적화 기회와 기술 부채(Technical debt)를 식별합니다.
• 프로젝트 방향성에 기반하여 새로운 기능을 제안합니다.
• 아키텍처 진화 전략을 권장합니다.
• 아이디어를 다음 경로에 저장합니다:
  docs/ideas.md

전체 git 히스토리에 지능적인 컨텍스트(Context)를 추가합니다.

저장소의 모든 커밋(Commit)을 분석하여 각 변경 사항이 실제로 무엇을 달성했는지 설명하는 AI 생성 노트를 추가합니다.

superclaude annotate # 모든 커밋에 AI 노트 추가
superclaude annotate --verbose # 주석 프로세스 확인

작동 방식:

• 각 커밋의 디프(Diff)를 처리하고 변경 사항을 이해합니다.
• 상세한 기술적 설명을 생성합니다.
• 컨텍스트와 목적이 담긴 git 노트(Git notes)를 추가합니다.
• 검색 가능한 커밋 히스토리를 생성합니다.
• 다음 명령어로 확인합니다:
  git log --show-notes

팀 워크플로(Workflow)를 위해 package.json에 추가하세요:

{
"scripts": {
"commit": "superclaude commit --interactive",
...

단순한 자동화 도구와 달리, SuperClaude는 코드의 컨텍스트를 이해합니다. 전체 코드베이스를 읽고, 패턴을 파악하며, 귀하의 특정 프로젝트에 의미 있는 콘텐츠를 생성합니다.

Claude의 깊은 추론(Reasoning) 능력과 GitHub 워크플로를 결합합니다. 구문(Syntax)뿐만 아니라 의도(Intent), 아키텍처, 그리고 사용자 영향력까지 이해하는 AI를 만나보세요.

커밋 메시지(Commit messages): 매번 30초에서 즉시로
변경 로그(Changelogs): 몇 시간의 수동 작업에서 2분으로
문서화(Documentation): 며칠간의 작성 작업에서 몇 분 만에 완성되는 포괄적인 문서로
코드 리뷰(Code reviews): 문제가 되기 전에 이슈를 포착

• 귀하의 프로젝트 기술 스택 (tech stack) 및 패턴을 이해합니다
• 기존 코드 스타일 (code style)과의 일관성을 유지합니다
• 단순한 기술적 변경 사항이 아닌 사용자 영향 (user impact)에 집중합니다
• 귀하의 코드베이스 구조 (codebase structure)와 관례 (conventions)로부터 학습합니다

# 변경 사항 적용
echo "new feature" >> src/feature.js
# 완벽한 메시지를 포함한 AI 커밋 (AI commit)
...

# 스탠드업 미팅 전 - 프로젝트 인사이트 (project insights) 확보
superclaude brainstorm
# ✅ "코드베이스를 기반으로 한 8가지 개선 기회는 다음과 같습니다..."
...

먼저 다음을 설치하세요:

# 필수 사항
npm install -g @anthropic-ai/claude-code
# 그 다음 실행: claude (인증 완료 필요)
...

시스템 요구 사항 (System Requirements): Node.js 18 이상, 사용자 정보가 설정된 Git.

SuperClaude는 모든 리포지토리 (repositories)에서 작동하는 지능적인 글로벌 인증 감지 기능을 사용합니다. 시스템은 SSH 키 또는 GitHub CLI 인증을 사용하여 귀하의 GitHub 액세스를 자동으로 검증합니다:

원격 저장소 (remote)가 git@github.com:... 형식을 사용하는 경우:

# SSH 키 생성 (없는 경우)
ssh-keygen -t ed25519 -C "your@email.com"
# GitHub에 공개 키 (public key) 추가
...

원격 저장소가 https://github.com/... 형식을 사용하는 경우, 세 가지 옵션이 있습니다:

옵션 1: GitHub CLI (권장)

brew install gh
gh auth login # 프롬프트가 뜨면 SSH 선택

옵션 2: SSH로 전환

git remote set-url origin git@github.com:USERNAME/REPOSITORY.git

옵션 3: 개인 액세스 토큰 (Personal Access Token)

• GitHub 설정 (Settings)에서 토큰 생성
• git에서 자격 증명 (credentials)을 요청할 때 토큰을 비밀번호로 사용

💡

SSH가 더 나은 이유: SSH는 비밀번호 입력 프롬프트를 제거하고, 더 안전하며, 원활한 인증을 제공합니다. SuperClaude는 귀하의 설정을 자동으로 감지하고 모든 인증 문제를 안내합니다.

Command not found (명령어를 찾을 수 없음)

npm install -g superclaude
# npm 글로벌 bin 디렉토리가 PATH에 포함되어 있는지 확인하세요

Claude Code not authenticated (Claude Code 인증되지 않음)

claude
# 인증 프롬프트(Console/Pro/Enterprise)를 따르세요

Git not configured (Git 설정되지 않음)

git config --global user.name "Your Name"
git config --global user.email "your@email.com"

GitHub CLI issues (선택 사항)

brew install gh # macOS 권장
gh auth login # GitHub 인증

상세한 출력을 보려면 --verbose를, 의존성 확인 (dependency checking)을 하려면 --verify를 사용하세요:

superclaude commit --verbose # 단계별 AI 추론 (reasoning) 과정을 보여줍니다
superclaude --verify # 전체 시스템 검증을 강제합니다
superclaude --verify --verbose # 상세한 의존성 진단 (diagnostics)을 수행합니다

• 명령어 참조를 위해 superclaude help를 실행하세요 - Claude Code 문서를 확인하세요

• GitHub에서 이슈 (issues)를 오픈하세요

• 저장소 (repository)를 포크 (Fork) 하세요

• 변경 사항을 적용하세요

• SuperClaude를 사용하여 커밋 (commit) 하세요:
  superclaude commit --interactive

• 풀 리퀘스트 (pull request)를 제출하세요

MIT License - LICENSE 파일을 참조하세요.

Made with ❤️ and AI - SuperClaude는 Claude에게 사용자의 GitHub 프로젝트에 대한 깊은 이해를 제공함으로써 개발 워크플로우 (workflow)를 변화시킵니다.