claude-symphony 0.0.6 → 0.0.8

package/bin/create.js

@@ -59,14 +59,14 @@ async function collectBriefInfo() {
   const info = {};
 
   // Sequential questions (each input() must complete before proceeding)
-  info.description = await input({ message: '📝 One-line description:' });
-  info.problem = await input({ message: '🔍 Problem definition (problem to solve):' });
-  info.targetUser = await input({ message: '🎯 Target users:' });
-  info.successCriteria = await input({ message: '🏆 Success criteria:' });
-  info.constraintSchedule = await input({ message: '⏰ Constraints - Schedule:' });
-  info.constraintBudget = await input({ message: '💰 Constraints - Budget:' });
-  info.constraintTech = await input({ message: '⚙️ Constraints - Technology:' });
-  info.references = await input({ message: '🔗 References (URL or documents):' });
+  info.description = await input({ message: '📝 One-line description (Enter to skip):' });
+  info.problem = await input({ message: '🔍 Problem definition (Enter to skip):' });
+  info.targetUser = await input({ message: '🎯 Target users (Enter to skip):' });
+  info.successCriteria = await input({ message: '🏆 Success criteria (Enter to skip):' });
+  info.constraintSchedule = await input({ message: '⏰ Constraints - Schedule (Enter to skip):' });
+  info.constraintBudget = await input({ message: '💰 Constraints - Budget (Enter to skip):' });
+  info.constraintTech = await input({ message: '⚙️ Constraints - Technology (Enter to skip):' });
+  info.references = await input({ message: '🔗 References (Enter to skip):' });
 
   // Core features - multiple inputs (separate loop)
   console.log('');
@@ -75,7 +75,11 @@ async function collectBriefInfo() {
   let featureNum = 1;
   while (true) {
     const feature = await input({ message: `  ${featureNum}.` });
-    if (!feature) break;
+    if (!feature) {
+      // Clear the empty line (move up and clear)
+      process.stdout.write('\x1b[1A\x1b[2K');
+      break;
+    }
     info.features.push(feature);
     featureNum++;
   }
@@ -342,34 +346,34 @@ ${colors.yellow}After creation:${colors.reset}
   log(`✓ Project '${actualProjectName}' created successfully!`, 'green');
   log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'green');
   console.log('');
-  log('Next steps:', 'yellow');
+  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'yellow');
+  log('🚀 Next steps:', 'yellow');
+  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'yellow');
+  console.log('');
   if (projectName !== '.') {
     console.log(`  1. cd ${projectName}`);
-    console.log('  2. Edit stages/01-brainstorm/inputs/project_brief.md');
-    console.log('  3. Run /run-stage 01-brainstorm');
+    console.log('  2. claude                      ← Start Claude Code');
+    console.log('  3. Install plugin (in Claude Code):');
+    log('     /plugin marketplace add jarrodwatts/claude-hud', 'cyan');
+    log('     /plugin install claude-hud', 'cyan');
+    console.log('  4. Edit stages/01-brainstorm/inputs/project_brief.md');
+    console.log('  5. Run /run-stage 01-brainstorm');
   } else {
-    console.log('  1. Edit stages/01-brainstorm/inputs/project_brief.md');
-    console.log('  2. Run /run-stage 01-brainstorm');
+    console.log('  1. claude                      ← Start Claude Code');
+    console.log('  2. Install plugin (in Claude Code):');
+    log('     /plugin marketplace add jarrodwatts/claude-hud', 'cyan');
+    log('     /plugin install claude-hud', 'cyan');
+    console.log('  3. Edit stages/01-brainstorm/inputs/project_brief.md');
+    console.log('  4. Run /run-stage 01-brainstorm');
   }
   console.log('');
-  log('Pipeline stages:', 'cyan');
+  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'cyan');
+  log('📋 Pipeline stages:', 'cyan');
+  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'cyan');
   console.log('  01-brainstorm → 02-research → 03-planning → 04-ui-ux');
   console.log('  → 05-task-management → 06-implementation → 07-refactoring');
   console.log('  → 08-qa → 09-testing → 10-deployment');
   console.log('');
