claude-symphony 0.0.1 β†’ 0.0.3

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 (150) hide show
  1. package/README.md +16 -12
  2. package/assets/claude_symphony.webp +0 -0
  3. package/assets/claude_symphony_ascii.txt +8 -0
  4. package/bin/create.js +80 -69
  5. package/package.json +3 -2
  6. package/template/.claude/commands/benchmark.md +32 -32
  7. package/template/.claude/commands/brainstorm.md +33 -33
  8. package/template/.claude/commands/checkpoint.md +42 -42
  9. package/template/.claude/commands/codex.md +52 -52
  10. package/template/.claude/commands/collaborate.md +47 -47
  11. package/template/.claude/commands/context.md +77 -77
  12. package/template/.claude/commands/deploy.md +50 -50
  13. package/template/.claude/commands/fork.md +46 -46
  14. package/template/.claude/commands/gemini.md +43 -43
  15. package/template/.claude/commands/handoff.md +42 -42
  16. package/template/.claude/commands/implement.md +42 -42
  17. package/template/.claude/commands/init-project.md +25 -25
  18. package/template/.claude/commands/next.md +67 -67
  19. package/template/.claude/commands/planning.md +38 -38
  20. package/template/.claude/commands/qa.md +47 -47
  21. package/template/.claude/commands/refactor.md +50 -50
  22. package/template/.claude/commands/research.md +31 -31
  23. package/template/.claude/commands/restore.md +53 -53
  24. package/template/.claude/commands/run-stage.md +45 -45
  25. package/template/.claude/commands/stages.md +49 -49
  26. package/template/.claude/commands/status.md +41 -41
  27. package/template/.claude/commands/tasks.md +33 -33
  28. package/template/.claude/commands/test.md +45 -45
  29. package/template/.claude/commands/ui-ux.md +31 -31
  30. package/template/.claude/commands/validate.md +81 -81
  31. package/template/.claude/hooks/ai-selector.sh +39 -39
  32. package/template/.claude/hooks/auto-checkpoint.sh +30 -30
  33. package/template/.claude/hooks/output-validator.sh +45 -45
  34. package/template/.claude/hooks/post-stage.sh +28 -28
  35. package/template/.claude/hooks/pre-stage.sh +47 -47
  36. package/template/.claude/hooks/session-start.sh +27 -27
  37. package/template/.claude/hooks/statusline.sh +24 -24
  38. package/template/.claude/hooks/stop.sh +26 -26
  39. package/template/.claude/settings.json +32 -32
  40. package/template/.claude/skills/ai-collaboration/README.md +31 -31
  41. package/template/.claude/skills/ai-collaboration/debate.md +66 -66
  42. package/template/.claude/skills/ai-collaboration/parallel.md +34 -34
  43. package/template/.claude/skills/ai-collaboration/prompts/CLAUDE.md +59 -63
  44. package/template/.claude/skills/auto-checkpoint/README.md +46 -46
  45. package/template/.claude/skills/auto-checkpoint/prompts/CLAUDE.md +68 -72
  46. package/template/.claude/skills/auto-checkpoint/rollback.md +95 -95
  47. package/template/.claude/skills/auto-checkpoint/trigger.md +37 -37
  48. package/template/.claude/skills/context-compression/README.md +69 -69
  49. package/template/.claude/skills/context-compression/analyze.md +74 -74
  50. package/template/.claude/skills/context-compression/compress.md +103 -103
  51. package/template/.claude/skills/context-compression/prompts/compression.md +78 -78
  52. package/template/.claude/skills/output-validator/README.md +33 -33
  53. package/template/.claude/skills/output-validator/prompts/CLAUDE.md +74 -78
  54. package/template/.claude/skills/output-validator/validate.md +76 -76
  55. package/template/.claude/skills/smart-handoff/README.md +35 -35
  56. package/template/.claude/skills/smart-handoff/extract.md +42 -42
  57. package/template/.claude/skills/smart-handoff/prompts/CLAUDE.md +52 -54
  58. package/template/.claude/skills/smart-handoff/summarize.md +55 -55
  59. package/template/.claude/skills/stage-transition/README.md +50 -50
  60. package/template/.claude/skills/stage-transition/handoff-gen.md +89 -89
  61. package/template/.claude/skills/stage-transition/prompts/transition.md +74 -74
  62. package/template/.claude/skills/stage-transition/validate.md +41 -41
  63. package/template/CLAUDE.md +334 -335
  64. package/template/config/ai_benchmarking.yaml +22 -22
  65. package/template/config/ai_collaboration.yaml +18 -18
  66. package/template/config/ai_logging.yaml +50 -50
  67. package/template/config/auto_checkpoint.yaml +32 -32
  68. package/template/config/context.yaml +20 -20
  69. package/template/config/git.yaml +51 -51
  70. package/template/config/handoff_intelligence.yaml +23 -23
  71. package/template/config/mcp_fallbacks.yaml +71 -71
  72. package/template/config/memory_integration.yaml +23 -23
  73. package/template/config/model_enforcement.yaml +53 -53
  74. package/template/config/models.yaml +24 -24
  75. package/template/config/output_validation.yaml +44 -44
  76. package/template/config/pipeline.yaml +25 -25
  77. package/template/config/pipeline_forking.yaml +40 -40
  78. package/template/config/qa_logging.yaml +67 -67
  79. package/template/config/smart_rollback.yaml +48 -48
  80. package/template/config/stage_personas.yaml +154 -154
  81. package/template/config/workflow.yaml +16 -16
  82. package/template/scripts/ai-benchmark.sh +41 -41
  83. package/template/scripts/codex-wrapper.sh +32 -32
  84. package/template/scripts/context-manager.sh +136 -136
  85. package/template/scripts/create-checkpoint.sh +34 -34
  86. package/template/scripts/gemini-wrapper.sh +31 -31
  87. package/template/scripts/init-project.sh +40 -40
  88. package/template/scripts/list-stages.sh +30 -30
  89. package/template/scripts/next-stage.sh +67 -67
  90. package/template/scripts/output-validate.sh +2 -2
  91. package/template/scripts/pipeline-fork.sh +68 -68
  92. package/template/scripts/pre-run-check.sh +84 -84
  93. package/template/scripts/restore-checkpoint.sh +50 -50
  94. package/template/scripts/run-stage.sh +44 -44
  95. package/template/scripts/show-status.sh +30 -30
  96. package/template/scripts/smart-handoff.sh +70 -70
  97. package/template/stages/01-brainstorm/CLAUDE.md +70 -74
  98. package/template/stages/01-brainstorm/README.md +54 -54
  99. package/template/stages/01-brainstorm/config.yaml +18 -18
  100. package/template/stages/01-brainstorm/prompts/collaboration.md +24 -24
  101. package/template/stages/01-brainstorm/prompts/ideation.md +41 -41
  102. package/template/stages/01-brainstorm/prompts/persona.md +50 -50
  103. package/template/stages/01-brainstorm/prompts/requirements.md +55 -55
  104. package/template/stages/01-brainstorm/prompts/validation.md +28 -28
  105. package/template/stages/01-brainstorm/templates/ideas.md +47 -47
  106. package/template/stages/01-brainstorm/templates/requirements_analysis.md +61 -61
  107. package/template/stages/02-research/CLAUDE.md +72 -76
  108. package/template/stages/02-research/config.yaml +12 -12
  109. package/template/stages/02-research/prompts/collaboration.md +29 -29
  110. package/template/stages/02-research/prompts/feasibility.md +38 -38
  111. package/template/stages/02-research/prompts/market_analysis.md +29 -29
  112. package/template/stages/02-research/prompts/tech_stack.md +34 -34
  113. package/template/stages/02-research/prompts/validation.md +29 -29
  114. package/template/stages/03-planning/CLAUDE.md +88 -92
  115. package/template/stages/03-planning/config.yaml +10 -10
  116. package/template/stages/03-planning/prompts/architecture.md +43 -43
  117. package/template/stages/03-planning/prompts/collaboration.md +34 -34
  118. package/template/stages/03-planning/prompts/validation.md +34 -34
  119. package/template/stages/04-ui-ux/CLAUDE.md +68 -72
  120. package/template/stages/04-ui-ux/config.yaml +5 -5
  121. package/template/stages/04-ui-ux/prompts/collaboration.md +35 -35
  122. package/template/stages/04-ui-ux/prompts/validation.md +30 -30
  123. package/template/stages/05-task-management/CLAUDE.md +81 -85
  124. package/template/stages/05-task-management/config.yaml +17 -17
  125. package/template/stages/05-task-management/prompts/collaboration.md +30 -30
  126. package/template/stages/05-task-management/prompts/validation.md +33 -33
  127. package/template/stages/05-task-management/templates/notion_integration.md +70 -70
  128. package/template/stages/05-task-management/templates/parallel_groups.yaml +64 -64
  129. package/template/stages/05-task-management/templates/task_schema.yaml +33 -33
  130. package/template/stages/06-implementation/CLAUDE.md +117 -121
  131. package/template/stages/06-implementation/config.yaml +10 -10
  132. package/template/stages/06-implementation/prompts/collaboration.md +29 -29
  133. package/template/stages/06-implementation/prompts/validation.md +36 -36
  134. package/template/stages/07-refactoring/CLAUDE.md +120 -124
  135. package/template/stages/07-refactoring/config.yaml +11 -11
  136. package/template/stages/07-refactoring/prompts/collaboration.md +36 -36
  137. package/template/stages/07-refactoring/prompts/validation.md +40 -40
  138. package/template/stages/08-qa/CLAUDE.md +80 -84
  139. package/template/stages/08-qa/config.yaml +7 -7
  140. package/template/stages/08-qa/prompts/collaboration.md +34 -34
  141. package/template/stages/08-qa/prompts/validation.md +41 -41
  142. package/template/stages/09-testing/CLAUDE.md +86 -90
  143. package/template/stages/09-testing/config.yaml +10 -10
  144. package/template/stages/09-testing/prompts/collaboration.md +38 -38
  145. package/template/stages/09-testing/prompts/validation.md +41 -41
  146. package/template/stages/10-deployment/CLAUDE.md +86 -90
  147. package/template/stages/10-deployment/config.yaml +11 -11
  148. package/template/stages/10-deployment/prompts/collaboration.md +37 -37
  149. package/template/stages/10-deployment/prompts/validation.md +54 -54
  150. package/template/stages/10-deployment/templates/github-actions-cd.yaml +1 -1
