claude-symphony 0.0.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (148) hide show
  1. package/README.md +16 -12
  2. package/bin/create.js +80 -69
  3. package/package.json +1 -1
  4. package/template/.claude/commands/benchmark.md +32 -32
  5. package/template/.claude/commands/brainstorm.md +33 -33
  6. package/template/.claude/commands/checkpoint.md +42 -42
  7. package/template/.claude/commands/codex.md +52 -52
  8. package/template/.claude/commands/collaborate.md +47 -47
  9. package/template/.claude/commands/context.md +77 -77
  10. package/template/.claude/commands/deploy.md +50 -50
  11. package/template/.claude/commands/fork.md +46 -46
  12. package/template/.claude/commands/gemini.md +43 -43
  13. package/template/.claude/commands/handoff.md +42 -42
  14. package/template/.claude/commands/implement.md +42 -42
  15. package/template/.claude/commands/init-project.md +25 -25
  16. package/template/.claude/commands/next.md +67 -67
  17. package/template/.claude/commands/planning.md +38 -38
  18. package/template/.claude/commands/qa.md +47 -47
  19. package/template/.claude/commands/refactor.md +50 -50
  20. package/template/.claude/commands/research.md +31 -31
  21. package/template/.claude/commands/restore.md +53 -53
  22. package/template/.claude/commands/run-stage.md +45 -45
  23. package/template/.claude/commands/stages.md +49 -49
  24. package/template/.claude/commands/status.md +41 -41
  25. package/template/.claude/commands/tasks.md +33 -33
  26. package/template/.claude/commands/test.md +45 -45
  27. package/template/.claude/commands/ui-ux.md +31 -31
  28. package/template/.claude/commands/validate.md +81 -81
  29. package/template/.claude/hooks/ai-selector.sh +39 -39
  30. package/template/.claude/hooks/auto-checkpoint.sh +30 -30
  31. package/template/.claude/hooks/output-validator.sh +45 -45
  32. package/template/.claude/hooks/post-stage.sh +28 -28
  33. package/template/.claude/hooks/pre-stage.sh +47 -47
  34. package/template/.claude/hooks/session-start.sh +27 -27
  35. package/template/.claude/hooks/statusline.sh +24 -24
  36. package/template/.claude/hooks/stop.sh +26 -26
  37. package/template/.claude/settings.json +32 -32
  38. package/template/.claude/skills/ai-collaboration/README.md +31 -31
  39. package/template/.claude/skills/ai-collaboration/debate.md +66 -66
  40. package/template/.claude/skills/ai-collaboration/parallel.md +34 -34
  41. package/template/.claude/skills/ai-collaboration/prompts/CLAUDE.md +59 -63
  42. package/template/.claude/skills/auto-checkpoint/README.md +46 -46
  43. package/template/.claude/skills/auto-checkpoint/prompts/CLAUDE.md +68 -72
  44. package/template/.claude/skills/auto-checkpoint/rollback.md +95 -95
  45. package/template/.claude/skills/auto-checkpoint/trigger.md +37 -37
  46. package/template/.claude/skills/context-compression/README.md +69 -69
  47. package/template/.claude/skills/context-compression/analyze.md +74 -74
  48. package/template/.claude/skills/context-compression/compress.md +103 -103
  49. package/template/.claude/skills/context-compression/prompts/compression.md +78 -78
  50. package/template/.claude/skills/output-validator/README.md +33 -33
  51. package/template/.claude/skills/output-validator/prompts/CLAUDE.md +74 -78
  52. package/template/.claude/skills/output-validator/validate.md +76 -76
  53. package/template/.claude/skills/smart-handoff/README.md +35 -35
  54. package/template/.claude/skills/smart-handoff/extract.md +42 -42
  55. package/template/.claude/skills/smart-handoff/prompts/CLAUDE.md +52 -54
  56. package/template/.claude/skills/smart-handoff/summarize.md +55 -55
  57. package/template/.claude/skills/stage-transition/README.md +50 -50
  58. package/template/.claude/skills/stage-transition/handoff-gen.md +89 -89
  59. package/template/.claude/skills/stage-transition/prompts/transition.md +74 -74
  60. package/template/.claude/skills/stage-transition/validate.md +41 -41
  61. package/template/CLAUDE.md +334 -335
  62. package/template/config/ai_benchmarking.yaml +22 -22
  63. package/template/config/ai_collaboration.yaml +18 -18
  64. package/template/config/ai_logging.yaml +50 -50
  65. package/template/config/auto_checkpoint.yaml +32 -32
  66. package/template/config/context.yaml +20 -20
  67. package/template/config/git.yaml +51 -51
  68. package/template/config/handoff_intelligence.yaml +23 -23
  69. package/template/config/mcp_fallbacks.yaml +71 -71
  70. package/template/config/memory_integration.yaml +23 -23
  71. package/template/config/model_enforcement.yaml +53 -53
  72. package/template/config/models.yaml +24 -24
  73. package/template/config/output_validation.yaml +44 -44
  74. package/template/config/pipeline.yaml +25 -25
  75. package/template/config/pipeline_forking.yaml +40 -40
  76. package/template/config/qa_logging.yaml +67 -67
  77. package/template/config/smart_rollback.yaml +48 -48
  78. package/template/config/stage_personas.yaml +154 -154
  79. package/template/config/workflow.yaml +16 -16
  80. package/template/scripts/ai-benchmark.sh +41 -41
  81. package/template/scripts/codex-wrapper.sh +32 -32
  82. package/template/scripts/context-manager.sh +136 -136
  83. package/template/scripts/create-checkpoint.sh +34 -34
  84. package/template/scripts/gemini-wrapper.sh +31 -31
  85. package/template/scripts/init-project.sh +40 -40
  86. package/template/scripts/list-stages.sh +30 -30
  87. package/template/scripts/next-stage.sh +67 -67
  88. package/template/scripts/output-validate.sh +2 -2
  89. package/template/scripts/pipeline-fork.sh +68 -68
  90. package/template/scripts/pre-run-check.sh +84 -84
  91. package/template/scripts/restore-checkpoint.sh +50 -50
  92. package/template/scripts/run-stage.sh +44 -44
  93. package/template/scripts/show-status.sh +30 -30
  94. package/template/scripts/smart-handoff.sh +70 -70
  95. package/template/stages/01-brainstorm/CLAUDE.md +70 -74
  96. package/template/stages/01-brainstorm/README.md +54 -54
  97. package/template/stages/01-brainstorm/config.yaml +18 -18
  98. package/template/stages/01-brainstorm/prompts/collaboration.md +24 -24
  99. package/template/stages/01-brainstorm/prompts/ideation.md +41 -41
  100. package/template/stages/01-brainstorm/prompts/persona.md +50 -50
  101. package/template/stages/01-brainstorm/prompts/requirements.md +55 -55
  102. package/template/stages/01-brainstorm/prompts/validation.md +28 -28
  103. package/template/stages/01-brainstorm/templates/ideas.md +47 -47
  104. package/template/stages/01-brainstorm/templates/requirements_analysis.md +61 -61
  105. package/template/stages/02-research/CLAUDE.md +72 -76
  106. package/template/stages/02-research/config.yaml +12 -12
  107. package/template/stages/02-research/prompts/collaboration.md +29 -29
  108. package/template/stages/02-research/prompts/feasibility.md +38 -38
  109. package/template/stages/02-research/prompts/market_analysis.md +29 -29
  110. package/template/stages/02-research/prompts/tech_stack.md +34 -34
  111. package/template/stages/02-research/prompts/validation.md +29 -29
  112. package/template/stages/03-planning/CLAUDE.md +88 -92
  113. package/template/stages/03-planning/config.yaml +10 -10
  114. package/template/stages/03-planning/prompts/architecture.md +43 -43
  115. package/template/stages/03-planning/prompts/collaboration.md +34 -34
  116. package/template/stages/03-planning/prompts/validation.md +34 -34
  117. package/template/stages/04-ui-ux/CLAUDE.md +68 -72
  118. package/template/stages/04-ui-ux/config.yaml +5 -5
  119. package/template/stages/04-ui-ux/prompts/collaboration.md +35 -35
  120. package/template/stages/04-ui-ux/prompts/validation.md +30 -30
  121. package/template/stages/05-task-management/CLAUDE.md +81 -85
  122. package/template/stages/05-task-management/config.yaml +17 -17
  123. package/template/stages/05-task-management/prompts/collaboration.md +30 -30
  124. package/template/stages/05-task-management/prompts/validation.md +33 -33
  125. package/template/stages/05-task-management/templates/notion_integration.md +70 -70
  126. package/template/stages/05-task-management/templates/parallel_groups.yaml +64 -64
  127. package/template/stages/05-task-management/templates/task_schema.yaml +33 -33
  128. package/template/stages/06-implementation/CLAUDE.md +117 -121
  129. package/template/stages/06-implementation/config.yaml +10 -10
  130. package/template/stages/06-implementation/prompts/collaboration.md +29 -29
  131. package/template/stages/06-implementation/prompts/validation.md +36 -36
  132. package/template/stages/07-refactoring/CLAUDE.md +120 -124
  133. package/template/stages/07-refactoring/config.yaml +11 -11
  134. package/template/stages/07-refactoring/prompts/collaboration.md +36 -36
  135. package/template/stages/07-refactoring/prompts/validation.md +40 -40
  136. package/template/stages/08-qa/CLAUDE.md +80 -84
  137. package/template/stages/08-qa/config.yaml +7 -7
  138. package/template/stages/08-qa/prompts/collaboration.md +34 -34
  139. package/template/stages/08-qa/prompts/validation.md +41 -41
  140. package/template/stages/09-testing/CLAUDE.md +86 -90
  141. package/template/stages/09-testing/config.yaml +10 -10
  142. package/template/stages/09-testing/prompts/collaboration.md +38 -38
  143. package/template/stages/09-testing/prompts/validation.md +41 -41
  144. package/template/stages/10-deployment/CLAUDE.md +86 -90
  145. package/template/stages/10-deployment/config.yaml +11 -11
  146. package/template/stages/10-deployment/prompts/collaboration.md +37 -37
  147. package/template/stages/10-deployment/prompts/validation.md +54 -54
  148. package/template/stages/10-deployment/templates/github-actions-cd.yaml +1 -1
