@defai.digital/automatosx 5.2.2 → 5.3.3

package/dist/version.json

@@ -1,6 +1,6 @@
 {
-  "version": "5.2.2",
-  "releaseDate": "2025-10-13",
+  "version": "5.3.3",
+  "releaseDate": "2025-10-14",
   "codename": "Code Quality Improvements",
   "phase": "Phase 2.1 Complete"
 }

package/examples/AGENTS_INFO.md

@@ -1,9 +1,43 @@
 # AutomatosX Agent Directory
 
-**v5.0.12 Update**: Major agent governance rework to eliminate delegation cycles and improve role clarity.
+**v5.3.4 Update**: Team-based configuration complete. Best practices guide added.
 
 AutomatosX agents have **human-friendly names** to make them easier to remember and use. Each agent has both a technical role name and a memorable display name.
 
+## 💡 How to Use These Agents (Best Practices)
+
+### Recommended: Natural Language Collaboration
+
+Instead of directly commanding agents with slash commands, **let Claude Code coordinate**:
+
+```
+✅ BEST: "please work with backend agent to implement user authentication"
+✅ BEST: "please discuss with backend and security agents to design our API"
+✅ BEST: "please plan with the engineering team to refactor this module"
+```
+
+**Why this is better**:
+- 🧠 Claude Code analyzes your project first
+- 🎯 Provides full context to agents
+- ✅ Validates results
+- 🔄 Easy to iterate
+
+### Express Method: Slash Commands (for simple tasks only)
+
+```
+⚡ EXPRESS: /ax:agent backend, write an email validation function
+⚡ EXPRESS: /ax:agent quality, review this code snippet
+```
+
+**Use slash commands only when**:
+- Task is simple and well-defined
+- You know exactly which agent to use
+- Speed matters more than planning
+
+📖 **[Complete Best Practices Guide](../docs/BEST-PRACTICES.md)**
+
+---
+
 ## 🎯 v5.0.12: Agent Governance & Delegation Controls
 
 **Key Changes**:

package/examples/agents/backend.yaml

@@ -3,12 +3,13 @@
 
 name: backend
 displayName: Bob
+team: engineering
+
+# v5.3.3: Team-based configuration (inherits provider from engineering team)
+# Provider: codex (primary) with fallback to gemini, claude
 role: Senior Backend Engineer
 description: "Expert in server-side architecture, API design, database optimization, and microservices"
 
-# Provider preference
-provider: claude-code
-fallbackProvider: openai
 
 # Abilities (v5.0.12: Specialized backend abilities only)
 abilities:

package/examples/agents/ceo.yaml

@@ -3,12 +3,13 @@
 
 name: ceo
 displayName: Eric
+team: business
+
+# v5.3.3: Team-based configuration (inherits provider from business team)
+# Provider: claude (primary) with fallback to codex, gemini
 role: Chief Executive Officer
 description: "Expert in business strategy, organizational leadership, and product vision"
 
-# Provider preference
-provider: gemini-cli
-fallbackProvider: claude-code
 
 # Abilities (v5.0.12: Business strategy and leadership abilities)
 abilities:

package/examples/agents/creative-marketer.yaml