-  // Plugin installation message (more prominent)
-  console.log('');
-  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'yellow');
-  log('🎯 Recommended: Install claude-hud plugin', 'yellow');
-  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━', 'yellow');
-  console.log('');
-  console.log('  claude-hud visualizes context usage, tool activity, and progress.');
-  console.log('');
-  console.log('  Run these commands in Claude Code:');
-  console.log('');
-  log('    /plugin marketplace add jarrodwatts/claude-hud', 'cyan');
-  log('    /plugin install claude-hud', 'cyan');
-  console.log('');
 }
 
 main().catch(err => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-symphony",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Multi-AI Orchestration Framework - Create new projects with 10-stage development workflow",
   "type": "module",
   "bin": {

package/template/CLAUDE.md

@@ -411,6 +411,36 @@ state/
 
 ---
 
+## Parallel AI Execution Policy
+
+### Overview
+All defined AI models execute the same task in parallel, and each output is synthesized to produce the final result.
+
+### Execution Flow
+1. **Parallel Execution**: Designated models perform the task simultaneously
+2. **Individual Output**: Each model generates `output_modelName.md`
+3. **Synthesis**: ClaudeCode analyzes all outputs and generates `final_output.md`
+
+### Stage Model Assignment
+
+| Stage | Parallel Models | Synthesizer | Output |
+|-------|-----------------|-------------|--------|
+| 01-brainstorm | Gemini + ClaudeCode | ClaudeCode | ideas.md |
+| 03-planning | Gemini + ClaudeCode | ClaudeCode | architecture.md |
+| 04-ui-ux | Gemini + ClaudeCode | ClaudeCode | wireframes.md |
+| 07-refactoring | Codex + ClaudeCode | ClaudeCode | refactoring_report.md |
+| 09-testing | Codex + ClaudeCode | ClaudeCode | tests/ |
+
+> Single-model stages (02, 05, 06, 08, 10) maintain existing behavior
+
+### Synthesis Criteria
+1. **Extract Commonalities**: Prioritize content all models agree on
+2. **Analyze Differences**: Compare pros/cons, select best approach
+3. **Complementary Integration**: Merge unique insights from each model
+4. **Quality Filtering**: Remove low-quality content
+
+---
+
 ## Smart HANDOFF System
 
 > Configuration files: `config/handoff_intelligence.yaml`, `config/memory_integration.yaml`

package/template/config/ai_collaboration.yaml

@@ -2,27 +2,42 @@
 # Multi-AI orchestration modes and collaboration strategies
 
 collaboration_modes:
-  # Parallel Execution: Execute same task with multiple AIs simultaneously
+  # Parallel Execution: Execute same task with multiple AIs simultaneously and synthesize
   parallel_execution:
-    description: "Execute same task with multiple AIs simultaneously and select best result"
+    description: "Execute same task with multiple AIs simultaneously and synthesize"
     enabled: true
 
     stages:
-      - "01-brainstorm"
-      - "02-research"
-
-    models:
-      - "gemini"
-      - "claude"
+      01-brainstorm:
+        parallel_models: [gemini, claudecode]
+        synthesizer: claudecode
+        output: ideas.md
+      03-planning:
+        parallel_models: [gemini, claudecode]
+        synthesizer: claudecode
+        output: architecture.md
+      04-ui-ux:
+        parallel_models: [gemini, claudecode]
+        synthesizer: claudecode
+        output: wireframes.md
+      07-refactoring:
+        parallel_models: [codex, claudecode]
+        synthesizer: claudecode
+        output: refactoring_report.md
+      09-testing:
+        parallel_models: [codex, claudecode]
+        synthesizer: claudecode
+        output: tests/
+
+    synthesis_criteria:
+      - extract_commonalities
+      - analyze_differences
+      - complementary_integration
+      - quality_filtering
 
     merge_strategy:
-      type: "best_of_n"
-      selection_criteria:
-        - quality_score
-        - completeness
-        - creativity
-      require_human_review: true
-      auto_select_threshold: 0.85  # Auto-select when score is 85% or higher
+      type: "synthesis"
+      synthesizer: claudecode
 
   # Sequential Handoff: Sequential transfer between AIs (review chain)
   sequential_handoff:

package/template/config/git.yaml

@@ -13,6 +13,30 @@ git:
       on_checkpoint: true         # On checkpoint creation
       on_milestone: true          # On milestone completion
 
+  # Enforcement rules (mandatory commits)
+  enforcement:
+    enabled: true
+
+    # Stages where commit is MANDATORY after each task
+    mandatory_stages:
+      - "06-implementation"
+      - "07-refactoring"
+      - "08-qa"
+      - "09-testing"
+      - "10-deployment"
+
+    # Task completion requirements
+    task_completion_requires:
+      - git_commit          # Must commit changes
+      - no_uncommitted_changes  # No pending changes allowed
+
+    # Verification message
+    verification_prompt: |
+      ⚠️ MANDATORY: Before marking this task as complete:
+      1. Stage all related changes: git add <files>
+      2. Commit with conventional format: git commit -m "type(scope): description"
+      3. Verify: git status (should show "nothing to commit")
+
   # Commit message rules (Conventional Commits)
   commit_convention:
     format: "<type>(<scope>): <description>"

package/template/stages/01-brainstorm/CLAUDE.md

@@ -38,6 +38,28 @@ Divergent idea generation and requirements exploration stage
 - **Secondary**: ClaudeCode (structuring, feasibility review)
 - **Mode**: YOLO (Container) - autonomous execution mode
 
+## Parallel Execution Protocol
+
+### Models
+- **Primary**: Gemini (creative ideation)
+- **Secondary**: ClaudeCode (structural organization)
+
+### Execution
+1. Gemini: Generate `output_gemini.md`
+2. ClaudeCode: Generate `output_claudecode.md`
+3. ClaudeCode (Synthesizer): Synthesize → `ideas.md`
+
+### Output Files
+- `output_gemini.md` - Gemini results
+- `output_claudecode.md` - ClaudeCode results
+- `ideas.md` - Final synthesized result
+
+### Synthesis Criteria
+1. Extract commonalities first
+2. Analyze differences and select best
+3. Integrate unique insights
+4. Filter low-quality content
+
 ## Goals
 1. Divergent ideation based on project brief
 2. In-depth analysis of user requirements

package/template/stages/03-planning/CLAUDE.md

@@ -33,6 +33,28 @@ System architecture and technology stack decision stage
 - **Primary**: Gemini (architecture design, diagrams)
 - **Mode**: Plan Mode - structured design
 
+## Parallel Execution Protocol
+
+### Models
+- **Primary**: Gemini (architecture design)
+- **Secondary**: ClaudeCode (technical validation)
+
+### Execution
+1. Gemini: Generate `output_gemini.md`
+2. ClaudeCode: Generate `output_claudecode.md`
+3. ClaudeCode (Synthesizer): Synthesize → `architecture.md`
+
+### Output Files
+- `output_gemini.md` - Gemini results
+- `output_claudecode.md` - ClaudeCode results
+- `architecture.md` - Final synthesized result
+
+### Synthesis Criteria
+1. Extract commonalities first
+2. Analyze differences and select best
+3. Integrate unique insights
+4. Filter low-quality content
+
 ## Goals
 1. System architecture design
 2. Final technology stack decision

package/template/stages/04-ui-ux/CLAUDE.md

@@ -33,6 +33,28 @@ User interface and experience design stage
 - **Primary**: Gemini (creative UI design)
 - **Mode**: Plan Mode
 
+## Parallel Execution Protocol
+
+### Models
+- **Primary**: Gemini (creative UI design)
+- **Secondary**: ClaudeCode (UX validation)
+
+### Execution
+1. Gemini: Generate `output_gemini.md`
+2. ClaudeCode: Generate `output_claudecode.md`
+3. ClaudeCode (Synthesizer): Synthesize → `wireframes.md`
+
+### Output Files
+- `output_gemini.md` - Gemini results
+- `output_claudecode.md` - ClaudeCode results
+- `wireframes.md` - Final synthesized result
+
+### Synthesis Criteria
+1. Extract commonalities first
+2. Analyze differences and select best
+3. Integrate unique insights
+4. Filter low-quality content
+
 ## Goals
 1. Wireframe design
 2. User flow definition

package/template/stages/06-implementation/CLAUDE.md

@@ -111,6 +111,50 @@ cd project-name
 | `/next` | Sprint remaining → Next Sprint / Complete → Stage 07 |
 | `/next --stage` | Force Stage transition (skip Sprints, not recommended) |
 
+---
+
+## ⚠️ Mandatory Git Commit Rule
+
+> **CRITICAL**: Starting from Stage 06, git commit is REQUIRED after every task completion.
+
+### Per-Task Commit Protocol
+After completing each task:
+
+1. **Stage changes**
+   ```bash
+   git add <relevant-files>
+   ```
+
+2. **Commit with conventional format**
+   ```bash
+   git commit -m "feat(impl): <task description>"
+   ```
+
+3. **Verify clean state**
+   ```bash
+   git status  # Should show "nothing to commit"
+   ```
+
+### Commit Message Format
+| Task Type | Format | Example |
+|-----------|--------|---------|
+| New feature | `feat(impl): ...` | `feat(impl): add user login form` |
+| Component | `feat(impl): ...` | `feat(impl): create Button component` |
+| API | `feat(impl): ...` | `feat(impl): implement auth API endpoint` |
+| Style | `style(impl): ...` | `style(impl): add responsive styles` |
+
+### ❌ Prohibited
+- Proceeding to next task without committing
+- Batching multiple tasks into single commit
+- WIP or meaningless commit messages
+
+### ✅ Required
+- One commit per task (minimum)
+- Meaningful, descriptive commit messages
+- Clean working directory before next task
+
+---
+
 ### Sprint Completion Criteria
 
 Each Sprint completion requires:

package/template/stages/07-refactoring/CLAUDE.md

@@ -38,6 +38,28 @@ Code quality improvement and optimization stage
 - **Secondary**: ClaudeCode (complex refactoring)
 - **Mode**: Deep Dive - in-depth code analysis
 
+## Parallel Execution Protocol
+
+### Models
+- **Primary**: Codex (code optimization)
+- **Secondary**: ClaudeCode (code review)
+
+### Execution
+1. Codex: Generate `output_codex.md`
+2. ClaudeCode: Generate `output_claudecode.md`
+3. ClaudeCode (Synthesizer): Synthesize → `refactoring_report.md`
+
+### Output Files
+- `output_codex.md` - Codex results
+- `output_claudecode.md` - ClaudeCode results
+- `refactoring_report.md` - Final synthesized result
+
+### Synthesis Criteria
+1. Extract commonalities first
+2. Analyze differences and select best
+3. Integrate unique insights
+4. Filter low-quality content
+
 ## Goals
 1. Code quality improvement
 2. Duplication removal
@@ -101,6 +123,48 @@ Goals: Improve readability, optimize performance"
 
 ---
 
+## ⚠️ Mandatory Git Commit Rule
+
+> **CRITICAL**: Git commit is REQUIRED after every task completion in this stage.
+
+### Per-Task Commit Protocol
+After completing each task:
+
+1. **Stage changes**
+   ```bash
+   git add <relevant-files>
+   ```
+
+2. **Commit with conventional format**
+   ```bash
+   git commit -m "refactor(refactor): <task description>"
+   ```
+
+3. **Verify clean state**
+   ```bash
+   git status  # Should show "nothing to commit"
+   ```
+
+### Commit Message Format
+| Task Type | Format | Example |
+|-----------|--------|---------|
+| Code cleanup | `refactor(refactor): ...` | `refactor(refactor): extract auth logic to service` |
+| Performance | `perf(refactor): ...` | `perf(refactor): optimize database queries` |
+| Duplication removal | `refactor(refactor): ...` | `refactor(refactor): consolidate API handlers` |
+| Architecture | `refactor(refactor): ...` | `refactor(refactor): apply repository pattern` |
+
+### ❌ Prohibited
+- Proceeding to next task without committing
+- Batching multiple tasks into single commit
+- WIP or meaningless commit messages
+
+### ✅ Required
+- One commit per task (minimum)
+- Meaningful, descriptive commit messages
+- Clean working directory before next task
+
+---
+
 ## ⚠️ AI Usage Recording (Required)
 
 > **Important**: This stage requires Codex CLI.

package/template/stages/08-qa/CLAUDE.md

@@ -78,6 +78,50 @@ Quality assurance and code review stage
 - Fix and verify
 - Regression testing
 
+---
+
+## ⚠️ Mandatory Git Commit Rule
+
+> **CRITICAL**: Git commit is REQUIRED after every task completion in this stage.
+
+### Per-Task Commit Protocol
+After completing each task:
+
+1. **Stage changes**
+   ```bash
+   git add <relevant-files>
+   ```
+
+2. **Commit with conventional format**
+   ```bash
+   git commit -m "fix(qa): <task description>"
+   ```
+
+3. **Verify clean state**
+   ```bash
+   git status  # Should show "nothing to commit"
+   ```
+
+### Commit Message Format
+| Task Type | Format | Example |
+|-----------|--------|---------|
+| Bug fix | `fix(qa): ...` | `fix(qa): fix login validation bug` |
+| Security fix | `fix(qa): ...` | `fix(qa): sanitize user input` |
+| Code review fix | `fix(qa): ...` | `fix(qa): address code review comments` |
+| Test fix | `fix(qa): ...` | `fix(qa): fix flaky test in auth module` |
+
+### ❌ Prohibited
+- Proceeding to next task without committing
+- Batching multiple tasks into single commit
+- WIP or meaningless commit messages
+
+### ✅ Required
+- One commit per task (minimum)
+- Meaningful, descriptive commit messages
+- Clean working directory before next task
+
+---
+
 ## Completion Criteria
 - [ ] Code review complete
 - [ ] Security inspection passed

package/template/stages/09-testing/CLAUDE.md

@@ -35,6 +35,28 @@ Test code writing and E2E testing stage
 - **Mode**: Sandbox + Playwright
 - **MCP**: playwright server integration
 
+## Parallel Execution Protocol
+
+### Models
+- **Primary**: Codex (test generation)
+- **Secondary**: ClaudeCode (test validation)
+
+### Execution
+1. Codex: Generate `output_codex.md`
+2. ClaudeCode: Generate `output_claudecode.md`
+3. ClaudeCode (Synthesizer): Synthesize → `tests/`
+
+### Output Files
+- `output_codex.md` - Codex results
+- `output_claudecode.md` - ClaudeCode results
+- `tests/` - Final synthesized test files
+
+### Synthesis Criteria
+1. Extract commonalities first
+2. Analyze differences and select best
+3. Integrate unique insights
+4. Filter low-quality content
+
 ## Goals
 1. Unit test writing
 2. Integration test writing
@@ -108,6 +130,50 @@ npx playwright install
 - **Functions**: 80%
 - **Lines**: 80%
 
+---
+
+## ⚠️ Mandatory Git Commit Rule
+
+> **CRITICAL**: Git commit is REQUIRED after every task completion in this stage.
+
+### Per-Task Commit Protocol
+After completing each task:
+
+1. **Stage changes**
+   ```bash
+   git add <relevant-files>
+   ```
+
+2. **Commit with conventional format**
+   ```bash
+   git commit -m "test(test): <task description>"
+   ```
+
+3. **Verify clean state**
+   ```bash
+   git status  # Should show "nothing to commit"
+   ```
+
+### Commit Message Format
+| Task Type | Format | Example |
+|-----------|--------|---------|
+| Unit test | `test(test): ...` | `test(test): add user service unit tests` |
+| Integration test | `test(test): ...` | `test(test): add API integration tests` |
+| E2E test | `test(test): ...` | `test(test): add auth E2E tests` |
+| Test fix | `test(test): ...` | `test(test): fix flaky async test` |
+
+### ❌ Prohibited
+- Proceeding to next task without committing
+- Batching multiple tasks into single commit
+- WIP or meaningless commit messages
+
+### ✅ Required
+- One commit per task (minimum)
+- Meaningful, descriptive commit messages
+- Clean working directory before next task
+
+---
+
 ## Completion Criteria
 - [ ] Unit tests written (coverage 80%+)
 - [ ] Integration tests written

package/template/stages/10-deployment/CLAUDE.md

@@ -97,6 +97,50 @@ jobs:
 - **AWS**: Enterprise
 - **Cloudflare**: Edge
 
+---
+
+## ⚠️ Mandatory Git Commit Rule
+
+> **CRITICAL**: Git commit is REQUIRED after every task completion in this stage.
+
+### Per-Task Commit Protocol
+After completing each task:
+
+1. **Stage changes**
+   ```bash
+   git add <relevant-files>
+   ```
+
+2. **Commit with conventional format**
+   ```bash
+   git commit -m "ci(deploy): <task description>"
+   ```
+
+3. **Verify clean state**
+   ```bash
+   git status  # Should show "nothing to commit"
+   ```
+
+### Commit Message Format
+| Task Type | Format | Example |
+|-----------|--------|---------|
+| CI pipeline | `ci(deploy): ...` | `ci(deploy): configure GitHub Actions CI` |
+| CD pipeline | `ci(deploy): ...` | `ci(deploy): add Vercel deployment workflow` |
+| Config | `chore(deploy): ...` | `chore(deploy): add environment variables` |
+| Monitoring | `ci(deploy): ...` | `ci(deploy): configure Sentry error tracking` |
+
+### ❌ Prohibited
+- Proceeding to next task without committing
+- Batching multiple tasks into single commit
+- WIP or meaningless commit messages
+
+### ✅ Required
+- One commit per task (minimum)
+- Meaningful, descriptive commit messages
+- Clean working directory before next task
+
+---
+
 ## Completion Criteria
 - [ ] CI pipeline configured
 - [ ] CD pipeline configured