@@ -1,113 +1,109 @@
1
1
  # Auto-Checkpoint Skill - AI Instructions
2
2
 
3
- ## 역할
3
+ ## Role
4
4
 
5
- 당신은 체크포인트 롤백 관리 전문가입니다. 작업의 안전한 진행을 위해 체크포인트를 관리하고 문제 발생 스마트 롤백을 지원합니다.
5
+ You are a checkpoint and rollback management specialist. You manage checkpoints for safe work progress and support smart rollback when issues occur.
6
6
 
7
- ## 핵심 책임
7
+ ## Core Responsibilities
8
8
 
9
- ### 1. 체크포인트 트리거 감지
9
+ ### 1. Checkpoint Trigger Detection
10
10
 
11
- 다음 상황을 감지하여 체크포인트 생성을 제안하거나 실행합니다:
11
+ Detect the following situations to suggest or execute checkpoint creation:
12
12
 
13
- - **태스크 완료**: 5 태스크 완료 시
14
- - **파일 변경**: 100 이상 변경 시
15
- - **파괴적 작업**: rm, reset, drop 감지 시
16
- - **스테이지 완료**: 스테이지 종료
13
+ - **Task completion**: Every 5 tasks completed
14
+ - **File change**: When 100+ lines changed
15
+ - **Destructive action**: When rm, reset, drop, etc. detected
16
+ - **Stage completion**: On stage end
17
17
 
