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,105 +1,101 @@
1
1
  # Stage 05: Task Management
2
2
 
3
- > ⚠️ **Notion 태스크 생성 규칙**
4
- > - 태스크는 반드시 **하나씩 순차적으로** 생성하세요
5
- > - 모든 태스크에 **Status** 필드 필수 (기본값: To Do)
6
- > - **Order** 필드로 순서 지정 (View 정렬은 수동 설정)
7
- > - 스키마: `templates/task_schema.yaml` | 가이드: `templates/notion_integration.md`
8
-
9
- 태스크 분해 스프린트 계획 단계
10
-
11
- ## 🎭 페르소나: Project Organizer
12
-
13
- > 당신은 Project Organizer입니다.
14
- > 모든 작업을 실행 가능한 작은 단위로 분해하세요.
15
- > 태스크는 명확한 완료 조건과 의존성을 가져야 합니다.
16
-
17
- ### 특성
18
- - 체계적 분해
19
- - 의존성 분석
20
- - 우선순위 설정
21
- - 실행 가능성
22
-
23
- ### 권장 행동
24
- - 작은 단위로 분해
25
- - 명확한 완료 조건
26
- - 의존성 명시
27
- - 실행 가능한 태스크
28
-
29
- ### 지양 행동
30
- - 모호한 태스크
31
- - 거대한 단위
32
- - 의존성 무시
33
-
34
- ### AI 설정
35
- - **Temperature**: 0.3 (높은 정밀도)
36
- - **정밀도**: High
37
-
38
- ## 실행 모델
39
- - **Primary**: ClaudeCode (구조화된 태스크 분해)
3
+ > **Notion Task Creation Rules**
4
+ > - Tasks must be created **one at a time sequentially**
5
+ > - **Status** field required for all tasks (default: To Do)
6
+ > - Specify order with **Order** field (View sorting is manual)
7
+ > - Schema: `templates/task_schema.yaml` | Guide: `templates/notion_integration.md`
8
+
9
+ Task breakdown and sprint planning stage
10
+
11
+ ## Persona: Project Organizer
12
+
13
+ > You are a Project Organizer.
14
+ > Break down all work into small, actionable units.
15
+ > Each task must have clear completion criteria and dependencies.
16
+
17
+ ### Characteristics
18
+ - Systematic breakdown
19
+ - Dependency analysis
20
+ - Priority setting
21
+ - Actionability
22
+
23
+ ### Recommended Actions
24
+ - Break into small units
25
+ - Clear completion criteria
26
+ - Explicit dependencies
27
+ - Actionable tasks
28
+
29
+ ### Actions to Avoid
30
+ - Vague tasks
31
+ - Large units
32
+ - Ignoring dependencies
33
+
34
+ ### AI Settings
35
+ - **Temperature**: 0.3 (high precision)
36
+ - **Precision**: High
37
+
38
+ ## Execution Model
39
+ - **Primary**: ClaudeCode (structured task breakdown)
40
40
  - **Mode**: Plan Mode
41
41
 
42
- ## 목표
43
- 1. 기능별 태스크 분해
44
- 2. 의존성 맵핑
45
- 3. 스프린트 계획 수립
46
- 4. 마일스톤별 산출물 정의
42
+ ## Goals
43
+ 1. Feature-based task breakdown
44
+ 2. Dependency mapping
45
+ 3. Sprint plan establishment
46
+ 4. Deliverables per milestone definition
47
47
 
48
- ## 입력 파일
48
+ ## Input Files
49
49
  - `../03-planning/outputs/project_plan.md`
50
50
  - `../03-planning/outputs/architecture.md`
51
51
  - `../04-ui-ux/outputs/design_system.md`
52
52
  - `../04-ui-ux/HANDOFF.md`
53
53
 
54
- ## 출력 파일
55
- - `outputs/tasks.md` - 태스크 목록
56
- - `outputs/sprint_plan.md` - 스프린트 계획
57
- - `outputs/milestones.md` - 마일스톤 정의
58
- - `HANDOFF.md` - 다음 스테이지 인계 문서
54
+ ## Output Files
55
+ - `outputs/tasks.md` - Task list
56
+ - `outputs/sprint_plan.md` - Sprint plan
57
+ - `outputs/milestones.md` - Milestone definitions
58
+ - `HANDOFF.md` - Handoff document for next stage
59
59
 