@@ -1,93 +1,93 @@
1
1
  # /checkpoint
2
2
 
3
- ν˜„μž¬ μƒνƒœμ˜ 체크포인트λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€.
3
+ Create a checkpoint of the current state.
4
4
 
5
- ## μ‚¬μš©λ²•
5
+ ## Usage
6
6
  ```
7
7
  /checkpoint [description]
8
8
  ```
9
9
 
10
- ## λ™μž‘
10
+ ## Actions
11
11
 
12
- 1. **ν˜„μž¬ μƒνƒœ 캑처**
13
- - ν˜„μž¬ μŠ€ν…Œμ΄μ§€ 정보
14
- - λͺ¨λ“  outputs 파일
12
+ 1. **Capture Current State**
13
+ - Current stage information
14
+ - All outputs files
15
15
  - state/progress.json
16
- - μ†ŒμŠ€ μ½”λ“œ (ν•΄λ‹Ή μ‹œ)
16
+ - Source code (when applicable)
17
17
 
18
- 2. **체크포인트 생성**
18
+ 2. **Create Checkpoint**
19
19
  - ID: `CP-[stage]-[timestamp]`
20
- - μœ„μΉ˜: `state/checkpoints/[CP-ID]/`
20
+ - Location: `state/checkpoints/[CP-ID]/`
21
21
 