18
- ### 2. 체크포인트 생성
18
+ ### 2. Checkpoint Creation
19
19
 
20
20
  ```
21
- 체크포인트 생성 포함 사항:
22
- 1. 현재 소스 코드
23
- 2. 설정 파일
24
- 3. 상태 파일 (progress.json )
25
- 4. HANDOFF (있는 경우)
26
- 5. 메타데이터 (트리거, 시간, 요약)
21
+ Items to include when creating checkpoint:
22
+ 1. Current source code
23
+ 2. Config files
24
+ 3. State files (progress.json, etc.)
25
+ 4. HANDOFF (if exists)
26
+ 5. Metadata (trigger, time, summary)
27
27
  ```
28
28
 
29
- ### 3. 롤백 제안
29
+ ### 3. Rollback Suggestion
30
30
 
31
- 에러 발생 시:
32
- 1. 에러 유형 분석
33
- 2. 관련 체크포인트 식별
34
- 3. 적절한 롤백 범위 제안
35
- 4. 영향 분석 제공
31
+ On error:
32
+ 1. Analyze error type
33
+ 2. Identify related checkpoints
34
+ 3. Suggest appropriate rollback scope
35
+ 4. Provide impact analysis
36
36
 
37
- ## 체크포인트 생성 프로토콜
37
+ ## Checkpoint Creation Protocol
38
38
 
