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.
Files changed (258) hide show
  1. package/README.md +374 -0
  2. package/bin/create.js +193 -0
  3. package/package.json +38 -0
  4. package/template/.claude/CLAUDE.md +7 -0
  5. package/template/.claude/commands/CLAUDE.md +0 -0
  6. package/template/.claude/commands/benchmark.md +103 -0
  7. package/template/.claude/commands/brainstorm.md +67 -0
  8. package/template/.claude/commands/checkpoint.md +93 -0
  9. package/template/.claude/commands/codex.md +107 -0
  10. package/template/.claude/commands/collaborate.md +85 -0
  11. package/template/.claude/commands/context.md +154 -0
  12. package/template/.claude/commands/deploy.md +102 -0
  13. package/template/.claude/commands/fork.md +142 -0
  14. package/template/.claude/commands/gemini.md +84 -0
  15. package/template/.claude/commands/handoff.md +80 -0
  16. package/template/.claude/commands/implement.md +82 -0
  17. package/template/.claude/commands/init-project.md +49 -0
  18. package/template/.claude/commands/next.md +125 -0
  19. package/template/.claude/commands/planning.md +69 -0
  20. package/template/.claude/commands/qa.md +81 -0
  21. package/template/.claude/commands/refactor.md +95 -0
  22. package/template/.claude/commands/research.md +60 -0
  23. package/template/.claude/commands/restore.md +113 -0
  24. package/template/.claude/commands/run-stage.md +78 -0
  25. package/template/.claude/commands/stages.md +109 -0
  26. package/template/.claude/commands/status.md +73 -0
  27. package/template/.claude/commands/tasks.md +80 -0
  28. package/template/.claude/commands/test.md +93 -0
  29. package/template/.claude/commands/ui-ux.md +61 -0
  30. package/template/.claude/commands/validate.md +174 -0
  31. package/template/.claude/hooks/CLAUDE.md +0 -0
  32. package/template/.claude/hooks/ai-selector.sh +223 -0
  33. package/template/.claude/hooks/auto-checkpoint.sh +187 -0
  34. package/template/.claude/hooks/output-validator.sh +289 -0
  35. package/template/.claude/hooks/post-stage.sh +123 -0
  36. package/template/.claude/hooks/pre-stage.sh +186 -0
  37. package/template/.claude/hooks/session-start.sh +90 -0
  38. package/template/.claude/hooks/statusline.sh +115 -0
  39. package/template/.claude/hooks/stop.sh +104 -0
  40. package/template/.claude/settings.json +149 -0
  41. package/template/.claude/skills/ai-collaboration/CLAUDE.md +0 -0
  42. package/template/.claude/skills/ai-collaboration/README.md +61 -0
  43. package/template/.claude/skills/ai-collaboration/debate.md +148 -0
  44. package/template/.claude/skills/ai-collaboration/parallel.md +96 -0
  45. package/template/.claude/skills/ai-collaboration/prompts/CLAUDE.md +107 -0
  46. package/template/.claude/skills/auto-checkpoint/CLAUDE.md +0 -0
  47. package/template/.claude/skills/auto-checkpoint/README.md +77 -0
  48. package/template/.claude/skills/auto-checkpoint/prompts/CLAUDE.md +113 -0
  49. package/template/.claude/skills/auto-checkpoint/rollback.md +152 -0
  50. package/template/.claude/skills/auto-checkpoint/trigger.md +122 -0
  51. package/template/.claude/skills/context-compression/CLAUDE.md +0 -0
  52. package/template/.claude/skills/context-compression/README.md +121 -0
  53. package/template/.claude/skills/context-compression/analyze.md +114 -0
  54. package/template/.claude/skills/context-compression/compress.md +175 -0
  55. package/template/.claude/skills/context-compression/prompts/CLAUDE.md +0 -0
  56. package/template/.claude/skills/context-compression/prompts/compression.md +172 -0
  57. package/template/.claude/skills/output-validator/CLAUDE.md +0 -0
  58. package/template/.claude/skills/output-validator/README.md +86 -0
  59. package/template/.claude/skills/output-validator/prompts/CLAUDE.md +119 -0
  60. package/template/.claude/skills/output-validator/validate.md +182 -0
  61. package/template/.claude/skills/smart-handoff/CLAUDE.md +0 -0
  62. package/template/.claude/skills/smart-handoff/README.md +59 -0
  63. package/template/.claude/skills/smart-handoff/extract.md +76 -0
  64. package/template/.claude/skills/smart-handoff/prompts/CLAUDE.md +86 -0
  65. package/template/.claude/skills/smart-handoff/summarize.md +94 -0
  66. package/template/.claude/skills/stage-transition/CLAUDE.md +0 -0
  67. package/template/.claude/skills/stage-transition/README.md +84 -0
  68. package/template/.claude/skills/stage-transition/handoff-gen.md +160 -0
  69. package/template/.claude/skills/stage-transition/prompts/CLAUDE.md +0 -0
  70. package/template/.claude/skills/stage-transition/prompts/transition.md +145 -0
  71. package/template/.claude/skills/stage-transition/validate.md +108 -0
  72. package/template/CLAUDE.md +528 -0
  73. package/template/config/CLAUDE.md +0 -0
  74. package/template/config/ai_benchmarking.yaml +184 -0
  75. package/template/config/ai_collaboration.yaml +159 -0
  76. package/template/config/ai_logging.yaml +129 -0
  77. package/template/config/auto_checkpoint.yaml +189 -0
  78. package/template/config/context.yaml +78 -0
  79. package/template/config/git.yaml +161 -0
  80. package/template/config/handoff_intelligence.yaml +229 -0
  81. package/template/config/implementation.yaml.template +181 -0
  82. package/template/config/mcp_fallbacks.yaml +252 -0
  83. package/template/config/memory_integration.yaml +200 -0
  84. package/template/config/model_enforcement.yaml +141 -0
  85. package/template/config/models.yaml +242 -0
  86. package/template/config/output_validation.yaml +352 -0
  87. package/template/config/pipeline.yaml +357 -0
  88. package/template/config/pipeline_forking.yaml +236 -0
  89. package/template/config/qa_logging.yaml +166 -0
  90. package/template/config/smart_rollback.yaml +209 -0
  91. package/template/config/stage_personas.yaml +354 -0
  92. package/template/config/workflow.yaml +54 -0
  93. package/template/scripts/CLAUDE.md +0 -0
  94. package/template/scripts/ai-benchmark.sh +272 -0
  95. package/template/scripts/codex-wrapper.sh +97 -0
  96. package/template/scripts/context-manager.sh +528 -0
  97. package/template/scripts/create-checkpoint.sh +116 -0
  98. package/template/scripts/gemini-wrapper.sh +96 -0
  99. package/template/scripts/init-project.sh +109 -0
  100. package/template/scripts/list-stages.sh +245 -0
  101. package/template/scripts/next-stage.sh +228 -0
  102. package/template/scripts/output-validate.sh +12 -0
  103. package/template/scripts/pipeline-fork.sh +293 -0
  104. package/template/scripts/pre-run-check.sh +361 -0
  105. package/template/scripts/restore-checkpoint.sh +247 -0
  106. package/template/scripts/run-stage.sh +139 -0
  107. package/template/scripts/show-status.sh +185 -0
  108. package/template/scripts/smart-handoff.sh +254 -0
  109. package/template/stages/01-brainstorm/CLAUDE.md +103 -0
  110. package/template/stages/01-brainstorm/HANDOFF.md +110 -0
  111. package/template/stages/01-brainstorm/HANDOFF.md.template +112 -0
  112. package/template/stages/01-brainstorm/README.md +97 -0
  113. package/template/stages/01-brainstorm/config.yaml +92 -0
  114. package/template/stages/01-brainstorm/inputs/.gitkeep +0 -0
  115. package/template/stages/01-brainstorm/inputs/CLAUDE.md +0 -0
  116. package/template/stages/01-brainstorm/inputs/project_brief.md +40 -0
  117. package/template/stages/01-brainstorm/outputs/.gitkeep +0 -0
  118. package/template/stages/01-brainstorm/outputs/CLAUDE.md +0 -0
  119. package/template/stages/01-brainstorm/outputs/ideas.md +159 -0
  120. package/template/stages/01-brainstorm/outputs/requirements_analysis.md +222 -0
  121. package/template/stages/01-brainstorm/prompts/CLAUDE.md +0 -0
  122. package/template/stages/01-brainstorm/prompts/collaboration.md +46 -0
  123. package/template/stages/01-brainstorm/prompts/ideation.md +62 -0
  124. package/template/stages/01-brainstorm/prompts/persona.md +73 -0
  125. package/template/stages/01-brainstorm/prompts/requirements.md +73 -0
  126. package/template/stages/01-brainstorm/prompts/validation.md +50 -0
  127. package/template/stages/01-brainstorm/templates/CLAUDE.md +0 -0
  128. package/template/stages/01-brainstorm/templates/ideas.md +91 -0
  129. package/template/stages/01-brainstorm/templates/requirements_analysis.md +129 -0
  130. package/template/stages/02-research/CLAUDE.md +101 -0
  131. package/template/stages/02-research/HANDOFF.md +158 -0
  132. package/template/stages/02-research/HANDOFF.md.template +102 -0
  133. package/template/stages/02-research/config.yaml +68 -0
  134. package/template/stages/02-research/inputs/.gitkeep +0 -0
  135. package/template/stages/02-research/outputs/.gitkeep +0 -0
  136. package/template/stages/02-research/outputs/CLAUDE.md +0 -0
  137. package/template/stages/02-research/outputs/feasibility_report.md +176 -0
  138. package/template/stages/02-research/outputs/tech_research.md +403 -0
  139. package/template/stages/02-research/prompts/CLAUDE.md +0 -0
  140. package/template/stages/02-research/prompts/collaboration.md +51 -0
  141. package/template/stages/02-research/prompts/feasibility.md +73 -0
  142. package/template/stages/02-research/prompts/market_analysis.md +58 -0
  143. package/template/stages/02-research/prompts/tech_stack.md +60 -0
  144. package/template/stages/02-research/prompts/validation.md +51 -0
  145. package/template/stages/02-research/templates/.gitkeep +0 -0
  146. package/template/stages/03-planning/CLAUDE.md +98 -0
  147. package/template/stages/03-planning/HANDOFF.md +168 -0
  148. package/template/stages/03-planning/HANDOFF.md.template +91 -0
  149. package/template/stages/03-planning/config.yaml +64 -0
  150. package/template/stages/03-planning/inputs/.gitkeep +0 -0
  151. package/template/stages/03-planning/outputs/.gitkeep +0 -0
  152. package/template/stages/03-planning/outputs/CLAUDE.md +0 -0
  153. package/template/stages/03-planning/outputs/architecture.md +400 -0
  154. package/template/stages/03-planning/outputs/implementation.yaml +209 -0
  155. package/template/stages/03-planning/outputs/project_plan.md +204 -0
  156. package/template/stages/03-planning/outputs/tech_stack.md +176 -0
  157. package/template/stages/03-planning/prompts/CLAUDE.md +0 -0
  158. package/template/stages/03-planning/prompts/architecture.md +62 -0
  159. package/template/stages/03-planning/prompts/collaboration.md +57 -0
  160. package/template/stages/03-planning/prompts/validation.md +59 -0
  161. package/template/stages/03-planning/templates/.gitkeep +0 -0
  162. package/template/stages/04-ui-ux/CLAUDE.md +88 -0
  163. package/template/stages/04-ui-ux/HANDOFF.md +165 -0
  164. package/template/stages/04-ui-ux/HANDOFF.md.template +92 -0
  165. package/template/stages/04-ui-ux/config.yaml +57 -0
  166. package/template/stages/04-ui-ux/inputs/.gitkeep +0 -0
  167. package/template/stages/04-ui-ux/outputs/.gitkeep +0 -0
  168. package/template/stages/04-ui-ux/outputs/CLAUDE.md +0 -0
  169. package/template/stages/04-ui-ux/outputs/design_system.md +449 -0
  170. package/template/stages/04-ui-ux/outputs/user_flows.md +321 -0
  171. package/template/stages/04-ui-ux/outputs/wireframes.md +241 -0
  172. package/template/stages/04-ui-ux/prompts/.gitkeep +0 -0
  173. package/template/stages/04-ui-ux/prompts/CLAUDE.md +0 -0
  174. package/template/stages/04-ui-ux/prompts/collaboration.md +56 -0
  175. package/template/stages/04-ui-ux/prompts/validation.md +54 -0
  176. package/template/stages/04-ui-ux/templates/.gitkeep +0 -0
  177. package/template/stages/05-task-management/CLAUDE.md +105 -0
  178. package/template/stages/05-task-management/HANDOFF.md +187 -0
  179. package/template/stages/05-task-management/HANDOFF.md.template +97 -0
  180. package/template/stages/05-task-management/config.yaml +81 -0
  181. package/template/stages/05-task-management/inputs/.gitkeep +0 -0
  182. package/template/stages/05-task-management/outputs/.gitkeep +0 -0
  183. package/template/stages/05-task-management/outputs/CLAUDE.md +0 -0
  184. package/template/stages/05-task-management/outputs/milestones.md +253 -0
  185. package/template/stages/05-task-management/outputs/sprint_plan.md +203 -0
  186. package/template/stages/05-task-management/outputs/tasks.md +402 -0
  187. package/template/stages/05-task-management/prompts/.gitkeep +0 -0
  188. package/template/stages/05-task-management/prompts/CLAUDE.md +0 -0
  189. package/template/stages/05-task-management/prompts/collaboration.md +54 -0
  190. package/template/stages/05-task-management/prompts/validation.md +66 -0
  191. package/template/stages/05-task-management/templates/CLAUDE.md +0 -0
  192. package/template/stages/05-task-management/templates/notion_integration.md +176 -0
  193. package/template/stages/05-task-management/templates/parallel_groups.yaml +153 -0
  194. package/template/stages/05-task-management/templates/task_schema.yaml +154 -0
  195. package/template/stages/06-implementation/CLAUDE.md +163 -0
  196. package/template/stages/06-implementation/HANDOFF.md +184 -0
  197. package/template/stages/06-implementation/HANDOFF.md.template +192 -0
  198. package/template/stages/06-implementation/config.yaml +62 -0
  199. package/template/stages/06-implementation/inputs/.gitkeep +0 -0
  200. package/template/stages/06-implementation/outputs/.gitkeep +0 -0
  201. package/template/stages/06-implementation/prompts/.gitkeep +0 -0
  202. package/template/stages/06-implementation/prompts/CLAUDE.md +0 -0
  203. package/template/stages/06-implementation/prompts/collaboration.md +64 -0
  204. package/template/stages/06-implementation/prompts/validation.md +65 -0
  205. package/template/stages/06-implementation/templates/.gitkeep +0 -0
  206. package/template/stages/07-refactoring/CLAUDE.md +180 -0
  207. package/template/stages/07-refactoring/HANDOFF.md +82 -0
  208. package/template/stages/07-refactoring/HANDOFF.md.template +97 -0
  209. package/template/stages/07-refactoring/config.yaml +68 -0
  210. package/template/stages/07-refactoring/inputs/.gitkeep +0 -0
  211. package/template/stages/07-refactoring/outputs/.gitkeep +0 -0
  212. package/template/stages/07-refactoring/outputs/refactoring_report.md +102 -0
  213. package/template/stages/07-refactoring/prompts/.gitkeep +0 -0
  214. package/template/stages/07-refactoring/prompts/CLAUDE.md +0 -0
  215. package/template/stages/07-refactoring/prompts/collaboration.md +71 -0
  216. package/template/stages/07-refactoring/prompts/validation.md +76 -0
  217. package/template/stages/07-refactoring/templates/.gitkeep +0 -0
  218. package/template/stages/08-qa/CLAUDE.md +93 -0
  219. package/template/stages/08-qa/HANDOFF.md +114 -0
  220. package/template/stages/08-qa/HANDOFF.md.template +96 -0
  221. package/template/stages/08-qa/config.yaml +56 -0
  222. package/template/stages/08-qa/inputs/.gitkeep +0 -0
  223. package/template/stages/08-qa/outputs/.gitkeep +0 -0
  224. package/template/stages/08-qa/outputs/qa_report.md +138 -0
  225. package/template/stages/08-qa/prompts/.gitkeep +0 -0
  226. package/template/stages/08-qa/prompts/CLAUDE.md +0 -0
  227. package/template/stages/08-qa/prompts/collaboration.md +65 -0
  228. package/template/stages/08-qa/prompts/validation.md +71 -0
  229. package/template/stages/08-qa/templates/.gitkeep +0 -0
  230. package/template/stages/09-testing/CLAUDE.md +124 -0
  231. package/template/stages/09-testing/HANDOFF.md +118 -0
  232. package/template/stages/09-testing/HANDOFF.md.template +113 -0
  233. package/template/stages/09-testing/config.yaml +65 -0
  234. package/template/stages/09-testing/inputs/.gitkeep +0 -0
  235. package/template/stages/09-testing/outputs/.gitkeep +0 -0
  236. package/template/stages/09-testing/outputs/test_report.md +146 -0
  237. package/template/stages/09-testing/prompts/.gitkeep +0 -0
  238. package/template/stages/09-testing/prompts/CLAUDE.md +0 -0
  239. package/template/stages/09-testing/prompts/collaboration.md +77 -0
  240. package/template/stages/09-testing/prompts/validation.md +83 -0
  241. package/template/stages/09-testing/templates/.gitkeep +0 -0
  242. package/template/stages/10-deployment/CLAUDE.md +117 -0
  243. package/template/stages/10-deployment/HANDOFF.md +141 -0
  244. package/template/stages/10-deployment/HANDOFF.md.template +148 -0
  245. package/template/stages/10-deployment/config.yaml +61 -0
  246. package/template/stages/10-deployment/inputs/.gitkeep +0 -0
  247. package/template/stages/10-deployment/outputs/.gitkeep +0 -0
  248. package/template/stages/10-deployment/prompts/.gitkeep +0 -0
  249. package/template/stages/10-deployment/prompts/CLAUDE.md +0 -0
  250. package/template/stages/10-deployment/prompts/collaboration.md +80 -0
  251. package/template/stages/10-deployment/prompts/validation.md +93 -0
  252. package/template/stages/10-deployment/templates/CLAUDE.md +0 -0
  253. package/template/stages/10-deployment/templates/github-actions-cd.yaml +118 -0
  254. package/template/stages/10-deployment/templates/github-actions-ci.yaml +136 -0
  255. package/template/state/progress.json.template +111 -0
  256. package/template/state/templates/CLAUDE.md +0 -0
  257. package/template/state/templates/handoff_base.md.template +187 -0
  258. 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
+
@@ -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` |
@@ -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
+ ```