Project Batch Questions - Skill Guide

Skill Metadata

Field	Value
Skill Name	moai-project-batch-questions
Version	1.0.0 (2025-11-05)
Core Tool	AskUserQuestion (Claude Code built-in)
UX Goal	60% interaction reduction through batching

---

What It Does

Purpose: Standardize AskUserQuestion patterns with reusable batch templates that reduce user interactions while maintaining clarity.

Key capabilities:

• ✅ Batch Templates: Pre-designed question groups for common scenarios
• ✅ UX Optimization: 60% interaction reduction through strategic batching
• ✅ Multi-language Support: Templates in Korean, English, Japanese, Chinese
• ✅ Response Validation: Built-in validation and processing patterns
• ✅ Error Handling: Graceful handling of invalid or missing responses

---

Batch Design Philosophy

Traditional vs Batch Approach

Traditional: Q1 → Answer → Q2 → Answer → Q3 → Answer (3 interactions) Batch: Q1 + Q2 + Q3 → All answers at once (1 interaction, 66% reduction)

Batching Rules

Rule	Description	Example
Related Questions	Group questions about same topic	Language settings
Sequential Logic	Q2 depends on Q1 answer	Team mode conditional questions
Same Decision Context	User thinking about same aspect	GitHub + Git workflow

---

Core Batch Templates

Template 1: Language Selection Batch (3 questions)

Purpose: Set language preferences for project initialization Interaction Reduction: 3 turns → 1 turn (66% improvement)

const languageBatch = {
  questions: [
    {
      question: "Which language would you like to use for project initialization and documentation?",
      header: "Language",
      multiSelect: false,
      options: [
        { label: "English", description: "All dialogs and documentation in English" },
        { label: "한국어", description: "모든 대화와 문서를 한국어로" },
        { label: "日本語", description: "すべての対話と文書を日本語で" },
        { label: "中文", description: "所有对话和文档使用中文" }
      ]
    },
    {
      question: "In which language should Alfred's sub-agent prompts be written?",
      header: "Agent Prompt",
      multiSelect: false,
      options: [
        { label: "English (Global Standard)", description: "Reduces token usage by 15-20%" },
        { label: "Selected Language (Localized)", description: "Local efficiency with native language" }
      ]
    },
    {
      question: "How would you like to be called in our conversations? (max 20 chars)",
      header: "Nickname",
      multiSelect: false,
      options: [
        { label: "Enter custom nickname", description: "Type your preferred name using 'Other' option" }
      ]
    }
  ]
};

Template 2: Team Mode Settings Batch (2 questions)

Purpose: Configure team-specific GitHub and Git settings Interaction Reduction: 2 turns → 1 turn (50% improvement) Conditional: Only shown when mode: "team" detected

const teamModeBatch = {
  questions: [
    {
      question: "[Team Mode] Is 'Automatically delete head branches' enabled in your GitHub repository?",
      header: "GitHub Settings", 
      multiSelect: false,
      options: [
        { label: "Yes, already enabled", description: "PR merge 후 자동으로 원격 브랜치 삭제됨" },
        { label: "No, not enabled (Recommended)", description: "Settings → General에서 확인 필요" },
        { label: "Not sure / Need to check", description: "GitHub Settings 확인 후 다시 진행" }
      ]
    },
    {
      question: "[Team Mode] Which Git workflow should we use for SPEC documents?",
      header: "Git Workflow",
      multiSelect: false,
      options: [
        { label: "Feature Branch + PR", description: "매 SPEC마다 feature 브랜치 생성 → PR 리뷰 → develop 병합" },
        { label: "Direct Commit to Develop", description: "develop에 직접 커밋. 빠른 프로토타이핑에 최적" },
        { label: "Decide per SPEC", description: "SPEC 생성 시마다 매번 선택. 유연성 높지만 결정 필요" }
      ]
    }
  ]
};

Template 3: Report Generation Batch (1 question)

Purpose: Configure report generation with token cost awareness