22
- 3. **메타데이터 μ €μž₯**
22
+ 3. **Save Metadata**
23
23
  ```json
24
24
  {
25
25
  "id": "CP-06-20240120-1430",
26
26
  "stage": "06-implementation",
27
- "description": "μŠ€ν”„λ¦°νŠΈ 1 μ™„λ£Œ",
27
+ "description": "Sprint 1 completed",
28
28
  "created_at": "2024-01-20T14:30:00Z",
29
29
  "files": [...],
30
30
  "progress_snapshot": {...}
31
31
  }
32
32
  ```
33
33
 
34
- 4. **state/progress.json μ—…λ°μ΄νŠΈ**
35
- - checkpoints 배열에 μΆ”κ°€
34
+ 4. **Update state/progress.json**
35
+ - Add to checkpoints array
36
36
 
37
- ## μ‹€ν–‰ 슀크립트
37
+ ## Execution Script
38
38
 
39
39
  ```bash
40
40
  scripts/create-checkpoint.sh "$ARGUMENTS"
41
41
  ```
42
42
 
43
- ## μ˜ˆμ‹œ
43
+ ## Example
44
44
 
45
45
  ```
46
- /checkpoint μŠ€ν”„λ¦°νŠΈ 1 μ™„λ£Œ
46
+ /checkpoint Sprint 1 completed
47
47
 
48
- 체크포인트 생성 쀑...
49
- βœ“ ν˜„μž¬ μƒνƒœ 캑처 μ™„λ£Œ
50
- βœ“ 파일 볡사 μ™„λ£Œ (42개 파일)
51
- βœ“ 메타데이터 μ €μž₯ μ™„λ£Œ
48
+ Creating checkpoint...
49
+ βœ“ Current state captured
50
+ βœ“ File copy completed (42 files)
51
+ βœ“ Metadata saved
52
52
 
53
- 체크포인트 생성 μ™„λ£Œ!
53
+ Checkpoint created!
54
54
  - ID: CP-06-20240120-1430
55
- - μœ„μΉ˜: state/checkpoints/CP-06-20240120-1430/
56
- - μ„€λͺ…: μŠ€ν”„λ¦°νŠΈ 1 μ™„λ£Œ
55
+ - Location: state/checkpoints/CP-06-20240120-1430/
56
+ - Description: Sprint 1 completed
57
57
 
58
- 볡ꡬ λͺ…λ Ήμ–΄:
58
+ Recovery command:
59
59
  scripts/restore-checkpoint.sh CP-06-20240120-1430
60
60
  ```
61
61
 
62
- ## 체크포인트 λͺ©λ‘ 보기
62
+ ## View Checkpoint List
63
63
 
64
64
  ```
65
65
  /checkpoint --list
66
66
 
67
- 체크포인트 λͺ©λ‘:
68
- | ID | μŠ€ν…Œμ΄μ§€ | μ„€λͺ… | 생성일 |
69
- |----|----------|------|--------|
70
- | CP-06-20240120-1030 | 06-impl | ν”„λ‘œμ νŠΈ μ΄ˆκΈ°ν™” | 2024-01-20 10:30 |
71
- | CP-06-20240120-1430 | 06-impl | μŠ€ν”„λ¦°νŠΈ 1 μ™„λ£Œ | 2024-01-20 14:30 |
67
+ Checkpoint List:
68
+ | ID | Stage | Description | Created |
69
+ |----|-------|-------------|---------|
70
+ | CP-06-20240120-1030 | 06-impl | Project initialized | 2024-01-20 10:30 |
71
+ | CP-06-20240120-1430 | 06-impl | Sprint 1 completed | 2024-01-20 14:30 |
72
72
  ```
73
73
 
74
- ## 체크포인트 볡ꡬ
74
+ ## Restore Checkpoint
75
75
 
76
76
  ```bash
77
77
  scripts/restore-checkpoint.sh CP-06-20240120-1030
78
78
 
79
- κ²½κ³ : ν˜„μž¬ μƒνƒœκ°€ 체크포인트 CP-06-20240120-1030 μ‹œμ μœΌλ‘œ λ³΅κ΅¬λ©λ‹ˆλ‹€.
80
- ν˜„μž¬ 변경사항이 손싀될 수 μžˆμŠ΅λ‹ˆλ‹€.
81
- κ³„μ†ν•˜μ‹œκ² μŠ΅λ‹ˆκΉŒ? [y/N] y
79
+ Warning: Current state will be restored to checkpoint CP-06-20240120-1030.
80
+ Current changes may be lost.
81
+ Continue? [y/N] y
82
82
 
83
- βœ“ 체크포인트 볡ꡬ μ™„λ£Œ
84
- βœ“ ν˜„μž¬ μŠ€ν…Œμ΄μ§€: 06-implementation
83
+ βœ“ Checkpoint restored
84
+ βœ“ Current stage: 06-implementation
85
85
  ```