39
- ### 자동 체크포인트
39
+ ### Auto Checkpoint
40
40
  ```
41
- 1. 트리거 조건 확인
42
- 2. 현재 상태 검증
43
- 3. 체크포인트 생성
44
- 4. 간단한 알림 표시
41
+ 1. Check trigger condition
42
+ 2. Verify current state
43
+ 3. Create checkpoint
44
+ 4. Display brief notification
45
45
  ```
46
46
 
47
- ### 파괴적 작업 체크포인트
47
+ ### Checkpoint Before Destructive Action
48
48
  ```
49
- 1. 파괴적 패턴 감지
50
- 2. **즉시 체크포인트 생성**
51
- 3. 사용자에게 경고 표시
52
- 4. 확인 후에만 작업 진행
49
+ 1. Detect destructive pattern
50
+ 2. **Create checkpoint immediately**
51
+ 3. Display warning to user
52
+ 4. Proceed only after confirmation
53
53
  ```
54
54
 
55
- ## 롤백 프로토콜
55
+ ## Rollback Protocol
56
56
 
57
- ### 롤백 제안
57
+ ### When Suggesting Rollback
58
58
  ```markdown
59
- ## 롤백 제안
59
+ ## Rollback Suggestion
60
60
 
61
- **에러 유형**: [분석된 에러]
62
- **권장 체크포인트**: [체크포인트 이름]
63
- **권장 범위**: [파일/함수/스테이지]
61
+ **Error Type**: [Analyzed error]
62
+ **Recommended Checkpoint**: [Checkpoint name]
63
+ **Recommended Scope**: [File/Function/Stage]
64
64
 
65
- ### 영향 분석
66
- - 복원될 파일: [목록]
67
- - 잃게 변경: [요약]
65
+ ### Impact Analysis
66
+ - Files to restore: [List]
67
+ - Changes to lose: [Summary]
68
68
 
69
- 롤백을 진행하시겠습니까?
69
+ Proceed with rollback?
70
70
  ```
71
71
 
72
- ### 롤백 실행
72
+ ### When Executing Rollback
73
73
  ```
74
- 1. 현재 상태 백업 (안전망)
75
- 2. 체크포인트 유효성 검증
76
- 3. 선택된 범위만 복원
77
- 4. 무결성 확인
78
- 5. 복구 가이드 제공
74
+ 1. Backup current state (safety net)
75
+ 2. Validate checkpoint
76
+ 3. Restore only selected scope
77
+ 4. Verify integrity
78
+ 5. Provide recovery guide
79
79
  ```
80
80
 
81
- ## 알림 형식
81
+ ## Notification Format
82
82
 
83
- ### 체크포인트 생성 완료
83
+ ### Checkpoint Creation Complete
84
84
  ```
85
- 체크포인트 생성: {name}
86
- - 트리거: {reason}
87
- - 파일: {count}
85
+ Checkpoint created: {name}
86
+ - Trigger: {reason}
87
+ - Files: {count}
88
88
  ```
89
89
 
90
- ### 롤백 완료
90
+ ### Rollback Complete
91
91
  ```
92
- 🔄 롤백 완료: {checkpoint} → 현재
93
- - 복원 파일: {count}
94
- - 다음 단계: {recommendations}
92
+ 🔄 Rollback complete: {checkpoint} → current
93
+ - Files restored: {count}
94
+ - Next steps: {recommendations}
95
95
  ```
96
96
 
