create-ax-project 1.0.0
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.
- package/README.md +374 -0
- package/bin/create.js +193 -0
- package/package.json +38 -0
- package/template/.claude/CLAUDE.md +7 -0
- package/template/.claude/commands/CLAUDE.md +0 -0
- package/template/.claude/commands/benchmark.md +103 -0
- package/template/.claude/commands/brainstorm.md +67 -0
- package/template/.claude/commands/checkpoint.md +93 -0
- package/template/.claude/commands/codex.md +107 -0
- package/template/.claude/commands/collaborate.md +85 -0
- package/template/.claude/commands/context.md +154 -0
- package/template/.claude/commands/deploy.md +102 -0
- package/template/.claude/commands/fork.md +142 -0
- package/template/.claude/commands/gemini.md +84 -0
- package/template/.claude/commands/handoff.md +80 -0
- package/template/.claude/commands/implement.md +82 -0
- package/template/.claude/commands/init-project.md +49 -0
- package/template/.claude/commands/next.md +125 -0
- package/template/.claude/commands/planning.md +69 -0
- package/template/.claude/commands/qa.md +81 -0
- package/template/.claude/commands/refactor.md +95 -0
- package/template/.claude/commands/research.md +60 -0
- package/template/.claude/commands/restore.md +113 -0
- package/template/.claude/commands/run-stage.md +78 -0
- package/template/.claude/commands/stages.md +109 -0
- package/template/.claude/commands/status.md +73 -0
- package/template/.claude/commands/tasks.md +80 -0
- package/template/.claude/commands/test.md +93 -0
- package/template/.claude/commands/ui-ux.md +61 -0
- package/template/.claude/commands/validate.md +174 -0
- package/template/.claude/hooks/CLAUDE.md +0 -0
- package/template/.claude/hooks/ai-selector.sh +223 -0
- package/template/.claude/hooks/auto-checkpoint.sh +187 -0
- package/template/.claude/hooks/output-validator.sh +289 -0
- package/template/.claude/hooks/post-stage.sh +123 -0
- package/template/.claude/hooks/pre-stage.sh +186 -0
- package/template/.claude/hooks/session-start.sh +90 -0
- package/template/.claude/hooks/statusline.sh +115 -0
- package/template/.claude/hooks/stop.sh +104 -0
- package/template/.claude/settings.json +149 -0
- package/template/.claude/skills/ai-collaboration/CLAUDE.md +0 -0
- package/template/.claude/skills/ai-collaboration/README.md +61 -0
- package/template/.claude/skills/ai-collaboration/debate.md +148 -0
- package/template/.claude/skills/ai-collaboration/parallel.md +96 -0
- package/template/.claude/skills/ai-collaboration/prompts/CLAUDE.md +107 -0
- package/template/.claude/skills/auto-checkpoint/CLAUDE.md +0 -0
- package/template/.claude/skills/auto-checkpoint/README.md +77 -0
- package/template/.claude/skills/auto-checkpoint/prompts/CLAUDE.md +113 -0
- package/template/.claude/skills/auto-checkpoint/rollback.md +152 -0
- package/template/.claude/skills/auto-checkpoint/trigger.md +122 -0
- package/template/.claude/skills/context-compression/CLAUDE.md +0 -0
- package/template/.claude/skills/context-compression/README.md +121 -0
- package/template/.claude/skills/context-compression/analyze.md +114 -0
- package/template/.claude/skills/context-compression/compress.md +175 -0
- package/template/.claude/skills/context-compression/prompts/CLAUDE.md +0 -0
- package/template/.claude/skills/context-compression/prompts/compression.md +172 -0
- package/template/.claude/skills/output-validator/CLAUDE.md +0 -0
- package/template/.claude/skills/output-validator/README.md +86 -0
- package/template/.claude/skills/output-validator/prompts/CLAUDE.md +119 -0
- package/template/.claude/skills/output-validator/validate.md +182 -0
- package/template/.claude/skills/smart-handoff/CLAUDE.md +0 -0
- package/template/.claude/skills/smart-handoff/README.md +59 -0
- package/template/.claude/skills/smart-handoff/extract.md +76 -0
- package/template/.claude/skills/smart-handoff/prompts/CLAUDE.md +86 -0
- package/template/.claude/skills/smart-handoff/summarize.md +94 -0
- package/template/.claude/skills/stage-transition/CLAUDE.md +0 -0
- package/template/.claude/skills/stage-transition/README.md +84 -0
- package/template/.claude/skills/stage-transition/handoff-gen.md +160 -0
- package/template/.claude/skills/stage-transition/prompts/CLAUDE.md +0 -0
- package/template/.claude/skills/stage-transition/prompts/transition.md +145 -0
- package/template/.claude/skills/stage-transition/validate.md +108 -0
- package/template/CLAUDE.md +528 -0
- package/template/config/CLAUDE.md +0 -0
- package/template/config/ai_benchmarking.yaml +184 -0
- package/template/config/ai_collaboration.yaml +159 -0
- package/template/config/ai_logging.yaml +129 -0
- package/template/config/auto_checkpoint.yaml +189 -0
- package/template/config/context.yaml +78 -0
- package/template/config/git.yaml +161 -0
- package/template/config/handoff_intelligence.yaml +229 -0
- package/template/config/implementation.yaml.template +181 -0
- package/template/config/mcp_fallbacks.yaml +252 -0
- package/template/config/memory_integration.yaml +200 -0
- package/template/config/model_enforcement.yaml +141 -0
- package/template/config/models.yaml +242 -0
- package/template/config/output_validation.yaml +352 -0
- package/template/config/pipeline.yaml +357 -0
- package/template/config/pipeline_forking.yaml +236 -0
- package/template/config/qa_logging.yaml +166 -0
- package/template/config/smart_rollback.yaml +209 -0
- package/template/config/stage_personas.yaml +354 -0
- package/template/config/workflow.yaml +54 -0
- package/template/scripts/CLAUDE.md +0 -0
- package/template/scripts/ai-benchmark.sh +272 -0
- package/template/scripts/codex-wrapper.sh +97 -0
- package/template/scripts/context-manager.sh +528 -0
- package/template/scripts/create-checkpoint.sh +116 -0
- package/template/scripts/gemini-wrapper.sh +96 -0
- package/template/scripts/init-project.sh +109 -0
- package/template/scripts/list-stages.sh +245 -0
- package/template/scripts/next-stage.sh +228 -0
- package/template/scripts/output-validate.sh +12 -0
- package/template/scripts/pipeline-fork.sh +293 -0
- package/template/scripts/pre-run-check.sh +361 -0
- package/template/scripts/restore-checkpoint.sh +247 -0
- package/template/scripts/run-stage.sh +139 -0
- package/template/scripts/show-status.sh +185 -0
- package/template/scripts/smart-handoff.sh +254 -0
- package/template/stages/01-brainstorm/CLAUDE.md +103 -0
- package/template/stages/01-brainstorm/HANDOFF.md +110 -0
- package/template/stages/01-brainstorm/HANDOFF.md.template +112 -0
- package/template/stages/01-brainstorm/README.md +97 -0
- package/template/stages/01-brainstorm/config.yaml +92 -0
- package/template/stages/01-brainstorm/inputs/.gitkeep +0 -0
- package/template/stages/01-brainstorm/inputs/CLAUDE.md +0 -0
- package/template/stages/01-brainstorm/inputs/project_brief.md +40 -0
- package/template/stages/01-brainstorm/outputs/.gitkeep +0 -0
- package/template/stages/01-brainstorm/outputs/CLAUDE.md +0 -0
- package/template/stages/01-brainstorm/outputs/ideas.md +159 -0
- package/template/stages/01-brainstorm/outputs/requirements_analysis.md +222 -0
- package/template/stages/01-brainstorm/prompts/CLAUDE.md +0 -0
- package/template/stages/01-brainstorm/prompts/collaboration.md +46 -0
- package/template/stages/01-brainstorm/prompts/ideation.md +62 -0
- package/template/stages/01-brainstorm/prompts/persona.md +73 -0
- package/template/stages/01-brainstorm/prompts/requirements.md +73 -0
- package/template/stages/01-brainstorm/prompts/validation.md +50 -0
- package/template/stages/01-brainstorm/templates/CLAUDE.md +0 -0
- package/template/stages/01-brainstorm/templates/ideas.md +91 -0
- package/template/stages/01-brainstorm/templates/requirements_analysis.md +129 -0
- package/template/stages/02-research/CLAUDE.md +101 -0
- package/template/stages/02-research/HANDOFF.md +158 -0
- package/template/stages/02-research/HANDOFF.md.template +102 -0
- package/template/stages/02-research/config.yaml +68 -0
- package/template/stages/02-research/inputs/.gitkeep +0 -0
- package/template/stages/02-research/outputs/.gitkeep +0 -0
- package/template/stages/02-research/outputs/CLAUDE.md +0 -0
- package/template/stages/02-research/outputs/feasibility_report.md +176 -0
- package/template/stages/02-research/outputs/tech_research.md +403 -0
- package/template/stages/02-research/prompts/CLAUDE.md +0 -0
- package/template/stages/02-research/prompts/collaboration.md +51 -0
- package/template/stages/02-research/prompts/feasibility.md +73 -0
- package/template/stages/02-research/prompts/market_analysis.md +58 -0
- package/template/stages/02-research/prompts/tech_stack.md +60 -0
- package/template/stages/02-research/prompts/validation.md +51 -0
- package/template/stages/02-research/templates/.gitkeep +0 -0
- package/template/stages/03-planning/CLAUDE.md +98 -0
- package/template/stages/03-planning/HANDOFF.md +168 -0
- package/template/stages/03-planning/HANDOFF.md.template +91 -0
- package/template/stages/03-planning/config.yaml +64 -0
- package/template/stages/03-planning/inputs/.gitkeep +0 -0
- package/template/stages/03-planning/outputs/.gitkeep +0 -0
- package/template/stages/03-planning/outputs/CLAUDE.md +0 -0
- package/template/stages/03-planning/outputs/architecture.md +400 -0
- package/template/stages/03-planning/outputs/implementation.yaml +209 -0
- package/template/stages/03-planning/outputs/project_plan.md +204 -0
- package/template/stages/03-planning/outputs/tech_stack.md +176 -0
- package/template/stages/03-planning/prompts/CLAUDE.md +0 -0
- package/template/stages/03-planning/prompts/architecture.md +62 -0
- package/template/stages/03-planning/prompts/collaboration.md +57 -0
- package/template/stages/03-planning/prompts/validation.md +59 -0
- package/template/stages/03-planning/templates/.gitkeep +0 -0
- package/template/stages/04-ui-ux/CLAUDE.md +88 -0
- package/template/stages/04-ui-ux/HANDOFF.md +165 -0
- package/template/stages/04-ui-ux/HANDOFF.md.template +92 -0
- package/template/stages/04-ui-ux/config.yaml +57 -0
- package/template/stages/04-ui-ux/inputs/.gitkeep +0 -0
- package/template/stages/04-ui-ux/outputs/.gitkeep +0 -0
- package/template/stages/04-ui-ux/outputs/CLAUDE.md +0 -0
- package/template/stages/04-ui-ux/outputs/design_system.md +449 -0
- package/template/stages/04-ui-ux/outputs/user_flows.md +321 -0
- package/template/stages/04-ui-ux/outputs/wireframes.md +241 -0
- package/template/stages/04-ui-ux/prompts/.gitkeep +0 -0
- package/template/stages/04-ui-ux/prompts/CLAUDE.md +0 -0
- package/template/stages/04-ui-ux/prompts/collaboration.md +56 -0
- package/template/stages/04-ui-ux/prompts/validation.md +54 -0
- package/template/stages/04-ui-ux/templates/.gitkeep +0 -0
- package/template/stages/05-task-management/CLAUDE.md +105 -0
- package/template/stages/05-task-management/HANDOFF.md +187 -0
- package/template/stages/05-task-management/HANDOFF.md.template +97 -0
- package/template/stages/05-task-management/config.yaml +81 -0
- package/template/stages/05-task-management/inputs/.gitkeep +0 -0
- package/template/stages/05-task-management/outputs/.gitkeep +0 -0
- package/template/stages/05-task-management/outputs/CLAUDE.md +0 -0
- package/template/stages/05-task-management/outputs/milestones.md +253 -0
- package/template/stages/05-task-management/outputs/sprint_plan.md +203 -0
- package/template/stages/05-task-management/outputs/tasks.md +402 -0
- package/template/stages/05-task-management/prompts/.gitkeep +0 -0
- package/template/stages/05-task-management/prompts/CLAUDE.md +0 -0
- package/template/stages/05-task-management/prompts/collaboration.md +54 -0
- package/template/stages/05-task-management/prompts/validation.md +66 -0
- package/template/stages/05-task-management/templates/CLAUDE.md +0 -0
- package/template/stages/05-task-management/templates/notion_integration.md +176 -0
- package/template/stages/05-task-management/templates/parallel_groups.yaml +153 -0
- package/template/stages/05-task-management/templates/task_schema.yaml +154 -0
- package/template/stages/06-implementation/CLAUDE.md +163 -0
- package/template/stages/06-implementation/HANDOFF.md +184 -0
- package/template/stages/06-implementation/HANDOFF.md.template +192 -0
- package/template/stages/06-implementation/config.yaml +62 -0
- package/template/stages/06-implementation/inputs/.gitkeep +0 -0
- package/template/stages/06-implementation/outputs/.gitkeep +0 -0
- package/template/stages/06-implementation/prompts/.gitkeep +0 -0
- package/template/stages/06-implementation/prompts/CLAUDE.md +0 -0
- package/template/stages/06-implementation/prompts/collaboration.md +64 -0
- package/template/stages/06-implementation/prompts/validation.md +65 -0
- package/template/stages/06-implementation/templates/.gitkeep +0 -0
- package/template/stages/07-refactoring/CLAUDE.md +180 -0
- package/template/stages/07-refactoring/HANDOFF.md +82 -0
- package/template/stages/07-refactoring/HANDOFF.md.template +97 -0
- package/template/stages/07-refactoring/config.yaml +68 -0
- package/template/stages/07-refactoring/inputs/.gitkeep +0 -0
- package/template/stages/07-refactoring/outputs/.gitkeep +0 -0
- package/template/stages/07-refactoring/outputs/refactoring_report.md +102 -0
- package/template/stages/07-refactoring/prompts/.gitkeep +0 -0
- package/template/stages/07-refactoring/prompts/CLAUDE.md +0 -0
- package/template/stages/07-refactoring/prompts/collaboration.md +71 -0
- package/template/stages/07-refactoring/prompts/validation.md +76 -0
- package/template/stages/07-refactoring/templates/.gitkeep +0 -0
- package/template/stages/08-qa/CLAUDE.md +93 -0
- package/template/stages/08-qa/HANDOFF.md +114 -0
- package/template/stages/08-qa/HANDOFF.md.template +96 -0
- package/template/stages/08-qa/config.yaml +56 -0
- package/template/stages/08-qa/inputs/.gitkeep +0 -0
- package/template/stages/08-qa/outputs/.gitkeep +0 -0
- package/template/stages/08-qa/outputs/qa_report.md +138 -0
- package/template/stages/08-qa/prompts/.gitkeep +0 -0
- package/template/stages/08-qa/prompts/CLAUDE.md +0 -0
- package/template/stages/08-qa/prompts/collaboration.md +65 -0
- package/template/stages/08-qa/prompts/validation.md +71 -0
- package/template/stages/08-qa/templates/.gitkeep +0 -0
- package/template/stages/09-testing/CLAUDE.md +124 -0
- package/template/stages/09-testing/HANDOFF.md +118 -0
- package/template/stages/09-testing/HANDOFF.md.template +113 -0
- package/template/stages/09-testing/config.yaml +65 -0
- package/template/stages/09-testing/inputs/.gitkeep +0 -0
- package/template/stages/09-testing/outputs/.gitkeep +0 -0
- package/template/stages/09-testing/outputs/test_report.md +146 -0
- package/template/stages/09-testing/prompts/.gitkeep +0 -0
- package/template/stages/09-testing/prompts/CLAUDE.md +0 -0
- package/template/stages/09-testing/prompts/collaboration.md +77 -0
- package/template/stages/09-testing/prompts/validation.md +83 -0
- package/template/stages/09-testing/templates/.gitkeep +0 -0
- package/template/stages/10-deployment/CLAUDE.md +117 -0
- package/template/stages/10-deployment/HANDOFF.md +141 -0
- package/template/stages/10-deployment/HANDOFF.md.template +148 -0
- package/template/stages/10-deployment/config.yaml +61 -0
- package/template/stages/10-deployment/inputs/.gitkeep +0 -0
- package/template/stages/10-deployment/outputs/.gitkeep +0 -0
- package/template/stages/10-deployment/prompts/.gitkeep +0 -0
- package/template/stages/10-deployment/prompts/CLAUDE.md +0 -0
- package/template/stages/10-deployment/prompts/collaboration.md +80 -0
- package/template/stages/10-deployment/prompts/validation.md +93 -0
- package/template/stages/10-deployment/templates/CLAUDE.md +0 -0
- package/template/stages/10-deployment/templates/github-actions-cd.yaml +118 -0
- package/template/stages/10-deployment/templates/github-actions-ci.yaml +136 -0
- package/template/state/progress.json.template +111 -0
- package/template/state/templates/CLAUDE.md +0 -0
- package/template/state/templates/handoff_base.md.template +187 -0
- package/template/state/templates/phase_state.md.template +97 -0
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
# AI Collaboration Skill - AI Instructions
|
|
2
|
+
|
|
3
|
+
## 역할
|
|
4
|
+
|
|
5
|
+
당신은 Multi-AI 협업 조정자입니다. 여러 AI 모델의 결과물을 조율하고 최적의 결과를 도출합니다.
|
|
6
|
+
|
|
7
|
+
## 협업 모드별 지침
|
|
8
|
+
|
|
9
|
+
### Parallel Execution Mode
|
|
10
|
+
|
|
11
|
+
**목표**: 다양한 관점의 결과물 중 최적 선택
|
|
12
|
+
|
|
13
|
+
**프로세스**:
|
|
14
|
+
1. 작업을 명확히 정의
|
|
15
|
+
2. 각 AI 모델에 적합한 프롬프트 준비
|
|
16
|
+
3. 결과물 수집 및 평가
|
|
17
|
+
4. 객관적 기준으로 선택/병합
|
|
18
|
+
|
|
19
|
+
**평가 기준**:
|
|
20
|
+
- 완성도 (Completeness): 요구사항 충족도
|
|
21
|
+
- 창의성 (Creativity): 독창적 접근
|
|
22
|
+
- 실현 가능성 (Feasibility): 구현 가능성
|
|
23
|
+
|
|
24
|
+
### Sequential Handoff Mode
|
|
25
|
+
|
|
26
|
+
**목표**: 각 AI의 강점을 순차적으로 활용
|
|
27
|
+
|
|
28
|
+
**프로세스**:
|
|
29
|
+
1. 체인 순서에 따라 작업 전달
|
|
30
|
+
2. 각 단계에서 핵심 컨텍스트 유지
|
|
31
|
+
3. 이전 결과물을 기반으로 개선
|
|
32
|
+
4. 최종 통합 결과물 생성
|
|
33
|
+
|
|
34
|
+
**핸드오프 포함 사항**:
|
|
35
|
+
- 현재까지의 핵심 성과
|
|
36
|
+
- 유지해야 할 결정사항
|
|
37
|
+
- 다음 단계 명확한 지시
|
|
38
|
+
|
|
39
|
+
### Debate Mode
|
|
40
|
+
|
|
41
|
+
**목표**: 다양한 관점에서 최적 결론 도출
|
|
42
|
+
|
|
43
|
+
**토론 진행 시**:
|
|
44
|
+
1. 각 입장을 공정하게 대변
|
|
45
|
+
2. 증거 기반 논증 요구
|
|
46
|
+
3. 반박은 건설적으로
|
|
47
|
+
4. 공통점과 차이점 명확히
|
|
48
|
+
|
|
49
|
+
**결론 도출 시**:
|
|
50
|
+
- 합의점 우선 정리
|
|
51
|
+
- 미합의 사항 명시
|
|
52
|
+
- 실행 가능한 권장사항 제시
|
|
53
|
+
|
|
54
|
+
## 공통 원칙
|
|
55
|
+
|
|
56
|
+
### 공정성
|
|
57
|
+
- 특정 모델 편향 없이 평가
|
|
58
|
+
- 객관적 기준 적용
|
|
59
|
+
- 결과의 근거 명시
|
|
60
|
+
|
|
61
|
+
### 효율성
|
|
62
|
+
- 토큰 예산 준수
|
|
63
|
+
- 중복 작업 최소화
|
|
64
|
+
- 명확한 작업 분배
|
|
65
|
+
|
|
66
|
+
### 통합성
|
|
67
|
+
- 결과물 간 일관성 유지
|
|
68
|
+
- 충돌 사항 해결
|
|
69
|
+
- 최종 결과물 완성도 확보
|
|
70
|
+
|
|
71
|
+
## 출력 형식
|
|
72
|
+
|
|
73
|
+
### 협업 결과 리포트
|
|
74
|
+
```markdown
|
|
75
|
+
# Collaboration Report
|
|
76
|
+
|
|
77
|
+
## Mode: [parallel/sequential/debate]
|
|
78
|
+
## Task: [작업 설명]
|
|
79
|
+
|
|
80
|
+
## Participants
|
|
81
|
+
- [AI 1]: [역할/관점]
|
|
82
|
+
- [AI 2]: [역할/관점]
|
|
83
|
+
|
|
84
|
+
## Results Summary
|
|
85
|
+
[각 AI의 핵심 기여]
|
|
86
|
+
|
|
87
|
+
## Evaluation
|
|
88
|
+
| Metric | AI 1 | AI 2 |
|
|
89
|
+
|--------|------|------|
|
|
90
|
+
|
|
91
|
+
## Final Decision
|
|
92
|
+
[선택/병합 결과]
|
|
93
|
+
|
|
94
|
+
## Rationale
|
|
95
|
+
[결정 근거]
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## 금지 사항
|
|
99
|
+
|
|
100
|
+
- 근거 없는 모델 우대
|
|
101
|
+
- 불완전한 결과물 선택
|
|
102
|
+
- 핵심 정보 누락
|
|
103
|
+
- 비교 없이 임의 선택
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
|
|
File without changes
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# Auto-Checkpoint Skill
|
|
2
|
+
|
|
3
|
+
자동 체크포인트 생성 및 스마트 롤백 스킬
|
|
4
|
+
|
|
5
|
+
## 개요
|
|
6
|
+
|
|
7
|
+
작업 안전망을 위한 자동 체크포인트 시스템:
|
|
8
|
+
- 조건 기반 자동 체크포인트 생성
|
|
9
|
+
- 스마트 롤백 제안 및 실행
|
|
10
|
+
- 파이프라인 분기 지원
|
|
11
|
+
|
|
12
|
+
## 트리거
|
|
13
|
+
|
|
14
|
+
### 자동 트리거
|
|
15
|
+
- 5개 태스크 완료마다
|
|
16
|
+
- 100줄 이상 파일 변경 시
|
|
17
|
+
- 파괴적 작업 감지 시
|
|
18
|
+
- 30분 간격 (변경 있을 때)
|
|
19
|
+
- 스테이지 완료 시
|
|
20
|
+
|
|
21
|
+
### 수동 트리거
|
|
22
|
+
- `/checkpoint` 명령어
|
|
23
|
+
|
|
24
|
+
## 기능
|
|
25
|
+
|
|
26
|
+
### 1. 자동 체크포인트 (trigger.md)
|
|
27
|
+
- 조건 감지 및 체크포인트 생성
|
|
28
|
+
- 메타데이터 기록
|
|
29
|
+
- Git 태그 연동
|
|
30
|
+
|
|
31
|
+
### 2. 스마트 롤백 (rollback.md)
|
|
32
|
+
- 에러 분석 및 관련 체크포인트 찾기
|
|
33
|
+
- 부분 롤백 지원 (파일/함수/스테이지)
|
|
34
|
+
- 롤백 미리보기
|
|
35
|
+
|
|
36
|
+
### 3. 파이프라인 분기
|
|
37
|
+
- 여러 접근법 동시 탐색
|
|
38
|
+
- 분기 비교 및 병합
|
|
39
|
+
|
|
40
|
+
## 파일 구조
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
auto-checkpoint/
|
|
44
|
+
├── README.md # 이 파일
|
|
45
|
+
├── trigger.md # 체크포인트 트리거 가이드
|
|
46
|
+
├── rollback.md # 롤백 가이드
|
|
47
|
+
└── prompts/
|
|
48
|
+
└── CLAUDE.md # AI 지침
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## 설정
|
|
52
|
+
|
|
53
|
+
- `config/auto_checkpoint.yaml` - 자동 체크포인트
|
|
54
|
+
- `config/smart_rollback.yaml` - 스마트 롤백
|
|
55
|
+
- `config/pipeline_forking.yaml` - 파이프라인 분기
|
|
56
|
+
|
|
57
|
+
## 사용 예시
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
# 수동 체크포인트 생성
|
|
61
|
+
/checkpoint --name "feature-complete"
|
|
62
|
+
|
|
63
|
+
# 롤백 제안 보기
|
|
64
|
+
/restore --suggest
|
|
65
|
+
|
|
66
|
+
# 특정 체크포인트로 롤백
|
|
67
|
+
/restore --checkpoint "stage_06_complete_20240120"
|
|
68
|
+
|
|
69
|
+
# 파이프라인 분기
|
|
70
|
+
/fork --reason "아키텍처 대안 탐색"
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## 저장 위치
|
|
74
|
+
|
|
75
|
+
- 체크포인트: `state/checkpoints/`
|
|
76
|
+
- 분기: `state/forks/`
|
|
77
|
+
- 롤백 히스토리: `state/rollback_history/`
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
# Auto-Checkpoint Skill - AI Instructions
|
|
2
|
+
|
|
3
|
+
## 역할
|
|
4
|
+
|
|
5
|
+
당신은 체크포인트 및 롤백 관리 전문가입니다. 작업의 안전한 진행을 위해 체크포인트를 관리하고 문제 발생 시 스마트 롤백을 지원합니다.
|
|
6
|
+
|
|
7
|
+
## 핵심 책임
|
|
8
|
+
|
|
9
|
+
### 1. 체크포인트 트리거 감지
|
|
10
|
+
|
|
11
|
+
다음 상황을 감지하여 체크포인트 생성을 제안하거나 실행합니다:
|
|
12
|
+
|
|
13
|
+
- **태스크 완료**: 5개 태스크 완료 시
|
|
14
|
+
- **파일 변경**: 100줄 이상 변경 시
|
|
15
|
+
- **파괴적 작업**: rm, reset, drop 등 감지 시
|
|
16
|
+
- **스테이지 완료**: 스테이지 종료 시
|
|
17
|
+
|
|
18
|
+
### 2. 체크포인트 생성
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
체크포인트 생성 시 포함 사항:
|
|
22
|
+
1. 현재 소스 코드
|
|
23
|
+
2. 설정 파일
|
|
24
|
+
3. 상태 파일 (progress.json 등)
|
|
25
|
+
4. HANDOFF (있는 경우)
|
|
26
|
+
5. 메타데이터 (트리거, 시간, 요약)
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
### 3. 롤백 제안
|
|
30
|
+
|
|
31
|
+
에러 발생 시:
|
|
32
|
+
1. 에러 유형 분석
|
|
33
|
+
2. 관련 체크포인트 식별
|
|
34
|
+
3. 적절한 롤백 범위 제안
|
|
35
|
+
4. 영향 분석 제공
|
|
36
|
+
|
|
37
|
+
## 체크포인트 생성 프로토콜
|
|
38
|
+
|
|
39
|
+
### 자동 체크포인트
|
|
40
|
+
```
|
|
41
|
+
1. 트리거 조건 확인
|
|
42
|
+
2. 현재 상태 검증
|
|
43
|
+
3. 체크포인트 생성
|
|
44
|
+
4. 간단한 알림 표시
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### 파괴적 작업 전 체크포인트
|
|
48
|
+
```
|
|
49
|
+
1. 파괴적 패턴 감지
|
|
50
|
+
2. **즉시 체크포인트 생성**
|
|
51
|
+
3. 사용자에게 경고 표시
|
|
52
|
+
4. 확인 후에만 작업 진행
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## 롤백 프로토콜
|
|
56
|
+
|
|
57
|
+
### 롤백 제안 시
|
|
58
|
+
```markdown
|
|
59
|
+
## 롤백 제안
|
|
60
|
+
|
|
61
|
+
**에러 유형**: [분석된 에러]
|
|
62
|
+
**권장 체크포인트**: [체크포인트 이름]
|
|
63
|
+
**권장 범위**: [파일/함수/스테이지]
|
|
64
|
+
|
|
65
|
+
### 영향 분석
|
|
66
|
+
- 복원될 파일: [목록]
|
|
67
|
+
- 잃게 될 변경: [요약]
|
|
68
|
+
|
|
69
|
+
롤백을 진행하시겠습니까?
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### 롤백 실행 시
|
|
73
|
+
```
|
|
74
|
+
1. 현재 상태 백업 (안전망)
|
|
75
|
+
2. 체크포인트 유효성 검증
|
|
76
|
+
3. 선택된 범위만 복원
|
|
77
|
+
4. 무결성 확인
|
|
78
|
+
5. 복구 가이드 제공
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## 알림 형식
|
|
82
|
+
|
|
83
|
+
### 체크포인트 생성 완료
|
|
84
|
+
```
|
|
85
|
+
✅ 체크포인트 생성: {name}
|
|
86
|
+
- 트리거: {reason}
|
|
87
|
+
- 파일: {count}개
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
### 롤백 완료
|
|
91
|
+
```
|
|
92
|
+
🔄 롤백 완료: {checkpoint} → 현재
|
|
93
|
+
- 복원 파일: {count}개
|
|
94
|
+
- 다음 단계: {recommendations}
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
## 금지 사항
|
|
98
|
+
|
|
99
|
+
- 사용자 확인 없이 롤백 실행
|
|
100
|
+
- 파괴적 작업 전 체크포인트 생략
|
|
101
|
+
- 불완전한 체크포인트 생성
|
|
102
|
+
- 롤백 후 복구 가이드 누락
|
|
103
|
+
|
|
104
|
+
## 우선순위
|
|
105
|
+
|
|
106
|
+
1. 데이터 보호 (체크포인트 생성)
|
|
107
|
+
2. 사용자 경고 (파괴적 작업)
|
|
108
|
+
3. 스마트 제안 (롤백 범위)
|
|
109
|
+
4. 간결한 알림 (상태 표시)
|
|
110
|
+
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
# Auto-Checkpoint - Rollback Guide
|
|
2
|
+
|
|
3
|
+
## 스마트 롤백 시스템
|
|
4
|
+
|
|
5
|
+
### 에러 발생 시 자동 분석
|
|
6
|
+
|
|
7
|
+
```mermaid
|
|
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[수동 처리]
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
### 에러 유형별 롤백 전략
|
|
19
|
+
|
|
20
|
+
| 에러 유형 | 권장 범위 | 자동 제안 |
|
|
21
|
+
|----------|----------|----------|
|
|
22
|
+
| 빌드 실패 | 파일 레벨 | ✅ |
|
|
23
|
+
| 테스트 실패 | 함수 레벨 | ✅ |
|
|
24
|
+
| 런타임 에러 | 파일 레벨 | ✅ |
|
|
25
|
+
| 설정 에러 | 설정 파일만 | ✅ |
|
|
26
|
+
| 심각한 오류 | 스테이지 레벨 | 확인 필요 |
|
|
27
|
+
|
|
28
|
+
## 롤백 범위
|
|
29
|
+
|
|
30
|
+
### 1. 파일 레벨 롤백
|
|
31
|
+
```bash
|
|
32
|
+
# 특정 파일만 체크포인트에서 복원
|
|
33
|
+
/restore --checkpoint "auto_task_5" --files "src/auth/UserService.ts"
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
**적합한 상황**:
|
|
37
|
+
- 단일 파일 변경으로 인한 오류
|
|
38
|
+
- 특정 모듈 롤백
|
|
39
|
+
|
|
40
|
+
### 2. 함수 레벨 롤백
|
|
41
|
+
```bash
|
|
42
|
+
# 특정 함수만 복원 (지원 언어: TS, JS, Python)
|
|
43
|
+
/restore --checkpoint "auto_task_5" --function "UserService.login"
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
**적합한 상황**:
|
|
47
|
+
- 리팩토링 중 특정 함수 문제
|
|
48
|
+
- 부분적 로직 오류
|
|
49
|
+
|
|
50
|
+
### 3. 스테이지 레벨 롤백
|
|
51
|
+
```bash
|
|
52
|
+
# 전체 스테이지 상태 복원
|
|
53
|
+
/restore --checkpoint "stage_06_start"
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
**적합한 상황**:
|
|
57
|
+
- 광범위한 문제
|
|
58
|
+
- 아키텍처 수준 변경 취소
|
|
59
|
+
|
|
60
|
+
### 4. 설정 파일만 롤백
|
|
61
|
+
```bash
|
|
62
|
+
/restore --checkpoint "auto_change" --config-only
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
**적합한 상황**:
|
|
66
|
+
- 설정 변경으로 인한 오류
|
|
67
|
+
- 환경 설정 문제
|
|
68
|
+
|
|
69
|
+
## 롤백 미리보기
|
|
70
|
+
|
|
71
|
+
```markdown
|
|
72
|
+
## 롤백 미리보기
|
|
73
|
+
|
|
74
|
+
**대상 체크포인트**: auto_task_5_20240120
|
|
75
|
+
**롤백 범위**: 파일 레벨
|
|
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줄 |
|
|
83
|
+
|
|
84
|
+
### 잃게 될 변경사항
|
|
85
|
+
- 비밀번호 해시 기능 추가 (UserService.ts:45-80)
|
|
86
|
+
- 새 타입 정의 (auth.ts:40-50)
|
|
87
|
+
- 관련 테스트 (auth.test.ts:70-100)
|
|
88
|
+
|
|
89
|
+
### 영향받는 의존성
|
|
90
|
+
- LoginForm 컴포넌트 (import 확인 필요)
|
|
91
|
+
|
|
92
|
+
**이 롤백을 실행하시겠습니까? (y/n)**
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## 롤백 실행 프로세스
|
|
96
|
+
|
|
97
|
+
### 사전 작업
|
|
98
|
+
1. 현재 상태 백업 체크포인트 생성
|
|
99
|
+
2. 커밋되지 않은 변경사항 stash
|
|
100
|
+
|
|
101
|
+
### 롤백 단계
|
|
102
|
+
1. 체크포인트 유효성 검증
|
|
103
|
+
2. 파일 추출
|
|
104
|
+
3. 선택적 파일 복원
|
|
105
|
+
4. 무결성 확인
|
|
106
|
+
5. 상태 파일 업데이트
|
|
107
|
+
|
|
108
|
+
### 사후 작업
|
|
109
|
+
1. 검증 테스트 실행
|
|
110
|
+
2. HANDOFF 업데이트
|
|
111
|
+
3. 롤백 기록 저장
|
|
112
|
+
|
|
113
|
+
## 복구 가이드 자동 생성
|
|
114
|
+
|
|
115
|
+
```markdown
|
|
116
|
+
## 파일 롤백 완료
|
|
117
|
+
|
|
118
|
+
**체크포인트**: auto_task_5_20240120
|
|
119
|
+
**복원된 파일**: 3개
|
|
120
|
+
**시간**: 2024-01-20 14:45:00
|
|
121
|
+
|
|
122
|
+
### 복구된 파일
|
|
123
|
+
- src/auth/UserService.ts
|
|
124
|
+
- src/types/auth.ts
|
|
125
|
+
- tests/auth.test.ts
|
|
126
|
+
|
|
127
|
+
### 권장 다음 단계
|
|
128
|
+
1. 변경사항 확인: `git diff`
|
|
129
|
+
2. 테스트 실행: `npm test`
|
|
130
|
+
3. 문제가 해결되었다면:
|
|
131
|
+
- 원인 분석 후 다시 구현
|
|
132
|
+
- 더 작은 단위로 작업
|
|
133
|
+
4. 문제가 지속된다면:
|
|
134
|
+
- 추가 롤백 필요 가능성
|
|
135
|
+
- `/restore --suggest` 실행
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
## 안전 장치
|
|
139
|
+
|
|
140
|
+
### 롤백 차단 조건
|
|
141
|
+
- 커밋되지 않은 변경사항 존재
|
|
142
|
+
- 활성 프로세스 실행 중
|
|
143
|
+
- 파일 잠금 상태
|
|
144
|
+
|
|
145
|
+
### 확인 필요 조건
|
|
146
|
+
- 스테이지 레벨 롤백
|
|
147
|
+
- 10개 이상 파일 영향
|
|
148
|
+
- 프로덕션 관련 파일 포함
|
|
149
|
+
|
|
150
|
+
### 쿨다운
|
|
151
|
+
- 연속 롤백 간 5분 대기
|
|
152
|
+
- 같은 체크포인트 재롤백 경고
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# Auto-Checkpoint - Trigger Guide
|
|
2
|
+
|
|
3
|
+
## 체크포인트 트리거 조건
|
|
4
|
+
|
|
5
|
+
### 1. 태스크 완료 기반
|
|
6
|
+
```yaml
|
|
7
|
+
trigger:
|
|
8
|
+
condition: "tasks_completed"
|
|
9
|
+
threshold: 5
|
|
10
|
+
action: "create_checkpoint"
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
**감지 방법**:
|
|
14
|
+
- TodoWrite에서 `completed` 상태 카운트
|
|
15
|
+
- 커밋 기록 분석
|
|
16
|
+
|
|
17
|
+
### 2. 파일 변경 기반
|
|
18
|
+
```yaml
|
|
19
|
+
trigger:
|
|
20
|
+
condition: "major_file_change"
|
|
21
|
+
threshold: 100 # lines
|
|
22
|
+
weights:
|
|
23
|
+
"*.ts": 1.0
|
|
24
|
+
"*.yaml": 0.5
|
|
25
|
+
"*.md": 0.3
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
**감지 방법**:
|
|
29
|
+
```bash
|
|
30
|
+
# 변경량 계산
|
|
31
|
+
git diff --stat | awk '{sum+=$4} END {print sum}'
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### 3. 파괴적 작업 전
|
|
35
|
+
```yaml
|
|
36
|
+
trigger:
|
|
37
|
+
condition: "destructive_action"
|
|
38
|
+
patterns:
|
|
39
|
+
- "rm -rf"
|
|
40
|
+
- "git reset --hard"
|
|
41
|
+
- "drop table"
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
**감지 시 동작**:
|
|
45
|
+
1. 즉시 체크포인트 생성
|
|
46
|
+
2. 사용자 확인 요청
|
|
47
|
+
3. 확인 후 작업 진행
|
|
48
|
+
|
|
49
|
+
### 4. 시간 기반
|
|
50
|
+
```yaml
|
|
51
|
+
trigger:
|
|
52
|
+
condition: "interval"
|
|
53
|
+
interval_minutes: 30
|
|
54
|
+
only_if_changes: true
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### 5. 스테이지 기반
|
|
58
|
+
```yaml
|
|
59
|
+
trigger:
|
|
60
|
+
conditions:
|
|
61
|
+
on_stage_complete: true
|
|
62
|
+
on_stage_error: true
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## 체크포인트 생성 프로세스
|
|
66
|
+
|
|
67
|
+
```mermaid
|
|
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[오래된 체크포인트 정리]
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## 메타데이터 형식
|
|
81
|
+
|
|
82
|
+
```yaml
|
|
83
|
+
checkpoint:
|
|
84
|
+
name: "auto_task_5_20240120_143022"
|
|
85
|
+
timestamp: "2024-01-20T14:30:22Z"
|
|
86
|
+
trigger: "tasks_completed"
|
|
87
|
+
stage: "06-implementation"
|
|
88
|
+
task_count: 25
|
|
89
|
+
files_changed: 12
|
|
90
|
+
git_commit: "abc1234"
|
|
91
|
+
|
|
92
|
+
summary:
|
|
93
|
+
completed_tasks: 5
|
|
94
|
+
modified_files:
|
|
95
|
+
- "src/auth/UserService.ts"
|
|
96
|
+
- "src/components/LoginForm.tsx"
|
|
97
|
+
key_changes: "사용자 인증 시스템 구현"
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
## 보존 정책
|
|
101
|
+
|
|
102
|
+
```yaml
|
|
103
|
+
retention:
|
|
104
|
+
max_checkpoints: 20
|
|
105
|
+
max_age_days: 30
|
|
106
|
+
|
|
107
|
+
# 절대 삭제 안함
|
|
108
|
+
milestones:
|
|
109
|
+
- stage_complete
|
|
110
|
+
- pre_destructive
|
|
111
|
+
- user_created
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## 명명 규칙
|
|
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` |
|
|
File without changes
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
# Context Compression Skill
|
|
2
|
+
|
|
3
|
+
토큰 사용량을 모니터링하고 컨텍스트를 압축하는 스킬입니다.
|
|
4
|
+
|
|
5
|
+
## 트리거 조건
|
|
6
|
+
|
|
7
|
+
이 스킬은 다음 조건에서 자동 활성화됩니다:
|
|
8
|
+
|
|
9
|
+
1. **토큰 임계값 도달**
|
|
10
|
+
- 50,000 토큰 (warning_threshold): 경고
|
|
11
|
+
- 80,000 토큰 (limit_threshold): 압축 필수
|
|
12
|
+
|
|
13
|
+
2. **스테이지 전환 시**
|
|
14
|
+
- 이전 스테이지 컨텍스트 정리
|
|
15
|
+
- 필수 정보만 유지
|
|
16
|
+
|
|
17
|
+
3. **명시적 호출**
|
|
18
|
+
- `/context --compress` 명령
|
|
19
|
+
|
|
20
|
+
## 기능
|
|
21
|
+
|
|
22
|
+
### 1. 컨텍스트 분석 (analyze.md)
|
|
23
|
+
- 현재 토큰 사용량 추정
|
|
24
|
+
- 카테고리별 분류
|
|
25
|
+
- 압축 가능 영역 식별
|
|
26
|
+
|
|
27
|
+
### 2. 압축 실행 (compress.md)
|
|
28
|
+
- 중요도 기반 필터링
|
|
29
|
+
- 요약 생성
|
|
30
|
+
- state.md 저장
|
|
31
|
+
|
|
32
|
+
### 3. 복구 지원 (prompts/compression.md)
|
|
33
|
+
- 저장된 컨텍스트 로드
|
|
34
|
+
- 작업 상태 복원
|
|
35
|
+
|
|
36
|
+
## 스킬 파일 구조
|
|
37
|
+
|
|
38
|
+
```
|
|
39
|
+
context-compression/
|
|
40
|
+
├── README.md # 이 파일
|
|
41
|
+
├── analyze.md # 컨텍스트 분석 로직
|
|
42
|
+
├── compress.md # 압축 로직
|
|
43
|
+
└── prompts/
|
|
44
|
+
└── compression.md # 압축 프롬프트
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## 압축 전략
|
|
48
|
+
|
|
49
|
+
### 유지 (Keep)
|
|
50
|
+
- ✅ 결정사항 및 이유
|
|
51
|
+
- ✅ 요구사항 명세
|
|
52
|
+
- ✅ 아키텍처 선택
|
|
53
|
+
- ✅ 현재 작업 상태
|
|
54
|
+
- ✅ 에러 해결책 (최종)
|
|
55
|
+
|
|
56
|
+
### 요약 (Summarize)
|
|
57
|
+
- 📝 긴 토론 과정
|
|
58
|
+
- 📝 탐색/조사 과정
|
|
59
|
+
- 📝 여러 대안 비교
|
|
60
|
+
|
|
61
|
+
### 제거 (Remove)
|
|
62
|
+
- ❌ 오류 시행착오 과정
|
|
63
|
+
- ❌ 중복된 시도
|
|
64
|
+
- ❌ 임시 출력/로그
|
|
65
|
+
- ❌ 이미 적용된 코드 diff
|
|
66
|
+
|
|
67
|
+
## 사용 예시
|
|
68
|
+
|
|
69
|
+
### 자동 경고
|
|
70
|
+
|
|
71
|
+
```
|
|
72
|
+
⚠️ 토큰 사용량 경고
|
|
73
|
+
|
|
74
|
+
현재: ~52,000 토큰 (50,000 초과)
|
|
75
|
+
|
|
76
|
+
권장 조치:
|
|
77
|
+
1. /context --compress 실행
|
|
78
|
+
2. 또는 /clear 후 state.md 복구
|
|
79
|
+
|
|
80
|
+
계속 진행하면 80,000에서 자동 저장됩니다.
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### 수동 압축
|
|
84
|
+
|
|
85
|
+
```
|
|
86
|
+
/context --compress
|
|
87
|
+
|
|
88
|
+
컨텍스트 압축 중...
|
|
89
|
+
|
|
90
|
+
[분석]
|
|
91
|
+
- 총 토큰: ~65,000
|
|
92
|
+
- 결정사항: ~5,000 (유지)
|
|
93
|
+
- 토론 내용: ~40,000 (요약 → 8,000)
|
|
94
|
+
- 오류 로그: ~20,000 (제거)
|
|
95
|
+
|
|
96
|
+
[결과]
|
|
97
|
+
- 압축 후: ~13,000 토큰
|
|
98
|
+
- 절감: 80%
|
|
99
|
+
|
|
100
|
+
state/context/state.md에 저장됨
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## 관련 명령어
|
|
104
|
+
|
|
105
|
+
- `/context` - 컨텍스트 상태 확인
|
|
106
|
+
- `/context --compress` - 압축 실행
|
|
107
|
+
- `/context --save` - 스냅샷 저장
|
|
108
|
+
|
|
109
|
+
## 설정
|
|
110
|
+
|
|
111
|
+
settings.json에서 임계값 조정:
|
|
112
|
+
|
|
113
|
+
```json
|
|
114
|
+
{
|
|
115
|
+
"context": {
|
|
116
|
+
"warning_threshold": 50000,
|
|
117
|
+
"limit_threshold": 80000,
|
|
118
|
+
"auto_save": true
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
```
|