dotfiles

6.3 KB•MD

AGENTS.md

6.3 KB • 148 lines • markdown

1# AGENTS - Rapid Selection Guide & Intelligent Orchestrator
2
3**Primary Directive**: "Agents First, Tools Second - Expert Context Over General Purpose"
4
5## â¡ RAPID AGENT SELECTION
6
7### ð¨ MANDATORY UTILITY AGENTS (5)
8**NEVER use direct tools for these domains**
9
10| Agent | Domain | Trigger Keywords |
11|-------|--------|------------------|
12| **file-creator** | File/directory creation | "create", "generate", "new file", "setup structure" |
13| **git-workflow** | All git operations | "commit", "branch", "merge", "git", "push", "pull" |
14| **context-fetcher** | Internal documentation | "docs", "README", "internal guide", "project docs" |
15| **knowledge-fetcher** | External research | "search", "Readwise", "Context7", "web search", "find articles" |
16| **date-checker** | Date/time calculations | "when", "schedule", "time since", "date", "timestamp" |
17
18### ð¯ INSTANT AGENT MATCHING
19
20| User Intent | Primary Agent | Secondary Options |
21|-------------|---------------|-------------------|
22| **"Build new feature"** | rapid-prototyper | â ui-designer â frontend-developer |
23| **"Fix this bug"** | backend-architect / frontend-developer | + test-writer-fixer (auto-triggers) |
24| **"Test this code"** | test-writer-fixer | + api-tester, performance-benchmarker |
25| **"Deploy this"** | devops-automator | + project-shipper |
26| **"Design this UI"** | ui-designer | â frontend-developer â whimsy-injector |
27| **"Analyze feedback"** | feedback-synthesizer | + ux-researcher |
28| **"Complex multi-step"** | **studio-coach** | (orchestrates others) |
29
30### ð COMPLEXITY ROUTING
31
32```yaml
33Simple (1 agent):     Direct task â Specialized agent
34Medium (2-3 agents):  Sequential workflow â Auto-handoffs  
35Complex (4+ agents):  studio-coach â Orchestrated workflow
36```
37
38## ð¼ ORCHESTRATION WORKFLOWS
39
40### ð MASTER ORCHESTRATOR: studio-coach
41
42**Auto-activates when:**
43- 4+ agents needed
44- Cross-domain complexity
45- Multi-phase projects
46- Agent coordination required
47
48### ð¯ AUTO-TRIGGERING AGENTS
49
50| Trigger Event | Agent | Purpose |
51|---------------|-------|---------|
52| Code changes | **test-writer-fixer** | Immediate test coverage |
53| UI/UX changes | **whimsy-injector** | Add delightful interactions |
54| Feature flags mentioned | **experiment-tracker** | A/B testing setup |
55| Complex workflows start | **studio-coach** | Orchestration management |
56
57## ð¯ SPECIALIZED AGENT DIRECTORY
58
59### ð ï¸ Engineering (7 agents)
60- **rapid-prototyper**: MVP builder â ui-designer, test-writer-fixer
61- **backend-architect**: API design â devops-automator, api-tester
62- **frontend-developer**: UI implementation â ui-designer, whimsy-injector
63- **mobile-app-builder**: Native apps â app-store-optimizer
64- **ai-engineer**: AI/ML integration â performance-benchmarker
65- **devops-automator**: Deployment â project-shipper, infrastructure-maintainer
66- **test-writer-fixer**: Testing strategy â api-tester, test-results-analyzer
67
68### ð¨ Design (5 agents)
69- **ui-designer**: Interface design â frontend-developer, brand-guardian
70- **ux-researcher**: User insights â feedback-synthesizer, analytics-reporter
71- **whimsy-injector**: Interaction delight (auto-triggers after UI changes)
72- **brand-guardian**: Visual consistency â visual-storyteller
73- **visual-storyteller**: Marketing visuals â content-creator
74
75### ð Marketing (7 agents)
76- **growth-hacker**: Viral loops â analytics-reporter, experiment-tracker
77- **tiktok-strategist**: TikTok content â content-creator
78- **app-store-optimizer**: ASO â mobile-app-builder
79- **content-creator**: Multi-platform content â instagram-curator, twitter-engager
80- **instagram-curator**: Visual content â visual-storyteller
81- **reddit-community-builder**: Community engagement â support-responder
82- **twitter-engager**: Trend engagement â trend-researcher
83
84### ð¯ Product (3 agents)
85- **feedback-synthesizer**: User feedback â ux-researcher, sprint-prioritizer
86- **sprint-prioritizer**: Planning â rapid-prototyper, studio-producer
87- **trend-researcher**: Market analysis â growth-hacker
88
89### ð Project Management (3 agents)
90- **experiment-tracker**: A/B testing (auto-triggers on feature flags)
91- **project-shipper**: Launch management â devops-automator
92- **studio-producer**: Team coordination â studio-coach
93
94### ð¢ Operations (5 agents)
95- **analytics-reporter**: Data insights â experiment-tracker
96- **finance-tracker**: Profitability â infrastructure-maintainer
97- **infrastructure-maintainer**: Scaling â devops-automator
98- **legal-compliance-checker**: Legal review â project-shipper
99- **support-responder**: Customer support â feedback-synthesizer
100
101### ð§ª Testing (5 agents)
102- **api-tester**: API validation â backend-architect, performance-benchmarker
103- **performance-benchmarker**: Speed optimization â test-results-analyzer
104- **test-results-analyzer**: Failure patterns â test-writer-fixer
105- **tool-evaluator**: Tech decisions â workflow-optimizer
106- **workflow-optimizer**: Process improvement â studio-producer
107
108### ð Bonus Agents
109- **joker**: Morale boost â whimsy-injector
110
111## ð¯ AGENT SELECTION MATRIX
112
113### Decision Tree
114```yaml
115task_analysis:
116  utility_domain: USE_MANDATORY_AGENT (no alternatives)
117  single_domain: USE_SPECIALIZED_AGENT
118  cross_domain: SEQUENTIAL_WORKFLOW (2-3 agents)
119  complex_project: STUDIO_COACH_ORCHESTRATION (4+ agents)
120  
121coordination_level:
122  simple: Direct agent selection
123  medium: Auto-handoffs between 2-3 agents
124  complex: studio-coach orchestrated workflows
125  
126urgency:
127  immediate: Single specialized agent
128  planned: Sequential workflow
129  strategic: Full orchestration with parallel teams
130```
131
132### Agent Relationship Map
133```yaml
134core_relationships:
135  development_trio: [rapid-prototyper, frontend-developer, test-writer-fixer]
136  design_duo: [ui-designer, whimsy-injector] 
137  backend_stack: [backend-architect, devops-automator, api-tester]
138  marketing_squad: [growth-hacker, content-creator, tiktok-strategist]
139  testing_team: [test-writer-fixer, api-tester, performance-benchmarker, test-results-analyzer]
140  
141auto_triggers:
142  code_change: test-writer-fixer
143  ui_change: whimsy-injector  
144  feature_flags: experiment-tracker
145  complex_workflow: studio-coach
146```
147
148**Agent orchestration is as important as agent selection** - Use studio-coach for complex coordination, leverage auto-triggering for workflow continuity, and prefer agent teams over solo agent work for comprehensive solutions.

