claude-symphony 0.0.4 → 0.0.6

package/template/config/implementation.yaml.template

@@ -1,180 +1,180 @@
 # Implementation Rules Template
-# claude-symphony 프로젝트별 구현 규칙 정의 (Issue #10 해결)
+# claude-symphony project-specific implementation rules definition (Issue #10 resolution)
 #
-# 이 파일은 Planning 스테이지(03)에서 프로젝트에 맞게 작성하고
-# Implementation 스테이지(06)에서 참조합니다.
+# This file is created during the Planning stage (03) to match project requirements
+# and referenced during the Implementation stage (06).
 #
-# 사용법:
-# 1. 이 템플릿을 프로젝트 루트에 implementation.yaml로 복사
-# 2. 프로젝트 요구사항에 맞게 수정
-# 3. 구현 시 이 규칙을 따름
+# Usage:
+# 1. Copy this template to the project root as implementation.yaml
+# 2. Modify according to project requirements
+# 3. Follow these rules during implementation
 
 project:
   name: "{{PROJECT_NAME}}"
   created_at: "{{TIMESTAMP}}"
 
-# 컴포넌트 규칙
+# Component Rules
 components:
-  # 컴포넌트 타입
+  # Component type
   type: "functional"  # functional | class | both
 
-  # export 방식
+  # Export method
   export: "named"     # named | default | both
 
-  # 파일당 컴포넌트 수
+  # Components per file
   single_component_per_file: true
 
-  # Props 정의 방식
+  # Props definition method
   props_definition: "interface"  # interface | type | inline
 
-  # 기본 구조
+  # Default structure
   structure: |
     // imports
     // types/interfaces
     // component
     // exports
 
-# 스타일링 규칙
+# Styling Rules
 styling:
-  # 접근 방식
+  # Approach
   approach: "css-modules"  # css-modules | styled-components | tailwind | emotion | vanilla
 
-  # 파일 위치
+  # File location
   location: "colocated"    # colocated | separate | global
 
-  # 네이밍
+  # Naming convention
   naming: "BEM"            # BEM | camelCase | kebab-case
 
-  # CSS 변수 사용
+  # CSS variables usage
   css_variables: true
 
-# 상태 관리 규칙
+# State Management Rules
 state_management:
-  # 전역 상태
+  # Global state
   global: "context"        # context | redux | zustand | recoil | jotai
 
-  # 서버 상태
+  # Server state
   server: "tanstack-query" # tanstack-query | swr | rtk-query
 
-  # 로컬 상태
+  # Local state
   local: "useState"        # useState | useReducer
 
-# 파일/폴더 네이밍
+# File/Folder Naming
 file_naming:
-  # 컴포넌트 파일
+  # Component files
   components: "PascalCase"     # PascalCase | kebab-case | camelCase
 
-  # 훅 파일
-  hooks: "camelCase"           # useXxx 패턴
+  # Hook files
+  hooks: "camelCase"           # useXxx pattern
 
-  # 유틸리티 파일
+  # Utility files
   utilities: "camelCase"
 
-  # 상수 파일
+  # Constant files
   constants: "SCREAMING_SNAKE_CASE"
 
-  # 테스트 파일
+  # Test files
   tests: "{name}.test.{ext}"   # {name}.test.{ext} | {name}.spec.{ext}
 
-# 폴더 구조
+# Folder Structure
 folder_structure:
-  # 구조 타입
+  # Structure type
   type: "feature-based"  # feature-based | type-based | atomic
 
-  # 기본 구조
+  # Default structure
   structure: |
     src/
-    ├── components/     # 공용 컴포넌트
-    ├── features/       # 기능별 모듈
+    ├── components/     # Shared components
+    ├── features/       # Feature modules
     │   └── [feature]/
     │       ├── components/
     │       ├── hooks/
     │       ├── utils/
     │       └── index.ts
-    ├── hooks/          # 공용 훅
-    ├── utils/          # 공용 유틸리티
-    ├── types/          # 타입 정의
-    ├── constants/      # 상수
-    └── styles/         # 전역 스타일
+    ├── hooks/          # Shared hooks
+    ├── utils/          # Shared utilities
+    ├── types/          # Type definitions
+    ├── constants/      # Constants
+    └── styles/         # Global styles
 
-# API 연동 규칙
+# API Integration Rules
 api:
-  # HTTP 클라이언트
+  # HTTP client
   client: "axios"       # axios | fetch | ky
 
-  # API 호출 위치
+  # API call location
   location: "services"  # services | features | hooks
 
-  # 에러 핸들링
+  # Error handling
   error_handling: "centralized"  # centralized | per-request
 
-  # 인터셉터 사용
+  # Interceptors usage
   interceptors: true
 
-# 에러 처리 규칙
+# Error Handling Rules
 error_handling:
-  # Error Boundary 사용
+  # Error Boundary usage
   error_boundary: true
 
-  # 로깅
+  # Logging
   logging: "console"    # console | service | both
 
-  # 사용자 알림
+  # User notification
   user_notification: "toast"  # toast | modal | inline
 
-# 테스트 규칙
+# Testing Rules
 testing:
-  # 테스트 프레임워크
+  # Test framework
   framework: "vitest"   # vitest | jest
 
-  # E2E 프레임워크
+  # E2E framework
   e2e: "playwright"     # playwright | cypress
 
-  # 커버리지 목표
+  # Coverage target
   coverage_target: 80
 
-  # 필수 테스트
+  # Required tests
   required:
     - "unit"
     - "integration"
 
-# 코드 품질 규칙
+# Code Quality Rules
 code_quality:
-  # 린터
+  # Linter
   linter: "eslint"
 
-  # 포매터
+  # Formatter
   formatter: "prettier"
 
-  # 타입 체크
+  # Type check
   type_check: "strict"  # strict | loose
 
-  # 커밋 훅
+  # Commit hooks
   commit_hooks: true
 
-# 문서화 규칙
+# Documentation Rules
 documentation:
-  # JSDoc 사용
+  # JSDoc usage
   jsdoc: true
 
-  # README 필수
+  # README per feature
   readme_per_feature: false
 
-  # 컴포넌트 문서
+  # Component documentation
   component_docs: "storybook"  # storybook | docz | none
 
-# 금지 사항
+# Prohibited Practices
 prohibited:
-  - "any 타입 사용 (명시적 escape 제외)"
-  - "console.log (개발 중 제외)"
-  - "인라인 스타일 (동적 스타일 제외)"
-  - "매직 넘버/스트링"
-  - "중첩 삼항 연산자"
-  - "var 키워드"
-
-# 권장 사항
+  - "Using 'any' type (except explicit escape)"
+  - "console.log (except during development)"
+  - "Inline styles (except dynamic styles)"
+  - "Magic numbers/strings"
+  - "Nested ternary operators"
+  - "var keyword"
+
+# Recommended Practices
 recommended:
-  - "Early return 패턴"
+  - "Early return pattern"
   - "Descriptive naming"
   - "Small functions (< 30 lines)"
   - "Composition over inheritance"

package/template/config/pipeline.yaml

@@ -355,3 +355,53 @@ forking:
     compare: "/fork compare"
     merge: "/fork merge"
     delete: "/fork delete"
+
+# ============================================
+# Sprint Mode Configuration
+# ============================================
+sprint_mode:
+  enabled: true
+  type: "sprint_based"  # single_pass | sprint_based | spiral
+
+  sprint_config:
+    enabled: true
+    source: "stages/05-task-management/outputs/sprint_plan.md"
+    default_sprints: 3
+    auto_detect: true
+
+    completion_criteria:
+      require_all_must_tasks: true
+      require_tests_pass: true
+      allow_force_complete: true
+
+  stage_iterations:
+    "06-implementation":
+      iterative: true
+      iteration_unit: "sprint"
+      completion_check: "all_sprints_complete"
+
+  loop_back:
+    enabled: true
+    max_stages_back: 3
+
+    triggers:
+      - name: "bug_found"
+        from_stages: ["08-qa", "09-testing"]
+        to_stage: "06-implementation"
+        auto_suggest: true
+
+      - name: "requirements_change"
+        from_stages: ["*"]
+        to_stage: "03-planning"
+        require_confirmation: true
+
+      - name: "feature_addition"
+        from_stages: ["07-refactoring"]
+        to_stage: "06-implementation"
+        auto_suggest: true
+
+    on_loop_back:
+      - create_checkpoint
+      - record_reason
+      - update_handoff
+      - notify_user

package/template/config/ui-ux.yaml