86
86
 
87
- ## ν•„μˆ˜ 체크포인트 μŠ€ν…Œμ΄μ§€
88
- - `06-implementation`: κ΅¬ν˜„ 쀑 μ£Όμš” λ§ˆμΌμŠ€ν†€λ§ˆλ‹€
89
- - `07-refactoring`: λ¦¬νŒ©ν† λ§ μ „/ν›„
87
+ ## Required Checkpoint Stages
88
+ - `06-implementation`: At major milestones during implementation
89
+ - `07-refactoring`: Before/after refactoring
90
90
 
91
- ## μ˜΅μ…˜
92
- - `--list`: 체크포인트 λͺ©λ‘ ν‘œμ‹œ
93
- - `--delete [CP-ID]`: 체크포인트 μ‚­μ œ
91
+ ## Options
92
+ - `--list`: Display checkpoint list
93
+ - `--delete [CP-ID]`: Delete checkpoint
@@ -1,48 +1,48 @@
1
1
  # /codex
2
2
 
3
- tmux μ„Έμ…˜μ„ 톡해 OpenAI Codex CLIλ₯Ό ν˜ΈμΆœν•©λ‹ˆλ‹€.
3
+ Call OpenAI Codex CLI through tmux session.
4
4
 
5
- ## μ‚¬μš©λ²•
5
+ ## Usage
6
6
  ```
7
7
  /codex [prompt]
8
8
  ```
9
9
 
10
- ## λ™μž‘
10
+ ## Actions
11
11
 
12
- 1. **tmux μ„Έμ…˜ 확인/생성**
13
- - μ„Έμ…˜λͺ…: `ax-codex`
14
- - μ—†μœΌλ©΄ μƒˆλ‘œ 생성
12
+ 1. **Check/Create tmux Session**
13
+ - Session name: `ax-codex`
14
+ - Create new if not exists
15
15
 
16
- 2. **Codex CLI μ‹€ν–‰**
17
- - ν”„λ‘¬ν”„νŠΈ 전솑
18
- - 응닡 λŒ€κΈ° (wait-for 방식)
16
+ 2. **Execute Codex CLI**
17
+ - Send prompt
18
+ - Wait for response (wait-for method)
19
19
 
20
- 3. **κ²°κ³Ό 캑처 및 λ°˜ν™˜**
21
- - 좜λ ₯ νŒŒμΌμ—μ„œ κ²°κ³Ό 읽기
22
- - μ‚¬μš©μžμ—κ²Œ ν‘œμ‹œ
20
+ 3. **Capture and Return Results**
21
+ - Read results from output file
22
+ - Display to user
23
23
 
24
- ## μ‹€ν–‰ 슀크립트
24
+ ## Execution Script
25
25
 
26
26
  ```bash
27
27
  scripts/codex-wrapper.sh "$ARGUMENTS"
28
28
  ```
29
29
 
30
- ## μ˜ˆμ‹œ
30
+ ## Example
31
31
 
32
32
  ```
33
- /codex λ‹€μŒ ν•¨μˆ˜λ₯Ό λ¦¬νŒ©ν† λ§ν•΄μ£Όμ„Έμš”. 가독성과 μ„±λŠ₯을 κ°œμ„ ν•˜κ³ ,
34
- νƒ€μž… μ•ˆμ „μ„±μ„ λ†’μ—¬μ£Όμ„Έμš”:
33
+ /codex Please refactor the following function. Improve readability and performance,
34
+ and enhance type safety:
35
35
 
36
36
  function processData(data) {
37
- // κΈ΄ ν•¨μˆ˜ μ½”λ“œ
37
+ // long function code
38
38
  }
39
39
 
40
- Codex 호좜 쀑...
41
- μ„Έμ…˜: ax-codex
42
- νƒ€μž„μ•„μ›ƒ: 300초
40
+ Calling Codex...
41
+ Session: ax-codex
42
+ Timeout: 300 seconds
43
43
 
44
- [응닡]
45
- λ¦¬νŒ©ν† λ§λœ μ½”λ“œ:
44
+ [Response]
45
+ Refactored code:
46
46
 
47
47
  \`\`\`typescript
48
48
  interface DataItem {
@@ -51,57 +51,57 @@ interface DataItem {
51
51
  }
52
52
 
53
53
  function processData(data: DataItem[]): ProcessedResult {
54
- // κΉ”λ”ν•˜κ²Œ λ¦¬νŒ©ν† λ§λœ μ½”λ“œ
54
+ // cleanly refactored code
55
55
  }
56
56
  \`\`\`
57
57
 
58
- λ³€κ²½ 사항:
59
- 1. TypeScript νƒ€μž… μΆ”κ°€
60
- 2. ν•¨μˆ˜λ₯Ό 3개의 μž‘μ€ ν•¨μˆ˜λ‘œ 뢄리
61
- 3. λΆˆν•„μš”ν•œ 루프 제거둜 O(nΒ²) β†’ O(n) μ΅œμ ν™”
58
+ Changes:
59
+ 1. Added TypeScript types
60
+ 2. Split function into 3 smaller functions
61
+ 3. Optimized O(nΒ²) β†’ O(n) by removing unnecessary loops
62
62
  ```
63
63
 