const reportGenerationBatch = {
  questions: [
    {
      question: "Configure report generation:\n\n⚡ **Minimal (Recommended)**: Essential reports only (20-30 tokens)\n📊 **Enable**: Full analysis reports (50-60 tokens)\n🚫 **Disable**: No reports (0 tokens)\n\nAffects future /alfred:3-sync costs.",
      header: "Report Generation",
      multiSelect: false,
      options: [
        { label: "⚡ Minimal (Recommended)", description: "80% token reduction, faster sync" },
        { label: "Enable", description: "Complete reports, higher token usage" },
        { label: "🚫 Disable", description: "No automatic reports, zero cost" }
      ]
    }
  ]
};

Template 4: Domain Selection Batch (Multi-select)

Purpose: Select project domains and technology areas

const domainSelectionBatch = {
  questions: [
    {
      question: "Which domains and technology areas should be included in this project?",
      header: "Domains",
      multiSelect: true,
      options: [
        { label: "Backend API", description: "REST/GraphQL APIs, server-side logic, databases" },
        { label: "Frontend Web", description: "React/Vue/Angular, UI components, client-side" },
        { label: "Mobile App", description: "iOS/Android apps, React Native, Flutter" },
        { label: "DevOps/Infrastructure", description: "CI/CD, Docker, Kubernetes, cloud" },
        { label: "Data/Analytics", description: "Data processing, ML pipelines, analytics" }
      ]
    }
  ]
};

---

Response Processing

Validation Function

function validateBatchResponse(responses: Record<string, string>, template: string): ValidationResult {
  const errors: string[] = [];
  
  switch (template) {
    case 'language-batch':
      const validLanguages = ['ko', 'en', 'ja', 'zh'];
      if (!validLanguages.includes(responses['Language'])) {
        errors.push('Invalid language selection');
      }
      if (responses['Nickname']?.length > 20) {
        errors.push('Nickname must be 20 characters or less');
      }
      break;
  }
  
  return { isValid: errors.length === 0, errors };
}

Configuration Mapping

function mapToConfig(responses: Record<string, string>, template: string): Partial<Config> {
  switch (template) {
    case 'language-batch':
      return {
        language: {
          conversation_language: responses['Language'],
          agent_prompt_language: responses['Agent Prompt'] === 'English (Global Standard)' ? 'english' : 'localized'
        },
        user: { nickname: responses['Nickname'], selected_at: new Date().toISOString() }
      };
      
    case 'team-mode-batch':
      return {
        github: {
          auto_delete_branches: responses['GitHub Settings'] === 'Yes, already enabled',
          spec_git_workflow: mapWorkflowToCode(responses['Git Workflow']),
          checked_at: new Date().toISOString()
        }
      };
  }
}

---

Usage Integration

Alfred Command Integration

// In 0-project.md command
async function initializeProject() {
  // Step 1: Language selection batch
  const languageResponses = await executeBatchTemplate(LANGUAGE_BATCH_TEMPLATE);
  
  // Step 2: Check for team mode
  if (isTeamMode()) {
    const teamResponses = await executeBatchTemplate(TEAM_MODE_BATCH_TEMPLATE);
  }
  
  // Step 3: Report generation batch  
  const reportResponses = await executeBatchTemplate(REPORT_GENERATION_BATCH_TEMPLATE);
}

---

Performance Metrics

Interaction Reduction

Template	Traditional	Batch	Reduction
Language Selection	3 interactions	1 interaction	66%
Team Mode Settings	2 interactions	1 interaction	50%
Domain Selection	5+ questions	1 interaction	80%+

---

Best Practices

✅ DO

• Group related questions: Same decision context
• Show total question count: "3 questions in this batch"
• Use consistent headers: Short, descriptive (≤12 chars)
• Include progress indicators: "Step 1 of 2"

❌ DON'T

• Overload batches: Max 4 questions per batch
• Mix unrelated topics: Keep thematic cohesion
• Skip validation: Always verify responses
• Ignore cancellation: Handle user gracefully

---

Quick Reference

Common Use Cases

Use Case	Template	Questions	Interaction Reduction
Project initialization	Language + Team batches	5 questions total	60%
Settings modification	Targeted batches	1-3 questions	50-80%
Feature configuration	Domain-specific batches	2-4 questions	75%

Integration Checklist

• Template selected for use case
• Response validation configured
• Error handling implemented
• Configuration mapping tested
• Multi-language support if needed

---

End of Skill | Created 2025-11-05 | Optimized for batch interaction reduction