#클로드코드웹: 리포 PR 중심 워크플로우 - 비틀어보기

Claude Code Web PR 워크플로우

🎯 핵심 통찰

“리포 중심 환경에서 PR로 비틀어보기가 아닐까?”

제약을 워크플로우로 전환하기:

• ❌ “웹에서는 파일을 직접 수정 못 함” (제약)
• ✅ “웹은 PR 중심 비동기 협업 환경” (워크플로우)

---

📊 Claude Code: Web vs CLI

측면	CLI	Web
실행 환경	로컬 터미널	클라우드 샌드박스
토큰 한도	제한적 (사용량 초과 문제)	더 자유로움
작업 방식	동기식, 순차적	비동기식, 병렬
파일 수정	직접 수정 (로컬)	PR 생성 (원격)
세션 복원	--teleport 가능	새 대화
Git 워크플로우	즉시 커밋/푸시	브랜치 + PR
적합한 작업	빠른 반복, 실시간 수정	잘 정의된 태스크, 문서화

---

🚀 Claude Code Web 철학 (Anthropic)

핵심 원칙

Delegation over Execution

• “assign multiple coding tasks to Claude”

• 개발자 = 감독자, Claude = 실행자

Parallel over Sequential

• 여러 저장소, 여러 작업 동시 진행

• 순차적 병목 제거

Human-in-the-loop Oversight

• “actively steer Claude to adjust course”

• Fire-and-forget 아님, 실시간 조정 가능

Automated Integration

• 자동 브랜치 생성

• 자동 PR 생성 (변경사항 요약 포함)

• 테스트 결과 첨부

Security by Isolation

• 격리된 샌드박스 환경

• 보안 Git 프록시 (인증된 저장소만)

• 네트워크/파일시스템 제한

---

🔄 PR 중심 워크플로우 설계

기본 패턴

사용자 요청
    ↓
Claude Web 분석 및 계획
    ↓
작업 실행 (샌드박스)
    ↓
브랜치 생성: claude/task-{session-id}
    ↓
변경사항 커밋
    ↓
PR 생성 (자동)
    ├── 변경사항 요약
    ├── 테스트 결과
    ├── 리뷰 제안
    └── 체크리스트
    ↓
사용자 리뷰 → 머지 or 추가 수정 요청

PR 구조 (Anthropic 권장)

## Summary
- 3-5 bullet points of what changed
 
## Changes Made
- Specific files and modifications
- Architecture decisions
 
## Testing
- [x] Unit tests passed
- [x] Integration tests
- [ ] Manual verification needed
 
## Review Notes
- Areas needing special attention
- Trade-offs made
- Future improvements
 
## Context
- Related issues/PRs
- Background information

---

💡 실전 사용 사례

Use Case 1: 문서 작성/수정

시나리오: Anthropic 지원 문서 작성

CLI 방식:

# 직접 파일 수정
claude "SUBMISSION-FIELDS.md 수정해줘"
# 즉시 커밋
git add . && git commit
- m "Update submission fields"

Web 방식:

1. "SUBMISSION-FIELDS.md에서 Why Anthropic 섹션 개선해줘"
2. Claude가 분석 → 개선안 제시
3. 승인하면 브랜치 생성: claude/improve-why-anthropic-{id}
4. PR 생성:
  
-  Title: "Improve Why Anthropic section with authenticity"
  
-  Summary: 변경 이유, 주요 수정 내용
  
-  Diff 포함
5. 리뷰 후 머지

장점:

• ✅ 변경사항 명확히 문서화
• ✅ 리뷰 프로세스 자연스러움
• ✅ 히스토리 깔끔하게 유지

Use Case 2: 멀티 태스크 병렬 실행

시나리오: 여러 문서 동시 작업

Web 방식:

Session 1: "PHILOSOPHY.md 톤 조정"
  → PR #1: claude/adjust-philosophy-tone-{id}
 
Session 2: "PORTFOLIO.md 기술 스택 업데이트"
  → PR #2: claude/update-tech-stack-{id}
 
Session 3: "README.md 구조 개선"
  → PR #3: claude/improve-readme-structure-{id}
 
모두 병렬로 실행 → 개별 PR → 순차적 머지

CLI로는 불가능한 패턴:

• 동시에 여러 세션 불가능
• 순차적으로만 작업 가능

Use Case 3: 메모리 시스템 연동

시나리오: ~/claude-memory 문서 정리

워크플로우:

1. Web에서 분석 요청:
   "memory/projects/ 아래 완료된 프로젝트 찾아서
    archives/로 이동하는 스크립트 작성해줘"
 
2. Claude가 작업:
  
-  스크립트 작성
  
-  테스트 실행
  
-  결과 문서화
 
3. PR 생성:
  
-  스크립트 파일
  
-  이동 대상 목록
  
-  실행 가이드
 
4. 리뷰 후 로컬에서 실행:
   git checkout claude/archive-completed-projects-{id}
   bash scripts/archive-projects.sh
   # 확인 후 머지

---

🎯 힣’s 컨텍스트: 웹 활용 전략

현재 상황

환경:

• 로컬: Ubuntu ThinkPad + NixOS 서버
• Claude Code CLI: 토큰 한도 제약
• Claude Web: 자유로운 토큰 사용

프로젝트:

• Anthropic Korea 지원 문서 작성
• ~/claude-memory 메모리 시스템 관리
• 8-config 생태계 유지보수

웹 환경 최적 활용법

1. 문서 중심 작업 → Web

✅ Anthropic 지원 문서 작성/개선
✅ README, PHILOSOPHY 같은 장문 문서
✅ 여러 문서 동시 작업
✅ 구조 재설계

이유:

• 토큰 많이 사용하는 작업
• PR로 변경사항 명확히 리뷰 가능
• 병렬 작업으로 효율 극대화

2. 코드 수정 → CLI (로컬)

✅ 빠른 버그 수정
✅ 설정 파일 조정
✅ 테스트 실행 및 디버깅

이유:

• 즉각적인 피드백 필요
• 반복적 수정
• 로컬 환경 의존성

3. 메모리 정리 → Web

✅ 완료 프로젝트 아카이브
✅ 중복 문서 통합
✅ 태그 표준화
✅ 구조 재정비

이유:

• 큰 그림 파악 필요
• 한 번에 많은 파일 분석
• 변경사항 체계적 리뷰

---

🛠️ 실전 팁

Web 세션 최적화

1. 명확한 태스크 정의

   ❌ "문서 좀 개선해줘"
   ✅ "SUBMISSION-FIELDS.md의 Why Anthropic 섹션에서
       '대장장이' 메타포의 과장된 톤을 줄이고,
       진정성을 강조하도록 290 words 내로 재작성해줘"

2. PR 제목 가이드 제공

   "작업 완료 후 PR 제목은:
    'docs: Improve Why Anthropic section with authentic tone'
    형식으로 해줘"

3. 테스트 기준 명시

      "변경 후 다음 확인:
   ​   
   -  Word count 280-300 범위
   ​   
   -  '4년' 표현 유지하되 과장 제거
   ​   
   -  대장장이 메타포 간결하게"

PR 머지 전략

옵션 1: 즉시 머지 (권장: 문서 작업)

gh pr checkout 123
# 리뷰 후
gh pr merge 123
- -squash

옵션 2: 로컬 수정 후 머지

gh pr checkout 123
# 추가 수정
git add . && git commit
- -amend
git push
- -force-with-lease
gh pr merge 123

옵션 3: 새 세션으로 추가 작업

Web에서:
"PR #123 기반으로 추가 개선:
 
-  톤 더 부드럽게
 
-  예시 하나 추가"
→ 새 PR 생성 (체인)

메모리 시스템 연동

Web → Memory 패턴:

1. 분석 및 제안

   "memory/projects/ 아래 __active 태그 문서 30개 분석해서
    완료된 것 같은 프로젝트 리스트 만들어줘"

2. 실행 스크립트 생성

   "위 리스트 기반으로 archives/로 이동하고
    __done 태그 추가하는 스크립트 작성"

3. PR 리뷰

• 이동 대상 확인

• 스크립트 안전성 검토

• 로컬 실행

     git checkout claude/archive-projects-{id}
     bash scripts/archive-completed-projects.sh
  ​- -dry-run
     # 확인 후 실행
     bash scripts/archive-completed-projects.sh
     git commit
  ​- -amend
     gh pr merge

---

🔮 미래 확장

Phase 1: 기본 PR 워크플로우 (현재)

• ✅ Web에서 작업 요청
• ✅ PR 생성
• ✅ 로컬에서 머지

TODO Phase 2: 자동화 강화

• PR 템플릿 표준화
• 리뷰 체크리스트 자동 생성
• CI/CD 통합 (Denote 검증 등)

TODO Phase 3: Agent Orchestration

• Web Agent가 Memory Agent와 협업
• 복잡한 멀티 스텝 작업 자동화
• 사용자는 최종 승인만

---

📚 참고 자료

Anthropic 공식:

• Claude Code on the Web
• Claude Code Documentation

핵심 개념:

• Delegation over Execution
• Human-in-the-loop Oversight
• Parallel Task Management
• Automated PR Creation

관련 문서:

• CLAUDE.md
• Agent 지침서
• PACKAGE-MANAGEMENT.md
• NixOS 환경 제약
• memory/resources/workflows/
• 기존 워크플로우들

---

✅ 액션 아이템

즉시 실행 가능

Anthropic 지원 문서 개선

• Web에서 각 문서 개선 요청
• 개별 PR로 리뷰
• 순차적 머지

Memory 정리 프로젝트

• Web에서 분석 및 스크립트 작성
• PR 리뷰
• 로컬 실행

이 문서 자체를 테스트

• 현재 작업이 첫 테스트!
• PR 생성하여 리뷰
• 워크플로우 개선점 기록

다음 단계

• PR 템플릿 작성
• 체크리스트 표준화
• 성공/실패 사례 수집
• 워크플로우 지속 개선

---

Version: 1.0 Author: 힣 (with Claude Web) Updated: 2025-11-11T15:58 Status: Living Document

---

메타: 이 문서는 Claude Code Web에서 PR 워크플로우로 작성된 첫 문서입니다.