97
- ## 금지 사항
98
-
99
- - 사용자 확인 없이 롤백 실행
100
- - 파괴적 작업 전 체크포인트 생략
101
- - 불완전한 체크포인트 생성
102
- - 롤백 후 복구 가이드 누락
103
-
104
- ## 우선순위
105
-
106
- 1. 데이터 보호 (체크포인트 생성)
107
- 2. 사용자 경고 (파괴적 작업)
108
- 3. 스마트 제안 (롤백 범위)
109
- 4. 간결한 알림 (상태 표시)
110
-
97
+ ## Prohibited Actions
111
98
 
99
+ - Execute rollback without user confirmation
100
+ - Skip checkpoint before destructive action
101
+ - Create incomplete checkpoints
102
+ - Omit recovery guide after rollback
112
103
 
104
+ ## Priorities
113
105
 
106
+ 1. Data protection (checkpoint creation)
107
+ 2. User warning (destructive actions)
108
+ 3. Smart suggestions (rollback scope)
109
+ 4. Concise notifications (status display)
@@ -1,152 +1,152 @@
1
1
  # Auto-Checkpoint - Rollback Guide
2
2
 
3
- ## 스마트 롤백 시스템
3
+ ## Smart Rollback System
4
4
 
5
- ### 에러 발생 자동 분석
5
+ ### Auto Analysis on Error
6
6
 
7
7
  ```mermaid
8
8
  graph TD
9
- A[에러 발생] --> B[에러 유형 분석]
10
- B --> C[관련 체크포인트 검색]
11
- C --> D[롤백 범위 계산]
12
- D --> E[롤백 제안 표시]
13
- E --> F{사용자 승인?}
14
- F -->|Yes| G[롤백 실행]
15
- F -->|No| H[수동 처리]
9
+ A[Error occurred] --> B[Analyze error type]
10
+ B --> C[Search related checkpoints]
11
+ C --> D[Calculate rollback scope]
12
+ D --> E[Display rollback suggestion]
13
+ E --> F{User approval?}
14
+ F -->|Yes| G[Execute rollback]
15
+ F -->|No| H[Manual handling]
16
16
  ```
17
17
 
18
- ### 에러 유형별 롤백 전략
18
+ ### Rollback Strategy by Error Type
19
19
 
20
- | 에러 유형 | 권장 범위 | 자동 제안 |
21
- |----------|----------|----------|
22
- | 빌드 실패 | 파일 레벨 | ✅ |
23
- | 테스트 실패 | 함수 레벨 | ✅ |
24
- | 런타임 에러 | 파일 레벨 | ✅ |
25
- | 설정 에러 | 설정 파일만 | ✅ |
26
- | 심각한 오류 | 스테이지 레벨 | 확인 필요 |
20
+ | Error Type | Recommended Scope | Auto Suggestion |
21
+ |------------|------------------|-----------------|
22
+ | Build failure | File level | ✅ |
23
+ | Test failure | Function level | ✅ |
24
+ | Runtime error | File level | ✅ |
25
+ | Config error | Config files only | ✅ |
26
+ | Severe error | Stage level | Confirmation required |
27
27
 
28
- ## 롤백 범위
28
+ ## Rollback Scopes
29
29
 
30
- ### 1. 파일 레벨 롤백
30
+ ### 1. File Level Rollback
31
31
  ```bash
32
- # 특정 파일만 체크포인트에서 복원
32
+ # Restore specific file from checkpoint
33
33
  /restore --checkpoint "auto_task_5" --files "src/auth/UserService.ts"
34
34
  ```
35
35
 
36
- **적합한 상황**:
37
- - 단일 파일 변경으로 인한 오류
38
- - 특정 모듈 롤백
36
+ **Suitable Situations**:
37
+ - Error due to single file change
38
+ - Rolling back specific module
39
39
 
40
- ### 2. 함수 레벨 롤백
40
+ ### 2. Function Level Rollback
41
41
  ```bash
42
- # 특정 함수만 복원 (지원 언어: TS, JS, Python)
42
+ # Restore specific function (Supported: TS, JS, Python)
43
43
  /restore --checkpoint "auto_task_5" --function "UserService.login"
44
44
  ```
45
45
 
46
- **적합한 상황**:
47
- - 리팩토링 특정 함수 문제
48
- - 부분적 로직 오류
46
+ **Suitable Situations**:
47
+ - Specific function issue during refactoring
48
+ - Partial logic error
49
49
 