64
- ## ν™œμš© μ‹œλ‚˜λ¦¬μ˜€
64
+ ## Usage Scenarios
65
65
 
66
- ### 1. μ½”λ“œ λ¦¬νŒ©ν† λ§ (07-refactoring)
66
+ ### 1. Code Refactoring (07-refactoring)
67
67
  ```
68
- /codex λ‹€μŒ μ½”λ“œμ˜ 쀑볡을 μ œκ±°ν•˜κ³  DRY 원칙을 μ μš©ν•΄μ£Όμ„Έμš”:
69
- [μ½”λ“œ]
68
+ /codex Please remove duplicates and apply DRY principle to the following code:
69
+ [code]
70
70
  ```
71
71
 
72
- ### 2. ν…ŒμŠ€νŠΈ μ½”λ“œ 생성 (09-testing)
72
+ ### 2. Test Code Generation (09-testing)
73
73
  ```
74
- /codex λ‹€μŒ ν•¨μˆ˜μ— λŒ€ν•œ Jest ν…ŒμŠ€νŠΈ μ½”λ“œλ₯Ό μž‘μ„±ν•΄μ£Όμ„Έμš”.
75
- μ—£μ§€ μΌ€μ΄μŠ€λ₯Ό ν¬ν•¨ν•΄μ£Όμ„Έμš”:
76
- [ν•¨μˆ˜ μ½”λ“œ]
74
+ /codex Please write Jest test code for the following function.
75
+ Include edge cases:
76
+ [function code]
77
77
  ```
78
78
 
79
- ### 3. μ„±λŠ₯ μ΅œμ ν™”
79
+ ### 3. Performance Optimization
80
80
  ```
81
- /codex λ‹€μŒ μ½”λ“œμ˜ μ„±λŠ₯ 병λͺ©μ„ λΆ„μ„ν•˜κ³  μ΅œμ ν™”ν•΄μ£Όμ„Έμš”:
82
- [μ½”λ“œ]
81
+ /codex Please analyze performance bottlenecks and optimize the following code:
82
+ [code]
83
83
  ```
84
84
 
85
- ### 4. μ½”λ“œ 뢄석
85
+ ### 4. Code Analysis
86
86
  ```
87
- /codex λ‹€μŒ μ½”λ“œμ˜ λ³΅μž‘λ„λ₯Ό λΆ„μ„ν•˜κ³  κ°œμ„ μ μ„ μ œμ•ˆν•΄μ£Όμ„Έμš”:
88
- [μ½”λ“œ]
87
+ /codex Please analyze complexity and suggest improvements for the following code:
88
+ [code]
89
89
  ```
90
90
 
91
- ## νƒ€μž„μ•„μ›ƒ
91
+ ## Timeout
92
92
 
93
- κΈ°λ³Έ νƒ€μž„μ•„μ›ƒ: 300초 (5λΆ„)
93
+ Default timeout: 300 seconds (5 minutes)
94
94
 
95
- λ³€κ²½:
95
+ To change:
96
96
  ```
97
- /codex --timeout 600 [κΈ΄ μž‘μ—… ν”„λ‘¬ν”„νŠΈ]
97
+ /codex --timeout 600 [long task prompt]
98
98
  ```
99
99
 
100
- ## μ œν•œμ‚¬ν•­
101
- - Codex CLIκ°€ μ„€μΉ˜λ˜μ–΄ μžˆμ–΄μ•Ό 함
102
- - tmuxκ°€ μ„€μΉ˜λ˜μ–΄ μžˆμ–΄μ•Ό 함
103
- - λŒ€ν™”ν˜• ν”„λ‘¬ν”„νŠΈλŠ” μ§€μ›ν•˜μ§€ μ•ŠμŒ (λ‹¨λ°œμ„± 질의만)
100
+ ## Limitations
101
+ - Codex CLI must be installed
102
+ - tmux must be installed
103
+ - Interactive prompts not supported (single queries only)
104
104
 
105
- ## κ΄€λ ¨
106
- - `/gemini`: Gemini CLI 호좜
107
- - `scripts/codex-wrapper.sh`: 래퍼 슀크립트
105
+ ## Related
106
+ - `/gemini`: Gemini CLI call
107
+ - `scripts/codex-wrapper.sh`: Wrapper script
@@ -1,85 +1,85 @@
1
1
  # /collaborate - Multi-AI Collaboration Command
2
2
 
3
- μ—¬λŸ¬ AI λͺ¨λΈμ„ ν˜‘μ—…μ‹œμΌœ 더 λ‚˜μ€ 결과물을 μƒμ„±ν•©λ‹ˆλ‹€.
3
+ Collaborate multiple AI models to generate better results.
4
4
 
5
- ## μ‚¬μš©λ²•
5
+ ## Usage
6
6
 
7
7
  ```bash
8
8
  /collaborate [options]
9
9
  ```
10
10
 
11
- ## μ˜΅μ…˜
11
+ ## Options
12
12
 