60
- ## 워크플로우
60
+ ## Workflow
61
61
 
62
- ### 1. 태스크 분해
63
- - 기능에픽스토리태스크
64
- - 예상 작업량 산정
65
- - 기술적 의존성 파악
62
+ ### 1. Task Breakdown
63
+ - FeatureEpicStoryTask
64
+ - Estimate work effort
65
+ - Identify technical dependencies
66
66
 
67
- ### 2. 우선순위 결정
68
- - MoSCoW 분류
69
- - 비즈니스 가치 vs 기술 복잡도
70
- - 리스크 기반 우선순위
67
+ ### 2. Priority Decision
68
+ - MoSCoW classification
69
+ - Business value vs technical complexity
70
+ - Risk-based prioritization
71
71
 
72
- ### 3. 스프린트 계획
73
- - 스프린트 길이 결정
74
- - 용량 기반 할당
75
- - 버퍼 포함
72
+ ### 3. Sprint Planning
73
+ - Determine sprint length
74
+ - Capacity-based allocation
75
+ - Include buffer
76
76
 
77
- ### 4. 마일스톤 정의
78
- - 체크포인트별 산출물
79
- - 성공 기준
80
- - 검증 방법
77
+ ### 4. Milestone Definition
78
+ - Deliverables per checkpoint
79
+ - Success criteria
80
+ - Validation methods
81
81
 
82
- ## 태스크 형식
82
+ ## Task Format
83
83
  ```markdown
84
- ## TASK-XXX: [태스크명]
85
- - **에픽**: [에픽명]
86
- - **스토리**: [유저스토리]
87
- - **우선순위**: Must/Should/Could
88
- - **예상 시간**: Xh
89
- - **의존성**: [TASK-YYY, TASK-ZZZ]
90
- - **담당 스테이지**: 06-implementation
84
+ ## TASK-XXX: [Task Name]
85
+ - **Epic**: [Epic Name]
86
+ - **Story**: [User Story]
87
+ - **Priority**: Must/Should/Could
88
+ - **Estimated Time**: Xh
89
+ - **Dependencies**: [TASK-YYY, TASK-ZZZ]
90
+ - **Assigned Stage**: 06-implementation
91
91
  ```
92
92
 
93
- ## 완료 조건
94
- - [ ] 전체 태스크 목록 작성
95
- - [ ] 의존성 그래프 생성
96
- - [ ] 스프린트 3 이상 계획
97
- - [ ] 마일스톤 산출물 정의
98
- - [ ] HANDOFF.md 생성
99
-
100
- ## 다음 스테이지
101
- → **06-implementation**: 핵심 기능 구현
102
-
103
-
104
-
93
+ ## Completion Criteria
94
+ - [ ] Complete task list creation
95
+ - [ ] Generate dependency graph
96
+ - [ ] Plan 3+ sprints
97
+ - [ ] Define milestone deliverables
98
+ - [ ] Generate HANDOFF.md
105
99
 
100
+ ## Next Stage
101
+ → **06-implementation**: Core feature implementation
@@ -3,7 +3,7 @@
3
3
  stage:
4
4
  id: "05-task-management"
5
5
  name: "Task Management"
6
- description: "태스크 분해 스프린트 계획"
6
+ description: "Task breakdown and sprint planning"
7
7
 
8
8
  models:
9
9
  primary: "claudecode"
@@ -28,32 +28,32 @@ inputs:
28
28
  outputs:
29
29
  required:
30
30
  - name: "tasks.md"
31
- description: "태스크 목록"
31
+ description: "Task list"
32
32
  - name: "sprint_plan.md"
33
- description: "스프린트 계획"
33
+ description: "Sprint plan"
34
34
  - name: "milestones.md"
35
- description: "마일스톤 정의"
35
+ description: "Milestone definitions"
36
36
  - name: "HANDOFF.md"
37
37
 
38
- # Notion 연동 설정 (Issue #4, #5, #6, #8, #16 해결)
38
+ # Notion integration settings (Issue #4, #5, #6, #8, #16 resolution)
39
39
  notion_integration:
40
40
  enabled: true
41
41
  schema: "templates/task_schema.yaml"
42
42
  guide: "templates/notion_integration.md"
43
43
 
44
- # 태스크 생성 규칙
44
+ # Task creation rules
45
45
  task_creation:
46
- mode: "sequential" # 순차 생성 필수!
47
- batch_size: 1 # 번에 하나씩
48
- delay_ms: 100 # 생성 딜레이
46
+ mode: "sequential" # Sequential creation required!
47
+ batch_size: 1 # One at a time
48
+ delay_ms: 100 # Delay between creations
49
49
 
50
- # 필수 필드
50
+ # Required fields
51
51
  required_fields:
52
52
  - "Task Name"
53
- - "Status" # Issue #16: 필수!
54
- - "Order" # Issue #5: 정렬용!
53
+ - "Status" # Issue #16: Required!
54
+ - "Order" # Issue #5: For sorting!
55
55
 
56
- # 기본값
56
+ # Defaults
57
57
  defaults:
58
58
  status: "To Do"
59
59
  priority: "Medium"
@@ -68,10 +68,10 @@ prompts:
68
68
 
69
69
  completion:
70
70
  checklist:
71
- - "전체 태스크 목록 작성"
72
- - "의존성 그래프 생성"
73
- - "스프린트 3 이상 계획"
74
- - "마일스톤 산출물 정의"
71
+ - "Complete task list creation"
72
+ - "Generate dependency graph"
73
+ - "Plan 3+ sprints"
74
+ - "Define milestone deliverables"
75
75
 
76
76
  transition:
77
77
  next_stage: "06-implementation"
@@ -1,53 +1,53 @@
1
- # AI 협업 프롬프트 - Task Management
1
+ # AI Collaboration Prompt - Task Management
2
2
 
3
- ## 협업 모드: Sequential Review
3
+ ## Collaboration Mode: Sequential Review
4
4
 
5
- 스테이지에서는 **순차적 리뷰** 모드를 사용하여 태스크 분해의 완전성을 보장합니다.
5
+ This stage uses **sequential review** mode to ensure completeness of task breakdown.
6
6
 
7
- ### 참여 모델
8
- - **ClaudeCode**: 태스크 분해, 의존성 분석
7
+ ### Participating Models
8
+ - **ClaudeCode**: Task breakdown, dependency analysis
9
9
 
10
- ### 협업 프롬프트
10
+ ### Collaboration Prompt
11
11
 
12
12
  ```
13
- # 단일 모델이지만 반복 검토
13
+ # Single model with iterative review
14
14
  /collaborate --mode sequential --chain "claudecode:decompose -> claudecode:review"
15
15
  ```
16
16
 
17
- ### 작업 흐름
17
+ ### Workflow
18
18
 
19
- 1. **초기 분해**: 기능에픽스토리태스크
20
- 2. **의존성 분석**: 태스크 관계 파악
21
- 3. **검토 조정**: 누락/중복 태스크 식별
19
+ 1. **Initial Breakdown**: FeatureEpicStoryTask
20
+ 2. **Dependency Analysis**: Identify task relationships
21
+ 3. **Review and Adjustment**: Identify missing/duplicate tasks
22
22
 
23
- ### 태스크 품질 기준
23
+ ### Task Quality Criteria
24
24
 
25
- | 기준 | 설명 |
26
- |------|------|
27
- | 원자성 | 이상 분해 불가 |
28
- | 명확성 | 완료 조건 명확 |
29
- | 독립성 | 최소한의 의존성 |
30
- | 추정 가능 | 시간 추정 가능 |
25
+ | Criteria | Description |
26
+ |----------|-------------|
27
+ | Atomicity | Cannot be broken down further |
28
+ | Clarity | Clear completion criteria |
29
+ | Independence | Minimal dependencies |
30
+ | Estimable | Time estimation possible |
31
31
 
32
- ### Notion 통합
32
+ ### Notion Integration
33
33
 
34
- 태스크 생성 반드시 준수:
35
- - 하나씩 순차적으로 생성
36
- - Status 필드 필수 (기본값: To Do)
37
- - Order 필드로 순서 지정
34
+ Must follow when creating tasks:
35
+ - Create one at a time sequentially
36
+ - Status field required (default: To Do)
37
+ - Specify order with Order field
38
38
 
39
- ### 출력 형식
39
+ ### Output Format
40
40
 
