gameforge-cli 0.1.0 → 0.2.1

package/dist/agents/specialists/EntitySpecialist.js

@@ -7,20 +7,67 @@ class EntitySpecialist extends BaseAgent_1.BaseAgent {
     constructor(apiKey, costTracker, modelSelector) {
         const config = {
             systemPrompt: `You are an Entity Design Specialist.
-Generate detailed specifications for game entities (NPCs, Items, Monsters) including:
-- Stat tables and attribute breakdowns
-- Behavior descriptions
-- Narrative context
-- Balance formulas
+Generate concise game entity descriptions including:
+- What the entity is and its role in the game
+- Key characteristics and behaviors
+- Brief narrative context if relevant
 
-Be specific and create production-ready documentation.`
+Keep descriptions brief and design-focused. Avoid technical implementation details.`
         };
         super(apiKey, config, costTracker, modelSelector);
     }
     async execute(bible, onProgress) {
-        const sections = ['# 03. Game Objects & Entities\n'];
-        // Group by category
-        const categories = ['NPC', 'Monster', 'Item', 'Interactable'];
+        const sections = ['# Game Objects & Entities\n'];
+        // Per-category MAXIMUM thresholds - only flag if exceeded (not minimums)
+        const scope = bible.meta.estimatedScope;
+        const entityMaxThresholds = {
+            'Prototype': {
+                NPC: 5, Monster: 5, Item: 8, Ability: 8, Interactable: 5, Card: 20, Vehicle: 3, Building: 5
+            },
+            'Vertical Slice': {
+                NPC: 8, Monster: 8, Item: 15, Ability: 12, Interactable: 8, Card: 40, Vehicle: 5, Building: 8
+            },
+            'MVP': {
+                NPC: 15, Monster: 15, Item: 30, Ability: 20, Interactable: 15, Card: 60, Vehicle: 10, Building: 15
+            },
+            'Full Game': {
+                NPC: 40, Monster: 40, Item: 80, Ability: 50, Interactable: 40, Card: 150, Vehicle: 25, Building: 40
+            }
+        };
+        const thresholds = entityMaxThresholds[scope] || entityMaxThresholds['MVP'];
+        // Count entities by category
+        const categoryCounts = {};
+        bible.gameObjects.forEach(entity => {
+            categoryCounts[entity.category] = (categoryCounts[entity.category] || 0) + 1;
+        });
+        // Check each category against its max threshold
+        const overages = [];
+        for (const [category, count] of Object.entries(categoryCounts)) {
+            const maxAllowed = thresholds[category];
+            if (maxAllowed && count > maxAllowed) {
+                overages.push(`${category}s (${count} > ${maxAllowed} max)`);
+            }
+        }
+        if (overages.length > 0) {
+            await this.askClarification(`The following entity categories exceed typical limits for a "${scope}" scope:\n\n${overages.map(o => `- ${o}`).join('\n')}`, bible, 'Entity Count');
+        }
+        // Check for economy features without currency items
+        const hasEconomyFeature = bible.features.some((f) => f.economy);
+        const hasCurrencyItems = bible.gameObjects.some((e) => e.category === 'Item' &&
+            (e.name.toLowerCase().includes('coin') ||
+                e.name.toLowerCase().includes('gold') ||
+                e.name.toLowerCase().includes('currency') ||
+                e.name.toLowerCase().includes('money')));
+        if (hasEconomyFeature && !hasCurrencyItems) {
+            await this.askClarification('Game has economy features but no currency items defined. Should we add coins, gold, or other tradeable items?', bible, 'Economy Items');
+        }
+        // Check for progression features without abilities/skills
+        const hasProgressionFeature = bible.features.some((f) => f.progression);
+        const hasAbilities = bible.gameObjects.some((e) => e.category === 'Ability');
+        if (hasProgressionFeature && !hasAbilities && bible.meta.genre.some((g) => g.toLowerCase().includes('rpg'))) {
+            await this.askClarification('RPG with progression but no abilities/skills defined. Should we add unlockable abilities?', bible, 'Progression Abilities');
+        }
+        const categories = ['NPC', 'Monster', 'Item', 'Interactable', 'Vehicle', 'Card', 'Building', 'Ability'];
         for (const category of categories) {
             const entities = bible.gameObjects.filter(e => e.category === category);
             if (entities.length > 0) {
@@ -35,35 +82,42 @@ Be specific and create production-ready documentation.`
         return sections.join('\n\n');
     }
     async generateEntityDoc(entity, bible, onProgress) {
-        const prompt = `Generate detailed documentation for this game entity:
+        const genre = bible.meta.genre.join(', ');
+        const prompt = `Generate a brief, design-focused description for this game entity:
 
 Entity: ${JSON.stringify(entity, null, 2)}
-Game Context: ${bible.meta.title}
+Game: ${bible.meta.title}
+Genre: ${genre}
 
-Create markdown documentation with:
+Create a concise markdown entry:
 
 ### ${entity.name}
-**ID**: ${entity.id}
-**Category**: ${entity.category}
 
-${entity.narrative ? `**Backstory**: ${entity.narrative.backstory}\n` : ''}
+Write 2-3 sentences describing what this entity is and its role in the game.
+
+${entity.narrative?.backstory ? `**Background**: Brief narrative context based on: "${entity.narrative.backstory}"` : ''}
 
-**Attributes**:
+${entity.stats ? `**Key Characteristics**:
 ${Object.entries(entity.stats.attributes).map(([key, val]) => `- ${key}: ${val}`).join('\n')}
+` : ''}
 
-**Behaviors**:
-${entity.stats.behaviors.map(b => `- ${b}`).join('\n')}
+${entity.stats?.behaviors && entity.stats.behaviors.length > 0 ? `**Behaviors**: ${entity.stats.behaviors.join(', ')}` : ''}
 
-${entity.stats.balanceFormulas && entity.stats.balanceFormulas.length > 0 ? `
-**Balance Formulas**:
-${entity.stats.balanceFormulas.map(f => `- ${f.expression}`).join('\n')}
-` : ''}
+${entity.cardGame ? `**Card Info**: ${entity.cardGame.cardType || 'Card'}${entity.cardGame.effects && entity.cardGame.effects.length > 0 ? ` - ${entity.cardGame.effects.join(', ')}` : ''}` : ''}
+
+${entity.combat ? `**Combat Role**: Describe briefly how this entity participates in combat.` : ''}
 
-${entity.references.features.length > 0 ? `**Used In Features**: ${entity.references.features.join(', ')}` : ''}
+${entity.social?.questGiver ? `**Quest Giver**: This character offers quests to the player.` : ''}
 
-Generate this in clean markdown format.`;
+IMPORTANT - Keep it SHORT and DESIGN-FOCUSED:
+- 1 short paragraph describing the entity
+- Simple list of key characteristics (no RPG stat blocks unless this IS an RPG)
+- NO balance formulas or math
+- NO AI implementation details (behavior trees, detection radius, etc.)
+- NO code references or feature IDs
+- Focus on what this entity MEANS to the player experience`;
         const result = await this.callLLMWithAutoRetry(prompt, modelSelector_1.TaskComplexity.SIMPLE, {
-            initialMaxTokens: 8000,
+            initialMaxTokens: 2000,
             maxRetries: 2,
             onProgress: (msg) => onProgress?.(`${entity.name}: ${msg}`)
         });

package/dist/agents/specialists/EntitySpecialist.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntitySpecialist.js","sourceRoot":"","sources":["../../../src/agents/specialists/EntitySpecialist.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"EntitySpecialist.js","sourceRoot":"","sources":["../../../src/agents/specialists/EntitySpecialist.ts"],"names":[],"mappings":"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"}

package/dist/agents/specialists/FeatureSpecialist.d.ts

@@ -3,6 +3,10 @@ import { GameBible } from '../../config/schema';
 export declare class FeatureSpecialist extends BaseAgent {
     constructor(apiKey: string, costTracker: any, modelSelector: any);
     execute(bible: GameBible, onProgress?: (message: string) => void): Promise<string>;
+    /**
+     * Calculate dependency depth for each feature
+     */
+    private calculateDependencyDepths;
     private generateFeatureDoc;
 }
 //# sourceMappingURL=FeatureSpecialist.d.ts.map

package/dist/agents/specialists/FeatureSpecialist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureSpecialist.d.ts","sourceRoot":"","sources":["../../../src/agents/specialists/FeatureSpecialist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAW,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG;IAc1D,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;YAY1E,kBAAkB;CAqDjC"}
+{"version":3,"file":"FeatureSpecialist.d.ts","sourceRoot":"","sources":["../../../src/agents/specialists/FeatureSpecialist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAW,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG;IAa1D,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAmFxF;;OAEG;IACH,OAAO,CAAC,yBAAyB;YA+BnB,kBAAkB;CA8DjC"}

package/dist/agents/specialists/FeatureSpecialist.js

@@ -7,18 +7,58 @@ class FeatureSpecialist extends BaseAgent_1.BaseAgent {
     constructor(apiKey, costTracker, modelSelector) {
         const config = {
             systemPrompt: `You are a Feature Design Specialist.
-Generate comprehensive technical specifications for game features including:
-- Mermaid sequence diagrams for gameplay loops
-- Math formulas with variable definitions
-- Agile user stories with acceptance criteria
-- Data structure pseudo-code
+Generate clear feature descriptions including:
+- What the feature does and why it exists
+- How players interact with it (gameplay loop)
+- UI/UX considerations
 
-Be specific and technical. Use industry-standard notation.`
+Focus on player experience, not technical implementation.`
         };
         super(apiKey, config, costTracker, modelSelector);
     }
     async execute(bible, onProgress) {
-        const sections = ['# 02. Systems & Features\n'];
+        const sections = ['# Systems & Features\n'];
+        // Check for very high complexity features that need clarification
+        const veryHighComplexityFeatures = bible.features.filter(f => f.technical.estimatedComplexity === 'Very High');
+        if (veryHighComplexityFeatures.length > 0) {
+            const feature = veryHighComplexityFeatures[0];
+            await this.askClarification(`The feature "${feature.name}" is marked as "Very High" complexity.`, bible, 'Feature Complexity');
+        }
+        // Check if all features have the same complexity
+        const complexities = bible.features.map((f) => f.technical.estimatedComplexity);
+        const uniqueComplexities = new Set(complexities);
+        if (uniqueComplexities.size === 1 && bible.features.length > 2) {
+            const complexity = complexities[0];
+            await this.askClarification(`All ${bible.features.length} features are marked "${complexity}" complexity. Are some more critical or complex than others?`, bible, 'Feature Complexity Variation');
+        }
+        // Check for vague feature intents
+        for (const feature of bible.features) {
+            const intent = feature.intent || '';
+            const hasVagueIntent = intent.length < 20 ||
+                intent.toLowerCase().includes('handles') ||
+                intent.toLowerCase().includes('manages') ||
+                intent.toLowerCase().includes('system for');
+            if (hasVagueIntent) {
+                await this.askClarification(`Feature "${feature.name}" has a vague intent. WHY does this exist? What does it add to the player experience?`, bible, 'Feature Intent');
+                break; // Only ask about the first vague intent
+            }
+        }
+        // Check for player-facing features without UI
+        for (const feature of bible.features) {
+            const hasGameplayLoop = feature.gameplayLoop && feature.gameplayLoop.length > 0;
+            const hasUI = feature.uiRequirements && feature.uiRequirements.length > 0;
+            if (hasGameplayLoop && !hasUI) {
+                await this.askClarification(`Feature "${feature.name}" has gameplay but no UI specified. What does the player see and interact with?`, bible, 'Feature UI Requirements');
+                break; // Only ask about the first missing UI
+            }
+        }
+        // Check for deep dependency chains
+        const dependencyDepths = this.calculateDependencyDepths(bible.features);
+        const deepDependencies = dependencyDepths.filter(d => d.depth > 3);
+        if (deepDependencies.length > 0) {
+            const feature = deepDependencies[0];
+            await this.askClarification(`Feature "${feature.name}" has a complex dependency chain (${feature.depth} levels deep). Can we simplify the feature unlock order?`, bible, 'Feature Dependencies');
+        }
         for (const feature of bible.features) {
             onProgress?.(`Processing feature ${feature.name}...`);
             const markdown = await this.generateFeatureDoc(feature, bible, onProgress);
@@ -26,53 +66,88 @@ Be specific and technical. Use industry-standard notation.`
         }
         return sections.join('\n\n---\n\n');
     }
+    /**
+     * Calculate dependency depth for each feature
+     */
+    calculateDependencyDepths(features) {
+        const featureMap = new Map(features.map(f => [f.id, f]));
+        const depths = [];
+        const getDepth = (featureId, visited = new Set()) => {
+            if (visited.has(featureId)) {
+                return 0; // Circular dependency, return 0
+            }
+            const feature = featureMap.get(featureId);
+            if (!feature || !feature.dependencies || feature.dependencies.length === 0) {
+                return 0;
+            }
+            visited.add(featureId);
+            const maxDepth = Math.max(...feature.dependencies.map(depId => getDepth(depId, new Set(visited))));
+            return maxDepth + 1;
+        };
+        for (const feature of features) {
+            depths.push({
+                name: feature.name,
+                depth: getDepth(feature.id)
+            });
+        }
+        return depths;
+    }
     async generateFeatureDoc(feature, bible, onProgress) {
-        const prompt = `Generate detailed technical documentation for this game feature:
+        const prompt = `Generate a clear, player-focused description for this game feature:
 
 Feature: ${JSON.stringify(feature, null, 2)}
-Game Context: ${bible.meta.title} (${bible.meta.genre.join(', ')})
+Game: ${bible.meta.title} (${bible.meta.genre.join(', ')})
 
-Create markdown documentation with:
+Create markdown documentation:
 
 ## ${feature.name}
-**Epic**: ${feature.agile.epic}
 
-### Intent
-${feature.intent}
+### Purpose
+Explain in 2-3 sentences why this feature exists and what it adds to the player experience.
+Base this on: "${feature.intent}"
 
-### Gameplay Loop
-\`\`\`mermaid
-sequenceDiagram
-${feature.gameplayLoop.map((step, i) => `    participant Step${i} as ${step}`).join('\n')}
-\`\`\`
+${feature.gameplayLoop && feature.gameplayLoop.length > 0 ? `### How It Works
+Describe the gameplay loop in plain language as a numbered list:
+${feature.gameplayLoop.map((step, i) => `${i + 1}. ${step}`).join('\n')}
 
-### User Stories
-${feature.agile.userStories.map(s => `- ${s}`).join('\n')}
+Expand each step with 1-2 sentences explaining the player's actions and the game's response.
+` : ''}
 
-### Technical Specification
-**Data Structure**:
-\`\`\`cpp
-${feature.technical.dataStructure}
-\`\`\`
-
-**Math Formulas**:
-${feature.technical.mathFormulas?.map(f => `
-- Formula: \\\`${f.expression}\\\`
-- Variables: ${Object.entries(f.variables).map(([k, v]) => `${k} (${v.type})`).join(', ')}
-`).join('\n') || 'None'}
+${feature.uiRequirements && feature.uiRequirements.length > 0 ? `### User Interface
+What UI elements does this feature need?
+${feature.uiRequirements.map(ui => `- ${ui}`).join('\n')}
+` : ''}
 
-**File Location**: \`${feature.technical.fileLocation}\`
+${feature.multiplayer ? `### Multiplayer
+- Supports ${feature.multiplayer.playerCount} players
+${feature.multiplayer.networkModel ? `- Uses ${feature.multiplayer.networkModel} architecture` : ''}
+Briefly describe how multiple players interact with this feature.
+` : ''}
 
-**Complexity**: ${feature.technical.estimatedComplexity}
+${feature.economy ? `### Economy Impact
+${feature.economy.currencies ? `Currencies involved: ${feature.economy.currencies.join(', ')}` : ''}
+Describe how this feature affects the game's economy.
+` : ''}
 
-### UI Requirements
-${feature.uiRequirements.map(ui => `- ${ui}`).join('\n')}
+${feature.progression ? `### Progression
+Describe how players unlock or advance through this feature.
+${feature.progression.unlockConditions ? `Unlock requirements: ${feature.progression.unlockConditions.join(', ')}` : ''}
+` : ''}
 
-${feature.monetization ? `### Monetization\n- Strategy: ${feature.monetization.strategy}\n- ${feature.monetization.implementation}` : ''}
+${feature.narrative ? `### Story Integration
+How does this feature connect to the game's narrative?
+${feature.narrative.storyBeats && feature.narrative.storyBeats.length > 0 ? `Key story moments: ${feature.narrative.storyBeats.join(', ')}` : ''}
+` : ''}
 
-Ensure Mermaid syntax is valid and formulas are properly escaped.`;
-        const result = await this.callLLMWithAutoRetry(prompt, modelSelector_1.TaskComplexity.MODERATE, {
-            initialMaxTokens: 16000,
+IMPORTANT - This is a DESIGN document, not an engineering spec:
+- NO code or pseudo-code
+- NO data structures
+- NO math formulas with variable types
+- NO file paths or complexity ratings
+- Focus on WHAT the player experiences, not HOW it's implemented
+- Keep it concise (half a page per feature max)`;
+        const result = await this.callLLMWithAutoRetry(prompt, modelSelector_1.TaskComplexity.SIMPLE, {
+            initialMaxTokens: 4000,
             maxRetries: 2,
             onProgress: (msg) => onProgress?.(`${feature.name}: ${msg}`)
         });

package/dist/agents/specialists/FeatureSpecialist.js.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureSpecialist.js","sourceRoot":"","sources":["../../../src/agents/specialists/FeatureSpecialist.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FeatureSpecialist.js","sourceRoot":"","sources":["../../../src/agents/specialists/FeatureSpecialist.ts"],"names":[],"mappings":"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"}

package/dist/agents/specialists/TechSpecialist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TechSpecialist.d.ts","sourceRoot":"","sources":["../../../src/agents/specialists/TechSpecialist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG;IAe1D,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CAwCzF"}
+{"version":3,"file":"TechSpecialist.d.ts","sourceRoot":"","sources":["../../../src/agents/specialists/TechSpecialist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG;IAc1D,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CA+NzF"}

package/dist/agents/specialists/TechSpecialist.js

@@ -6,52 +6,189 @@ const modelSelector_1 = require("../../utils/modelSelector");
 class TechSpecialist extends BaseAgent_1.BaseAgent {
     constructor(apiKey, costTracker, modelSelector) {
         const config = {
-            systemPrompt: `You are a Technical Specification Specialist.
-Generate detailed technical documentation including:
-- Engine configuration and setup
-- Required tools and their purposes
-- Directory structure
-- Build targets and deployment
-- Localization strategy
-
-Be precise and actionable.`
+            systemPrompt: `You are a Technical Overview Specialist.
+Generate a high-level technical summary for stakeholders including:
+- Recommended game engine and why
+- Target platforms
+- Multiplayer approach (if applicable)
+- Accessibility features
+
+Keep it brief and non-technical. This is a design document, not an engineering spec.`
         };
         super(apiKey, config, costTracker, modelSelector);
     }
     async execute(bible, onProgress) {
-        const prompt = `Generate comprehensive technical documentation:
+        if (!bible.technical) {
+            return '# Technical Overview\n\n*No technical specifications provided for this design document.*';
+        }
+        // Check if targeting too many platforms for the scope
+        const platformCount = bible.technical.buildTargets.length;
+        const scope = bible.meta.estimatedScope;
+        if (platformCount > 2 && (scope === 'Prototype' || scope === 'Vertical Slice')) {
+            const result = await this.askClarification(`You're targeting ${platformCount} platforms (${bible.technical.buildTargets.join(', ')}) for a "${scope}" scope.`, bible, 'Platform Scope');
+            const decision = (result.answer || '').toLowerCase();
+            const currentTargets = bible.technical.buildTargets;
+            if (decision.includes('focus on primary') || decision.includes('primary platform')) {
+                if (currentTargets.length > 0) {
+                    bible.technical.buildTargets = [currentTargets[0]];
+                    onProgress?.(`Technical scope updated: focusing on primary platform "${currentTargets[0]}".`);
+                }
+            }
+            else if (decision.includes('start with fewer') || decision.includes('fewer platform')) {
+                if (currentTargets.length > 1) {
+                    const reducedTargets = currentTargets.slice(0, 2);
+                    bible.technical.buildTargets = reducedTargets;
+                    onProgress?.(`Technical scope updated: starting with fewer platforms (${reducedTargets.join(', ')}).`);
+                }
+            }
+            else {
+                onProgress?.('Technical scope: keeping all configured platforms.');
+            }
+        }
+        // Check for platform-monetization mismatch
+        // Get monetization from features (monetization is defined per-feature in schema)
+        const featureMonetization = bible.features
+            .filter((f) => f.monetization?.strategy)
+            .map((f) => f.monetization.strategy);
+        const monetization = featureMonetization.length > 0 ? featureMonetization[0] : '';
+        const platforms = bible.technical.buildTargets.map((p) => p.toLowerCase());
+        const monetizationLower = monetization.toLowerCase();
+        // Exclude hybrid models like "Freemium" or "Free-to-Play with Premium"
+        const isHybridFreeModel = monetizationLower.includes('freemium') ||
+            monetizationLower.includes('free-to-play') ||
+            (monetizationLower.includes('free') && monetizationLower.includes('premium'));
+        if (platforms.includes('mobile') && monetizationLower.includes('premium') && !isHybridFreeModel) {
+            const result = await this.askClarification(`Premium paid games are rare on mobile. Most successful mobile games use Free-to-Play or Ad-Supported models. Is this intentional?`, bible, 'Mobile Monetization');
+            const decision = (result.answer || '').toLowerCase();
+            if (decision.includes('yes') || decision.includes('intentional') || decision.includes('premium')) {
+                onProgress?.('Premium mobile monetization acknowledged as intentional strategy');
+            }
+            else if (decision.includes('change') || decision.includes('free')) {
+                onProgress?.('Note: Consider revising monetization model for mobile platform');
+            }
+        }
+        if (platforms.some((p) => p.includes('console')) && monetizationLower.includes('ads')) {
+            const result = await this.askClarification(`Ad-supported monetization is uncommon on console platforms. Did you mean a different model?`, bible, 'Console Monetization');
+            const decision = (result.answer || '').toLowerCase();
+            if (decision.includes('yes') || decision.includes('intentional') || decision.includes('ads')) {
+                onProgress?.('Ad-supported console monetization acknowledged as intentional');
+            }
+            else {
+                onProgress?.('Note: Consider revising monetization model for console platform');
+            }
+        }
+        // Check for platform-control mismatches in UI requirements
+        const allUIRequirements = bible.features
+            .flatMap((f) => f.uiRequirements || [])
+            .join(' ')
+            .toLowerCase();
+        if (platforms.includes('mobile')) {
+            if (allUIRequirements.includes('keyboard') ||
+                allUIRequirements.includes('mouse') ||
+                allUIRequirements.includes('wasd')) {
+                await this.askClarification(`Detected keyboard/mouse controls for mobile platform. Should we use touch controls instead?`, bible, 'Mobile Controls');
+            }
+        }
+        if (platforms.some((p) => p.includes('console'))) {
+            if (allUIRequirements.includes('touch') ||
+                allUIRequirements.includes('swipe') ||
+                allUIRequirements.includes('tap')) {
+                await this.askClarification(`Detected touch controls for console platform. Should we use gamepad controls instead?`, bible, 'Console Controls');
+            }
+        }
+        // Check for complexity stacking
+        const hasMultiplayer = bible.technical.networking || bible.features.some((f) => f.multiplayer);
+        const hasProcedural = bible.features.some((f) => f.procedural);
+        const hasPhysics = bible.features.some((f) => f.physics);
+        if (hasMultiplayer && hasProcedural && hasPhysics) {
+            const result = await this.askClarification(`Combining multiplayer + procedural generation + physics simulation is very complex. Is this feasible for a "${scope}" project?`, bible, 'Technical Complexity');
+            const decision = (result.answer || '').toLowerCase();
+            if (decision.includes('yes') || decision.includes('feasible') || decision.includes('experienced')) {
+                onProgress?.('High technical complexity acknowledged - team has experience with complex systems');
+            }
+            else if (decision.includes('simplify') || decision.includes('reduce') || decision.includes('no')) {
+                onProgress?.('Note: Consider simplifying technical scope - remove procedural generation or reduce physics complexity');
+            }
+            else {
+                onProgress?.('Technical complexity acknowledged');
+            }
+        }
+        // Check for localization strategy mismatch
+        if (bible.technical.localization) {
+            const strategy = bible.technical.localization.strategy;
+            const languageCount = bible.technical.localization.languages?.length || 0;
+            if (strategy === 'Global' && languageCount < 5) {
+                const result = await this.askClarification(`Global localization strategy with only ${languageCount} languages. Did you mean 'EFIGS' or should we add more languages?`, bible, 'Localization Strategy');
+                const decision = (result.answer || '').toLowerCase();
+                if (decision.includes('efigs')) {
+                    bible.technical.localization.strategy = 'EFIGS';
+                    onProgress?.('Updated localization strategy to EFIGS');
+                }
+                else if (decision.includes('add') || decision.includes('more')) {
+                    onProgress?.('Note: Consider expanding language list for Global localization strategy');
+                }
+            }
+        }
+        // Check for cross-platform without clear primary
+        if (platformCount > 1) {
+            const result = await this.askClarification(`Targeting multiple platforms: ${bible.technical.buildTargets.join(', ')}. Which is PRIMARY for initial development?`, bible, 'Primary Platform');
+            const decision = (result.answer || '').toLowerCase();
+            const currentTargets = bible.technical.buildTargets;
+            // Try to identify primary platform from response
+            for (const platform of currentTargets) {
+                if (decision.includes(platform.toLowerCase())) {
+                    onProgress?.(`Primary platform identified as: ${platform}`);
+                    break;
+                }
+            }
+            if (!decision.match(/windows|mac|linux|ios|android|console/i)) {
+                onProgress?.('Note: Primary platform should be clearly specified for development focus');
+            }
+        }
+        const prompt = `Generate a brief technical overview for stakeholders (not developers):
 
-Technical Spec: ${JSON.stringify(bible.technical, null, 2)}
 Game: ${bible.meta.title}
+Technical Info: ${JSON.stringify(bible.technical, null, 2)}
 
-Create markdown with these sections:
+Create a concise markdown document with these sections:
 
-# 04. Technical Specification
+# Technical Overview
 
-## Engine Configuration
-**Engine**: ${bible.technical.engine.primary} ${bible.technical.engine.version}
-${bible.technical.engine.plugins && bible.technical.engine.plugins.length > 0 ? `**Plugins**: ${bible.technical.engine.plugins.join(', ')}` : ''}
-${bible.technical.engine.reasoning ? `**Reasoning**: ${bible.technical.engine.reasoning}` : ''}
+## Game Engine
+Describe the chosen engine (${bible.technical.engine.primary}${bible.technical.engine.version ? ` ${bible.technical.engine.version}` : ''}) and briefly explain why it's a good fit for this project.
+${bible.technical.engine.reasoning ? `Use this reasoning: ${bible.technical.engine.reasoning}` : ''}
 
-## Required Tools
-${bible.technical.toolsRequired.map(t => `- **${t.name}**: ${t.purpose} ${t.required ? '(Required)' : '(Optional)'}`).join('\n')}
+## Target Platforms
+List the platforms: ${bible.technical.buildTargets.join(', ')}
+Briefly mention any platform-specific considerations.
 
-## Localization
-**Strategy**: ${bible.technical.localization.strategy}
-${bible.technical.localization.languages ? `**Languages**: ${bible.technical.localization.languages.join(', ')}` : ''}
-${bible.technical.localization.stringCount ? `**Estimated Strings**: ${bible.technical.localization.stringCount}` : ''}
+${bible.technical.networking ? `## Multiplayer
+${bible.technical.networking.architecture ? `Architecture: ${bible.technical.networking.architecture}` : ''}
+${bible.technical.networking.maxPlayers ? `Supports up to ${bible.technical.networking.maxPlayers} players.` : ''}
+Describe the multiplayer approach in 2-3 sentences.
+` : ''}
 
-## Directory Structure
-\`\`\`
-${bible.technical.directoryStructure}
-\`\`\`
+${bible.technical.localization ? `## Localization
+Strategy: ${bible.technical.localization.strategy}
+${bible.technical.localization.languages ? `Languages: ${bible.technical.localization.languages.join(', ')}` : ''}
+` : ''}
 
-## Build Targets
-${bible.technical.buildTargets.map(t => `- ${t}`).join('\n')}
+${bible.technical.accessibility ? `## Accessibility Features
+List the planned accessibility features:
+${bible.technical.accessibility.colorblindMode ? '- Colorblind mode support' : ''}
+${bible.technical.accessibility.subtitles ? '- Subtitles for audio' : ''}
+${bible.technical.accessibility.remappableControls ? '- Remappable controls' : ''}
+${bible.technical.accessibility.difficultyOptions ? '- Adjustable difficulty options' : ''}
+` : ''}
 
-Expand on each section with practical implementation notes.`;
-        const result = await this.callLLMWithAutoRetry(prompt, modelSelector_1.TaskComplexity.MODERATE, {
-            initialMaxTokens: 16000,
+IMPORTANT: Keep this document SHORT (1-2 pages max). This is for stakeholders to understand the technical direction, not a developer specification. Do NOT include:
+- Code or pseudo-code
+- Directory structures
+- Tool lists
+- Performance metrics
+- Implementation details`;
+        const result = await this.callLLMWithAutoRetry(prompt, modelSelector_1.TaskComplexity.SIMPLE, {
+            initialMaxTokens: 4000,
             maxRetries: 2,
             onProgress: onProgress
         });