13
- | μ˜΅μ…˜ | μ„€λͺ… | κΈ°λ³Έκ°’ |
14
- |------|------|--------|
15
- | `--mode` | ν˜‘μ—… λͺ¨λ“œ (parallel, sequential, debate) | parallel |
16
- | `--task` | μˆ˜ν–‰ν•  μž‘μ—… μ„€λͺ… | - |
17
- | `--models` | μ°Έμ—¬ AI λͺ¨λΈ (μ‰Όν‘œ ꡬ뢄) | gemini,claude |
18
- | `--chain` | 순차 체인 이름 (sequential λͺ¨λ“œ) | - |
19
- | `--rounds` | ν† λ‘  λΌμš΄λ“œ 수 (debate λͺ¨λ“œ) | 3 |
20
- | `--topic` | ν† λ‘  주제 (debate λͺ¨λ“œ) | - |
13
+ | Option | Description | Default |
14
+ |--------|-------------|---------|
15
+ | `--mode` | Collaboration mode (parallel, sequential, debate) | parallel |
16
+ | `--task` | Task description to perform | - |
17
+ | `--models` | Participating AI models (comma-separated) | gemini,claude |
18
+ | `--chain` | Sequential chain name (sequential mode) | - |
19
+ | `--rounds` | Debate rounds (debate mode) | 3 |
20
+ | `--topic` | Debate topic (debate mode) | - |
21
21
 
22
- ## ν˜‘μ—… λͺ¨λ“œ
22
+ ## Collaboration Modes
23
23
 
24
- ### 1. Parallel (병렬 μ‹€ν–‰)
24
+ ### 1. Parallel (Parallel Execution)
25
25
  ```bash
26
- /collaborate --mode parallel --task "아이디어 생성" --models "gemini,claude"
26
+ /collaborate --mode parallel --task "idea generation" --models "gemini,claude"
27
27
  ```
28
- - 동일 μž‘μ—…μ„ μ—¬λŸ¬ AIκ°€ λ™μ‹œ μˆ˜ν–‰
29
- - κ²°κ³Ό 비ꡐ ν›„ 졜적 선택
28
+ - Multiple AIs perform same task simultaneously
29
+ - Compare results and select best
30
30
 
31
- ### 2. Sequential (순차 ν•Έλ“œμ˜€ν”„)
31
+ ### 2. Sequential (Sequential Handoff)
32
32
  ```bash
33
33
  /collaborate --mode sequential --chain "code_review"
34
34
  ```
35
- - AI κ°„ 릴레이둜 점진적 κ°œμ„ 
36
- - 체인: `code_review`, `planning_review`
35
+ - Relay between AIs for progressive improvement
36
+ - Chains: `code_review`, `planning_review`
37
37
 
38
- ### 3. Debate (ν† λ‘ )
38
+ ### 3. Debate (Discussion)
39
39
  ```bash
40
- /collaborate --mode debate --topic "μ•„ν‚€ν…μ²˜ 선택" --rounds 3
40
+ /collaborate --mode debate --topic "architecture choice" --rounds 3
41
41
  ```
42
- - AI κ°„ ν† λ‘ μœΌλ‘œ 졜적 κ²°λ‘  λ„μΆœ
43
- - λ‹€μ–‘ν•œ 관점 비ꡐ
42
+ - AI debate to reach optimal conclusion
43
+ - Compare various perspectives
44
44
 
45
- ## 사전 체인 μ •μ˜
45
+ ## Predefined Chains
46
46
 
47
47
  ### code_review
48
- 1. Claude: μ΄ˆμ•ˆ μž‘μ„±
49
- 2. Gemini: 창의적 κ°œμ„ 
50
- 3. Codex: 기술 검증
48
+ 1. Claude: Draft creation
49
+ 2. Gemini: Creative improvement
50
+ 3. Codex: Technical verification
51
51
 
52
52
  ### planning_review
53
- 1. Gemini: 아이디어 λ°œμ‚°
54
- 2. Claude: μ‹€ν˜„ κ°€λŠ₯μ„± 뢄석
55
- 3. Claude: μ΅œμ’… κ³„νš 수립
53
+ 1. Gemini: Idea divergence
54
+ 2. Claude: Feasibility analysis
55
+ 3. Claude: Final plan establishment
56
56
 
57
- ## 좜λ ₯
57
+ ## Output
58
58
 
59
- - 각 AI 결과물
60
- - 비ꡐ 뢄석 리포트
61
- - μ΅œμ’… 선택/병합 κ²°κ³Ό
62
- - μ €μž₯: `state/collaborations/{task_id}/`
59
+ - Each AI's results
60
+ - Comparative analysis report
61
+ - Final selection/merge result
62
+ - Storage: `state/collaborations/{task_id}/`
63
63
 
64
- ## μ˜ˆμ‹œ
64
+ ## Examples
65
65
 
66
66
  ```bash
67
- # κΈ°λ³Έ 병렬 ν˜‘μ—…
68
- /collaborate --task "μ‚¬μš©μž 인증 섀계"
67
+ # Basic parallel collaboration
68
+ /collaborate --task "user authentication design"
69
69
 
70
- # μ½”λ“œ 리뷰 체인
70
+ # Code review chain
71
71
  /collaborate --mode sequential --chain code_review
72
72
 
73
- # μ•„ν‚€ν…μ²˜ ν† λ‘ 
74
- /collaborate --mode debate --topic "λ§ˆμ΄ν¬λ‘œμ„œλΉ„μŠ€ vs λͺ¨λ†€λ¦¬μ‹"
73
+ # Architecture debate
74
+ /collaborate --mode debate --topic "microservices vs monolithic"
75
75
  ```
76
76
 
77
- ## μ„€μ •
77
+ ## Configuration
78
78
 
79
- `config/ai_collaboration.yaml` μ°Έμ‘°
79
+ See `config/ai_collaboration.yaml`
80
80
 
81
- ## κ΄€λ ¨ μ»€λ§¨λ“œ
81
+ ## Related Commands
82
82
 