41
41
  ```markdown
42
- ## 태스크 분해 결과
42
+ ## Task Breakdown Results
43
43
 
44
- ### 에픽 1: [에픽명]
45
- #### 스토리 1.1: [스토리명]
46
- - TASK-001: [태스크] (2h)
47
- - TASK-002: [태스크] (4h)
44
+ ### Epic 1: [Epic Name]
45
+ #### Story 1.1: [Story Name]
46
+ - TASK-001: [Task] (2h)
47
+ - TASK-002: [Task] (4h)
48
48
  ...
49
49
 
50
- ### 의존성 그래프
50
+ ### Dependency Graph
51
51
  TASK-001 → TASK-003
52
52
  TASK-002 → TASK-004
53
53
  ...
@@ -1,66 +1,66 @@
1
- # 산출물 검증 프롬프트 - Task Management
1
+ # Output Validation Prompt - Task Management
2
2
 
3
- ## 검증 대상
3
+ ## Validation Targets
4
4
 
5
- | 산출물 | 필수 조건 | 검증 방법 |
6
- |--------|----------|----------|
7
- | `tasks.md` | 전체 태스크 목록 | 구조 확인 |
8
- | `sprint_plan.md` | 스프린트 3개+ | 수량 확인 |
9
- | `milestones.md` | 산출물 정의 | 구조 확인 |
10
- | `HANDOFF.md` | 스프린트 태스크 | 항목 확인 |
5
+ | Output | Required Conditions | Validation Method |
6
+ |--------|---------------------|-------------------|
7
+ | `tasks.md` | Complete task list | Structure verification |
8
+ | `sprint_plan.md` | 3+ sprints | Count verification |
9
+ | `milestones.md` | Deliverables defined | Structure verification |
10
+ | `HANDOFF.md` | First sprint tasks | Item verification |
11
11
 
12
- ## 검증 명령
12
+ ## Validation Command
13
13
 
14
14
  ```bash
15
15
  /validate --stage 05-task-management
16
16
  ```
17
17
 
18
- ## 품질 기준
18
+ ## Quality Criteria
19
19
 
20
20
  ### tasks.md
21
- - [ ] MoSCoW 분류 적용
22
- - [ ] 태스크에 예상 시간
23
- - [ ] 의존성 명시
24
- - [ ] 담당 스테이지 지정
21
+ - [ ] MoSCoW classification applied
22
+ - [ ] Estimated time for each task
23
+ - [ ] Dependencies specified
24
+ - [ ] Assigned stage designated
25
25
 
26
26
  ### sprint_plan.md
27
- - [ ] 스프린트 3 이상
28
- - [ ] 스프린트 용량 계산
29
- - [ ] 버퍼 시간 포함
30
- - [ ] 우선순위 기반 할당
27
+ - [ ] 3+ sprints
28
+ - [ ] Capacity calculation per sprint
29
+ - [ ] Buffer time included
30
+ - [ ] Priority-based allocation
31
31
 
32
32
  ### milestones.md
33
- - [ ] 마일스톤별 산출물 정의
34
- - [ ] 성공 기준 명시
35
- - [ ] 검증 방법 포함
33
+ - [ ] Deliverables defined per milestone
34
+ - [ ] Success criteria specified
35
+ - [ ] Validation methods included
36
36
 
37
37
  ### HANDOFF.md
38
- - [ ] 스프린트 1 태스크 목록
39
- - [ ] 의존성 그래프
40
- - [ ] 우선 구현 항목
38
+ - [ ] Sprint 1 task list
39
+ - [ ] Dependency graph
40
+ - [ ] Priority implementation items
41
41
 
42
- ## 자동 검증 스크립트
42
+ ## Automated Validation Script
43
43
 
44
44
  ```bash
45
- # 태스크 확인
45
+ # Check task count
46
46
  grep -c "^- TASK-" outputs/tasks.md
47
47
 
48
- # 스프린트 확인
48
+ # Check sprint count
49
49
  grep -c "^## Sprint" outputs/sprint_plan.md
50
50
 
51
- # 마일스톤 확인
51
+ # Check milestone count
52
52
  grep -c "^## Milestone" outputs/milestones.md
53
53
 
54
- # 의존성 그래프 존재 확인
54
+ # Check dependency graph existence
55
55
  grep -c "→" outputs/tasks.md
56
56
  ```
57
57
 
58
- ## 태스크 품질 체크
58
+ ## Task Quality Check
59
59
 
60
60
  ```bash
61
- # 예상 시간 누락 확인
61
+ # Check for missing estimated time
62
62
  grep -E "^- TASK-" outputs/tasks.md | grep -v -E "\([0-9]+h\)"
63
63
 
