session

개발 세션을 마치며 결정 사항과 후속 작업을 남길 때 사용합니다. 작업 중 배운 내용과 프로젝트 규칙을 .claude 문서에 정리해 다음 세션에서 이어갈 수 있게 합니다.

한마디로#

작업 중 배운 내용과 프로젝트 규칙을 .claude 문서에 정리해 다음 세션에서 이어갈 수 있게 합니다.

무엇을·언제#

무엇을 해주나요
- 그날 정한 규칙과 배운 점을 프로젝트 문서(.claude/ 폴더와 CLAUDE.md)에 자동으로 추가합니다.
- 반복되던 수작업 패턴을 찾아 "이건 자동화하면 좋겠다"라고 제안합니다.
- 다음에 이어서 하면 좋을 후속 작업(남은 할 일, 개선거리)을 정리해 줍니다.
- 같은 내용이 중복으로 적히지 않게 한 번 더 점검하고 정리합니다.
언제 작동하나요
- 작업 세션을 마무리할 때(예: /cc-dev:session:wrap 또는 줄임말 /wrap, /sw 실행) 동작합니다.
- 기존 내용을 지우기보다 더하는 방식으로 안전하게 업데이트하며, 중요한 변경은 사용자 확인 후 반영합니다.

핵심 용어#

용어	쉬운 설명
세션(session)	한 번 켜서 작업하고 마무리하기까지의 "작업 한 판"
`.claude/`	프로젝트의 규칙과 설정을 모아 두는 메모 폴더
`CLAUDE.md`	프로젝트 사용 설명서 같은 핵심 안내 문서
Agent(에이전트)	특정 일을 맡아 처리하는 작은 자동 일꾼
Dry run	실제로 바꾸지 않고 "이렇게 바뀔 예정"만 미리 보여 주는 시험 실행
Auto-commit	변경 내용을 자동으로 저장(기록)하는 것
후속 작업(Follow-up)	다음에 이어서 하면 좋은 남은 할 일
TODO	아직 처리하지 못한 "해야 할 일" 표시

A skill that auto-reflects content learned during sessions into .claude/ directory documents.

Scope and Capabilities#

Core Features#

Feature	Description
Document updates	Auto-update CLAUDE.md and related documents
Automation detection	Discover repetitive task patterns and suggest skills
Learning extraction	Extract rules/patterns learned during sessions
Follow-up tasks	Suggest tasks for next session

2-Phase Workflow#

Phase 1: Parallel Analysis (4 Agents)
├── doc-updater Agent      → Document update suggestions
├── automation-scout Agent → Automation pattern detection
├── learning-extractor Agent → Learned content extraction
└── followup-suggester Agent → Follow-up task suggestions

Phase 2: Sequential Processing (1 Agent)
└── duplicate-checker Agent → Duplicate check and cleanup

Quick Start#

Basic Usage#

# Full session analysis and document update
/cc-dev:session:wrap

# Abbreviated commands
/wrap
/sw

With Options#

# Update specific area only
/cc-dev:session:wrap --scope rules      # Rules only
/cc-dev:session:wrap --scope commands   # Commands only
/cc-dev:session:wrap --scope agents     # Agents only

# Dry run (preview changes)
/cc-dev:session:wrap --dry-run

# Auto-commit
/cc-dev:session:wrap --auto-commit

# Skip duplicate check
/cc-dev:session:wrap --skip-duplicates

Analysis Targets#

Phase 1 Agent Analysis Targets#

Agent	Analysis Targets
doc-updater	Coding conventions, project settings, architecture patterns, dependencies
automation-scout	Repetitive tasks, manual patterns, skill candidates
learning-extractor	Code patterns, error solutions, user preferences
followup-suggester	Incomplete TODOs, improvements, technical debt

Target Files#

Path	Description
`CLAUDE.md`	Project main guide
`.claude/rules/*/.md`	Coding rules
`.claude/commands/*/.md`	Skill/agent definitions
`.claude/settings.local.json`	Local settings

Result Format#

On Completion#

╔════════════════════════════════════════════════════════════════╗
║  Session Wrap Complete                                         ║
╠════════════════════════════════════════════════════════════════╣
║                                                                ║
║  📝 Document Updates                                           ║
║  ├── CLAUDE.md: +15 lines (coding conventions added)           ║
║  ├── .claude/rules/bloc-patterns.md: +8 lines                 ║
║  └── .claude/commands/session/wrap.md: newly created           ║
║                                                                ║
║  🤖 Automation Suggestions                                     ║
║  ├── Recommend creating bloc-event-state-pair skill            ║
║  └── Recommend adding test-template auto-import                ║
║                                                                ║
║  📚 Learned Content                                            ║
║  ├── [Rule] Actively use dot shorthand                         ║
║  ├── [Rule] isClosed check required after await                ║
║  └── [Pattern] ZenHub issueTypeId must be specified            ║
║                                                                ║
║  📋 Follow-up Tasks                                            ║
║  ├── [High] Achieve 80% test coverage                          ║
║  └── [Medium] Optimize author search API                       ║
║                                                                ║
║  🔄 Duplicates removed: 2                                      ║
║  ⚠️ Conflicts resolved: 0                                      ║
║                                                                ║
╚════════════════════════════════════════════════════════════════╝

Key Rules#

Non-destructive Updates: Prefer additions/modifications over deleting existing content
Evidence-based: State session-based evidence for all changes
Maintain Consistency: Maintain consistency with existing document style
Prevent Duplicates: Prevent duplicate content additions
User Confirmation: Apply important changes only after user confirmation

Additional Resources#

wrap.md - Detailed command definition