50
- ### 3. 스테이지 레벨 롤백
50
+ ### 3. Stage Level Rollback
51
51
  ```bash
52
- # 전체 스테이지 상태 복원
52
+ # Restore entire stage state
53
53
  /restore --checkpoint "stage_06_start"
54
54
  ```
55
55
 
56
- **적합한 상황**:
57
- - 광범위한 문제
58
- - 아키텍처 수준 변경 취소
56
+ **Suitable Situations**:
57
+ - Widespread issues
58
+ - Canceling architecture-level changes
59
59
 
60
- ### 4. 설정 파일만 롤백
60
+ ### 4. Config Files Only Rollback
61
61
  ```bash
62
62
  /restore --checkpoint "auto_change" --config-only
63
63
  ```
64
64
 
65
- **적합한 상황**:
66
- - 설정 변경으로 인한 오류
67
- - 환경 설정 문제
65
+ **Suitable Situations**:
66
+ - Error due to config changes
67
+ - Environment configuration issues
68
68
 
69
- ## 롤백 미리보기
69
+ ## Rollback Preview
70
70
 
71
71
  ```markdown
72
- ## 롤백 미리보기
72
+ ## Rollback Preview
73
73
 
74
- **대상 체크포인트**: auto_task_5_20240120
75
- **롤백 범위**: 파일 레벨
74
+ **Target Checkpoint**: auto_task_5_20240120
75
+ **Rollback Scope**: File level
76
76
 
77
- ### 복원될 파일 (3)
78
- | 파일 | 현재 크기 | 복원 크기 | 변경량 |
79
- |------|----------|----------|--------|
80
- | src/auth/UserService.ts | 250 | 180 | -70 |
81
- | src/types/auth.ts | 50 | 45 | -5 |
82
- | tests/auth.test.ts | 100 | 80 | -20 |
77
+ ### Files to Restore (3)
78
+ | File | Current Size | Restore Size | Change |
79
+ |------|--------------|--------------|--------|
80
+ | src/auth/UserService.ts | 250 lines | 180 lines | -70 lines |
81
+ | src/types/auth.ts | 50 lines | 45 lines | -5 lines |
82
+ | tests/auth.test.ts | 100 lines | 80 lines | -20 lines |
83
83
 
84
- ### 잃게 변경사항
85
- - 비밀번호 해시 기능 추가 (UserService.ts:45-80)
86
- - 타입 정의 (auth.ts:40-50)
87
- - 관련 테스트 (auth.test.ts:70-100)
84
+ ### Changes to be Lost
85
+ - Password hash function added (UserService.ts:45-80)
86
+ - New type definitions (auth.ts:40-50)
87
+ - Related tests (auth.test.ts:70-100)
88
88
 
89
- ### 영향받는 의존성
90
- - LoginForm 컴포넌트 (import 확인 필요)
89
+ ### Affected Dependencies
90
+ - LoginForm component (import check required)
91
91
 
92
- **이 롤백을 실행하시겠습니까? (y/n)**
92
+ **Execute this rollback? (y/n)**
93
93
  ```
94
94
 
95
- ## 롤백 실행 프로세스
95
+ ## Rollback Execution Process
96
96
 
97
- ### 사전 작업
98
- 1. 현재 상태 백업 체크포인트 생성
99
- 2. 커밋되지 않은 변경사항 stash
97
+ ### Pre-work
98
+ 1. Create backup checkpoint of current state
99
+ 2. Stash uncommitted changes
100
100
 
101
- ### 롤백 단계
102
- 1. 체크포인트 유효성 검증
103
- 2. 파일 추출
104
- 3. 선택적 파일 복원
105
- 4. 무결성 확인
106
- 5. 상태 파일 업데이트
101
+ ### Rollback Steps
102
+ 1. Validate checkpoint
103
+ 2. Extract files
104
+ 3. Restore selected files
105
+ 4. Verify integrity
106
+ 5. Update state files
107
107
 
108
- ### 사후 작업
109
- 1. 검증 테스트 실행
110
- 2. HANDOFF 업데이트
111
- 3. 롤백 기록 저장
108
+ ### Post-work
109
+ 1. Run verification tests
110
+ 2. Update HANDOFF
111
+ 3. Save rollback history
112
112
 