64
- # 의존성 누락 확인
65
- grep -E "^- TASK-" outputs/tasks.md | grep -v "의존성"
64
+ # Check for missing dependencies
65
+ grep -E "^- TASK-" outputs/tasks.md | grep -v "dependency"
66
66
  ```
@@ -1,53 +1,53 @@
1
- # Notion 연동 가이드
1
+ # Notion Integration Guide
2
2
 
3
- > claude-symphony 태스크 관리 - Notion 데이터베이스 연동
3
+ > claude-symphony Task Management - Notion Database Integration
4
4
 
5
- ## 주의사항 (Issue #5, #6, #8, #16 해결)
5
+ ## Important Notes (Issue #5, #6, #8, #16 Resolution)
6
6
 
7
- ### ⚠️ 순차 생성 필수
7
+ ### Sequential Creation Required
8
8
 
9
- Notion API 태스크를 생성할 **반드시 하나씩 순차적으로** 생성해야 합니다.
9
+ When creating tasks via Notion API, **tasks must be created one at a time sequentially**.
10
10
 
11
11
  ```
12
- 잘못된 방식 (병렬 생성)
12
+ Incorrect (parallel creation)
13
13
  Promise.all([
14
- createTask("태스크 1"),
15
- createTask("태스크 2"),
16
- createTask("태스크 3")
14
+ createTask("Task 1"),
15
+ createTask("Task 2"),
16
+ createTask("Task 3")
17
17
  ])
18
18
 
19
- 올바른 방식 (순차 생성)
20
- await createTask("태스크 1", { order: 1 })
21
- await createTask("태스크 2", { order: 2 })
22
- await createTask("태스크 3", { order: 3 })
19
+ Correct (sequential creation)
20
+ await createTask("Task 1", { order: 1 })
21
+ await createTask("Task 2", { order: 2 })
22
+ await createTask("Task 3", { order: 3 })
23
23
  ```
24
24
 
25
- ### ⚠️ Status 필드 필수
25
+ ### Status Field Required
26
26
 
27
- 모든 태스크는 반드시 `Status` 필드를 포함해야 합니다.
28
- - 기본값: `To Do`
29
- - 생성 명시적으로 지정
27
+ All tasks must include the `Status` field.
28
+ - Default: `To Do`
29
+ - Explicitly specify when creating
30
30
 
31
- ### ⚠️ Order 필드로 정렬
31
+ ### Sorting with Order Field
32
32
 
33
- Notion 데이터베이스 View 정렬은 수동으로 설정해야 합니다:
33
+ Notion database View sorting must be configured manually:
34
34
 
35
- 1. 데이터베이스 View 열기
36
- 2. `Sort` 클릭
37
- 3. `Order` 필드 선택
38
- 4. `Ascending` 정렬
35
+ 1. Open database View
36
+ 2. Click `Sort`
37
+ 3. Select `Order` field
38
+ 4. Set to `Ascending` order
39
39
 
40
40
  ---
41
41
 
42
- ## 데이터베이스 생성 절차
42
+ ## Database Creation Procedure
43
43
 
44
- ### 1. 데이터베이스 생성
44
+ ### 1. Create Database
45
45
 
46
46
  ```javascript
