magic-building/.claude/commands/generate.md

description	argument-hint	allowed-tools
Generate a professional image using Gemini Flash via Nano Banana MCP from free-form description	<description>	Read Write Glob Grep Bash mcp__nano-banana-mcp__generate_image mcp__nano-banana-mcp__get_configuration_status

Generate a professional image based on the user description: "$ARGUMENTS"

Follow these steps:

1. Configuration Check: First verify that Gemini API is properly configured using mcp__nano-banana-mcp__get_configuration_status

2. Context Discovery: Automatically search for and gather relevant context from the project files:

   • Search for any mentioned characters in /heroes/ directory
   • Look for locations in /locations/ or /cities/ directories
   • Find world information in /worlds/ directory
   • Identify items in /items/ directory
   • Check for creatures in /creatures/ directory
   • Find applicable settings in /settings/ directory

3. Entity Analysis: Parse the description to identify:

   • Characters mentioned (explicit or implied)
   • Locations referenced
   • Items involved
   • Creatures present
   • Scene context and actions
   • Appropriate style settings to apply

4. Prompt Generation: Create a professional prompt following the guidelines in @docs/prompting-guide.md:

   • Use narrative descriptions instead of keyword lists
   • Apply appropriate template from the prompting guide based on content type
   • Include world-specific style elements
   • Reference character unique identifying features
   • Integrate linked items and relationships naturally
   • Specify lighting and atmosphere
   • Include technical quality descriptors
   • Maintain visual continuity with established universe

5. Settings Integration: Automatically apply appropriate settings based on context:

   • Character clothing based on status, world, and scenario
   • Transportation methods suitable for world and character
   • Environmental styles matching location and world
   • Weapon styles appropriate for character and scenario
   • Magical effects suitable for character abilities

6. Image Generation: Use mcp__nano-banana-mcp__generate_image with the professionally crafted prompt

7. File Management: Upon successful generation:

   • Save image to appropriate directory based on content:
     • Character portraits → /heroes/{character-name}/photos/
     • Location shots → /locations/{location-name}/images/ or /cities/{city-name}/images/
     • Item visualizations → /items/{item-name}/images/
     • Creature images → /creatures/{creature-name}/images/
     • Scene compositions → /scenes/{scene-name}/images/
   • Archive the successful prompt in corresponding /prompts/ directory
   • Update cross-references if new relationships are established

8. Documentation: Create a markdown file in /prepared_prompts/ directory documenting:

   • The final prompt used
   • Applied settings and context
   • Generated image path
   • Validation results and suggestions
   • Entity relationships discovered

Important:

• The prompt must be in English regardless of input language
• Follow exact templates and best practices from docs/prompting-guide.md
• Respect the project framework defined in CLAUDE.md
• Use mcp__nano-banana-mcp__generate_image tool for actual image generation
• Ensure proper file organization according to project structure