83
- - `/benchmark` - AI λͺ¨λΈ λ²€μΉ˜λ§ˆν‚Ή
84
- - `/gemini` - Gemini 직접 호좜
85
- - `/codex` - Codex 직접 호좜
83
+ - `/benchmark` - AI model benchmarking
84
+ - `/gemini` - Direct Gemini call
85
+ - `/codex` - Direct Codex call
@@ -1,46 +1,46 @@
1
1
  # /context
2
2
 
3
- μ»¨ν…μŠ€νŠΈ μƒνƒœλ₯Ό ν™•μΈν•˜κ³  κ΄€λ¦¬ν•©λ‹ˆλ‹€.
3
+ Check and manage context state.
4
4
 
5
- ## μ‚¬μš©λ²•
5
+ ## Usage
6
6
  ```
7
- /context # ν˜„μž¬ μƒνƒœ 확인
8
- /context --save [desc] # μŠ€λƒ…μƒ· μ €μž₯
9
- /context --compress # μ••μΆ• μ‹€ν–‰
10
- /context --restore # μ €μž₯된 μƒνƒœ 볡ꡬ
11
- /context --clean # 였래된 μŠ€λƒ…μƒ· 정리
7
+ /context # Check current state
8
+ /context --save [desc] # Save snapshot
9
+ /context --compress # Execute compression
10
+ /context --restore # Restore saved state
11
+ /context --clean # Clean old snapshots
12
12
  ```
13
13
 
14
- ## λ™μž‘
14
+ ## Actions
15
15
 
16
- ### μƒνƒœ 확인 (`/context`)
17
- - μΆ”μ • 토큰 μ‚¬μš©λŸ‰ ν‘œμ‹œ
18
- - μž„κ³„κ°’ λŒ€λΉ„ μƒνƒœ
19
- - μ €μž₯된 μŠ€λƒ…μƒ· λͺ©λ‘
16
+ ### State Check (`/context`)
17
+ - Display estimated token usage
18
+ - State relative to thresholds
19
+ - List of saved snapshots
20
20
 
21
- ### μŠ€λƒ…μƒ· μ €μž₯ (`--save`)
22
- - ν˜„μž¬ μƒνƒœλ₯Ό state.md둜 μ €μž₯
23
- - μ„€λͺ… μΆ”κ°€ κ°€λŠ₯
24
- - state/context/ 디렉토리에 μ €μž₯
21
+ ### Save Snapshot (`--save`)
22
+ - Save current state as state.md
23
+ - Can add description
24
+ - Save to state/context/ directory
25
25
 
26
- ### μ••μΆ• μ‹€ν–‰ (`--compress`)
27
- - context-compression μŠ€ν‚¬ ν™œμ„±ν™”
28
- - λΆˆν•„μš”ν•œ μ»¨ν…μŠ€νŠΈ 정리
29
- - 핡심 μ •λ³΄λ§Œ μœ μ§€
26
+ ### Execute Compression (`--compress`)
27
+ - Activate context-compression skill
28
+ - Clean unnecessary context
29
+ - Keep only essential information
30
30
 
31
- ### 볡ꡬ (`--restore`)
32
- - μ €μž₯된 μŠ€λƒ…μƒ·μ—μ„œ 볡ꡬ
33
- - /clear ν›„ μ‚¬μš©
31
+ ### Restore (`--restore`)
32
+ - Restore from saved snapshot
33
+ - Use after /clear
34
34
 
35
- ## μ‹€ν–‰ 슀크립트
35
+ ## Execution Script
36
36
 
37
37
  ```bash
38
38
  scripts/context-manager.sh "$ARGUMENTS"
39
39
  ```
40
40
 
41
- ## 좜λ ₯ μ˜ˆμ‹œ
41
+ ## Output Examples
42
42
 
43
- ### μƒνƒœ 확인
43
+ ### State Check
44
44
 
45
45
  ```
46
46
  /context
@@ -49,83 +49,83 @@ scripts/context-manager.sh "$ARGUMENTS"
49
49
  πŸ“Š Context Status
50
50
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
51
51
 
52
- 토큰 μ‚¬μš©λŸ‰: ~45,230 / 80,000
53
- μƒνƒœ: β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘β–‘β–‘β–‘β–‘β–‘β–‘ 56% [정상]
52
+ Token usage: ~45,230 / 80,000
53
+ Status: β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘β–‘β–‘β–‘β–‘β–‘β–‘ 56% [Normal]
54
54
 
55
- μž„κ³„κ°’:
56
- β€’ κ²½κ³  (50k): 아직 μ—¬μœ  있음
57
- β€’ ν•œλ„ (80k): ~35,000 토큰 λ‚¨μŒ
55
+ Thresholds:
56
+ β€’ Warning (50k): Still have room
57
+ β€’ Limit (80k): ~35,000 tokens remaining
58
58
 
59
- ν˜„μž¬ μŠ€ν…Œμ΄μ§€: 04-ui-ux
60
- λŒ€ν™” λ©”μ‹œμ§€: 28개
59
+ Current stage: 04-ui-ux
60
+ Conversation messages: 28
61
61
 
62
- [μ €μž₯된 μŠ€λƒ…μƒ·]
63
- β€’ state-20240120-1030.md (03-planning μ™„λ£Œ μ‹œμ )
64
- β€’ state-20240120-1430.md (04-ui-ux μ‹œμž‘)
62
+ [Saved Snapshots]
63
+ β€’ state-20240120-1030.md (03-planning completion)
64
+ β€’ state-20240120-1430.md (04-ui-ux start)
65
65
 
66
66
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
67
67
  ```
68
68
 