113
- ## 복구 가이드 자동 생성
113
+ ## Auto-Generated Recovery Guide
114
114
 
115
115
  ```markdown
116
- ## 파일 롤백 완료
116
+ ## File Rollback Complete
117
117
 
118
- **체크포인트**: auto_task_5_20240120
119
- **복원된 파일**: 3
120
- **시간**: 2024-01-20 14:45:00
118
+ **Checkpoint**: auto_task_5_20240120
119
+ **Files Restored**: 3
120
+ **Time**: 2024-01-20 14:45:00
121
121
 
122
- ### 복구된 파일
122
+ ### Recovered Files
123
123
  - src/auth/UserService.ts
124
124
  - src/types/auth.ts
125
125
  - tests/auth.test.ts
126
126
 
127
- ### 권장 다음 단계
128
- 1. 변경사항 확인: `git diff`
129
- 2. 테스트 실행: `npm test`
130
- 3. 문제가 해결되었다면:
131
- - 원인 분석 다시 구현
132
- - 작은 단위로 작업
133
- 4. 문제가 지속된다면:
134
- - 추가 롤백 필요 가능성
135
- - `/restore --suggest` 실행
127
+ ### Recommended Next Steps
128
+ 1. Check changes: `git diff`
129
+ 2. Run tests: `npm test`
130
+ 3. If issue resolved:
131
+ - Analyze cause and re-implement
132
+ - Work in smaller units
133
+ 4. If issue persists:
134
+ - Additional rollback may be needed
135
+ - Run `/restore --suggest`
136
136
  ```
137
137
 
138
- ## 안전 장치
138
+ ## Safety Measures
139
139
 
140
- ### 롤백 차단 조건
141
- - 커밋되지 않은 변경사항 존재
142
- - 활성 프로세스 실행 중
143
- - 파일 잠금 상태
140
+ ### Rollback Block Conditions
141
+ - Uncommitted changes exist
142
+ - Active processes running
143
+ - Files locked
144
144
 
145
- ### 확인 필요 조건
146
- - 스테이지 레벨 롤백
147
- - 10 이상 파일 영향
148
- - 프로덕션 관련 파일 포함
145
+ ### Confirmation Required Conditions
146
+ - Stage level rollback
147
+ - 10+ files affected
148
+ - Production-related files included
149
149
 
150
- ### 쿨다운
151
- - 연속 롤백 5분 대기
152
- - 같은 체크포인트 재롤백 경고
150
+ ### Cooldown
151
+ - 5 minute wait between consecutive rollbacks
152
+ - Warning on rolling back same checkpoint again
@@ -1,8 +1,8 @@
1
1
  # Auto-Checkpoint - Trigger Guide
2
2
 
3
- ## 체크포인트 트리거 조건
3
+ ## Checkpoint Trigger Conditions
4
4
 
5
- ### 1. 태스크 완료 기반
5
+ ### 1. Task Completion Based
6
6
  ```yaml
7
7
  trigger:
8
8
  condition: "tasks_completed"
@@ -10,11 +10,11 @@ trigger:
10
10
  action: "create_checkpoint"
11
11
  ```
12
12
 
13
- **감지 방법**:
14
- - TodoWrite에서 `completed` 상태 카운트
15
- - 커밋 기록 분석
13
+ **Detection Method**:
14
+ - Count `completed` status from TodoWrite
15
+ - Analyze commit history
16
16
 
17
- ### 2. 파일 변경 기반
17
+ ### 2. File Change Based
18
18
  ```yaml
19
19
  trigger:
20
20
  condition: "major_file_change"
@@ -25,13 +25,13 @@ trigger:
25
25
  "*.md": 0.3
26
26
  ```
27
27
 
28
- **감지 방법**:
28
+ **Detection Method**:
29
29
  ```bash
30
- # 변경량 계산
30
+ # Calculate change amount
31
31
  git diff --stat | awk '{sum+=$4} END {print sum}'
32
32
  ```
33
33
 
34
- ### 3. 파괴적 작업
34
+ ### 3. Before Destructive Action
35
35
  ```yaml
36
36
  trigger:
37
37
  condition: "destructive_action"
@@ -41,12 +41,12 @@ trigger:
41
41
  - "drop table"
42
42
  ```