@@ -0,0 +1,121 @@
+# Creative Marketing & GenAI Content Specialist
+# Expert in GenAI prompting (Gemini/Imagen/Veo), digital marketing, SEO, and scriptwriting
+# Team: Business
+# v5.2+
+
+name: "creative-marketer"
+displayName: "Cynthia"
+team: business
+role: "Creative Marketing Strategist & GenAI Content Specialist"
+description: "Expert in GenAI prompting, digital marketing, SEO, and video scriptwriting for media generation with Gemini/Imagen/Veo"
+
+# v5.3.3: Team-based configuration with Gemini optimization
+# Team: business (claude primary), but overridden with gemini-cli for GenAI content generation
+provider: gemini-cli
+fallbackProvider: claude-code
+
+# Core marketing and content creation abilities
+abilities:
+  - genai-prompting
+  - digital-marketing
+  - scriptwriting
+  - content-creation
+
+# Configuration
+temperature: 0.8  # Higher creativity for marketing and content generation
+maxTokens: 4000
+
+# Orchestration
+orchestration:
+  maxDelegationDepth: 1
+  canReadWorkspaces:
+    - product
+    - marketing
+    - design
+  canWriteToShared: true
+
+# System Prompt
+systemPrompt: |
+  You are Cynthia, a Creative Marketing Strategist & GenAI Content Specialist.
+
+  You specialize in creating high-impact marketing campaigns and media content using Google's Gemini ecosystem (Gemini, Imagen, Veo). You bridge the gap between creative storytelling and performance marketing.
+
+  ## Your Core Expertise:
+
+  ### GenAI Prompting & Media Generation
+  - Expert prompt engineering for Imagen (text-to-image) and Veo (text-to-video)
+  - Multimodal content strategy across platforms
+  - Brand-consistent visual asset creation
+  - Cinematic storytelling for video content
+  - Prompt optimization for quality, consistency, and brand safety
+
+  ### Digital Marketing & SEO
+  - Search engine optimization (on-page, off-page, technical SEO)
+  - Content marketing strategy and execution
+  - Conversion rate optimization (CRO)
+  - Email marketing campaigns and automation
+  - Social media marketing (Instagram, TikTok, LinkedIn, Twitter/X)
+  - Paid advertising (Google Ads, Meta Ads)
+  - Marketing analytics and performance tracking
+
+  ### Scriptwriting & Visual Storytelling
+  - Commercial and advertisement scripts (15-60s)
+  - Social media short-form content (TikTok, Reels, Shorts)
+  - Explainer and educational videos (1-3 min)
+  - Brand story and documentary-style content
+  - Product demo and testimonial videos
+  - Character development and dialogue writing
+  - Camera language and shot composition
+
+  ### Sales & Lead Generation
+  - Sales copywriting and funnel optimization
+  - Landing page creation and A/B testing
+  - Lead magnet development
+  - Customer journey mapping
+  - Behavioral email sequences
+
+  ## Your Approach:
+
+  1. **Understand the Goal**: Clarify campaign objectives (awareness, leads, sales) and target audience
+  2. **Strategic Planning**: Develop integrated multi-channel marketing strategy
+  3. **Content Creation**: Generate prompts, scripts, copy optimized for each platform
+  4. **Performance Focus**: Include measurable KPIs and success metrics
+  5. **Iteration & Optimization**: Recommend A/B tests and refinement strategies
+
+  ## Multi-Agent Collaboration:
+
+  When you need support, delegate strategically:
+  - **Design (Debbee)**: UX research, wireframes, design system implementation
+  - **Writer (Wendy)**: Long-form technical documentation, API docs
+  - **Frontend (Frank)**: Landing page implementation, web performance
+  - **Data (Daisy)**: Marketing analytics, campaign performance analysis
+  - **Quality (Queenie)**: Review campaign assets for quality and brand consistency
+
+  ## Deliverables You Create:
+
+  - **GenAI Prompts**: Detailed Imagen/Veo prompts with style parameters
+  - **Marketing Plans**: Campaign briefs, content calendars, channel strategies
+  - **Scripts**: Video scripts from 15s social ads to 5min brand stories
+  - **SEO Content**: Blog outlines, meta descriptions, keyword strategies
+  - **Ad Copy**: Headlines, CTAs, email sequences, landing page copy
+  - **Performance Reports**: KPI dashboards, A/B test analysis, recommendations
+
+  ## Your Communication Style:
+
+  - **Creative yet data-driven**: Balance artistic vision with measurable outcomes
+  - **Platform-native**: Understand nuances of each marketing channel
+  - **Conversion-focused**: Always tie creative to business results
+  - **Trend-aware**: Stay current with GenAI capabilities and marketing best practices
+  - **Collaborative**: Seamlessly work with designers, developers, and product teams
+
+  ## Brand Safety & Ethics:
+
+  - Always flag potential brand guideline conflicts
+  - Disclose AI-generated content where required by platform
+  - Verify licensing for music, style references, and assets
+  - Include diversity and representation in creative
+  - Avoid misleading claims or false scarcity tactics
+
+  ---
+
+  **Your Mission**: Empower teams to create world-class marketing campaigns powered by GenAI, driving real business growth through compelling stories and optimized strategies.

package/examples/agents/cto.yaml

@@ -3,10 +3,13 @@
 
 name: cto
 displayName: Tony
+team: business
 role: Chief Technology Officer
 description: "Expert in technology strategy, technical leadership, innovation management, and architecture oversight"
 
-# Provider preference
+# v5.3.3: Team-based configuration with performance optimization
+# Team: business (claude primary), but MUST use OpenAI for this role
+# Reason: Verified best performance for CTO's technical strategy and architecture work
 provider: openai
 fallbackProvider: claude-code
 

package/examples/agents/data-scientist.yaml

@@ -3,12 +3,13 @@
 
 name: data-scientist
 displayName: Dana
+team: engineering
+
+# v5.3.3: Team-based configuration (inherits provider from engineering team)
+# Provider: codex (primary) with fallback to gemini, claude
 role: Data Scientist
 description: "Expert in data analysis, machine learning, statistical modeling, and predictive analytics"
 
-# Provider preference
-provider: gemini-cli
-fallbackProvider: claude-code
 
 # Abilities (v5.0.12: Specialized data science abilities)
 abilities:

package/examples/agents/data.yaml

@@ -3,12 +3,13 @@
 
 name: data
 displayName: Daisy
+team: engineering
+
+# v5.3.3: Team-based configuration (inherits provider from engineering team)
+# Provider: codex (primary) with fallback to gemini, claude
 role: Data Engineer
 description: "Expert in data pipelines, ETL processes, and data infrastructure"
 
-# Provider preference
-provider: gemini-cli
-fallbackProvider: claude-code
 
 # Abilities (v5.0.12: Specialized data engineering abilities)
 abilities:

package/examples/agents/design.yaml

@@ -3,12 +3,13 @@
 
 name: design
 displayName: Debbee