69
- ### κ²½κ³  μƒνƒœ
69
+ ### Warning State
70
70
 
71
71
  ```
72
72
  /context
73
73
 
74
74
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
75
- ⚠️ Context Status - 경고
75
+ ⚠️ Context Status - Warning
76
76
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
77
77
 
78
- 토큰 μ‚¬μš©λŸ‰: ~52,000 / 80,000
79
- μƒνƒœ: β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘β–‘β–‘ 65% [κ²½κ³ ]
78
+ Token usage: ~52,000 / 80,000
79
+ Status: β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘β–‘β–‘ 65% [Warning]
80
80
 
81
- ⚠️ κ²½κ³  μž„κ³„κ°’(50k) 초과!
81
+ ⚠️ Warning threshold (50k) exceeded!
82
82
 
83
- ꢌμž₯ 쑰치:
84
- 1. /context --compress 둜 μ••μΆ•
85
- 2. /context --save ν›„ /clear
83
+ Recommended actions:
84
+ 1. Compress with /context --compress
85
+ 2. /context --save then /clear
86
86
 
87
87
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
88
88
  ```
89
89
 
90
- ### μŠ€λƒ…μƒ· μ €μž₯
90
+ ### Save Snapshot
91
91
 
92
92
  ```
93
- /context --save "UI 섀계 μ™„λ£Œ"
93
+ /context --save "UI design completed"
94
94
 
95
95
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
96
96
  πŸ’Ύ Context Snapshot Saved
97
97
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
98
98
 
99
- 파일: state/context/state-20240120-1530.md
100
- μ„€λͺ…: UI 섀계 μ™„λ£Œ
101
- μŠ€ν…Œμ΄μ§€: 04-ui-ux
102
- 토큰: ~45,000
99
+ File: state/context/state-20240120-1530.md
100
+ Description: UI design completed
101
+ Stage: 04-ui-ux
102
+ Tokens: ~45,000
103
103
 
104
- [μ €μž₯ λ‚΄μš©]
105
- βœ“ ν˜„μž¬ μŠ€ν…Œμ΄μ§€ 정보
106
- βœ“ μ§„ν–‰ 상황
107
- βœ“ 핡심 결정사항 (5개)
108
- βœ“ μ°Έμ‘° 파일 λͺ©λ‘
104
+ [Saved Content]
105
+ βœ“ Current stage information
106
+ βœ“ Progress status
107
+ βœ“ Key decisions (5)
108
+ βœ“ Reference file list
109
109
 
110
- 볡ꡬ: /context --restore state-20240120-1530.md
110
+ Recovery: /context --restore state-20240120-1530.md
111
111
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
112
112
  ```
113
113
 
114
- ## μ˜΅μ…˜
114
+ ## Options
115
115
 
116
- | μ˜΅μ…˜ | μ„€λͺ… |
117
- |------|------|
118
- | (μ—†μŒ) | ν˜„μž¬ μƒνƒœ 확인 |
119
- | `--save [desc]` | μŠ€λƒ…μƒ· μ €μž₯ |
120
- | `--compress` | μ»¨ν…μŠ€νŠΈ μ••μΆ• |
121
- | `--restore [file]` | μŠ€λƒ…μƒ· 볡ꡬ |
122
- | `--list` | μŠ€λƒ…μƒ· λͺ©λ‘ |
123
- | `--clean` | 였래된 μŠ€λƒ…μƒ· 정리 |
124
- | `--json` | JSON ν˜•μ‹ 좜λ ₯ |
116
+ | Option | Description |
117
+ |--------|-------------|
118
+ | (none) | Check current state |
119
+ | `--save [desc]` | Save snapshot |
120
+ | `--compress` | Context compression |
121
+ | `--restore [file]` | Restore snapshot |
122
+ | `--list` | Snapshot list |
123
+ | `--clean` | Clean old snapshots |
124
+ | `--json` | JSON format output |
125
125
 
126
- ## μ„€μ • μ°Έμ‘°
126
+ ## Configuration Reference
127
127
 
128
- settings.json의 context μ„€μ •:
128
+ settings.json context settings:
129
129
 
130
130
  ```json
131
131
  {
@@ -137,18 +137,18 @@ settings.json의 context μ„€μ •:
137
137
  }
138
138
  ```
139
139
 
140
- ## κ΄€λ ¨ μŠ€ν‚¬
140
+ ## Related Skills
141
141
 
142
- - `context-compression` - μžλ™ μ••μΆ• μŠ€ν‚¬
142
+ - `context-compression` - Auto compression skill
143
143
 
144
- ## κ΄€λ ¨ λͺ…λ Ήμ–΄
144
+ ## Related Commands
145
145
 
146
- - `/status` - νŒŒμ΄ν”„λΌμΈ μƒνƒœ
147
- - `/checkpoint` - 체크포인트 생성
148
- - `/restore` - 체크포인트 볡ꡬ
146
+ - `/status` - Pipeline status
147
+ - `/checkpoint` - Create checkpoint
148
+ - `/restore` - Restore checkpoint
149
149
 
150
150
  ## Tips
151
151
 
152
- - κΈ΄ μž‘μ—… μ „ `/context --save` ꢌμž₯
153
- - 50k κ²½κ³  μ‹œ `/context --compress` μ‹€ν–‰
154
- - /clear ν›„ `/context --restore` 둜 볡ꡬ
152
+ - Recommended: `/context --save` before long tasks
153
+ - Run `/context --compress` at 50k warning
154
+ - Recover with `/context --restore` after /clear