43
43
 
44
- **감지 동작**:
45
- 1. 즉시 체크포인트 생성
46
- 2. 사용자 확인 요청
47
- 3. 확인 작업 진행
44
+ **Action on Detection**:
45
+ 1. Create checkpoint immediately
46
+ 2. Request user confirmation
47
+ 3. Proceed with action after confirmation
48
48
 
49
- ### 4. 시간 기반
49
+ ### 4. Time Based
50
50
  ```yaml
51
51
  trigger:
52
52
  condition: "interval"
@@ -54,7 +54,7 @@ trigger:
54
54
  only_if_changes: true
55
55
  ```
56
56
 
57
- ### 5. 스테이지 기반
57
+ ### 5. Stage Based
58
58
  ```yaml
59
59
  trigger:
60
60
  conditions:
@@ -62,22 +62,22 @@ trigger:
62
62
  on_stage_error: true
63
63
  ```
64
64
 
65
- ## 체크포인트 생성 프로세스
65
+ ## Checkpoint Creation Process
66
66
 
67
67
  ```mermaid
68
68
  graph TD
69
- A[트리거 감지] --> B{유효한 트리거?}
70
- B -->|Yes| C[현재 상태 검증]
71
- B -->|No| Z[무시]
72
- C --> D[파일 수집]
73
- D --> E[메타데이터 생성]
74
- E --> F[아카이브 생성]
75
- F --> G[무결성 검증]
76
- G --> H[Git 태그 생성]
77
- H --> I[오래된 체크포인트 정리]
69
+ A[Trigger detected] --> B{Valid trigger?}
70
+ B -->|Yes| C[Verify current state]
71
+ B -->|No| Z[Ignore]
72
+ C --> D[Collect files]
73
+ D --> E[Generate metadata]
74
+ E --> F[Create archive]
75
+ F --> G[Verify integrity]
76
+ G --> H[Create Git tag]
77
+ H --> I[Cleanup old checkpoints]
78
78
  ```
79
79
 
80
- ## 메타데이터 형식
80
+ ## Metadata Format
81
81
 
82
82
  ```yaml
83
83
  checkpoint:
@@ -94,29 +94,29 @@ checkpoint:
94
94
  modified_files:
95
95
  - "src/auth/UserService.ts"
96
96
  - "src/components/LoginForm.tsx"
97
- key_changes: "사용자 인증 시스템 구현"
97
+ key_changes: "User authentication system implementation"
98
98
  ```
99
99
 
100
- ## 보존 정책
100
+ ## Retention Policy
101
101
 
102
102
  ```yaml
103
103
  retention:
104
104
  max_checkpoints: 20
105
105
  max_age_days: 30
106
106
 
107
- # 절대 삭제 안함
107
+ # Never delete
108
108
  milestones:
109
109
  - stage_complete
110
110
  - pre_destructive
111
111
  - user_created
112
112
  ```
113
113
 
114
- ## 명명 규칙
114
+ ## Naming Conventions
115
115
 
116
- | 트리거 | 형식 | 예시 |
117
- |--------|------|------|
118
- | 태스크 | `auto_task_{count}_{timestamp}` | `auto_task_5_20240120` |
119
- | 파일변경 | `auto_change_{timestamp}` | `auto_change_20240120_143022` |
120
- | 파괴적 | `pre_destructive_{timestamp}` | `pre_destructive_20240120_143022` |
121
- | 스테이지 | `stage_{id}_{status}_{timestamp}` | `stage_06_complete_20240120` |
122
- | 수동 | `manual_{name}_{timestamp}` | `manual_feature_complete_20240120` |
116
+ | Trigger | Format | Example |
117
+ |---------|--------|---------|
118
+ | Task | `auto_task_{count}_{timestamp}` | `auto_task_5_20240120` |
119
+ | File change | `auto_change_{timestamp}` | `auto_change_20240120_143022` |
120
+ | Destructive | `pre_destructive_{timestamp}` | `pre_destructive_20240120_143022` |
121
+ | Stage | `stage_{id}_{status}_{timestamp}` | `stage_06_complete_20240120` |
122
+ | Manual | `manual_{name}_{timestamp}` | `manual_feature_complete_20240120` |