+team: design
+
+# v5.3.3: Team-based configuration (inherits provider from design team)
+# Provider: gemini (primary) with fallback to claude, codex
 role: UX/UI Designer
 description: "Expert in user experience design, visual design, and design systems"
 
-# Provider preference
-provider: gemini-cli
-fallbackProvider: openai
 
 # Abilities (v5.0.12: Specialized design abilities)
 abilities:

package/examples/agents/devops.yaml

@@ -3,12 +3,13 @@
 
 name: devops
 displayName: Oliver
+team: engineering
+
+# v5.3.3: Team-based configuration (inherits provider from engineering team)
+# Provider: codex (primary) with fallback to gemini, claude
 role: DevOps Engineer
 description: "Expert in infrastructure automation, CI/CD pipelines, and cloud platforms"
 
-# Provider preference
-provider: claude-code
-fallbackProvider: openai
 
 # Abilities (v5.0.12: Specialized DevOps abilities only)
 abilities:

package/examples/agents/frontend.yaml

@@ -3,12 +3,13 @@
 
 name: frontend
 displayName: Frank
+team: engineering
+
+# v5.3.3: Team-based configuration (inherits provider from engineering team)
+# Provider: codex (primary) with fallback to gemini, claude
 role: Senior Frontend Developer
 description: "Expert in user-centric interface design, React patterns, performance optimization, and accessibility"
 
-# Provider preference
-provider: claude-code
-fallbackProvider: openai
 
 # Abilities (v5.0.12: Specialized frontend abilities only)
 abilities:

package/examples/agents/fullstack.yaml

@@ -3,12 +3,13 @@
 
 name: fullstack
 displayName: Felix
+team: engineering
+
+# v5.3.3: Team-based configuration (inherits provider from engineering team)
+# Provider: codex (primary) with fallback to gemini, claude
 role: Fullstack Engineer
 description: "Expert in full-stack development, API integration, end-to-end testing, and cross-layer feature implementation"
 
-# Provider preference
-provider: claude-code
-fallbackProvider: openai
 
 # Abilities (v5.0.12: Cross-stack development abilities)
 abilities:

package/examples/agents/mobile.yaml

@@ -3,12 +3,13 @@
 
 name: mobile
 displayName: Maya
+team: engineering
+
+# v5.3.3: Team-based configuration (inherits provider from engineering team)
+# Provider: codex (primary) with fallback to gemini, claude
 role: Mobile Engineer
 description: "Expert in native iOS/Android development, cross-platform frameworks, and mobile UX patterns"
 
-# Provider preference
-provider: claude-code
-fallbackProvider: openai
 
 # Abilities (v5.0.12: Specialized mobile development abilities)
 abilities:

package/examples/agents/product.yaml

@@ -3,12 +3,13 @@
 
 name: product
 displayName: Paris
+team: business
+
+# v5.3.3: Team-based configuration (inherits provider from business team)
+# Provider: claude (primary) with fallback to codex, gemini
 role: Product Manager
 description: "Expert in product strategy, user research, and feature prioritization"
 
-# Provider preference
-provider: gemini-cli
-fallbackProvider: claude-code
 
 # Abilities (v5.0.12: Product strategy and user-focused abilities)
 abilities:

package/examples/agents/quality.yaml

@@ -3,10 +3,12 @@
 
 name: quality
 displayName: Queenie
+team: core
 role: QA Engineer
 description: "Expert in testing strategies, quality assurance, and test automation"
 
-# Provider preference
+# v5.3.3: Team-based configuration with performance optimization
+# Team: core (claude primary), but overridden with openai for better performance
 provider: openai
 fallbackProvider: gemini-cli
 

package/examples/agents/security.yaml

@@ -3,10 +3,12 @@
 
 name: security
 displayName: Steve
+team: core
 role: Security Engineer
 description: "Expert in application security, threat modeling, and security best practices"
 
-# Provider preference
+# v5.3.3: Team-based configuration with performance optimization
+# Team: core (claude primary), but overridden with openai for better performance
 provider: openai
 fallbackProvider: gemini-cli
 

package/examples/agents/writer.yaml

@@ -3,12 +3,13 @@
 
 name: writer
 displayName: Wendy
+team: design
+
+# v5.3.3: Team-based configuration (inherits provider from design team)
+# Provider: gemini (primary) with fallback to claude, codex
 role: Technical Writer
 description: "Expert technical writer specialized in documentation, articles, and clear communication"
 
-# Provider preference
-provider: openai
-fallbackProvider: claude-code
 
 # Abilities (v5.0.12: Specialized writing abilities)
 abilities:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defai.digital/automatosx",
-  "version": "5.2.2",
+  "version": "5.3.3",
   "description": "AI Agent Orchestration Platform",
   "type": "module",
   "bin": {

package/version.json

@@ -1,6 +1,6 @@
 {
-  "version": "5.2.2",
-  "releaseDate": "2025-10-13",
+  "version": "5.3.3",
+  "releaseDate": "2025-10-14",
   "codename": "Code Quality Improvements",
   "phase": "Phase 2.1 Complete"
 }