Using AI Engineering
Overview
This meta-skill routes you to the right AI/ML engineering pack based on your task. Load this skill when you need ML/AI expertise but aren't sure which specific pack to use.
Core Principle: Problem type determines routing - clarify before guessing.
When to Use
Load this skill when:
- Starting any AI/ML engineering task
- User mentions: "neural network", "train a model", "RL agent", "fine-tune LLM", "deploy model"
- You recognize ML/AI work but unsure which pack applies
- Need to combine multiple domains (e.g., train RL + deploy)
How to Access Reference Sheets
IMPORTANT: All reference sheets are located in the SAME DIRECTORY as this SKILL.md file.
When this skill is loaded from:
skills/using-ai-engineering/SKILL.md
Reference sheets are at:
skills/using-ai-engineering/routing-examples.md
NOT at:
skills/routing-examples.md ← WRONG PATH
STOP - Mandatory Clarification Triggers
Before routing, if query contains ANY of these ambiguous patterns, ASK ONE clarifying question:
| Ambiguous Term |
What to Ask |
Why |
| "Model not working" |
"What's not working - architecture, training, or deployment?" |
Could be 3+ packs |
| "Improve performance" |
"Performance in what sense - training speed, inference speed, or accuracy?" |
Different domains |
| "Learning chatbot/agent" |
"Fine-tuning language generation or optimizing dialogue policy?" |
LLM vs RL vs both |
| "Train/deploy model" |
"Both training AND deployment, or just one?" |
May need multiple packs |
| Framework not mentioned |
"What framework are you using?" |
PyTorch-specific vs generic |
If you catch yourself about to guess the domain, STOP and clarify.
Routing by Problem Type
| Keywords/Signals |
Route To |
Why |
| PyTorch, CUDA, memory, distributed, tensor, GPU |
pytorch-engineering |
Foundation issues |
| NaN loss, converge, unstable, hyperparameters, gradients, LR |
training-optimization |
Training problems |
| Agent, policy, reward, environment, MDP, game, exploration |
deep-rl |
RL domain |
| LLM, fine-tune, RLHF, LoRA, GPT, prompt, instruction tuning |
llm-specialist |
Language models |
| Which architecture, CNN vs transformer, model selection |
neural-architectures |
Architecture choice |
| Deploy, serve, production, quantize, inference, latency, mobile |
ml-production |
Deployment |
Cross-Cutting Scenarios
When task spans domains, route to ALL relevant packs in execution order:
| Query |
Route To |
Order |
| "Train RL agent and deploy" |
deep-rl + ml-production |
Train before deploy |
| "Fine-tune LLM with distributed training" |
llm-specialist + pytorch-engineering |
Domain first, then infrastructure |
| "LLM memory error during fine-tuning" |
pytorch-engineering + llm-specialist |
Foundation first |
| "RL training unstable" |
training-optimization + deep-rl |
General training first |
Principle: Load in order of dependency. Fix foundation before domain. Complete training before deployment.
Common Routing Mistakes
| Symptom |
Wrong Route |
Correct Route |
Why |
| "Train agent faster" |
deep-rl |
training-optimization FIRST |
Could be general training issue |
| "LLM memory error" |
llm-specialist |
pytorch-engineering FIRST |
Foundation issue |
| "Deploy RL model" |
deep-rl |
ml-production |
Deployment problem |
| "Transformer for chess" |
neural-architectures |
deep-rl FIRST |
RL problem |
| "Chatbot learning" |
llm-specialist |
ASK FIRST |
Could be LLM OR RL |
Pressure Resistance - Critical Discipline
Time/Emergency Pressure
| Rationalization |
Reality Check |
Correct Action |
| "Emergency means skip diagnostics" |
Wrong diagnosis wastes MORE time |
Fast systematic diagnosis IS emergency protocol |
| "Quick question means quick answer" |
Wrong answer slower than 30-sec clarification |
Ask ONE clarifying question |
| "Production down, no time for routing" |
Wrong pack = longer outage |
Correct routing (60 sec) prevents 20-min detour |
Emergency Protocol:
- Acknowledge urgency
- Fast clarification (30 sec)
- Route to correct pack
- Let pack provide emergency-appropriate approach
Authority/Hierarchy Pressure
| Rationalization |
Reality Check |
Correct Action |
| "PM/architect said use X" |
Authority can be wrong about routing |
Verify task type regardless |
| "Questioning authority is risky" |
Professional duty = correct routing |
Frame as verification |
| "They have more context" |
Context ≠ correct technical routing |
Route based on problem type |
Authority Protocol: "I see [authority] suggested X - to apply it correctly, let me verify problem type"
Sunk Cost Pressure
| Rationalization |
Reality Check |
Correct Action |
| "Already spent N hours in X, continue" |
Sunk cost fallacy - wrong direction stays wrong |
Cut losses immediately |
| "Redirecting invalidates their effort" |
Correct routing validates effort by enabling success |
Redirect now |
| "Too invested to change direction" |
More investment in wrong direction = more waste |
"Stop digging when in hole" |
Sunk Cost Protocol: "I see N hours invested - redirecting now prevents more wasted hours"
Keyword/Anchoring Pressure
| Rationalization |
Reality Check |
Correct Action |
| "They mentioned transformer" |
Keywords mislead; problem type matters |
"Transformer for what problem type?" |
| "LLM mentioned, must be llm-specialist" |
LLM could have foundation issues |
Check problem type first |
| "They asked to 'fix RL'" |
User's framing can be wrong |
Verify RL is correct approach |
Red Flags Checklist - STOP Immediately
Basic Routing Red Flags
- ❌ "I'll guess this domain" → ASK clarifying question
- ❌ "They probably mean X" → Verify, don't assume
- ❌ "Just give generic advice" → Route to specific pack
Time/Emergency Red Flags
- ❌ "Emergency means skip clarification" → Fast clarification IS emergency protocol
- ❌ "Production issue means guess quickly" → Wrong guess = longer outage
- ❌ "I'll skip asking to save time" → Clarifying (30 sec) faster than wrong route (5+ min)
Authority/Social Red Flags
- ❌ "Authority figure suggested X, so route to X" → Verify task requirements
- ❌ "PM/senior has more context, trust them" → Route based on problem type
- ❌ "They're frustrated/exhausted, avoid redirect" → Continuing wrong path makes it worse
Sunk Cost Red Flags
- ❌ "They invested N hours in X, continue there" → Sunk cost fallacy, cut losses
- ❌ "Redirecting invalidates their effort" → Correct routing enables success
- ❌ "Too much sunk cost to change direction" → More investment = more waste
Keyword/Anchoring Red Flags
- ❌ "They mentioned transformer/CNN, discuss architecture" → Check problem type first
- ❌ "LLM/RL mentioned, route to that domain" → Could be foundation issue
- ❌ "Technical jargon means they know domain" → Vocabulary ≠ correct self-diagnosis
All of these mean: Either ASK ONE clarifying question, or reconsider your routing logic.
Comprehensive Rationalization Prevention Table
| Pressure Type |
Rationalization |
Counter-Narrative |
Correct Action |
| Time |
"Emergency means skip diagnostics" |
Wrong diagnosis wastes MORE time |
"Fast clarification ensures fastest fix" |
| Time |
"Quick question means quick answer" |
Wrong answer slower than clarification |
"Quick clarification prevents wrong path" |
| Time |
"Production down, no time for routing" |
Wrong pack = longer outage |
"60-second routing prevents 20-minute detour" |
| Authority |
"PM/architect said use X pack" |
Authority can be wrong |
"To apply X correctly, let me verify" |
| Authority |
"Senior colleague suggested X" |
Seniority ≠ correct routing |
"To use suggestion effectively: [verify]" |
| Sunk Cost |
"Already spent 6 hours in pack X" |
Sunk cost fallacy |
"Redirecting now prevents more wasted hours" |
| Sunk Cost |
"Redirecting invalidates effort" |
Correct routing enables success |
"Redirect so effort succeeds" |
| Keywords |
"User mentioned transformers" |
Keywords mislead |
"Clarifying problem type first" |
| Keywords |
"They said LLM, route to llm-specialist" |
LLM could have foundation issues |
"Memory error is foundation issue" |
| Anchoring |
"They asked to 'fix RL'" |
User's framing can be wrong |
"Before fixing, verify RL is correct" |
| Complexity |
"Too many domains, just pick one" |
Cross-cutting needs multi-pack |
Route to ALL relevant packs |
| Social |
"They're frustrated, don't redirect" |
Continuing wrong path increases frustration |
"Redirecting prevents more frustration" |
| Demanding |
"They said 'just tell me', skip questions" |
Tone doesn't change routing needs |
"To help effectively, I need: [question]" |
When NOT to Use Yzmir Skills
Skip AI/ML skills when:
- Simple data processing without ML
- Statistical analysis without neural networks
- Data cleaning/ETL without model training
Red flag: If you're not training/deploying a neural network or implementing ML algorithms, probably don't need Yzmir.
Routing Summary Flowchart
User Query
↓
Is query ambiguous? → YES → ASK clarifying question
↓ NO
Identify problem type:
- Framework error? → pytorch-engineering
- Training not working? → training-optimization
- RL problem? → deep-rl
- LLM fine-tuning? → llm-specialist
- Architecture choice? → neural-architectures
- Production deployment? → ml-production
↓
Cross-cutting? → YES → Route to MULTIPLE packs (order by dependency)
↓ NO
Route to single pack
Examples
See routing-examples.md for detailed worked examples:
- Ambiguous queries
- Cross-cutting scenarios
- Misleading keywords
- Time pressure handling
- Foundation issues disguised as domain issues
- Emergency + authority pressure
- Sunk cost + frustration
- Multiple pressures combined
AI Engineering Plugin Router Catalog
This meta-router directs you to the appropriate Yzmir AI/ML plugin:
- yzmir-pytorch-engineering - PyTorch framework: CUDA, memory, distributed, tensor operations
- yzmir-training-optimization - Training problems: NaN losses, convergence, gradients, learning rate
- yzmir-deep-rl - Reinforcement learning: Agents, policies, rewards, environments, MDP
- yzmir-llm-specialist - Large language models: Fine-tuning, RLHF, LoRA, prompt engineering
- yzmir-neural-architectures - Architecture selection: CNN vs transformer, model design
- yzmir-ml-production - Production deployment: Serving, quantization, inference, MLOps
Remember: When in doubt, ASK. Clarification takes seconds, wrong routing takes minutes.
1---2name: using-ai-engineering3description: Route AI/ML tasks to correct Yzmir pack - frameworks, training, RL, LLMs, architectures, production4---5
6# Using AI Engineering
7
8## Overview
9
10This meta-skill routes you to the right AI/ML engineering pack based on your task. Load this skill when you need ML/AI expertise but aren't sure which specific pack to use.
11
12**Core Principle**: Problem type determines routing - clarify before guessing.
13
14## When to Use
15
16Load this skill when:
17- Starting any AI/ML engineering task
18- User mentions: "neural network", "train a model", "RL agent", "fine-tune LLM", "deploy model"
19- You recognize ML/AI work but unsure which pack applies
20- Need to combine multiple domains (e.g., train RL + deploy)
21
22## How to Access Reference Sheets
23
24**IMPORTANT**: All reference sheets are located in the SAME DIRECTORY as this SKILL.md file.
25
26When this skill is loaded from:
27 `skills/using-ai-engineering/SKILL.md`
28
29Reference sheets are at:
30 `skills/using-ai-engineering/routing-examples.md`
31
32NOT at:
33 `skills/routing-examples.md` ← WRONG PATH
34
35---
36
37## STOP - Mandatory Clarification Triggers
38
39Before routing, if query contains ANY of these ambiguous patterns, ASK ONE clarifying question:
40
41| Ambiguous Term | What to Ask | Why |
42|----------------|-------------|-----|
43| "Model not working" | "What's not working - architecture, training, or deployment?" | Could be 3+ packs |
44| "Improve performance" | "Performance in what sense - training speed, inference speed, or accuracy?" | Different domains |
45| "Learning chatbot/agent" | "Fine-tuning language generation or optimizing dialogue policy?" | LLM vs RL vs both |
46| "Train/deploy model" | "Both training AND deployment, or just one?" | May need multiple packs |
47| Framework not mentioned | "What framework are you using?" | PyTorch-specific vs generic |
48
49**If you catch yourself about to guess the domain, STOP and clarify.**
50
51---
52
53## Routing by Problem Type
54
55| Keywords/Signals | Route To | Why |
56|------------------|----------|-----|
57| PyTorch, CUDA, memory, distributed, tensor, GPU | **pytorch-engineering** | Foundation issues |
58| NaN loss, converge, unstable, hyperparameters, gradients, LR | **training-optimization** | Training problems |
59| Agent, policy, reward, environment, MDP, game, exploration | **deep-rl** | RL domain |
60| LLM, fine-tune, RLHF, LoRA, GPT, prompt, instruction tuning | **llm-specialist** | Language models |
61| Which architecture, CNN vs transformer, model selection | **neural-architectures** | Architecture choice |
62| Deploy, serve, production, quantize, inference, latency, mobile | **ml-production** | Deployment |
63
64---
65
66## Cross-Cutting Scenarios
67
68When task spans domains, route to ALL relevant packs in execution order:
69
70| Query | Route To | Order |
71|-------|----------|-------|
72| "Train RL agent and deploy" | deep-rl + ml-production | Train before deploy |
73| "Fine-tune LLM with distributed training" | llm-specialist + pytorch-engineering | Domain first, then infrastructure |
74| "LLM memory error during fine-tuning" | pytorch-engineering + llm-specialist | Foundation first |
75| "RL training unstable" | training-optimization + deep-rl | General training first |
76
77**Principle**: Load in order of dependency. Fix foundation before domain. Complete training before deployment.
78
79---
80
81## Common Routing Mistakes
82
83| Symptom | Wrong Route | Correct Route | Why |
84|---------|-------------|---------------|-----|
85| "Train agent faster" | deep-rl | training-optimization FIRST | Could be general training issue |
86| "LLM memory error" | llm-specialist | pytorch-engineering FIRST | Foundation issue |
87| "Deploy RL model" | deep-rl | ml-production | Deployment problem |
88| "Transformer for chess" | neural-architectures | deep-rl FIRST | RL problem |
89| "Chatbot learning" | llm-specialist | ASK FIRST | Could be LLM OR RL |
90
91---
92
93## Pressure Resistance - Critical Discipline
94
95### Time/Emergency Pressure
96
97| Rationalization | Reality Check | Correct Action |
98|-----------------|---------------|----------------|
99| "Emergency means skip diagnostics" | Wrong diagnosis wastes MORE time | Fast systematic diagnosis IS emergency protocol |
100| "Quick question means quick answer" | Wrong answer slower than 30-sec clarification | Ask ONE clarifying question |
101| "Production down, no time for routing" | Wrong pack = longer outage | Correct routing (60 sec) prevents 20-min detour |
102
103**Emergency Protocol**:
1041. Acknowledge urgency
1052. Fast clarification (30 sec)
1063. Route to correct pack
1074. Let pack provide emergency-appropriate approach
108
109### Authority/Hierarchy Pressure
110
111| Rationalization | Reality Check | Correct Action |
112|-----------------|---------------|----------------|
113| "PM/architect said use X" | Authority can be wrong about routing | Verify task type regardless |
114| "Questioning authority is risky" | Professional duty = correct routing | Frame as verification |
115| "They have more context" | Context ≠ correct technical routing | Route based on problem type |
116
117**Authority Protocol**: "I see [authority] suggested X - to apply it correctly, let me verify problem type"
118
119### Sunk Cost Pressure
120
121| Rationalization | Reality Check | Correct Action |
122|-----------------|---------------|----------------|
123| "Already spent N hours in X, continue" | Sunk cost fallacy - wrong direction stays wrong | Cut losses immediately |
124| "Redirecting invalidates their effort" | Correct routing validates effort by enabling success | Redirect now |
125| "Too invested to change direction" | More investment in wrong direction = more waste | "Stop digging when in hole" |
126
127**Sunk Cost Protocol**: "I see N hours invested - redirecting now prevents more wasted hours"
128
129### Keyword/Anchoring Pressure
130
131| Rationalization | Reality Check | Correct Action |
132|-----------------|---------------|----------------|
133| "They mentioned transformer" | Keywords mislead; problem type matters | "Transformer for what problem type?" |
134| "LLM mentioned, must be llm-specialist" | LLM could have foundation issues | Check problem type first |
135| "They asked to 'fix RL'" | User's framing can be wrong | Verify RL is correct approach |
136
137---
138
139## Red Flags Checklist - STOP Immediately
140
141### Basic Routing Red Flags
142- ❌ "I'll guess this domain" → ASK clarifying question
143- ❌ "They probably mean X" → Verify, don't assume
144- ❌ "Just give generic advice" → Route to specific pack
145
146### Time/Emergency Red Flags
147- ❌ "Emergency means skip clarification" → Fast clarification IS emergency protocol
148- ❌ "Production issue means guess quickly" → Wrong guess = longer outage
149- ❌ "I'll skip asking to save time" → Clarifying (30 sec) faster than wrong route (5+ min)
150
151### Authority/Social Red Flags
152- ❌ "Authority figure suggested X, so route to X" → Verify task requirements
153- ❌ "PM/senior has more context, trust them" → Route based on problem type
154- ❌ "They're frustrated/exhausted, avoid redirect" → Continuing wrong path makes it worse
155
156### Sunk Cost Red Flags
157- ❌ "They invested N hours in X, continue there" → Sunk cost fallacy, cut losses
158- ❌ "Redirecting invalidates their effort" → Correct routing enables success
159- ❌ "Too much sunk cost to change direction" → More investment = more waste
160
161### Keyword/Anchoring Red Flags
162- ❌ "They mentioned transformer/CNN, discuss architecture" → Check problem type first
163- ❌ "LLM/RL mentioned, route to that domain" → Could be foundation issue
164- ❌ "Technical jargon means they know domain" → Vocabulary ≠ correct self-diagnosis
165
166**All of these mean: Either ASK ONE clarifying question, or reconsider your routing logic.**
167
168---
169
170## Comprehensive Rationalization Prevention Table
171
172| Pressure Type | Rationalization | Counter-Narrative | Correct Action |
173|---------------|-----------------|-------------------|----------------|
174| **Time** | "Emergency means skip diagnostics" | Wrong diagnosis wastes MORE time | "Fast clarification ensures fastest fix" |
175| **Time** | "Quick question means quick answer" | Wrong answer slower than clarification | "Quick clarification prevents wrong path" |
176| **Time** | "Production down, no time for routing" | Wrong pack = longer outage | "60-second routing prevents 20-minute detour" |
177| **Authority** | "PM/architect said use X pack" | Authority can be wrong | "To apply X correctly, let me verify" |
178| **Authority** | "Senior colleague suggested X" | Seniority ≠ correct routing | "To use suggestion effectively: [verify]" |
179| **Sunk Cost** | "Already spent 6 hours in pack X" | Sunk cost fallacy | "Redirecting now prevents more wasted hours" |
180| **Sunk Cost** | "Redirecting invalidates effort" | Correct routing enables success | "Redirect so effort succeeds" |
181| **Keywords** | "User mentioned transformers" | Keywords mislead | "Clarifying problem type first" |
182| **Keywords** | "They said LLM, route to llm-specialist" | LLM could have foundation issues | "Memory error is foundation issue" |
183| **Anchoring** | "They asked to 'fix RL'" | User's framing can be wrong | "Before fixing, verify RL is correct" |
184| **Complexity** | "Too many domains, just pick one" | Cross-cutting needs multi-pack | Route to ALL relevant packs |
185| **Social** | "They're frustrated, don't redirect" | Continuing wrong path increases frustration | "Redirecting prevents more frustration" |
186| **Demanding** | "They said 'just tell me', skip questions" | Tone doesn't change routing needs | "To help effectively, I need: [question]" |
187
188---
189
190## When NOT to Use Yzmir Skills
191
192**Skip AI/ML skills when:**
193- Simple data processing without ML
194- Statistical analysis without neural networks
195- Data cleaning/ETL without model training
196
197**Red flag**: If you're not training/deploying a neural network or implementing ML algorithms, probably don't need Yzmir.
198
199---
200
201## Routing Summary Flowchart
202
203```
204User Query
205 ↓
206Is query ambiguous? → YES → ASK clarifying question
207 ↓ NO
208Identify problem type:
209 - Framework error? → pytorch-engineering
210 - Training not working? → training-optimization
211 - RL problem? → deep-rl
212 - LLM fine-tuning? → llm-specialist
213 - Architecture choice? → neural-architectures
214 - Production deployment? → ml-production
215 ↓
216Cross-cutting? → YES → Route to MULTIPLE packs (order by dependency)
217 ↓ NO
218Route to single pack
219```
220
221---
222
223## Examples
224
225See [routing-examples.md](routing-examples.md) for detailed worked examples:
226- Ambiguous queries
227- Cross-cutting scenarios
228- Misleading keywords
229- Time pressure handling
230- Foundation issues disguised as domain issues
231- Emergency + authority pressure
232- Sunk cost + frustration
233- Multiple pressures combined
234
235---
236
237## AI Engineering Plugin Router Catalog
238
239This meta-router directs you to the appropriate Yzmir AI/ML plugin:
240
2411. **yzmir-pytorch-engineering** - PyTorch framework: CUDA, memory, distributed, tensor operations
2422. **yzmir-training-optimization** - Training problems: NaN losses, convergence, gradients, learning rate
2433. **yzmir-deep-rl** - Reinforcement learning: Agents, policies, rewards, environments, MDP
2444. **yzmir-llm-specialist** - Large language models: Fine-tuning, RLHF, LoRA, prompt engineering
2455. **yzmir-neural-architectures** - Architecture selection: CNN vs transformer, model design
2466. **yzmir-ml-production** - Production deployment: Serving, quantization, inference, MLOps
247
248**Remember**: When in doubt, ASK. Clarification takes seconds, wrong routing takes minutes.