@@ -0,0 +1,31 @@
+# UI/UX Configuration
+# Settings for the 04-ui-ux stage
+
+moodboard:
+  enabled: true
+  supported_formats: [png, jpg, webp, svg]
+  max_images: 10
+
+  directories:
+    ui_references: "stages/04-ui-ux/inputs/moodboard/ui-references"
+    brand_assets: "stages/04-ui-ux/inputs/moodboard/brand-assets"
+    sketches: "stages/04-ui-ux/inputs/moodboard/sketches"
+
+  analysis:
+    # AI will analyze images using vision capabilities
+    extract_colors: true
+    identify_layouts: true
+    suggest_components: true
+
+design_system:
+  # Design system generation settings
+  auto_generate: true
+  include_spacing: true
+  include_typography: true
+  include_colors: true
+
+wireframes:
+  # Wireframe output format
+  format: "ascii"  # ascii | mermaid | both
+  responsive: true
+  breakpoints: [mobile, tablet, desktop]

package/template/scripts/config-manager.sh

@@ -0,0 +1,350 @@
+#!/bin/bash
+# config-manager.sh - Pipeline configuration manager
+# claude-symphony workflow pipeline
+
+set -e
+
+PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+CONFIG_FILE="$PROJECT_ROOT/config/pipeline.yaml"
+TASK_CONFIG_FILE="$PROJECT_ROOT/stages/05-task-management/config.yaml"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+CONFIG_HISTORY="$PROJECT_ROOT/state/config_history.json"
+
+# Color definitions
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+WHITE='\033[1;37m'
+NC='\033[0m' # No Color
+
+# Check for yq (YAML parser)
+check_yq() {
+    if ! command -v yq &> /dev/null; then
+        echo -e "${RED}Error:${NC} yq is required for configuration management."
+        echo "  Install: brew install yq (macOS) or apt install yq (Linux)"
+        exit 1
+    fi
+}
+
+# Check for jq
+check_jq() {
+    if ! command -v jq &> /dev/null; then
+        echo -e "${RED}Error:${NC} jq is required."
+        exit 1
+    fi
+}
+
+# Initialize config history if not exists
+init_config_history() {
+    if [ ! -f "$CONFIG_HISTORY" ]; then
+        mkdir -p "$(dirname "$CONFIG_HISTORY")"
+        echo '{"changes": []}' > "$CONFIG_HISTORY"
+    fi
+}
+
+# Record config change
+record_change() {
+    local CATEGORY=$1
+    local ACTION=$2
+    local VALUE=$3
+
+    init_config_history
+
+    local ENTRY=$(cat << EOF
+{
+  "timestamp": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
+  "category": "$CATEGORY",
+  "action": "$ACTION",
+  "value": "$VALUE"
+}
+EOF
+)
+
+    jq ".changes += [$ENTRY]" "$CONFIG_HISTORY" > "${CONFIG_HISTORY}.tmp" \
+        && mv "${CONFIG_HISTORY}.tmp" "$CONFIG_HISTORY"
+}
+
+# Sprint configuration
+config_sprint() {
+    local ACTION=$1
+    local VALUE=$2
+
+    check_yq
+    check_jq
+
+    case $ACTION in
+        enable)
+            yq -i '.sprint_mode.enabled = true' "$CONFIG_FILE"
+            record_change "sprint" "enable" "true"
+            echo -e "${GREEN}✅${NC} Sprint mode enabled"
+            ;;
+
+        disable)
+            yq -i '.sprint_mode.enabled = false' "$CONFIG_FILE"
+            record_change "sprint" "disable" "false"
+            echo -e "${GREEN}✅${NC} Sprint mode disabled (single-pass mode)"
+            ;;
+
+        count)
+            if [[ "$VALUE" =~ ^[0-9]+$ ]] && [ "$VALUE" -ge 1 ] && [ "$VALUE" -le 100 ]; then
+                yq -i ".sprint_mode.sprint_config.default_sprints = $VALUE" "$CONFIG_FILE"
+
+                # Also update progress.json
+                if [ -f "$PROGRESS_FILE" ]; then
+                    # Update total_sprints
+                    jq ".current_iteration.total_sprints = $VALUE" "$PROGRESS_FILE" > "${PROGRESS_FILE}.tmp" \
+                        && mv "${PROGRESS_FILE}.tmp" "$PROGRESS_FILE"
+
+                    # Regenerate sprints object
+                    local SPRINTS_JSON="{}"
+                    for ((i=1; i<=VALUE; i++)); do
+                        SPRINTS_JSON=$(echo "$SPRINTS_JSON" | jq ". + {\"Sprint $i\": {\"status\": \"pending\", \"tasks_total\": 0, \"tasks_completed\": 0, \"checkpoint_id\": null}}")
+                    done
+                    jq ".sprints = $SPRINTS_JSON" "$PROGRESS_FILE" > "${PROGRESS_FILE}.tmp" \
+                        && mv "${PROGRESS_FILE}.tmp" "$PROGRESS_FILE"
+                fi
+
+                record_change "sprint" "count" "$VALUE"
+                echo -e "${GREEN}✅${NC} Default sprint count: $VALUE"
+            else
+                echo -e "${RED}Error:${NC} Sprint count must be between 1 and 100"
+                exit 1
+            fi
+            ;;
+
+        status)
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo -e "⚙️  ${WHITE}Sprint Configuration${NC}"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+            local ENABLED=$(yq '.sprint_mode.enabled // false' "$CONFIG_FILE")
+            local COUNT=$(yq '.sprint_mode.sprint_config.default_sprints // 3' "$CONFIG_FILE")
+            local TYPE=$(yq '.sprint_mode.type // "sprint_based"' "$CONFIG_FILE")
+
+            echo -e "Sprint mode:   ${CYAN}$ENABLED${NC}"
+            echo -e "Type:          ${CYAN}$TYPE${NC}"
+            echo -e "Default count: ${CYAN}$COUNT${NC}"
+
+            if [ -f "$PROGRESS_FILE" ]; then
+                echo ""
+                echo "Current session:"
+                local CURRENT=$(jq -r '.current_iteration.current_sprint // 1' "$PROGRESS_FILE")
+                local TOTAL=$(jq -r '.current_iteration.total_sprints // 3' "$PROGRESS_FILE")
+                echo -e "  Sprint:      ${CYAN}$CURRENT / $TOTAL${NC}"
+            fi
+
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            ;;
+
+        *)
+            echo -e "${RED}Error:${NC} Unknown sprint action: $ACTION"
+            echo "  Available: enable, disable, count <n>, status"
+            exit 1
+            ;;
+    esac
+}
+
+# Notion configuration
+config_notion() {
+    local ACTION=$1
+
+    check_yq
+
+    case $ACTION in
+        enable)
+            if [ -f "$TASK_CONFIG_FILE" ]; then
+                yq -i '.notion_integration.enabled = true' "$TASK_CONFIG_FILE"
+            fi
+            record_change "notion" "enable" "true"
+            echo -e "${GREEN}✅${NC} Notion integration enabled"
+            ;;
+
+        disable)
+            if [ -f "$TASK_CONFIG_FILE" ]; then
+                yq -i '.notion_integration.enabled = false' "$TASK_CONFIG_FILE"
+            fi
+            record_change "notion" "disable" "false"
+            echo -e "${GREEN}✅${NC} Notion integration disabled"
+            ;;
+
+        status)
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo -e "📋 ${WHITE}Notion Configuration${NC}"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+            if [ -f "$TASK_CONFIG_FILE" ]; then
+                local ENABLED=$(yq '.notion_integration.enabled // false' "$TASK_CONFIG_FILE")
+                echo -e "Notion integration: ${CYAN}$ENABLED${NC}"
+            else
+                echo -e "Notion integration: ${YELLOW}config not found${NC}"
+            fi
+
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            ;;
+
+        *)
+            echo -e "${RED}Error:${NC} Unknown notion action: $ACTION"
+            echo "  Available: enable, disable, status"
+            exit 1
+            ;;
+    esac
+}
+
+# Loop-back configuration
+config_loopback() {
+    local ACTION=$1
+    local VALUE=$2
+
+    check_yq
+
+    case $ACTION in
+        enable)
+            yq -i '.sprint_mode.loop_back.enabled = true' "$CONFIG_FILE"
+            record_change "loopback" "enable" "true"
+            echo -e "${GREEN}✅${NC} Loop-back enabled"
+            ;;
+
+        disable)
+            yq -i '.sprint_mode.loop_back.enabled = false' "$CONFIG_FILE"
+            record_change "loopback" "disable" "false"
+            echo -e "${GREEN}✅${NC} Loop-back disabled"
+            ;;
+
+        max)
+            if [[ "$VALUE" =~ ^[0-9]+$ ]] && [ "$VALUE" -ge 1 ] && [ "$VALUE" -le 10 ]; then
+                yq -i ".sprint_mode.loop_back.max_stages_back = $VALUE" "$CONFIG_FILE"
+                record_change "loopback" "max" "$VALUE"
+                echo -e "${GREEN}✅${NC} Max loop-back stages: $VALUE"
+            else
+                echo -e "${RED}Error:${NC} Max stages must be between 1 and 10"
+                exit 1
+            fi
+            ;;
+
+        status)
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo -e "🔙 ${WHITE}Loop-back Configuration${NC}"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+            local ENABLED=$(yq '.sprint_mode.loop_back.enabled // true' "$CONFIG_FILE")
+            local MAX=$(yq '.sprint_mode.loop_back.max_stages_back // 3' "$CONFIG_FILE")
+
+            echo -e "Loop-back enabled: ${CYAN}$ENABLED${NC}"
+            echo -e "Max stages back:   ${CYAN}$MAX${NC}"
+
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            ;;
+
+        *)
+            echo -e "${RED}Error:${NC} Unknown loopback action: $ACTION"
+            echo "  Available: enable, disable, max <n>, status"
+            exit 1
+            ;;
+    esac
+}
+
+# Show all configurations
+show_all() {
+    config_sprint status
+    echo ""
+    config_notion status
+    echo ""
+    config_loopback status
+}
+
+# Show config history
+show_history() {
+    check_jq
+    init_config_history
+
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "📜 ${WHITE}Configuration History${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    local COUNT=$(jq '.changes | length' "$CONFIG_HISTORY")
+
+    if [ "$COUNT" == "0" ]; then
+        echo "No configuration changes recorded."
+    else
+        jq -r '.changes | reverse | .[0:10] | .[] | "[\(.timestamp)] \(.category)/\(.action): \(.value)"' "$CONFIG_HISTORY"
+
+        if [ "$COUNT" -gt 10 ]; then
+            echo ""
+            echo -e "${GRAY}(Showing last 10 of $COUNT changes)${NC}"
+        fi
+    fi
+
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+}
+
+# Print usage
+print_usage() {
+    echo "Usage: config-manager.sh <category> <action> [value]"
+    echo ""
+    echo "Categories:"
+    echo "  sprint      Sprint mode configuration"
+    echo "  notion      Notion integration configuration"
+    echo "  loopback    Loop-back configuration"
+    echo "  all         Show all configurations"
+    echo "  history     Show configuration change history"
+    echo ""
+    echo "Sprint actions:"
+    echo "  enable      Enable sprint mode"
+    echo "  disable     Disable sprint mode (single-pass)"
+    echo "  count <n>   Set default sprint count"
+    echo "  status      Show current sprint configuration"
+    echo ""
+    echo "Notion actions:"
+    echo "  enable      Enable Notion integration"
+    echo "  disable     Disable Notion integration"
+    echo "  status      Show current Notion configuration"
+    echo ""
+    echo "Loopback actions:"
+    echo "  enable      Enable loop-back"
+    echo "  disable     Disable loop-back"
+    echo "  max <n>     Set max stages for loop-back"
+    echo "  status      Show current loop-back configuration"
+    echo ""
+    echo "Examples:"
+    echo "  ./config-manager.sh sprint enable"
+    echo "  ./config-manager.sh sprint count 5"
+    echo "  ./config-manager.sh notion disable"
+    echo "  ./config-manager.sh all"
+}
+
+# Main
+CATEGORY=$1
+ACTION=$2
+VALUE=$3
+
+case $CATEGORY in
+    sprint)
+        config_sprint "$ACTION" "$VALUE"
+        ;;
+    notion)
+        config_notion "$ACTION"
+        ;;
+    loopback)
+        config_loopback "$ACTION" "$VALUE"
+        ;;
+    all)
+        show_all
+        ;;
+    history)
+        show_history
+        ;;
+    --help|-h)
+        print_usage
+        ;;
+    *)
+        if [ -z "$CATEGORY" ]; then
+            print_usage
+        else
+            echo -e "${RED}Error:${NC} Unknown category: $CATEGORY"
+            print_usage
+            exit 1
+        fi
+        ;;
+esac