claude_version 1.6.1

Claude Code version manager: install, upgrade, and session lifecycle
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# Pitfall Doc Entity

### Scope

- **Purpose**: Document confirmed design traps discovered through implementation of claude_version.
- **Responsibility**: Index of pitfall doc instances covering failure modes with concrete trap, failure, and mitigation sections.
- **In Scope**: Version lock side effects, auto-updater bypass vectors.
- **Out of Scope**: Design pattern rationale (→ `pattern/`), feature behavior (→ `feature/`).

### Overview Table

| ID | Name | Purpose | Status |
|----|------|---------|--------|
| 001 | [Version Lock chmod Side Effects](001_version_lock_chmod.md) | chmod modifies symlink target permissions causing lock bypass | ✅ |
| 002 | [Auto-Updater Symlink Retarget](002_symlink_retarget.md) | Auto-updater rewrites symlink, bypassing pinned version | ✅ |