47
- // MCP Notion 도구 사용 예시
47
+ // MCP Notion tool usage example
48
48
  await notion.createDatabase({
49
- parent: { page_id: "프로젝트_페이지_ID" },
50
- title: [{ text: { content: "프로젝트명 Tasks" } }],
49
+ parent: { page_id: "PROJECT_PAGE_ID" },
50
+ title: [{ text: { content: "Project Tasks" } }],
51
51
  properties: {
52
52
  "Task Name": { title: {} },
53
53
  "Status": {
@@ -98,79 +98,79 @@ await notion.createDatabase({
98
98
  })
99
99
  ```
100
100
 
101
- ### 2. 태스크 생성 (순차적)
101
+ ### 2. Create Tasks (Sequential)
102
102
 
103
103
  ```javascript
104
- // 태스크 목록
104
+ // Task list
105
105
  const tasks = [
106
- { name: "프로젝트 초기 설정", priority: "High" },
107
- { name: "기본 UI 컴포넌트 구현", priority: "High" },
108
- { name: "API 연동", priority: "Medium" },
106
+ { name: "Project initial setup", priority: "High" },
107
+ { name: "Basic UI component implementation", priority: "High" },
108
+ { name: "API integration", priority: "Medium" },
109
109
  // ...
110
110
  ];
111
111
 
112
- // 순차 생성 (중요!)
112
+ // Sequential creation (important!)
113
113
  for (let i = 0; i < tasks.length; i++) {
114
114
  await notion.createPage({
115
- parent: { database_id: "데이터베이스_ID" },
115
+ parent: { database_id: "DATABASE_ID" },
116
116
  properties: {
117
117
  "Task Name": { title: [{ text: { content: tasks[i].name } }] },
118
- "Status": { select: { name: "To Do" } }, // 필수!
118
+ "Status": { select: { name: "To Do" } }, // Required!
119
119
  "Priority": { select: { name: tasks[i].priority } },
120
- "Order": { number: i + 1 } // 순서 보장!
120
+ "Order": { number: i + 1 } // Order guaranteed!
121
121
  }
122
122
  });
123
123
 
124
- // 순서 보장을 위한 짧은 대기
124
+ // Short delay to ensure order
125
125
  await new Promise(resolve => setTimeout(resolve, 100));
126
126
  }
127
127
  ```
128
128
 
129
129
  ---
130
130
 
131
- ## View 설정 (수동)
131
+ ## View Settings (Manual)
132
132
 
133
- Notion UI에서 직접 설정해야 합니다:
133
+ Must be configured directly in Notion UI:
134
134
 
135
- ### Board View 설정
136
- 1. `+ Add a view` 클릭
137
- 2. `Board` 선택
138
- 3. `Group by` → `Status` 선택
135
+ ### Board View Setup
136
+ 1. Click `+ Add a view`
137
+ 2. Select `Board`
138
+ 3. Set `Group by` → `Status`
139
139
 
140
- ### List View 정렬 설정
141
- 1. View에서 `...` 클릭
142
- 2. `Sort` 선택
143
- 3. `+ Add a sort`
144
- 4. `Order` → `Ascending` 선택
140
+ ### List View Sort Setup
141
+ 1. Click `...` in View
142
+ 2. Select `Sort`
143
+ 3. Click `+ Add a sort`
144
+ 4. Set `Order` → `Ascending`
145
145
 
146
- ### 필터 설정 (선택)
147
- 1. `Filter` 클릭
148
- 2. `Status` `is not` `Done` 추가
146
+ ### Filter Setup (Optional)
147
+ 1. Click `Filter`
148
+ 2. Add `Status` `is not` `Done`
149
149
 
150
150
  ---
151
151
 
152
- ## 체크리스트
152
+ ## Checklist
153
153
 
154
- - [ ] 데이터베이스 생성 완료
155
- - [ ] Status 필드 포함 확인
156
- - [ ] Order 필드 포함 확인
157
- - [ ] 태스크 순차 생성 완료
158
- - [ ] Board View 설정 (Status 그룹화)
159
- - [ ] List View 정렬 설정 (Order 오름차순)
154
+ - [ ] Database creation complete
155
+ - [ ] Status field included
156
+ - [ ] Order field included
157
+ - [ ] Sequential task creation complete
158
+ - [ ] Board View setup (Status grouping)
159
+ - [ ] List View sort setup (Order ascending)
160
160
 
161
161
  ---
162
162
 
163
- ## 문제 해결
163
+ ## Troubleshooting
164
164
 
165
- ### 태스크 순서가 뒤죽박죽인 경우
166
- 1. List View에서 `Order` 정렬 확인
167
- 2. Order 값이 누락된 태스크 수정
168
- 3. 필요시 Order 재할당
165
+ ### Tasks are out of order
166
+ 1. Check `Order` sort in List View
167
+ 2. Fix tasks with missing Order values
168
+ 3. Reassign Order values if needed
169
169
 
170
- ### Status 필드가 없는 경우
171
- 1. 데이터베이스 속성에서 `Status` 추가
172
- 2. 기존 태스크에 Status 할당
170
+ ### Status field missing
171
+ 1. Add `Status` in database properties
172
+ 2. Assign Status values to existing tasks
173
173
 
174
- ### View 정렬이 저장되지 않는 경우
175
- 1. 해당 View가 저장된 View인지 확인
176
- 2. `...` → `Lock database` 해제 확인
174
+ ### View sort not saving
175
+ 1. Check if it's a saved View
176
+ 2. Verify `...` → `Lock database` is disabled