@defai.digital/automatosx 5.3.1 → 5.3.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +84 -0
- package/README.md +98 -33
- package/dist/version.json +1 -1
- package/examples/AGENTS_INFO.md +35 -1
- package/examples/agents/backend.yaml +4 -3
- package/examples/agents/ceo.yaml +4 -3
- package/examples/agents/creative-marketer.yaml +121 -0
- package/examples/agents/cto.yaml +4 -1
- package/examples/agents/data-scientist.yaml +4 -3
- package/examples/agents/data.yaml +4 -3
- package/examples/agents/design.yaml +4 -3
- package/examples/agents/devops.yaml +4 -3
- package/examples/agents/frontend.yaml +4 -3
- package/examples/agents/fullstack.yaml +4 -3
- package/examples/agents/mobile.yaml +4 -3
- package/examples/agents/product.yaml +4 -3
- package/examples/agents/quality.yaml +3 -1
- package/examples/agents/security.yaml +3 -1
- package/examples/agents/writer.yaml +4 -3
- package/package.json +1 -1
- package/version.json +1 -1
- /package/examples/claude/commands/{ax:agent.md → ax-agent.md} +0 -0
- /package/examples/claude/commands/{ax:clear.md → ax-clear.md} +0 -0
- /package/examples/claude/commands/{ax:init.md → ax-init.md} +0 -0
- /package/examples/claude/commands/{ax:list.md → ax-list.md} +0 -0
- /package/examples/claude/commands/{ax:memory.md → ax-memory.md} +0 -0
- /package/examples/claude/commands/{ax:status.md → ax-status.md} +0 -0
- /package/examples/claude/commands/{ax:update.md → ax-update.md} +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,90 @@ All notable changes to AutomatosX will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [5.3.3] - 2025-10-14
|
|
9
|
+
|
|
10
|
+
### 🏗️ Foundation for Agent Optimization
|
|
11
|
+
|
|
12
|
+
**This release establishes the infrastructure and comprehensive analysis for intelligent ability loading, setting the stage for 50-90% token savings in v5.4.0.**
|
|
13
|
+
|
|
14
|
+
#### Added
|
|
15
|
+
|
|
16
|
+
- **Ability Metadata Infrastructure**:
|
|
17
|
+
- Created `schema/ability-metadata.json` with tier framework (core/advanced/specialized)
|
|
18
|
+
- Established foundation for intelligent ability loading system
|
|
19
|
+
- Defined tier constraints: core ≤250 words, advanced ≤600 words, specialized unlimited
|
|
20
|
+
- Infrastructure ready for task complexity-based loading (v5.4.0)
|
|
21
|
+
|
|
22
|
+
- **Comprehensive Optimization Analysis**:
|
|
23
|
+
- Complete analysis of all 16 agents and 63 abilities (`automatosx/PRD/v5.3-agent-optimization.md`)
|
|
24
|
+
- Token waste analysis identifying 50-92% savings potential
|
|
25
|
+
- Ability classification matrix (core/advanced/specialized)
|
|
26
|
+
- Per-agent optimization recommendations
|
|
27
|
+
- 4-phase implementation roadmap
|
|
28
|
+
|
|
29
|
+
- **User Feedback Integration** (`automatosx/PRD/v5.4.0_Recommendations_and_Roadmap.md`):
|
|
30
|
+
- Agent role expansion strategy (community-driven framework for 50+ roles)
|
|
31
|
+
- Delegation Guard architecture (cycle detection, deadlock prevention)
|
|
32
|
+
- Configurable timeout system (25→35-45 minutes)
|
|
33
|
+
- Delegation depth increase plan (2→3 levels with safety guards)
|
|
34
|
+
- Prioritized implementation roadmap (P0-P3)
|
|
35
|
+
|
|
36
|
+
- **Technical Implementation Specifications** (`automatosx/PRD/v5.4.0_Implementation_Guide.md`):
|
|
37
|
+
- Detailed architecture diagrams for Delegation Guard
|
|
38
|
+
- Graph-based cycle detection algorithm
|
|
39
|
+
- Role similarity scoring mechanism
|
|
40
|
+
- Context preservation for deep delegation chains
|
|
41
|
+
- Complete code examples and integration points
|
|
42
|
+
|
|
43
|
+
- **Feature Roadmap** (`automatosx/PRD/FEATURE-ROADMAP-v5.4.md`):
|
|
44
|
+
- Agent interaction visualizer
|
|
45
|
+
- Public agent/ability registry
|
|
46
|
+
- Interactive debugger
|
|
47
|
+
- Provider response caching
|
|
48
|
+
- Git and CI/CD integrations
|
|
49
|
+
- Enterprise features (RBAC, audit logging, secrets management)
|
|
50
|
+
|
|
51
|
+
#### Documentation
|
|
52
|
+
|
|
53
|
+
- **v5.3-agent-optimization.md**: Complete optimization analysis with ability classification matrix, intelligent loading strategy, and success metrics
|
|
54
|
+
- **v5.3.3-implementation-plan.md**: Foundation release plan and roadmap for v5.4.0
|
|
55
|
+
- **v5.4.0_Recommendations_and_Roadmap.md**: User feedback analysis with prioritized P0-P3 recommendations
|
|
56
|
+
- **v5.4.0_Implementation_Guide.md**: Technical specifications with pseudocode and implementation details
|
|
57
|
+
- **FEATURE-ROADMAP-v5.4.md**: General feature roadmap for future releases
|
|
58
|
+
|
|
59
|
+
#### Performance Impact (Foundation for v5.4.0)
|
|
60
|
+
|
|
61
|
+
No immediate performance changes in v5.3.3. This release establishes infrastructure for v5.4.0 optimizations:
|
|
62
|
+
|
|
63
|
+
| Agent | Current Avg Tokens | v5.4.0 Target | Savings | Use Case |
|
|
64
|
+
|-------|-------------------|---------------|---------|----------|
|
|
65
|
+
| Creative marketer | 5,242 | 400-800 | **85-92%** | Simple social media |
|
|
66
|
+
| Design | 1,468 | 250-600 | **59-83%** | Quick wireframes |
|
|
67
|
+
| Mobile | 1,732 | 250-500 | **71-86%** | Basic UI questions |
|
|
68
|
+
| Data scientist | 992 | 250-500 | **50-75%** | Simple data queries |
|
|
69
|
+
| Backend | 1,185 | 350-600 | **41-70%** | Simple CRUD |
|
|
70
|
+
| Frontend | 846 | 250-450 | **47-70%** | Component questions |
|
|
71
|
+
|
|
72
|
+
**Overall**: 50-90% token reduction for simple tasks while maintaining full power for complex workflows (v5.4.0).
|
|
73
|
+
|
|
74
|
+
#### Changed
|
|
75
|
+
|
|
76
|
+
None (infrastructure-only release)
|
|
77
|
+
|
|
78
|
+
#### Fixed
|
|
79
|
+
|
|
80
|
+
None (infrastructure-only release)
|
|
81
|
+
|
|
82
|
+
#### Notes
|
|
83
|
+
|
|
84
|
+
- **Zero breaking changes** - This is a pure infrastructure and documentation release
|
|
85
|
+
- **All tests passing** - 1,702 tests (99.59% pass rate)
|
|
86
|
+
- **TypeScript strict mode** - 0 errors
|
|
87
|
+
- **Foundation complete** - Ready for v5.4.0 implementation
|
|
88
|
+
- **Estimated v5.4.0 timeline** - 8-10 weeks for full optimization
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
8
92
|
## [5.3.1] - 2025-10-14
|
|
9
93
|
|
|
10
94
|
### 🪟 Windows CLI Provider Detection & Enhanced Robustness
|
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
[](https://www.typescriptlang.org/)
|
|
10
10
|
[](#)
|
|
11
11
|
|
|
12
|
-
**Status**: ✅ Production Ready · v5.3.
|
|
12
|
+
**Status**: ✅ Production Ready · v5.3.3 · October 2025
|
|
13
13
|
|
|
14
14
|
Looking for answers? See the [FAQ](FAQ.md).
|
|
15
15
|
|
|
@@ -19,13 +19,42 @@ Looking for answers? See the [FAQ](FAQ.md).
|
|
|
19
19
|
|
|
20
20
|
**AutomatosX extends Claude Code with specialized AI agents that remember context, delegate tasks, and collaborate autonomously.**
|
|
21
21
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
22
|
+
### 💡 Best Way to Use: Natural Language Collaboration (Recommended)
|
|
23
|
+
|
|
24
|
+
Instead of directly commanding agents, **let Claude Code think and coordinate**:
|
|
25
|
+
|
|
26
|
+
```
|
|
27
|
+
✅ RECOMMENDED: Natural language collaboration
|
|
28
|
+
"please work with ax agent to implement user authentication with JWT"
|
|
29
|
+
|
|
30
|
+
What happens:
|
|
31
|
+
1. Claude Code analyzes your project structure
|
|
32
|
+
2. AutomatosX selects the most suitable agent automatically
|
|
33
|
+
3. Provides full context to the agent
|
|
34
|
+
4. Validates the results
|
|
35
|
+
5. Helps you understand and iterate
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
**vs.**
|
|
39
|
+
|
|
26
40
|
```
|
|
41
|
+
⚡ EXPRESS: Direct slash command (for simple tasks)
|
|
42
|
+
/ax:agent backend, implement JWT auth
|
|
43
|
+
|
|
44
|
+
What happens:
|
|
45
|
+
1. Backend agent executes directly
|
|
46
|
+
2. Limited project context
|
|
47
|
+
3. No validation or planning
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### 🎓 Think of it This Way
|
|
27
51
|
|
|
28
|
-
**
|
|
52
|
+
- **Natural Collaboration** = Having a conversation with an intelligent coordinator who summons experts
|
|
53
|
+
- **Slash Commands** = Directly commanding the experts without coordination
|
|
54
|
+
|
|
55
|
+
**Recommendation**: Use natural language for 80% of tasks, slash commands for quick 20%.
|
|
56
|
+
|
|
57
|
+
📖 **[Complete Best Practices Guide](docs/BEST-PRACTICES.md)**
|
|
29
58
|
|
|
30
59
|
---
|
|
31
60
|
|
|
@@ -203,22 +232,45 @@ AutomatosX offers **two powerful modes** to fit your workflow:
|
|
|
203
232
|
|
|
204
233
|
### 1️⃣ Claude Code Integration (Recommended)
|
|
205
234
|
|
|
206
|
-
**Use
|
|
235
|
+
**The best way**: Use **natural language collaboration** to let Claude Code coordinate agents intelligently.
|
|
236
|
+
|
|
237
|
+
#### Natural Language Collaboration (Primary Method - 80% of tasks)
|
|
238
|
+
|
|
239
|
+
```
|
|
240
|
+
# Let Claude Code think, plan, and coordinate
|
|
241
|
+
"please work with ax agent to implement user authentication"
|
|
242
|
+
"please work with ax agent to design a secure API for our application"
|
|
243
|
+
"please work with ax agent to refactor this module with best practices"
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
**Why this is better**:
|
|
247
|
+
- 🧠 Claude Code analyzes your project first
|
|
248
|
+
- 🎯 Automatically selects the best agents
|
|
249
|
+
- 📚 Provides full context from your codebase
|
|
250
|
+
- ✅ Validates results and handles errors
|
|
251
|
+
- 🔄 Easy to iterate and refine
|
|
252
|
+
|
|
253
|
+
#### Slash Commands (Express Method - 20% of tasks)
|
|
207
254
|
|
|
208
255
|
```bash
|
|
209
|
-
#
|
|
256
|
+
# Direct execution for simple, well-defined tasks
|
|
210
257
|
/ax:agent Paris, design a REST API for user authentication
|
|
211
|
-
/ax:agent Bob,
|
|
212
|
-
/ax:agent Steve,
|
|
258
|
+
/ax:agent Bob, write a function to validate emails
|
|
259
|
+
/ax:agent Steve, review this code snippet
|
|
213
260
|
```
|
|
214
261
|
|
|
262
|
+
**Use slash commands when**:
|
|
263
|
+
- ⚡ Task is simple and well-defined
|
|
264
|
+
- 🎯 You know exactly which agent to use
|
|
265
|
+
- 🚀 Speed matters more than planning
|
|
266
|
+
|
|
215
267
|
**Perfect for**:
|
|
216
|
-
- 💬
|
|
217
|
-
- 🔄
|
|
218
|
-
- 🤝
|
|
219
|
-
- 🎯
|
|
268
|
+
- 💬 All types of development workflows
|
|
269
|
+
- 🔄 Both simple and complex tasks
|
|
270
|
+
- 🤝 Single and multi-agent coordination
|
|
271
|
+
- 🎯 Interactive and automated workflows
|
|
220
272
|
|
|
221
|
-
**How it works**: Claude Code
|
|
273
|
+
**How it works**: Claude Code acts as an intelligent coordinator, analyzing context, selecting agents, and orchestrating their work seamlessly.
|
|
222
274
|
|
|
223
275
|
### 2️⃣ Terminal/CLI Mode (Power Users)
|
|
224
276
|
|
|
@@ -278,7 +330,7 @@ npm install -g @defai.digital/automatosx
|
|
|
278
330
|
|
|
279
331
|
```bash
|
|
280
332
|
ax --version
|
|
281
|
-
# Should show: 5.3.
|
|
333
|
+
# Should show: 5.3.3 (or later)
|
|
282
334
|
```
|
|
283
335
|
|
|
284
336
|
> **Windows Users**: If `ax` command not found, see [Windows Troubleshooting](docs/troubleshooting/windows-troubleshooting.md)
|
|
@@ -390,7 +442,36 @@ Having issues on Windows? See our comprehensive guides:
|
|
|
390
442
|
|
|
391
443
|
### Step 3: Run Your First Agent
|
|
392
444
|
|
|
393
|
-
|
|
445
|
+
#### Option A: Claude Code Integration (Recommended)
|
|
446
|
+
|
|
447
|
+
**Best Practice: Natural Language Collaboration**
|
|
448
|
+
|
|
449
|
+
Open Claude Code and try these prompts:
|
|
450
|
+
|
|
451
|
+
```
|
|
452
|
+
✅ "please work with ax agent to create a simple calculator function"
|
|
453
|
+
✅ "please work with ax agent to design a REST API for user management"
|
|
454
|
+
✅ "please work with ax agent to implement secure authentication"
|
|
455
|
+
```
|
|
456
|
+
|
|
457
|
+
**What happens**:
|
|
458
|
+
1. Claude Code analyzes your project context
|
|
459
|
+
2. Selects and coordinates the best agents
|
|
460
|
+
3. Agents execute with full context
|
|
461
|
+
4. Results are validated and explained
|
|
462
|
+
5. Easy to iterate: "please improve the error handling"
|
|
463
|
+
|
|
464
|
+
**Express Option: Slash Commands** (for simple tasks)
|
|
465
|
+
|
|
466
|
+
```bash
|
|
467
|
+
# Quick, direct execution
|
|
468
|
+
/ax:agent backend, write a function to validate email
|
|
469
|
+
/ax:agent quality, review this code snippet
|
|
470
|
+
```
|
|
471
|
+
|
|
472
|
+
📖 **Learn more**: [Best Practices Guide](docs/BEST-PRACTICES.md)
|
|
473
|
+
|
|
474
|
+
#### Option B: Terminal Mode (Power Users)
|
|
394
475
|
|
|
395
476
|
```bash
|
|
396
477
|
# Test with backend agent
|
|
@@ -402,22 +483,6 @@ ax run Bob "Implement the API" # Auto-receives Paris's design
|
|
|
402
483
|
ax run Queenie "Write tests for the API" # Auto-receives design + implementation
|
|
403
484
|
```
|
|
404
485
|
|
|
405
|
-
**Claude Code Integration**:
|
|
406
|
-
|
|
407
|
-
```bash
|
|
408
|
-
# In Claude Code, use the slash command
|
|
409
|
-
/ax:agent Paris, design REST API for users
|
|
410
|
-
/ax:agent Bob, implement the API
|
|
411
|
-
/ax:agent Queenie, write tests for the API
|
|
412
|
-
```
|
|
413
|
-
|
|
414
|
-
**What happens**:
|
|
415
|
-
1. Claude Code executes AutomatosX behind the scenes
|
|
416
|
-
2. Paris designs the API → Saved to memory
|
|
417
|
-
3. Bob reads Paris's design from memory → Implements code
|
|
418
|
-
4. Queenie reads everything → Writes comprehensive tests
|
|
419
|
-
5. Results flow back into your Claude Code conversation
|
|
420
|
-
|
|
421
486
|
---
|
|
422
487
|
|
|
423
488
|
### Common Issues
|
package/dist/version.json
CHANGED
package/examples/AGENTS_INFO.md
CHANGED
|
@@ -1,9 +1,43 @@
|
|
|
1
1
|
# AutomatosX Agent Directory
|
|
2
2
|
|
|
3
|
-
**v5.
|
|
3
|
+
**v5.3.4 Update**: Team-based configuration complete. Best practices guide added.
|
|
4
4
|
|
|
5
5
|
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.
|
|
6
6
|
|
|
7
|
+
## 💡 How to Use These Agents (Best Practices)
|
|
8
|
+
|
|
9
|
+
### Recommended: Natural Language Collaboration
|
|
10
|
+
|
|
11
|
+
Instead of directly commanding agents with slash commands, **let Claude Code coordinate**:
|
|
12
|
+
|
|
13
|
+
```
|
|
14
|
+
✅ BEST: "please work with backend agent to implement user authentication"
|
|
15
|
+
✅ BEST: "please discuss with backend and security agents to design our API"
|
|
16
|
+
✅ BEST: "please plan with the engineering team to refactor this module"
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
**Why this is better**:
|
|
20
|
+
- 🧠 Claude Code analyzes your project first
|
|
21
|
+
- 🎯 Provides full context to agents
|
|
22
|
+
- ✅ Validates results
|
|
23
|
+
- 🔄 Easy to iterate
|
|
24
|
+
|
|
25
|
+
### Express Method: Slash Commands (for simple tasks only)
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
⚡ EXPRESS: /ax:agent backend, write an email validation function
|
|
29
|
+
⚡ EXPRESS: /ax:agent quality, review this code snippet
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
**Use slash commands only when**:
|
|
33
|
+
- Task is simple and well-defined
|
|
34
|
+
- You know exactly which agent to use
|
|
35
|
+
- Speed matters more than planning
|
|
36
|
+
|
|
37
|
+
📖 **[Complete Best Practices Guide](../docs/BEST-PRACTICES.md)**
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
7
41
|
## 🎯 v5.0.12: Agent Governance & Delegation Controls
|
|
8
42
|
|
|
9
43
|
**Key Changes**:
|
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
name: backend
|
|
5
5
|
displayName: Bob
|
|
6
|
+
team: engineering
|
|
7
|
+
|
|
8
|
+
# v5.3.3: Team-based configuration (inherits provider from engineering team)
|
|
9
|
+
# Provider: codex (primary) with fallback to gemini, claude
|
|
6
10
|
role: Senior Backend Engineer
|
|
7
11
|
description: "Expert in server-side architecture, API design, database optimization, and microservices"
|
|
8
12
|
|
|
9
|
-
# Provider preference
|
|
10
|
-
provider: claude-code
|
|
11
|
-
fallbackProvider: openai
|
|
12
13
|
|
|
13
14
|
# Abilities (v5.0.12: Specialized backend abilities only)
|
|
14
15
|
abilities:
|
package/examples/agents/ceo.yaml
CHANGED
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
name: ceo
|
|
5
5
|
displayName: Eric
|
|
6
|
+
team: business
|
|
7
|
+
|
|
8
|
+
# v5.3.3: Team-based configuration (inherits provider from business team)
|
|
9
|
+
# Provider: claude (primary) with fallback to codex, gemini
|
|
6
10
|
role: Chief Executive Officer
|
|
7
11
|
description: "Expert in business strategy, organizational leadership, and product vision"
|
|
8
12
|
|
|
9
|
-
# Provider preference
|
|
10
|
-
provider: gemini-cli
|
|
11
|
-
fallbackProvider: claude-code
|
|
12
13
|
|
|
13
14
|
# Abilities (v5.0.12: Business strategy and leadership abilities)
|
|
14
15
|
abilities:
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
# Creative Marketing & GenAI Content Specialist
|
|
2
|
+
# Expert in GenAI prompting (Gemini/Imagen/Veo), digital marketing, SEO, and scriptwriting
|
|
3
|
+
# Team: Business
|
|
4
|
+
# v5.2+
|
|
5
|
+
|
|
6
|
+
name: "creative-marketer"
|
|
7
|
+
displayName: "Cynthia"
|
|
8
|
+
team: business
|
|
9
|
+
role: "Creative Marketing Strategist & GenAI Content Specialist"
|
|
10
|
+
description: "Expert in GenAI prompting, digital marketing, SEO, and video scriptwriting for media generation with Gemini/Imagen/Veo"
|
|
11
|
+
|
|
12
|
+
# v5.3.3: Team-based configuration with Gemini optimization
|
|
13
|
+
# Team: business (claude primary), but overridden with gemini-cli for GenAI content generation
|
|
14
|
+
provider: gemini-cli
|
|
15
|
+
fallbackProvider: claude-code
|
|
16
|
+
|
|
17
|
+
# Core marketing and content creation abilities
|
|
18
|
+
abilities:
|
|
19
|
+
- genai-prompting
|
|
20
|
+
- digital-marketing
|
|
21
|
+
- scriptwriting
|
|
22
|
+
- content-creation
|
|
23
|
+
|
|
24
|
+
# Configuration
|
|
25
|
+
temperature: 0.8 # Higher creativity for marketing and content generation
|
|
26
|
+
maxTokens: 4000
|
|
27
|
+
|
|
28
|
+
# Orchestration
|
|
29
|
+
orchestration:
|
|
30
|
+
maxDelegationDepth: 1
|
|
31
|
+
canReadWorkspaces:
|
|
32
|
+
- product
|
|
33
|
+
- marketing
|
|
34
|
+
- design
|
|
35
|
+
canWriteToShared: true
|
|
36
|
+
|
|
37
|
+
# System Prompt
|
|
38
|
+
systemPrompt: |
|
|
39
|
+
You are Cynthia, a Creative Marketing Strategist & GenAI Content Specialist.
|
|
40
|
+
|
|
41
|
+
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.
|
|
42
|
+
|
|
43
|
+
## Your Core Expertise:
|
|
44
|
+
|
|
45
|
+
### GenAI Prompting & Media Generation
|
|
46
|
+
- Expert prompt engineering for Imagen (text-to-image) and Veo (text-to-video)
|
|
47
|
+
- Multimodal content strategy across platforms
|
|
48
|
+
- Brand-consistent visual asset creation
|
|
49
|
+
- Cinematic storytelling for video content
|
|
50
|
+
- Prompt optimization for quality, consistency, and brand safety
|
|
51
|
+
|
|
52
|
+
### Digital Marketing & SEO
|
|
53
|
+
- Search engine optimization (on-page, off-page, technical SEO)
|
|
54
|
+
- Content marketing strategy and execution
|
|
55
|
+
- Conversion rate optimization (CRO)
|
|
56
|
+
- Email marketing campaigns and automation
|
|
57
|
+
- Social media marketing (Instagram, TikTok, LinkedIn, Twitter/X)
|
|
58
|
+
- Paid advertising (Google Ads, Meta Ads)
|
|
59
|
+
- Marketing analytics and performance tracking
|
|
60
|
+
|
|
61
|
+
### Scriptwriting & Visual Storytelling
|
|
62
|
+
- Commercial and advertisement scripts (15-60s)
|
|
63
|
+
- Social media short-form content (TikTok, Reels, Shorts)
|
|
64
|
+
- Explainer and educational videos (1-3 min)
|
|
65
|
+
- Brand story and documentary-style content
|
|
66
|
+
- Product demo and testimonial videos
|
|
67
|
+
- Character development and dialogue writing
|
|
68
|
+
- Camera language and shot composition
|
|
69
|
+
|
|
70
|
+
### Sales & Lead Generation
|
|
71
|
+
- Sales copywriting and funnel optimization
|
|
72
|
+
- Landing page creation and A/B testing
|
|
73
|
+
- Lead magnet development
|
|
74
|
+
- Customer journey mapping
|
|
75
|
+
- Behavioral email sequences
|
|
76
|
+
|
|
77
|
+
## Your Approach:
|
|
78
|
+
|
|
79
|
+
1. **Understand the Goal**: Clarify campaign objectives (awareness, leads, sales) and target audience
|
|
80
|
+
2. **Strategic Planning**: Develop integrated multi-channel marketing strategy
|
|
81
|
+
3. **Content Creation**: Generate prompts, scripts, copy optimized for each platform
|
|
82
|
+
4. **Performance Focus**: Include measurable KPIs and success metrics
|
|
83
|
+
5. **Iteration & Optimization**: Recommend A/B tests and refinement strategies
|
|
84
|
+
|
|
85
|
+
## Multi-Agent Collaboration:
|
|
86
|
+
|
|
87
|
+
When you need support, delegate strategically:
|
|
88
|
+
- **Design (Debbee)**: UX research, wireframes, design system implementation
|
|
89
|
+
- **Writer (Wendy)**: Long-form technical documentation, API docs
|
|
90
|
+
- **Frontend (Frank)**: Landing page implementation, web performance
|
|
91
|
+
- **Data (Daisy)**: Marketing analytics, campaign performance analysis
|
|
92
|
+
- **Quality (Queenie)**: Review campaign assets for quality and brand consistency
|
|
93
|
+
|
|
94
|
+
## Deliverables You Create:
|
|
95
|
+
|
|
96
|
+
- **GenAI Prompts**: Detailed Imagen/Veo prompts with style parameters
|
|
97
|
+
- **Marketing Plans**: Campaign briefs, content calendars, channel strategies
|
|
98
|
+
- **Scripts**: Video scripts from 15s social ads to 5min brand stories
|
|
99
|
+
- **SEO Content**: Blog outlines, meta descriptions, keyword strategies
|
|
100
|
+
- **Ad Copy**: Headlines, CTAs, email sequences, landing page copy
|
|
101
|
+
- **Performance Reports**: KPI dashboards, A/B test analysis, recommendations
|
|
102
|
+
|
|
103
|
+
## Your Communication Style:
|
|
104
|
+
|
|
105
|
+
- **Creative yet data-driven**: Balance artistic vision with measurable outcomes
|
|
106
|
+
- **Platform-native**: Understand nuances of each marketing channel
|
|
107
|
+
- **Conversion-focused**: Always tie creative to business results
|
|
108
|
+
- **Trend-aware**: Stay current with GenAI capabilities and marketing best practices
|
|
109
|
+
- **Collaborative**: Seamlessly work with designers, developers, and product teams
|
|
110
|
+
|
|
111
|
+
## Brand Safety & Ethics:
|
|
112
|
+
|
|
113
|
+
- Always flag potential brand guideline conflicts
|
|
114
|
+
- Disclose AI-generated content where required by platform
|
|
115
|
+
- Verify licensing for music, style references, and assets
|
|
116
|
+
- Include diversity and representation in creative
|
|
117
|
+
- Avoid misleading claims or false scarcity tactics
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
**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
CHANGED
|
@@ -3,10 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
name: cto
|
|
5
5
|
displayName: Tony
|
|
6
|
+
team: business
|
|
6
7
|
role: Chief Technology Officer
|
|
7
8
|
description: "Expert in technology strategy, technical leadership, innovation management, and architecture oversight"
|
|
8
9
|
|
|
9
|
-
#
|
|
10
|
+
# v5.3.3: Team-based configuration with performance optimization
|
|
11
|
+
# Team: business (claude primary), but MUST use OpenAI for this role
|
|
12
|
+
# Reason: Verified best performance for CTO's technical strategy and architecture work
|
|
10
13
|
provider: openai
|
|
11
14
|
fallbackProvider: claude-code
|
|
12
15
|
|
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
name: data-scientist
|
|
5
5
|
displayName: Dana
|
|
6
|
+
team: engineering
|
|
7
|
+
|
|
8
|
+
# v5.3.3: Team-based configuration (inherits provider from engineering team)
|
|
9
|
+
# Provider: codex (primary) with fallback to gemini, claude
|
|
6
10
|
role: Data Scientist
|
|
7
11
|
description: "Expert in data analysis, machine learning, statistical modeling, and predictive analytics"
|
|
8
12
|
|
|
9
|
-
# Provider preference
|
|
10
|
-
provider: gemini-cli
|
|
11
|
-
fallbackProvider: claude-code
|
|
12
13
|
|
|
13
14
|
# Abilities (v5.0.12: Specialized data science abilities)
|
|
14
15
|
abilities:
|
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
name: data
|
|
5
5
|
displayName: Daisy
|
|
6
|
+
team: engineering
|
|
7
|
+
|
|
8
|
+
# v5.3.3: Team-based configuration (inherits provider from engineering team)
|
|
9
|
+
# Provider: codex (primary) with fallback to gemini, claude
|
|
6
10
|
role: Data Engineer
|
|
7
11
|
description: "Expert in data pipelines, ETL processes, and data infrastructure"
|
|
8
12
|
|
|
9
|
-
# Provider preference
|
|
10
|
-
provider: gemini-cli
|
|
11
|
-
fallbackProvider: claude-code
|
|
12
13
|
|
|
13
14
|
# Abilities (v5.0.12: Specialized data engineering abilities)
|
|
14
15
|
abilities:
|
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
name: design
|
|
5
5
|
displayName: Debbee
|
|
6
|
+
team: design
|
|
7
|
+
|
|
8
|
+
# v5.3.3: Team-based configuration (inherits provider from design team)
|
|
9
|
+
# Provider: gemini (primary) with fallback to claude, codex
|
|
6
10
|
role: UX/UI Designer
|
|
7
11
|
description: "Expert in user experience design, visual design, and design systems"
|
|
8
12
|
|
|
9
|
-
# Provider preference
|
|
10
|
-
provider: gemini-cli
|
|
11
|
-
fallbackProvider: openai
|
|
12
13
|
|
|
13
14
|
# Abilities (v5.0.12: Specialized design abilities)
|
|
14
15
|
abilities:
|
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
name: devops
|
|
5
5
|
displayName: Oliver
|
|
6
|
+
team: engineering
|
|
7
|
+
|
|
8
|
+
# v5.3.3: Team-based configuration (inherits provider from engineering team)
|
|
9
|
+
# Provider: codex (primary) with fallback to gemini, claude
|
|
6
10
|
role: DevOps Engineer
|
|
7
11
|
description: "Expert in infrastructure automation, CI/CD pipelines, and cloud platforms"
|
|
8
12
|
|
|
9
|
-
# Provider preference
|
|
10
|
-
provider: claude-code
|
|
11
|
-
fallbackProvider: openai
|
|
12
13
|
|
|
13
14
|
# Abilities (v5.0.12: Specialized DevOps abilities only)
|
|
14
15
|
abilities:
|
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
name: frontend
|
|
5
5
|
displayName: Frank
|
|
6
|
+
team: engineering
|
|
7
|
+
|
|
8
|
+
# v5.3.3: Team-based configuration (inherits provider from engineering team)
|
|
9
|
+
# Provider: codex (primary) with fallback to gemini, claude
|
|
6
10
|
role: Senior Frontend Developer
|
|
7
11
|
description: "Expert in user-centric interface design, React patterns, performance optimization, and accessibility"
|
|
8
12
|
|
|
9
|
-
# Provider preference
|
|
10
|
-
provider: claude-code
|
|
11
|
-
fallbackProvider: openai
|
|
12
13
|
|
|
13
14
|
# Abilities (v5.0.12: Specialized frontend abilities only)
|
|
14
15
|
abilities:
|
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
name: fullstack
|
|
5
5
|
displayName: Felix
|
|
6
|
+
team: engineering
|
|
7
|
+
|
|
8
|
+
# v5.3.3: Team-based configuration (inherits provider from engineering team)
|
|
9
|
+
# Provider: codex (primary) with fallback to gemini, claude
|
|
6
10
|
role: Fullstack Engineer
|
|
7
11
|
description: "Expert in full-stack development, API integration, end-to-end testing, and cross-layer feature implementation"
|
|
8
12
|
|
|
9
|
-
# Provider preference
|
|
10
|
-
provider: claude-code
|
|
11
|
-
fallbackProvider: openai
|
|
12
13
|
|
|
13
14
|
# Abilities (v5.0.12: Cross-stack development abilities)
|
|
14
15
|
abilities:
|
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
name: mobile
|
|
5
5
|
displayName: Maya
|
|
6
|
+
team: engineering
|
|
7
|
+
|
|
8
|
+
# v5.3.3: Team-based configuration (inherits provider from engineering team)
|
|
9
|
+
# Provider: codex (primary) with fallback to gemini, claude
|
|
6
10
|
role: Mobile Engineer
|
|
7
11
|
description: "Expert in native iOS/Android development, cross-platform frameworks, and mobile UX patterns"
|
|
8
12
|
|
|
9
|
-
# Provider preference
|
|
10
|
-
provider: claude-code
|
|
11
|
-
fallbackProvider: openai
|
|
12
13
|
|
|
13
14
|
# Abilities (v5.0.12: Specialized mobile development abilities)
|
|
14
15
|
abilities:
|
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
name: product
|
|
5
5
|
displayName: Paris
|
|
6
|
+
team: business
|
|
7
|
+
|
|
8
|
+
# v5.3.3: Team-based configuration (inherits provider from business team)
|
|
9
|
+
# Provider: claude (primary) with fallback to codex, gemini
|
|
6
10
|
role: Product Manager
|
|
7
11
|
description: "Expert in product strategy, user research, and feature prioritization"
|
|
8
12
|
|
|
9
|
-
# Provider preference
|
|
10
|
-
provider: gemini-cli
|
|
11
|
-
fallbackProvider: claude-code
|
|
12
13
|
|
|
13
14
|
# Abilities (v5.0.12: Product strategy and user-focused abilities)
|
|
14
15
|
abilities:
|
|
@@ -3,10 +3,12 @@
|
|
|
3
3
|
|
|
4
4
|
name: quality
|
|
5
5
|
displayName: Queenie
|
|
6
|
+
team: core
|
|
6
7
|
role: QA Engineer
|
|
7
8
|
description: "Expert in testing strategies, quality assurance, and test automation"
|
|
8
9
|
|
|
9
|
-
#
|
|
10
|
+
# v5.3.3: Team-based configuration with performance optimization
|
|
11
|
+
# Team: core (claude primary), but overridden with openai for better performance
|
|
10
12
|
provider: openai
|
|
11
13
|
fallbackProvider: gemini-cli
|
|
12
14
|
|
|
@@ -3,10 +3,12 @@
|
|
|
3
3
|
|
|
4
4
|
name: security
|
|
5
5
|
displayName: Steve
|
|
6
|
+
team: core
|
|
6
7
|
role: Security Engineer
|
|
7
8
|
description: "Expert in application security, threat modeling, and security best practices"
|
|
8
9
|
|
|
9
|
-
#
|
|
10
|
+
# v5.3.3: Team-based configuration with performance optimization
|
|
11
|
+
# Team: core (claude primary), but overridden with openai for better performance
|
|
10
12
|
provider: openai
|
|
11
13
|
fallbackProvider: gemini-cli
|
|
12
14
|
|
|
@@ -3,12 +3,13 @@
|
|
|
3
3
|
|
|
4
4
|
name: writer
|
|
5
5
|
displayName: Wendy
|
|
6
|
+
team: design
|
|
7
|
+
|
|
8
|
+
# v5.3.3: Team-based configuration (inherits provider from design team)
|
|
9
|
+
# Provider: gemini (primary) with fallback to claude, codex
|
|
6
10
|
role: Technical Writer
|
|
7
11
|
description: "Expert technical writer specialized in documentation, articles, and clear communication"
|
|
8
12
|
|
|
9
|
-
# Provider preference
|
|
10
|
-
provider: openai
|
|
11
|
-
fallbackProvider: claude-code
|
|
12
13
|
|
|
13
14
|
# Abilities (v5.0.12: Specialized writing abilities)
|
|
14
15
|
abilities:
|
package/package.json
CHANGED
package/version.json
CHANGED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|