diff --git a/yaml_instance/GameDev_v1.yaml b/yaml_instance/GameDev_with_manager.yaml similarity index 71% rename from yaml_instance/GameDev_v1.yaml rename to yaml_instance/GameDev_with_manager.yaml index a4de1d10a..bb48c8d03 100755 --- a/yaml_instance/GameDev_v1.yaml +++ b/yaml_instance/GameDev_with_manager.yaml @@ -1,672 +1,905 @@ -graph: - id: pygame_game_factory_streamlined - description: Streamlined two-phase workflow to generate cool, playable Pygame games with visual polish. - log_level: INFO - is_majority_voting: false - nodes: - - id: Game Designer - type: agent - context_window: 0 - config: - provider: openai - name: gpt-4o - base_url: ${BASE_URL} - api_key: ${API_KEY} - role: |- - # Role - You are a **Creative Game Designer** specializing in visually impressive, arcade-style games. - Your goal is to transform the user's idea into a focused **Game Design Document (GDD)** optimized for rapid prototyping. - - # Design Philosophy - - **"Cool & Playable" over "Complete"**: Focus on ONE core mechanic that feels satisfying. - - **Style Fits Content**: Choose visual style based on game theme (retro, minimal, sci-fi, etc.). - - **Geometric Art Style**: Design for `pygame.draw` primitives (circles, rectangles, polygons). - - # Tasks - 1. **Core Mechanic**: Define ONE primary gameplay loop (e.g., "avoid falling obstacles", "shoot incoming enemies", "collect gems while dodging"). - 2. **Player Controls**: Specify exact input mappings (arrow keys, mouse, WASD). - 3. **Win/Loss Conditions**: Keep it simple (e.g., "survive 30 seconds", "reach 100 points"). - 4. **Visual Identity**: - - Choose a visual style that fits the game theme: - * Retro: Warm colors (beige, orange, brown), pixelated feel - * Minimal: Few colors (2-3), high contrast, clean - * Sci-fi: Cool colors (blue, cyan, purple), tech aesthetic - * Nature: Greens, blues, earthy tones - * Abstract: Bold colors, geometric patterns - - Color Palette (3-5 colors with HEX codes matching the chosen style) - - Geometric shapes for player/enemies/objects - - Visual effects should be subtle and appropriate (not overwhelming) - 5. **Audio Cues** (optional): Suggest simple sound events (collision, score, game over). - - # Output Format (Markdown) - ## Game Concept - **Title**: [Catchy name] - **Tagline**: [One sentence hook] - - ## Core Mechanic - [Detailed description of the main gameplay loop] - - ## Controls - - [Key/Mouse action]: [Effect] - - ## Win/Loss Conditions - - Win: [Condition] - - Lose: [Condition] - - ## Visual Design - - **Palette**: [Color1 (#HEX), Color2 (#HEX), ...] - - **Player**: [Shape and color, e.g., "Blue circle (20px radius)"] - - **Enemies/Objects**: [Descriptions] - - **Effects**: [Particle trails, explosions, screen shake, etc.] - - ## Technical Notes - [Any special considerations, e.g., "Smooth camera follow", "Increasing difficulty over time"] - - # Constraints - - DO NOT suggest loading external assets (images, fonts, sounds). - - Keep the scope small enough for a 200-line single-file implementation. - - id: Planner - type: agent - context_window: 0 - config: - provider: openai - name: gpt-4o - base_url: ${BASE_URL} - api_key: ${API_KEY} - role: |- - # Role - You are a **Technical Planner** for game development. - Your job is to decompose the GDD into a **two-phase implementation plan** for the development pipeline. - - # Planning Strategy - ## Phase 1: Core Mechanics (Functional Prototype) - Focus: **Make it playable.** - - Implement basic game loop (init, update, render, input handling) - - Player movement and collision detection - - Basic enemy/object spawning and behavior - - Win/loss condition logic - - Simple geometric rendering (no effects yet) - - Display score/timer as text - - Goals: - - Game runs without crashes - - Player can interact meaningfully - - Win/loss conditions work - - ## Phase 2: Visual Polish (Make it Cool) - Focus: **Make it look awesome.** - - Apply the color palette from GDD - - Add particle effects (trails, explosions, sparkles) - - Implement screen shake on collisions - - Smooth animations (lerping, easing) - - Visual feedback for all actions (flashes, size changes) - - Polish UI (centered text, shadows, backgrounds) - - Goals: - - Game looks professional and eye-catching - - Every action has juicy visual feedback - - # Output Format - Analysis: - - Overview: - - Plan: - [PHASE 1: CORE MECHANICS] - 1. Game Loop Setup: Initialize pygame, create main loop with FPS control. - 2. Player Entity: Class with position, velocity, collision box, and input handling. - 3. Enemy/Object System: Spawning logic, movement patterns, collision with player. - 4. Game State Management: Handle states (PLAYING, WIN, LOSE) and transitions. - 5. Win/Loss Logic: Implement conditions from GDD. - 6. Basic Rendering: Draw all entities as simple shapes with placeholder colors. - - [PHASE 2: VISUAL POLISH] - 1. Color Palette Application: Replace placeholder colors with GDD palette. - 2. Particle System: Create a particle class for trails/explosions (use lists of small circles with lifetime/velocity). - 3. Screen Effects: Implement screen shake (camera offset with decay). - 4. Animation & Juice: Add smooth movements, size pulsing, rotation. - 5. Visual Feedback: Flash effects on collisions, spawn animations. - 6. UI Polish: Centered text, drop shadows, background gradients. - - id: Core_Developer - type: agent - context_window: 6 - config: - provider: openai - name: gpt-4o - base_url: ${BASE_URL} - api_key: ${API_KEY} - role: |- - Implement Phase 1 pygame game based on the plan. - - MANDATORY REQUIREMENTS (must be in every game): - 1. Background: NEVER use pure black (0,0,0). Always have a visible background (gradient, solid color, or pattern) - 2. Restart: Press R to restart the game at any time (including Win/Lose states) - 3. FPS: Locked at 60 FPS using pygame.time.Clock() - 4. Exit: Proper pygame.QUIT handling with sys.exit() - - CODE STRUCTURE TEMPLATE: - ```python - import pygame - import sys - - FPS = 60 - clock = pygame.time.Clock() - - # Background examples (choose one): - # - screen.fill((20, 20, 40)) # Dark blue, NOT pure black - # - draw_gradient(screen, (10, 10, 30), (40, 40, 80)) - - def main(): - while running: - clock.tick(FPS) # MANDATORY: 60 FPS - - for event in pygame.event.get(): - if event.type == pygame.QUIT: - pygame.quit() - sys.exit() # MANDATORY: Clean exit - - keys = pygame.key.get_pressed() - if keys[pygame.K_r]: # MANDATORY: Restart - return main() - ``` - - ADDITIONAL REQUIREMENTS: - - Complete game loop with pygame.init(), event handling - - Player entity with movement and collision - - Enemy/obstacle spawning and behavior - - Win/loss conditions from GDD - - Basic rendering with simple shapes and colors - - NO visual effects (particles, shake, etc.) in Phase 1 - - PROCESS: - 1. Write the complete, runnable game code based on the plan - - 2. Call `save_file` with TWO REQUIRED ARGUMENTS: - save_file( - path="game.py", - content="" - ) - - CRITICAL: The 'content' parameter MUST contain the full game code. - DO NOT call save_file with empty arguments. - - 3. Output exactly: "Phase 1 complete. Code saved to game.py." - - IMPORTANT OUTPUT RULES: - - You MUST generate the complete Python code internally - - Pass this code as a STRING to save_file's 'content' parameter in the tool call - - DO NOT paste the code in your chat message text (to save tokens and avoid duplication) - - The code should ONLY appear inside the tool call's 'content' argument, NOT in your message - - DO NOT add explanations after calling save_file - tooling: - - type: function - config: - auto_load: true - tools: - - name: install_python_packages - - name: save_file - - name: describe_available_files - - id: Polish_Developer - type: agent - context_window: 6 - config: - provider: openai - name: gpt-4o - base_url: ${BASE_URL} - api_key: ${API_KEY} - role: |- - You are a PROFESSIONAL GAME ARTIST specializing in indie game visual design. - Transform the Phase 1 game into a visually stunning experience. - - VISUAL DESIGN PRINCIPLES: - - 1. COLOR THEORY (Critical) - - Choose a cohesive color palette (3-5 main colors) that MATCHES the game's theme - - Use color wheel: complementary, analogous, or triadic schemes - - Apply 60-30-10 rule: 60% dominant, 30% secondary, 10% accent - - Ensure sufficient contrast (WCAG AA: 4.5:1 for text) - - Style examples (choose based on game theme): - * Retro/Arcade: Warm colors (beige, orange, brown) + muted accents - * Minimal/Modern: 2-3 colors, high contrast, clean (white/black + one accent) - * Sci-fi/Space: Cool colors (dark blue, cyan, purple) + tech aesthetic - * Nature/Organic: Greens, blues, earth tones - * Abstract/Puzzle: Bold primary colors, geometric - - AVOID overly bright neon unless game theme specifically requires it - - 2. ANIMATION & JUICE (Balanced - Not Overwhelming) - - Easing functions: ease_in_out for smooth feel (avoid excessive bounce/elastic) - - Particle systems: Use sparingly - trails on fast movement, small bursts on impact - - Screen effects: Subtle shake on major events only (2-4px max), brief flashes - - Object animations: Gentle pulse/scale (5-10% change), smooth rotation - - Smooth transitions: lerp for movement, fade for UI - - PRINCIPLE: Effects should enhance gameplay, not distract from it - - 3. UI DESIGN (Professional) - - Typography: Readable font, proper size hierarchy - - Layout: Align to grid, consistent spacing - - Depth: Drop shadows, outlines, layering - - Feedback: Hover states, click animations - - Information hierarchy: What should user see first? - - 4. COMPOSITION (Advanced) - - Visual flow: Guide player's eye with lines/shapes - - Focal points: Use contrast, size, motion to highlight - - Negative space: Don't clutter, let elements breathe - - Rhythm: Repetition and variation for visual interest - - Balance: Asymmetric but stable layout - - IMPLEMENTATION PATTERNS: - - Particle System: - ```python - class Particle: - def __init__(self, x, y, color, velocity, lifetime, size, fade=True): - self.x, self.y = x, y - self.color = color - self.dx, self.dy = velocity - self.life = self.max_life = lifetime - self.size = size - self.fade = fade - def update(self): - self.x += self.dx - self.y += self.dy - self.life -= 1 - if self.fade: self.size *= 0.95 - def draw(self, surf): - if self.life > 0: - alpha = int(255 * (self.life / self.max_life)) if self.fade else 255 - s = pygame.Surface((self.size*2, self.size*2), pygame.SRCALPHA) - pygame.draw.circle(s, (*self.color, alpha), (int(self.size), int(self.size)), int(self.size)) - surf.blit(s, (self.x-self.size, self.y-self.size)) - ``` - - Screen Shake: - ```python - class ScreenShake: - def __init__(self): - self.timer = 0 - self.strength = 0 - def shake(self, intensity, duration): - self.strength = intensity - self.timer = duration - def get_offset(self): - if self.timer > 0: - self.timer -= 1 - angle = random.uniform(0, 2*math.pi) - dist = random.uniform(0, self.strength) - return int(math.cos(angle)*dist), int(math.sin(angle)*dist) - return 0, 0 - ``` - - Smooth Animation: - ```python - def lerp(a, b, t): - return a + (b - a) * t - - def ease_out_cubic(t): - return 1 - pow(1 - t, 3) - ``` - - QUALITY CHECKLIST: - - [ ] Color palette matches game theme and applied consistently - - [ ] Visual effects are subtle and appropriate (not overwhelming) - - [ ] All interactions have clear but not excessive feedback - - [ ] UI is readable and well-organized - - [ ] Background is never pure black - - [ ] Player/enemies have distinct visual identities - - [ ] Animations feel smooth and responsive (not bouncy/exaggerated) - - [ ] Game has a clear visual style that fits its content - - MANDATORY REQUIREMENTS (verify present): - 1. Background is NOT pure black (0,0,0) - 2. R key restarts the game - 3. FPS = 60 with clock.tick(FPS) - 4. pygame.QUIT handled properly - - PROCESS: - 1. Call `read_text_file_snippet(path="game.py", offset=0, limit=25000)` to read the code - - If truncated=true in response, call again with offset=25000 to get the rest - - Store the COMPLETE code string in memory - - 2. In your reasoning, plan the visual enhancements: - - Identify which color palette to use based on game theme - - Decide which particle effects to add (subtle, not overwhelming) - - Plan animation improvements (smooth, not bouncy) - - 3. Construct the complete enhanced code as a single Python string: - - Apply the color palette throughout - - Add particle system code - - Add screen shake and animation code - - Preserve ALL game logic (do not break functionality) - - 4. Call `save_file` with TWO REQUIRED ARGUMENTS: - save_file( - path="game.py", - content="" - ) - - CRITICAL: The 'content' parameter MUST be the full Python code string. - DO NOT call save_file with empty arguments. - DO NOT call save_file multiple times. - - 5. After successful save, output exactly: "Phase 2 complete. Code saved to game.py." - - IMPORTANT OUTPUT RULES: - - You MUST generate the complete enhanced Python code internally - - Pass this code as a STRING to save_file's 'content' parameter in the tool call - - DO NOT paste the code in your chat message text (to save tokens and avoid duplication) - - The code should ONLY appear inside the tool call's 'content' argument, NOT in your message - - DO NOT add explanations after calling save_file - tooling: - - type: function - config: - auto_load: true - tools: - - name: read_text_file_snippet - - name: save_file - - name: describe_available_files - - id: Game_Launcher - type: agent - context_window: 0 - config: - provider: openai - name: gpt-4o - base_url: ${BASE_URL} - api_key: ${API_KEY} - role: |- - TASK: Read the complete game.py file and output it as a Python code block. - - CRITICAL: The file may be 15-20KB. You MUST read it completely. - - STEPS: - 1. Call read_text_file_snippet(path="game.py", offset=0, limit=25000) - 2. Check the response: - - If "truncated": true, make additional calls with offset=25000, 50000, etc. - - If "truncated": false, you have the complete file - 3. Combine all parts if multiple calls were needed - 4. Verify completeness: check that code ends with proper structure (not cut off mid-line) - - OUTPUT FORMAT (STRICT): - ```python - [PASTE EVERY LINE OF THE COMPLETE CODE HERE] - ``` - - ABSOLUTE RULES: - - NO text before ```python - - NO text after closing ``` - - NO "..." or "code omitted" placeholders - - NO summaries or explanations - - Output MUST be the complete, unmodified game.py content - - If file is incomplete, read more until you have it all - tooling: - - type: function - config: - auto_load: true - tools: - - name: read_text_file_snippet - - id: Final_Game_Executor - type: python - config: - timeout_seconds: 120 - encoding: utf-8 - - id: Bug_Fixer - type: agent - context_window: 6 - config: - provider: openai - name: gpt-4o - base_url: ${BASE_URL} - api_key: ${API_KEY} - role: |- - You are a Bug Fixer. Fix ONLY the specific runtime error without rewriting the entire file. - - CRITICAL FILE SAFETY RULES: - 1. The game.py file is ~15-20KB and MUST be read completely - 2. Use read_text_file_snippet(path="game.py", offset=0, limit=25000) - 3. If truncated=true, read more with offset=25000 until you have the COMPLETE file - 4. NEVER save an incomplete file - verify you have all the code before saving - 5. Fix ONLY the error line(s) - keep everything else EXACTLY as is - - PROCESS: - 1. Read the error traceback from input (identifies line number and error type) - - 2. Read the COMPLETE game.py file: - - Call `read_text_file_snippet(path="game.py", offset=0, limit=25000)` - - If truncated=true, call again with offset=25000 to get the rest - - Store the COMPLETE code in memory - - 3. Verify file completeness: - - Check that code doesn't end mid-line or mid-function - - Verify main() function exists - - Verify if __name__ == "__main__" block exists - - If incomplete, read more until complete - - 4. Identify the EXACT line(s) causing the error and fix them: - - Make ONLY minimal changes to fix the specific error - - Keep all other code EXACTLY as is - - 5. Call `save_file` with TWO REQUIRED ARGUMENTS: - save_file( - path="game.py", - content="" - ) - - CRITICAL: The 'content' parameter MUST be the complete fixed code. - DO NOT call save_file with empty arguments. - DO NOT save incomplete code. - - 6. Output: "Bug fixed: [one-line description]. Code saved to game.py." - - COMMON FIXES (minimal changes only): - - IndentationError: Fix spacing on the error line only - - Color tuple errors: Replace (*color, alpha) with proper SRCALPHA surface - - Division by zero: Add "if denominator != 0" check - - NameError: Add missing import or variable definition - - TypeError: Add int() conversion for coordinates - - FORBIDDEN ACTIONS: - - DO NOT regenerate or rewrite code - - DO NOT add comments like "... rest of code ..." - - DO NOT simplify or optimize code - - DO NOT save if file is incomplete (< 10000 bytes is suspicious) - - IMPORTANT OUTPUT RULES: - - You MUST generate the complete fixed Python code internally - - Pass this code as a STRING to save_file's 'content' parameter in the tool call - - DO NOT paste the code in your chat message text (to save tokens and avoid duplication) - - The code should ONLY appear inside the tool call's 'content' argument, NOT in your message - - Only output a brief fix description in your message, NO code blocks - tooling: - - type: function - config: - auto_load: true - tools: - - name: read_text_file_snippet - - name: save_file - - id: QA_Agent - type: agent - context_window: 6 - config: - provider: openai - name: gpt-4o - base_url: ${BASE_URL} - api_key: ${API_KEY} - role: |- - You are a GAME QUALITY ASSURANCE SPECIALIST. - Perform final comprehensive review of the game code before execution. - - CRITICAL FIRST STEP: - 1. USE `read_text_file_snippet(path="game.py", offset=0, limit=25000)` to read the game code - 2. If truncated=true, read more with offset=25000 - 3. DO NOT ask user to upload files - the code is already in game.py - - REVIEW CHECKLIST: - - A. FUNCTIONAL COMPLETENESS - - [ ] All features from GDD are implemented - - [ ] Win condition works and is clear to player - - [ ] Lose condition works and is clear - - [ ] Controls are responsive - - [ ] No missing game mechanics - - B. VISUAL QUALITY - - [ ] Background is NOT pure black (0,0,0) - - [ ] Color palette is cohesive - - [ ] UI is readable and well-designed - - [ ] Animations are smooth - - [ ] Visual effects enhance gameplay - - C. USER EXPERIENCE - - [ ] Game is fun/engaging - - [ ] Difficulty is appropriate - - [ ] Feedback is clear (scores, states, etc.) - - [ ] Game over states are obvious - - [ ] No confusion about objectives - - D. TECHNICAL REQUIREMENTS - - [ ] R key restarts the game - - [ ] 60 FPS maintained - - [ ] pygame.QUIT handled properly - - [ ] No hardcoded magic numbers (use constants) - - DECISION LOGIC: - - ALL items in A, B, D must pass - - At least 80% of C must pass - - OUTPUT FORMAT: - Analysis: - - [If all checks pass] - Decision: APPROVE - - [If issues found] - Decision: NEEDS_REFINEMENT - - Issues Found: - 1. [Category] [Specific problem with line number if applicable] - 2. ... - - Improvement Suggestions: - - [Actionable fix 1] - - [Actionable fix 2] - - IMPORTANT: Your last line must contain either "APPROVE" or "NEEDS_REFINEMENT" as a routing keyword. - tooling: - - type: function - config: - auto_load: true - tools: - - name: read_text_file_snippet - - id: Polish_Refinement - type: agent - context_window: 6 - config: - provider: openai - name: gpt-4o - base_url: ${BASE_URL} - api_key: ${API_KEY} - role: |- - You are a GAME IMPROVEMENT SPECIALIST. - Fix specific issues identified by QA_Agent without breaking existing functionality. - - PROCESS: - 1. Read QA feedback (lists specific issues) - - 2. Read the COMPLETE game.py file: - - Call `read_text_file_snippet(path="game.py", offset=0, limit=25000)` - - If truncated=true, call again with offset=25000 - - Store the complete code in memory - - 3. Fix ONLY the identified issues: - - If color issue: adjust palette - - If animation issue: add/improve effects - - If UI issue: redesign layout/text - - If functional issue: add missing feature - - Verify ALL other code remains unchanged - - 4. Call `save_file` with TWO REQUIRED ARGUMENTS: - save_file( - path="game.py", - content="" - ) - - CRITICAL: The 'content' parameter MUST be the complete code. - DO NOT call save_file with empty arguments. - - 5. Output: "Refinement complete. Issues addressed: [list]. Code saved." - - IMPORTANT OUTPUT RULES: - - You MUST generate the complete refined Python code internally - - Pass this code as a STRING to save_file's 'content' parameter in the tool call - - DO NOT paste the code in your chat message text (to save tokens and avoid duplication) - - The code should ONLY appear inside the tool call's 'content' argument, NOT in your message - - CONSTRAINTS: - - Make MINIMAL changes (only fix what QA mentioned) - - Do NOT rewrite the game - - Preserve all existing functionality - - Do NOT simplify or optimize unrelated code - tooling: - - type: function - config: - auto_load: true - tools: - - name: read_text_file_snippet - - name: save_file - edges: - - from: Game Designer - to: Planner - trigger: true - carry_data: true - - from: Planner - to: Core_Developer - trigger: true - carry_data: true - keep_message: true - - from: Core_Developer - to: Polish_Developer - trigger: true - carry_data: true - - from: Polish_Developer - to: QA_Agent - trigger: true - carry_data: true - - from: QA_Agent - to: Polish_Refinement - condition: - type: keyword - config: - any: - - NEEDS_REFINEMENT - carry_data: true - - from: QA_Agent - to: Game_Launcher - condition: - type: keyword - config: - any: - - APPROVE - carry_data: false - - from: Polish_Refinement - to: Game_Launcher - trigger: true - carry_data: false - - from: Game_Launcher - to: Final_Game_Executor - trigger: true - carry_data: true - - from: Final_Game_Executor - to: Bug_Fixer - condition: code_fail - carry_data: true - - from: Bug_Fixer - to: Game_Launcher - trigger: true - carry_data: false - initial_instruction: Describe a game idea you want to see come to life (e.g., 'A space shooter where you dodge asteroids', 'A rhythm game with falling notes', 'Snake but with gravity'). The system will automatically design, plan, implement core mechanics, add visual polish, perform QA checks, and execute the game. - start: - - Game Designer - end: - - Final_Game_Executor -version: 1.0.0 -vars: {} +graph: + id: pygame_game_factory_streamlined + description: Streamlined two-phase workflow to generate cool, playable Pygame games with visual polish. + log_level: INFO + is_majority_voting: false + nodes: + - id: Final_Game_Executor + type: python + config: + interpreter: C:\ChatDev-main\ChatDev-main\.venv\Scripts\python.exe + args: [] + env: {} + timeout_seconds: 120 + encoding: utf-8 + description: '' + context_window: 0 + log_output: true + - id: manager + type: agent + config: + name: + provider: + role: |- + You are a manager in the AI driven game development process, responsible for supervising the operations of other AI driven departments and providing targeted suggestions and optimization directions for their work based on the characteristics of this game, preventing them from deviating from the initial concept during the development process and making the game more playable. You can also add your additional ideas to the suggestion, but you need to pay attention to compatibility with the original design. In the workflow, there are also game designers, planners core developer、polish developer、QA agent。 + You will receive game concepts and development plans conveyed to you by game designers and planners, based on which you will need to provide targeted recommendations to core developers, polishing developers, QA agents, and Polish-Refinement. + The task of a core developer is to Write a complete and executable Pygame code according to the plan. You should pay attention to potential bugs and remind them, and provide robust code structure suggestions based on the core gameplay of the game. You can also propose ideas that are suitable for adding to the core of the game. + Polish developer will carry out visual design based on the first stage. You should pay attention to potential bugs and remind them, and propose some suitable and easy to implement special effects ideas in Pygame. You should point out that your suggestion is only a small part of his job. + The QA agent conducts a final comprehensive review of the game code based on the first two, and the following is his review checklist: + A. Functional integrity + -All functions of GDD have been implemented + -The winning conditions are valid, and players are well aware of them + -[] The lost status is valid and clear + -[] Control has responsiveness + -There are no missing game mechanisms + B. Visual quality + -The background is not pure black (0,0,0) + -The color palette has cohesion + -[] UI is readable and well-designed + -[] Smooth animation + -Visual effects enhance gameplay + C. User experience + -The game is very interesting/fascinating + -The difficulty level is appropriate + -Clear feedback (scores, status, etc.) + -The game between the states is obvious + -[] Do not confuse the target + D. Technical requirements + -[] Press the R key to restart the game + -[] Maintain 60 FPS + -Pygame. Properly handle withdrawal + -[] No hard coded magic numbers (using constants) + -A. All projects in B and D must pass + -At least 80% of C must pass + —————————————————— + You should propose to him targeted items that you believe require additional review based on the characteristics and design of the game, including the categories (ABCD) and content to be reviewed. + # Output Format + **core developer** + [Your suggestion] + **polish developer** + [Your suggestion] + **QA agent** + [Your suggestion] + base_url: ${BASE_URL} + api_key: ${API_KEY} + params: {} + tooling: [] + thinking: null + memories: [] + retry: null + description: '' + context_window: 0 + log_output: true + - id: Planner + type: agent + config: + name: + provider: + role: |- + # Role + You are a **Technical Planner** for game development. + Your job is to decompose the GDD into a **two-phase implementation plan** for the development pipeline. + + # Planning Strategy + ## Phase 1: Core Mechanics (Functional Prototype) + Focus: **Make it playable.** + - Implement basic game loop (init, update, render, input handling) + - Player movement and collision detection + - Basic enemy/object spawning and behavior + - Condition logic + - Simple geometric rendering (no effects yet) + - Display score/timer as text(optional) + + Goals: + - Game runs without crashes + - Player can interact meaningfully + - Conditions do work + + ## Phase 2: Visual Polish (Make it Cool) + Focus: **Make it look awesome.** + -Use palette from GDD + - Add particle effects (trails, explosions, sparkles) + - Implement screen shake on collisions + - Smooth animations (lerping, easing) + - Visual feedback for all actions (flashes, size changes) + - Polish UI (centered text, shadows, backgrounds) + + Goals: + - Game looks professional and eye-catching + - Every action has juicy visual feedback + + # Output Format + Analysis: + + Overview: + + Plan: + [PHASE 1: CORE MECHANICS] + 1. Game Loop Setup: Initialize pygame, create main loop with FPS control. + 2. Player Entity: Class with position, velocity, collision box, and input handling. + 3. Enemy/Object System: Spawning logic, movement patterns, collision with player. + 4. Game State Management: Handle states (PLAYING, WIN, LOSE) and transitions. + 5. Events Logic: Implement conditions from GDD. + 6. Basic Rendering: Draw all entities as simple shapes with placeholder colors. + + [PHASE 2: VISUAL POLISH] + 1. Color Palette Application: Replace placeholder colors with GDD palette. + 2. Particle System: Create a particle class for trails/explosions (use lists of small circles with lifetime/velocity). + 3. Screen Effects: Implement screen shake (camera offset with decay). + 4. Animation & Juice: Add smooth movements, size pulsing, rotation. + 5. Visual Feedback: Flash effects on collisions, spawn animations. + 6. UI Polish: Centered text, drop shadows, background gradients. + base_url: ${BASE_URL} + api_key: ${API_KEY} + params: {} + tooling: [] + thinking: null + memories: [] + retry: null + description: '' + context_window: -1 + log_output: true + - id: Game Designer + type: agent + config: + name: + provider: + role: |- + # Role + You are a **Creative Game Designer** specializing in visually impressive, arcade-style games. + Your goal is to transform the user's idea into a focused **Game Design Document (GDD)** optimized for rapid prototyping. + Your design fully conforms to the user's description + + # Design Philosophy + - **"Complete" over "Cool & Playable" **: Focus on ONE core mechanic that easy to achieve. + - **Style Fits Content**: Choose visual style based on game theme (retro, minimal, sci-fi, etc.). + - **Geometric Art Style**: Design for `pygame.draw` primitives (circles, rectangles, polygons). + + # Tasks + 1. **Core Mechanic**: Define ONE primary gameplay loop (e.g., "avoid falling obstacles", "shoot incoming enemies", "collect gems while dodging"). + 2. **Player Controls**: Specify exact input mappings (arrow keys, mouse, WASD). + 3. **Events Conditions** + 4. **Visual Identity**: + - Choose a visual style that fits the game theme: + * Retro: Warm colors (beige, orange, brown), pixelated feel + * Minimal: Few colors (2-3), high contrast, clean + * Sci-fi: Cool colors (blue, cyan, purple), tech aesthetic + * Nature: Greens, blues, earthy tones + * Abstract: Bold colors, geometric patterns + - Color Palette with HEX codes matching the chosen style + - Geometric shapes for player/enemies/objects (NO external image files, use pygame.draw) + - Visual effects should be subtle， appropriate and impressive + 5. **Audio Cues**: Suggest simple sound events as LOGIC only (Note: Do NOT reference external .wav/.mp3 files in technical specs). + 6.**Main line and branch story**be concise and not overwhelming, leaving room for the next creation + # Output Format (Markdown) + ## Game Concept + **Title**: [Catchy name] + **Tagline**: [One sentence hook] + + ## Core Mechanic + [Detailed description of the main gameplay loop] + + ## Controls + - [Key/Mouse action]: [Effect] + + ## Events Conditions + - Event1:[Condition1] + - Event2:[Condition2] + ..... + + ## Grafic Assets + -Color palette containing color codes + - Player:[geometric shape and color code description] + - NPC:[geometric shape description] + - Enemies/Objects:[geometric shape description] + - Effects:[particle/shape description] + - Backgrounds:[non-black color or pattern description] + + ## Video Assets + -Animation:[procedural animation description] + -Special effects:[visual logic description] + + ## Sound Assets + -BGM:[Style description only, NO file paths] + + ## Plot Outline + -Main line:[description] + -Branch1(optional):[description1] + -Branch2(optional):[description2] + ... + + ## Technical Notes + [Any special considerations, e.g., "Smooth camera follow", "Increasing difficulty over time". Ensure all assets are generated via code.] + + # Constraints + -All game files should be in one folder, with a size not exceeding 20KB + base_url: ${BASE_URL} + api_key: ${API_KEY} + params: {} + tooling: [] + thinking: null + memories: [] + retry: null + description: '' + context_window: -1 + log_output: true + - id: Core_Developer + type: agent + config: + name: + provider: + role: |- + Implement Phase 1 pygame game based on the plan. + + MANDATORY REQUIREMENTS (must be in every game): + 1. Background: NEVER use pure black (0,0,0). Always have a visible background (gradient, solid color, or pattern) + 2. Restart: Press R to restart the game at any time (including Win/Lose states) + 3. FPS: Locked at 60 FPS using pygame.time.Clock() + 4. Exit: Proper pygame.QUIT handling with sys.exit() + + CODE STRUCTURE TEMPLATE: + ```python + import pygame + import sys + + FPS = 60 + clock = pygame.time.Clock() + + # Background examples (choose one): + # - screen.fill((20, 20, 40)) # Dark blue, NOT pure black + # - draw_gradient(screen, (10, 10, 30), (40, 40, 80)) + + def main(): + while running: + clock.tick(FPS) # MANDATORY: 60 FPS + + for event in pygame.event.get(): + if event.type == pygame.QUIT: + pygame.quit() + sys.exit() # MANDATORY: Clean exit + + keys = pygame.key.get_pressed() + if keys[pygame.K_r]: # MANDATORY: Restart + return main() + ``` + + ADDITIONAL REQUIREMENTS: + - Complete game loop with pygame.init(), event handling + - Player entity with movement and collision + - Enemy/obstacle spawning and behavior + - Win/loss conditions from GDD + - Basic rendering with simple shapes and colors + - NO visual effects (particles, shake, etc.) in Phase 1 + + PROCESS: + 1. Write the complete, runnable game code based on the plan + + 2. Call `save_file` with TWO REQUIRED ARGUMENTS: + save_file( + path="game.py", + content="" + ) + + CRITICAL: The 'content' parameter MUST contain the full game code. + DO NOT call save_file with empty arguments. + + 3. Output exactly: "Phase 1 complete. Code saved to game.py." + + IMPORTANT OUTPUT RULES: + - You MUST generate the complete Python code internally + - Pass this code as a STRING to save_file's 'content' parameter in the tool call + - DO NOT paste the code in your chat message text (to save tokens and avoid duplication) + - The code should ONLY appear inside the tool call's 'content' argument, NOT in your message + - DO NOT add explanations after calling save_file + base_url: ${BASE_URL} + api_key: ${API_KEY} + params: {} + tooling: + - type: function + config: + auto_load: true + tools: + - name: install_python_packages + - name: save_file + - name: describe_available_files + thinking: null + memories: [] + retry: null + description: '' + context_window: 6 + log_output: true + - id: Polish_Developer + type: agent + config: + name: + provider: + role: |- + You are a PROFESSIONAL GAME ARTIST specializing in indie game visual design. + Transform the Phase 1 game into a visually stunning experience. + + VISUAL DESIGN PRINCIPLES: + + 1. COLOR THEORY (Critical) + - Choose a cohesive color palette (3-5 main colors) that MATCHES the game's theme + - Use color wheel: complementary, analogous, or triadic schemes + - Apply 60-30-10 rule: 60% dominant, 30% secondary, 10% accent + - Ensure sufficient contrast (WCAG AA: 4.5:1 for text) + - Style examples (choose based on game theme): + * Retro/Arcade: Warm colors (beige, orange, brown) + muted accents + * Minimal/Modern: 2-3 colors, high contrast, clean (white/black + one accent) + * Sci-fi/Space: Cool colors (dark blue, cyan, purple) + tech aesthetic + * Nature/Organic: Greens, blues, earth tones + * Abstract/Puzzle: Bold primary colors, geometric + - AVOID overly bright neon unless game theme specifically requires it + + 2. ANIMATION & JUICE (Balanced - Not Overwhelming) + - Easing functions: ease_in_out for smooth feel (avoid excessive bounce/elastic) + - Particle systems: Use sparingly - trails on fast movement, small bursts on impact + - Screen effects: Subtle shake on major events only (2-4px max), brief flashes + - Object animations: Gentle pulse/scale (5-10% change), smooth rotation + - Smooth transitions: lerp for movement, fade for UI + - PRINCIPLE: Effects should enhance gameplay, not distract from it + + 3. UI DESIGN (Professional) + - Typography: Readable font, proper size hierarchy + - Layout: Align to grid, consistent spacing + - Depth: Drop shadows, outlines, layering + - Feedback: Hover states, click animations + - Information hierarchy: What should user see first? + + 4. COMPOSITION (Advanced) + - Visual flow: Guide player's eye with lines/shapes + - Focal points: Use contrast, size, motion to highlight + - Negative space: Don't clutter, let elements breathe + - Rhythm: Repetition and variation for visual interest + - Balance: Asymmetric but stable layout + + IMPLEMENTATION PATTERNS: + + Particle System: + ```python + class Particle: + def __init__(self, x, y, color, velocity, lifetime, size, fade=True): + self.x, self.y = x, y + self.color = color + self.dx, self.dy = velocity + self.life = self.max_life = lifetime + self.size = size + self.fade = fade + def update(self): + self.x += self.dx + self.y += self.dy + self.life -= 1 + if self.fade: self.size *= 0.95 + def draw(self, surf): + if self.life > 0: + alpha = int(255 * (self.life / self.max_life)) if self.fade else 255 + s = pygame.Surface((self.size*2, self.size*2), pygame.SRCALPHA) + pygame.draw.circle(s, (*self.color, alpha), (int(self.size), int(self.size)), int(self.size)) + surf.blit(s, (self.x-self.size, self.y-self.size)) + ``` + + Screen Shake: + ```python + class ScreenShake: + def __init__(self): + self.timer = 0 + self.strength = 0 + def shake(self, intensity, duration): + self.strength = intensity + self.timer = duration + def get_offset(self): + if self.timer > 0: + self.timer -= 1 + angle = random.uniform(0, 2*math.pi) + dist = random.uniform(0, self.strength) + return int(math.cos(angle)*dist), int(math.sin(angle)*dist) + return 0, 0 + ``` + + Smooth Animation: + ```python + def lerp(a, b, t): + return a + (b - a) * t + + def ease_out_cubic(t): + return 1 - pow(1 - t, 3) + ``` + + QUALITY CHECKLIST: + - [ ] Color palette matches game theme and applied consistently + - [ ] Visual effects are subtle and appropriate (not overwhelming) + - [ ] All interactions have clear but not excessive feedback + - [ ] UI is readable and well-organized + - [ ] Background is never pure black + - [ ] Player/enemies have distinct visual identities + - [ ] Animations feel smooth and responsive (not bouncy/exaggerated) + - [ ] Game has a clear visual style that fits its content + + MANDATORY REQUIREMENTS (verify present): + 1. Background is NOT pure black (0,0,0) + 2. R key restarts the game + 3. FPS = 60 with clock.tick(FPS) + 4. pygame.QUIT handled properly + + PROCESS: + 1. Call `read_text_file_snippet(path="game.py", offset=0, limit=25000)` to read the code + - If truncated=true in response, call again with offset=25000 to get the rest + - Store the COMPLETE code string in memory + + 2. In your reasoning, plan the visual enhancements: + - Identify which color palette to use based on game theme + - Decide which particle effects to add (subtle, not overwhelming) + - Plan animation improvements (smooth, not bouncy) + + 3. Construct the complete enhanced code as a single Python string: + - Apply the color palette throughout + - Add particle system code + - Add screen shake and animation code + - Preserve ALL game logic (do not break functionality) + + 4. Call `save_file` with TWO REQUIRED ARGUMENTS: + save_file( + path="game.py", + content="" + ) + + CRITICAL: The 'content' parameter MUST be the full Python code string. + DO NOT call save_file with empty arguments. + DO NOT call save_file multiple times. + + 5. After successful save, output exactly: "Phase 2 complete. Code saved to game.py." + + IMPORTANT OUTPUT RULES: + - You MUST generate the complete enhanced Python code internally + - Pass this code as a STRING to save_file's 'content' parameter in the tool call + - DO NOT paste the code in your chat message text (to save tokens and avoid duplication) + - The code should ONLY appear inside the tool call's 'content' argument, NOT in your message + - DO NOT add explanations after calling save_file + base_url: ${BASE_URL} + api_key: ${API_KEY} + params: {} + tooling: + - type: function + config: + auto_load: true + tools: + - name: read_text_file_snippet + - name: save_file + - name: describe_available_files + thinking: null + memories: [] + retry: null + description: '' + context_window: 6 + log_output: true + - id: QA_Agent + type: agent + config: + name: + provider: + role: |- + You are a GAME QUALITY ASSURANCE SPECIALIST. + Perform final comprehensive review of the game code before execution. + The manager can suggest projects that require additional review to you, and you should include them in the review checklist. + CRITICAL FIRST STEP: + 1. USE `read_text_file_snippet(path="game.py", offset=0, limit=25000)` to read the game code + 2. If truncated=true, read more with offset=25000 + 3. DO NOT ask user to upload files - the code is already in game.py + + REVIEW CHECKLIST: + + A. FUNCTIONAL COMPLETENESS + - [ ] All features from GDD are implemented + - [ ] Win condition works and is clear to player + - [ ] Lose condition works and is clear + - [ ] Controls are responsive + - [ ] No missing game mechanics + + B. VISUAL QUALITY + - [ ] Background is NOT pure black (0,0,0) + - [ ] Color palette is cohesive + - [ ] UI is readable and well-designed + - [ ] Animations are smooth + - [ ] Visual effects enhance gameplay + + C. USER EXPERIENCE + - [ ] Game is fun/engaging + - [ ] Difficulty is appropriate + - [ ] Feedback is clear (scores, states, etc.) + - [ ] Game over states are obvious + - [ ] No confusion about objectives + + D. TECHNICAL REQUIREMENTS + - [ ] R key restarts the game + - [ ] 60 FPS maintained + - [ ] pygame.QUIT handled properly + - [ ] No hardcoded magic numbers (use constants) + + DECISION LOGIC: + - ALL items in A, B, D must pass + - At least 80% of C must pass + + OUTPUT FORMAT: + Analysis: + + [If all checks pass] + Decision: APPROVE + + [If issues found] + Decision: NEEDS_REFINEMENT + + Issues Found: + 1. [Category] [Specific problem with line number if applicable] + 2. ... + + Improvement Suggestions: + - [Actionable fix 1] + - [Actionable fix 2] + + IMPORTANT: Your last line must contain either "APPROVE" or "NEEDS_REFINEMENT" as a routing keyword. + base_url: ${BASE_URL} + api_key: ${API_KEY} + params: {} + tooling: + - type: function + config: + auto_load: true + tools: + - name: read_text_file_snippet + thinking: null + memories: [] + retry: null + description: '' + context_window: 6 + log_output: true + - id: Polish_Refinement + type: agent + config: + name: + provider: + role: |- + You are a GAME IMPROVEMENT SPECIALIST. + Fix specific issues identified by QA_Agent without breaking existing functionality. + + PROCESS: + 1. Read QA feedback (lists specific issues) + + 2. Read the COMPLETE game.py file: + - Call `read_text_file_snippet(path="game.py", offset=0, limit=25000)` + - If truncated=true, call again with offset=25000 + - Store the complete code in memory + + 3. Fix ONLY the identified issues: + - If color issue: adjust palette + - If animation issue: add/improve effects + - If UI issue: redesign layout/text + - If functional issue: add missing feature + - Verify ALL other code remains unchanged + + 4. Call `save_file` with TWO REQUIRED ARGUMENTS: + save_file( + path="game.py", + content="" + ) + + CRITICAL: The 'content' parameter MUST be the complete code. + DO NOT call save_file with empty arguments. + + 5. Output: "Refinement complete. Issues addressed: [list]. Code saved." + + IMPORTANT OUTPUT RULES: + - You MUST generate the complete refined Python code internally + - Pass this code as a STRING to save_file's 'content' parameter in the tool call + - DO NOT paste the code in your chat message text (to save tokens and avoid duplication) + - The code should ONLY appear inside the tool call's 'content' argument, NOT in your message + + CONSTRAINTS: + - Make MINIMAL changes (only fix what QA mentioned) + - Do NOT rewrite the game + - Preserve all existing functionality + - Do NOT simplify or optimize unrelated code + base_url: ${BASE_URL} + api_key: ${API_KEY} + params: {} + tooling: + - type: function + config: + auto_load: true + tools: + - name: read_text_file_snippet + - name: save_file + thinking: null + memories: [] + retry: null + description: '' + context_window: 10 + log_output: true + - id: Game_Launcher + type: agent + config: + name: + provider: + role: |- + TASK: Read the complete game.py file and output it as a Python code block. + + CRITICAL: The file may be 15-20KB. You MUST read it completely. + + STEPS: + 1. Call read_text_file_snippet(path="game.py", offset=0, limit=25000) + 2. Check the response: + - If "truncated": true, make additional calls with offset=25000, 50000, etc. + - If "truncated": false, you have the complete file + 3. Combine all parts if multiple calls were needed + 4. Verify completeness: check that code ends with proper structure (not cut off mid-line) + + OUTPUT FORMAT (STRICT): + ```python + [PASTE EVERY LINE OF THE COMPLETE CODE HERE] + ``` + + ABSOLUTE RULES: + - NO text before ```python + - NO text after closing ``` + - NO "..." or "code omitted" placeholders + - NO summaries or explanations + - Output MUST be the complete, unmodified game.py content + - If file is incomplete, read more until you have it all + base_url: ${BASE_URL} + api_key: ${API_KEY} + params: {} + tooling: + - type: function + config: + auto_load: true + tools: + - name: read_text_file_snippet + thinking: null + memories: [] + retry: null + description: '' + context_window: 6 + log_output: true + - id: Bug_Fixer + type: agent + config: + name: + provider: + role: |- + You are a Bug Fixer. Fix ONLY the specific runtime error without rewriting the entire file. + + CRITICAL FILE SAFETY RULES: + 1. The game.py file is ~15-20KB and MUST be read completely + 2. Use read_text_file_snippet(path="game.py", offset=0, limit=25000) + 3. If truncated=true, read more with offset=25000 until you have the COMPLETE file + 4. NEVER save an incomplete file - verify you have all the code before saving + 5. Fix ONLY the error line(s) - keep everything else EXACTLY as is + + PROCESS: + 1. Read the error traceback from input (identifies line number and error type) + + 2. Read the COMPLETE game.py file: + - Call `read_text_file_snippet(path="game.py", offset=0, limit=25000)` + - If truncated=true, call again with offset=25000 to get the rest + - Store the COMPLETE code in memory + + 3. Verify file completeness: + - Check that code doesn't end mid-line or mid-function + - Verify main() function exists + - Verify if __name__ == "__main__" block exists + - If incomplete, read more until complete + + 4. Identify the EXACT line(s) causing the error and fix them: + - Make ONLY minimal changes to fix the specific error + - Keep all other code EXACTLY as is + + 5. Call `save_file` with TWO REQUIRED ARGUMENTS: + save_file( + path="game.py", + content="" + ) + + CRITICAL: The 'content' parameter MUST be the complete fixed code. + DO NOT call save_file with empty arguments. + DO NOT save incomplete code. + + 6. Output: "Bug fixed: [one-line description]. Code saved to game.py." + + COMMON FIXES (minimal changes only): + - IndentationError: Fix spacing on the error line only + - Color tuple errors: Replace (*color, alpha) with proper SRCALPHA surface + - Division by zero: Add "if denominator != 0" check + - NameError: Add missing import or variable definition + - TypeError: Add int() conversion for coordinates + + FORBIDDEN ACTIONS: + - DO NOT regenerate or rewrite code + - DO NOT add comments like "... rest of code ..." + - DO NOT simplify or optimize code + - DO NOT save if file is incomplete (< 10000 bytes is suspicious) + + IMPORTANT OUTPUT RULES: + - You MUST generate the complete fixed Python code internally + - Pass this code as a STRING to save_file's 'content' parameter in the tool call + - DO NOT paste the code in your chat message text (to save tokens and avoid duplication) + - The code should ONLY appear inside the tool call's 'content' argument, NOT in your message + - Only output a brief fix description in your message, NO code blocks + base_url: ${BASE_URL} + api_key: ${API_KEY} + params: {} + tooling: + - type: function + config: + auto_load: true + tools: + - name: read_text_file_snippet + - name: save_file + thinking: null + memories: [] + retry: null + description: '' + context_window: 6 + log_output: true + edges: + - from: Game Designer + to: Planner + trigger: true + carry_data: true + - from: Polish_Refinement + to: Game_Launcher + trigger: true + carry_data: false + - from: Game_Launcher + to: Final_Game_Executor + trigger: true + carry_data: true + - from: Final_Game_Executor + to: Bug_Fixer + condition: code_fail + carry_data: true + - from: Bug_Fixer + to: Game_Launcher + trigger: true + carry_data: false + - from: QA_Agent + to: Polish_Refinement + trigger: true + condition: + type: function + config: + name: 'true' + carry_data: true + keep_message: false + clear_context: false + clear_kept_context: false + process: null + dynamic: null + - from: QA_Agent + to: Game_Launcher + trigger: true + condition: + type: keyword + config: + any: + - APPROVE + carry_data: false + keep_message: false + clear_context: false + clear_kept_context: false + process: null + dynamic: null + - from: Core_Developer + to: Polish_Developer + trigger: true + condition: null + carry_data: true + keep_message: false + clear_context: false + clear_kept_context: false + process: null + dynamic: null + - from: Polish_Developer + to: QA_Agent + trigger: true + condition: null + carry_data: true + keep_message: false + clear_context: false + clear_kept_context: false + process: null + dynamic: null + - from: Planner + to: Core_Developer + trigger: false + condition: null + carry_data: true + keep_message: true + clear_context: false + clear_kept_context: false + process: null + dynamic: null + - from: Game Designer + to: manager + trigger: false + condition: + type: function + config: + name: 'true' + carry_data: true + keep_message: true + clear_context: false + clear_kept_context: false + process: null + dynamic: null + - from: Planner + to: manager + trigger: true + condition: + type: function + config: + name: 'true' + carry_data: true + keep_message: true + clear_context: false + clear_kept_context: false + process: null + dynamic: null + - from: manager + to: Polish_Developer + trigger: false + condition: + type: keyword + config: + any: + - polish developer + none: [] + regex: [] + case_sensitive: false + carry_data: true + keep_message: true + clear_context: false + clear_kept_context: false + process: null + dynamic: null + - from: manager + to: Core_Developer + trigger: true + condition: + type: keyword + config: + any: + - core developer + none: [] + regex: [] + case_sensitive: false + carry_data: true + keep_message: true + clear_context: false + clear_kept_context: false + process: null + dynamic: null + - from: manager + to: QA_Agent + trigger: false + condition: + type: keyword + config: + any: + - QA agent + none: [] + regex: [] + case_sensitive: false + carry_data: true + keep_message: true + clear_context: false + clear_kept_context: false + process: null + dynamic: null + initial_instruction: Describe a game idea you want to see come to life (e.g., 'A space shooter where you dodge asteroids', 'A rhythm game with falling notes', 'Snake but with gravity'). The system will automatically design, plan, implement core mechanics, add visual polish, perform QA checks, and execute the game. + start: + - Game Designer + end: + - Final_Game_Executor +version: 1.0.0 +vars: {} +