1# AGENTS - Rapid Selection Guide & Intelligent Orchestrator 2 3**Primary Directive**: "Agents First, Tools Second - Expert Context Over General Purpose" 4 5## â¡ RAPID AGENT SELECTION 6 7### ð¨ MANDATORY UTILITY AGENTS (5) 8**NEVER use direct tools for these domains** 9 10| Agent | Domain | Trigger Keywords | 11|-------|--------|------------------| 12| **file-creator** | File/directory creation | "create", "generate", "new file", "setup structure" | 13| **git-workflow** | All git operations | "commit", "branch", "merge", "git", "push", "pull" | 14| **context-fetcher** | Internal documentation | "docs", "README", "internal guide", "project docs" | 15| **knowledge-fetcher** | External research | "search", "Readwise", "Context7", "web search", "find articles" | 16| **date-checker** | Date/time calculations | "when", "schedule", "time since", "date", "timestamp" | 17 18### ð¯ INSTANT AGENT MATCHING 19 20| User Intent | Primary Agent | Secondary Options | 21|-------------|---------------|-------------------| 22| **"Build new feature"** | rapid-prototyper | â ui-designer â frontend-developer | 23| **"Fix this bug"** | backend-architect / frontend-developer | + test-writer-fixer (auto-triggers) | 24| **"Test this code"** | test-writer-fixer | + api-tester, performance-benchmarker | 25| **"Deploy this"** | devops-automator | + project-shipper | 26| **"Design this UI"** | ui-designer | â frontend-developer â whimsy-injector | 27| **"Analyze feedback"** | feedback-synthesizer | + ux-researcher | 28| **"Complex multi-step"** | **studio-coach** | (orchestrates others) | 29 30### ð COMPLEXITY ROUTING 31 32```yaml 33Simple (1 agent): Direct task â Specialized agent 34Medium (2-3 agents): Sequential workflow â Auto-handoffs 35Complex (4+ agents): studio-coach â Orchestrated workflow 36``` 37 38## ð¼ ORCHESTRATION WORKFLOWS 39 40### ð MASTER ORCHESTRATOR: studio-coach 41 42**Auto-activates when:** 43- 4+ agents needed 44- Cross-domain complexity 45- Multi-phase projects 46- Agent coordination required 47 48### ð¯ AUTO-TRIGGERING AGENTS 49 50| Trigger Event | Agent | Purpose | 51|---------------|-------|---------| 52| Code changes | **test-writer-fixer** | Immediate test coverage | 53| UI/UX changes | **whimsy-injector** | Add delightful interactions | 54| Feature flags mentioned | **experiment-tracker** | A/B testing setup | 55| Complex workflows start | **studio-coach** | Orchestration management | 56 57## ð¯ SPECIALIZED AGENT DIRECTORY 58 59### ð ï¸ Engineering (7 agents) 60- **rapid-prototyper**: MVP builder â ui-designer, test-writer-fixer 61- **backend-architect**: API design â devops-automator, api-tester 62- **frontend-developer**: UI implementation â ui-designer, whimsy-injector 63- **mobile-app-builder**: Native apps â app-store-optimizer 64- **ai-engineer**: AI/ML integration â performance-benchmarker 65- **devops-automator**: Deployment â project-shipper, infrastructure-maintainer 66- **test-writer-fixer**: Testing strategy â api-tester, test-results-analyzer 67 68### ð¨ Design (5 agents) 69- **ui-designer**: Interface design â frontend-developer, brand-guardian 70- **ux-researcher**: User insights â feedback-synthesizer, analytics-reporter 71- **whimsy-injector**: Interaction delight (auto-triggers after UI changes) 72- **brand-guardian**: Visual consistency â visual-storyteller 73- **visual-storyteller**: Marketing visuals â content-creator 74 75### ð Marketing (7 agents) 76- **growth-hacker**: Viral loops â analytics-reporter, experiment-tracker 77- **tiktok-strategist**: TikTok content â content-creator 78- **app-store-optimizer**: ASO â mobile-app-builder 79- **content-creator**: Multi-platform content â instagram-curator, twitter-engager 80- **instagram-curator**: Visual content â visual-storyteller 81- **reddit-community-builder**: Community engagement â support-responder 82- **twitter-engager**: Trend engagement â trend-researcher 83 84### ð¯ Product (3 agents) 85- **feedback-synthesizer**: User feedback â ux-researcher, sprint-prioritizer 86- **sprint-prioritizer**: Planning â rapid-prototyper, studio-producer 87- **trend-researcher**: Market analysis â growth-hacker 88 89### ð Project Management (3 agents) 90- **experiment-tracker**: A/B testing (auto-triggers on feature flags) 91- **project-shipper**: Launch management â devops-automator 92- **studio-producer**: Team coordination â studio-coach 93 94### ð¢ Operations (5 agents) 95- **analytics-reporter**: Data insights â experiment-tracker 96- **finance-tracker**: Profitability â infrastructure-maintainer 97- **infrastructure-maintainer**: Scaling â devops-automator 98- **legal-compliance-checker**: Legal review â project-shipper 99- **support-responder**: Customer support â feedback-synthesizer 100 101### ð§ª Testing (5 agents) 102- **api-tester**: API validation â backend-architect, performance-benchmarker 103- **performance-benchmarker**: Speed optimization â test-results-analyzer 104- **test-results-analyzer**: Failure patterns â test-writer-fixer 105- **tool-evaluator**: Tech decisions â workflow-optimizer 106- **workflow-optimizer**: Process improvement â studio-producer 107 108### ð Bonus Agents 109- **joker**: Morale boost â whimsy-injector 110 111## ð¯ AGENT SELECTION MATRIX 112 113### Decision Tree 114```yaml 115task_analysis: 116 utility_domain: USE_MANDATORY_AGENT (no alternatives) 117 single_domain: USE_SPECIALIZED_AGENT 118 cross_domain: SEQUENTIAL_WORKFLOW (2-3 agents) 119 complex_project: STUDIO_COACH_ORCHESTRATION (4+ agents) 120 121coordination_level: 122 simple: Direct agent selection 123 medium: Auto-handoffs between 2-3 agents 124 complex: studio-coach orchestrated workflows 125 126urgency: 127 immediate: Single specialized agent 128 planned: Sequential workflow 129 strategic: Full orchestration with parallel teams 130``` 131 132### Agent Relationship Map 133```yaml 134core_relationships: 135 development_trio: [rapid-prototyper, frontend-developer, test-writer-fixer] 136 design_duo: [ui-designer, whimsy-injector] 137 backend_stack: [backend-architect, devops-automator, api-tester] 138 marketing_squad: [growth-hacker, content-creator, tiktok-strategist] 139 testing_team: [test-writer-fixer, api-tester, performance-benchmarker, test-results-analyzer] 140 141auto_triggers: 142 code_change: test-writer-fixer 143 ui_change: whimsy-injector 144 feature_flags: experiment-tracker 145 complex_workflow: studio-coach 146``` 147 148**Agent orchestration is as important as agent selection** - Use studio-coach for complex coordination, leverage auto-triggering for workflow continuity, and prefer agent teams over solo agent work for comprehensive solutions.