antigravity-devkit 1.0.2 → 1.0.4
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/README.md +153 -26
- package/package.json +2 -2
- package/template/ARCHITECTURE.md +0 -148
- package/template/README.md +0 -421
- package/template/agents/backend-specialist.md +0 -137
- package/template/agents/database-architect.md +0 -114
- package/template/agents/debugger.md +0 -108
- package/template/agents/devops-engineer.md +0 -125
- package/template/agents/documentation-writer.md +0 -109
- package/template/agents/explorer-agent.md +0 -107
- package/template/agents/frontend-specialist.md +0 -231
- package/template/agents/orchestrator.md +0 -100
- package/template/agents/performance-optimizer.md +0 -109
- package/template/agents/project-planner.md +0 -123
- package/template/agents/security-auditor.md +0 -107
- package/template/agents/test-engineer.md +0 -133
- package/template/rules/GEMINI.md +0 -180
- package/template/scripts/README.md +0 -317
- package/template/scripts/checklist.py +0 -170
- package/template/scripts/lint_runner.py +0 -253
- package/template/scripts/schema_validator.py +0 -277
- package/template/scripts/security_scan.py +0 -354
- package/template/scripts/verify_all.py +0 -243
- package/template/scripts/vitest_runner.py +0 -203
- package/template/scripts/xunit_runner.py +0 -235
- package/template/skills/api-patterns/SKILL.md +0 -116
- package/template/skills/architecture/SKILL.md +0 -98
- package/template/skills/aspnet-patterns/SKILL.md +0 -122
- package/template/skills/azure-aks/SKILL.md +0 -136
- package/template/skills/azure-devops/SKILL.md +0 -123
- package/template/skills/azure-keyvault/SKILL.md +0 -100
- package/template/skills/brainstorming/SKILL.md +0 -96
- package/template/skills/clean-code/SKILL.md +0 -84
- package/template/skills/csharp-patterns/SKILL.md +0 -155
- package/template/skills/documentation-templates/SKILL.md +0 -127
- package/template/skills/frontend-design/SKILL.md +0 -199
- package/template/skills/frontend-design/animation-guide.md +0 -217
- package/template/skills/frontend-design/design-systems.md +0 -230
- package/template/skills/frontend-design/ux-psychology.md +0 -128
- package/template/skills/gitops-patterns/SKILL.md +0 -105
- package/template/skills/grafana-logging/SKILL.md +0 -107
- package/template/skills/intelligent-routing/SKILL.md +0 -75
- package/template/skills/plan-writing/SKILL.md +0 -96
- package/template/skills/sqlserver-design/SKILL.md +0 -97
- package/template/skills/systematic-debugging/SKILL.md +0 -98
- package/template/skills/testing-patterns/SKILL.md +0 -102
- package/template/skills/vitest-testing/SKILL.md +0 -116
- package/template/skills/vue3-patterns/SKILL.md +0 -235
- package/template/skills/vulnerability-scanner/SKILL.md +0 -104
- package/template/skills/xunit-testing/SKILL.md +0 -127
- package/template/workflows/brainstorm.md +0 -69
- package/template/workflows/code.md +0 -82
- package/template/workflows/create.md +0 -79
- package/template/workflows/debug.md +0 -83
- package/template/workflows/deploy.md +0 -101
- package/template/workflows/orchestrate.md +0 -86
- package/template/workflows/plan.md +0 -79
- package/template/workflows/review.md +0 -85
- package/template/workflows/status.md +0 -90
- package/template/workflows/test.md +0 -89
|
@@ -1,230 +0,0 @@
|
|
|
1
|
-
# Design Systems Reference
|
|
2
|
-
|
|
3
|
-
> Color theory, typography, and visual hierarchy principles for Vue3 + Tailwind.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## Color Principles
|
|
8
|
-
|
|
9
|
-
### 60-30-10 Rule
|
|
10
|
-
|
|
11
|
-
```
|
|
12
|
-
60% → Primary/Background (calm, neutral base)
|
|
13
|
-
30% → Secondary (supporting areas)
|
|
14
|
-
10% → Accent (CTAs, highlights)
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
### Color Psychology
|
|
18
|
-
|
|
19
|
-
| Need | Consider | Avoid |
|
|
20
|
-
|------|----------|-------|
|
|
21
|
-
| Trust, calm | Blue family | Aggressive reds |
|
|
22
|
-
| Growth, nature | Green family | Industrial grays |
|
|
23
|
-
| Energy, urgency | Orange, red | Passive blues |
|
|
24
|
-
| Luxury | Deep Teal, Gold, Emerald | Cheap brights |
|
|
25
|
-
| Clean, minimal | Neutrals | Overwhelming color |
|
|
26
|
-
|
|
27
|
-
### ⛔ Colors to AVOID (AI Clichés)
|
|
28
|
-
|
|
29
|
-
| ❌ Avoid | Why | ✅ Try Instead |
|
|
30
|
-
|----------|-----|----------------|
|
|
31
|
-
| Purple/Violet | #1 AI default | Teal, Emerald, Coral |
|
|
32
|
-
| Fintech Blue | Safe harbor | Signal Orange, Deep Green |
|
|
33
|
-
| Pink gradients | Overused | Rich Gold, Warm Terracotta |
|
|
34
|
-
| Neon glow | Generic "tech" | Solid contrast, texture |
|
|
35
|
-
|
|
36
|
-
### Selection Process
|
|
37
|
-
|
|
38
|
-
1. **Industry?** → Narrows options
|
|
39
|
-
2. **Emotion?** → Picks primary
|
|
40
|
-
3. **Light/Dark mode?** → Sets foundation
|
|
41
|
-
4. **ASK USER** if not specified
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
45
|
-
## Tailwind Custom Palette
|
|
46
|
-
|
|
47
|
-
```javascript
|
|
48
|
-
// tailwind.config.js - UNIQUE colors
|
|
49
|
-
module.exports = {
|
|
50
|
-
theme: {
|
|
51
|
-
extend: {
|
|
52
|
-
colors: {
|
|
53
|
-
// Define brand-specific colors
|
|
54
|
-
brand: {
|
|
55
|
-
50: '#f0fdfa',
|
|
56
|
-
500: '#14b8a6', // Primary - NOT purple
|
|
57
|
-
900: '#134e4a',
|
|
58
|
-
},
|
|
59
|
-
accent: {
|
|
60
|
-
DEFAULT: '#f59e0b', // Distinctive accent
|
|
61
|
-
hover: '#d97706',
|
|
62
|
-
}
|
|
63
|
-
}
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
}
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
---
|
|
70
|
-
|
|
71
|
-
## Typography Principles
|
|
72
|
-
|
|
73
|
-
### Scale Ratios
|
|
74
|
-
|
|
75
|
-
| Content Type | Ratio | Feel |
|
|
76
|
-
|--------------|-------|------|
|
|
77
|
-
| Dense UI | 1.125-1.2 | Compact, efficient |
|
|
78
|
-
| General web | 1.25 | Balanced |
|
|
79
|
-
| Editorial | 1.333 | Readable, spacious |
|
|
80
|
-
| Hero/display | 1.5-1.618 | Dramatic |
|
|
81
|
-
|
|
82
|
-
### Font Pairing Concept
|
|
83
|
-
|
|
84
|
-
```
|
|
85
|
-
Contrast + Harmony:
|
|
86
|
-
├── DIFFERENT enough for hierarchy
|
|
87
|
-
├── SIMILAR enough for cohesion
|
|
88
|
-
└── Usually: display + neutral, or serif + sans
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
### ⛔ Fonts to AVOID (AI Defaults)
|
|
92
|
-
|
|
93
|
-
| ❌ Avoid | Why | ✅ Try Instead |
|
|
94
|
-
|----------|-----|----------------|
|
|
95
|
-
| Inter | Every AI uses it | Space Grotesk, DM Sans |
|
|
96
|
-
| Roboto | Generic | Outfit, General Sans |
|
|
97
|
-
| Poppins | Overused | Cabinet Grotesk, Clash Display |
|
|
98
|
-
| System fonts | Lazy | Research unique fonts |
|
|
99
|
-
|
|
100
|
-
### Unique Font Suggestions
|
|
101
|
-
|
|
102
|
-
| Purpose | Font Options |
|
|
103
|
-
|---------|--------------|
|
|
104
|
-
| Display/Hero | Clash Display, Cabinet Grotesk, Syne |
|
|
105
|
-
| Body | DM Sans, Outfit, General Sans |
|
|
106
|
-
| Mono/Code | JetBrains Mono, Fira Code |
|
|
107
|
-
| Elegant | Fraunces, Newsreader, Lora |
|
|
108
|
-
|
|
109
|
-
---
|
|
110
|
-
|
|
111
|
-
## Tailwind Typography Setup
|
|
112
|
-
|
|
113
|
-
```javascript
|
|
114
|
-
// tailwind.config.js
|
|
115
|
-
module.exports = {
|
|
116
|
-
theme: {
|
|
117
|
-
extend: {
|
|
118
|
-
fontFamily: {
|
|
119
|
-
display: ['Clash Display', 'sans-serif'],
|
|
120
|
-
body: ['DM Sans', 'sans-serif'],
|
|
121
|
-
mono: ['JetBrains Mono', 'monospace'],
|
|
122
|
-
},
|
|
123
|
-
fontSize: {
|
|
124
|
-
'hero': ['4.5rem', { lineHeight: '1.1', letterSpacing: '-0.02em' }],
|
|
125
|
-
'display': ['3rem', { lineHeight: '1.2' }],
|
|
126
|
-
}
|
|
127
|
-
}
|
|
128
|
-
}
|
|
129
|
-
}
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
### Readability Rules
|
|
133
|
-
|
|
134
|
-
- **Line length:** 45-75 characters optimal
|
|
135
|
-
- **Line height:** 1.4-1.6 for body
|
|
136
|
-
- **Contrast:** WCAG AA minimum (4.5:1)
|
|
137
|
-
- **Base size:** 16px+ for web
|
|
138
|
-
|
|
139
|
-
---
|
|
140
|
-
|
|
141
|
-
## Visual Hierarchy
|
|
142
|
-
|
|
143
|
-
### Sizing Principles
|
|
144
|
-
|
|
145
|
-
| Element | Consideration |
|
|
146
|
-
|---------|---------------|
|
|
147
|
-
| **Touch targets** | Min 44×44px mobile |
|
|
148
|
-
| **Buttons** | Height by importance (48/40/36px) |
|
|
149
|
-
| **Inputs** | Match button height |
|
|
150
|
-
| **Cards** | Consistent padding |
|
|
151
|
-
| **Reading width** | max-w-prose (65ch) |
|
|
152
|
-
|
|
153
|
-
### 8-Point Grid
|
|
154
|
-
|
|
155
|
-
```css
|
|
156
|
-
/* All spacing in multiples of 8 */
|
|
157
|
-
.spacing {
|
|
158
|
-
--space-1: 4px; /* half-step */
|
|
159
|
-
--space-2: 8px;
|
|
160
|
-
--space-3: 16px;
|
|
161
|
-
--space-4: 24px;
|
|
162
|
-
--space-5: 32px;
|
|
163
|
-
--space-6: 48px;
|
|
164
|
-
--space-7: 64px;
|
|
165
|
-
--space-8: 80px;
|
|
166
|
-
}
|
|
167
|
-
```
|
|
168
|
-
|
|
169
|
-
---
|
|
170
|
-
|
|
171
|
-
## Border Radius Strategy
|
|
172
|
-
|
|
173
|
-
**Don't default to `rounded-md`!**
|
|
174
|
-
|
|
175
|
-
| Style | Radius | Use Case |
|
|
176
|
-
|-------|--------|----------|
|
|
177
|
-
| **Sharp** | 0-2px | Tech, Luxury, Brutalist |
|
|
178
|
-
| **Subtle** | 4-6px | Professional, B2B |
|
|
179
|
-
| **Medium** | 8-12px | General, balanced |
|
|
180
|
-
| **Friendly** | 16-24px | Social, lifestyle |
|
|
181
|
-
| **Pill** | 9999px | Buttons, badges |
|
|
182
|
-
|
|
183
|
-
```javascript
|
|
184
|
-
// tailwind.config.js - COMMIT to a style
|
|
185
|
-
module.exports = {
|
|
186
|
-
theme: {
|
|
187
|
-
extend: {
|
|
188
|
-
borderRadius: {
|
|
189
|
-
'card': '2px', // Sharp for tech
|
|
190
|
-
'button': '9999px', // Pill buttons
|
|
191
|
-
}
|
|
192
|
-
}
|
|
193
|
-
}
|
|
194
|
-
}
|
|
195
|
-
```
|
|
196
|
-
|
|
197
|
-
---
|
|
198
|
-
|
|
199
|
-
## Shadow Hierarchy
|
|
200
|
-
|
|
201
|
-
```css
|
|
202
|
-
/* Tailwind shadow scale */
|
|
203
|
-
.elevation-1 { @apply shadow-sm; } /* Subtle lift */
|
|
204
|
-
.elevation-2 { @apply shadow-md; } /* Cards */
|
|
205
|
-
.elevation-3 { @apply shadow-lg; } /* Modals, dropdowns */
|
|
206
|
-
.elevation-4 { @apply shadow-xl; } /* Popovers */
|
|
207
|
-
.elevation-5 { @apply shadow-2xl; } /* Dialogs */
|
|
208
|
-
|
|
209
|
-
/* Custom dramatic shadow */
|
|
210
|
-
.shadow-dramatic {
|
|
211
|
-
box-shadow:
|
|
212
|
-
0 25px 50px -12px rgba(0, 0, 0, 0.25),
|
|
213
|
-
0 0 0 1px rgba(0, 0, 0, 0.05);
|
|
214
|
-
}
|
|
215
|
-
```
|
|
216
|
-
|
|
217
|
-
---
|
|
218
|
-
|
|
219
|
-
## Quick Decision Checklist
|
|
220
|
-
|
|
221
|
-
- [ ] **Color** - NOT purple, justified choice
|
|
222
|
-
- [ ] **Typography** - NOT Inter/Roboto, unique fonts
|
|
223
|
-
- [ ] **Border radius** - Committed style (sharp OR rounded)
|
|
224
|
-
- [ ] **Shadows** - Elevation hierarchy defined
|
|
225
|
-
- [ ] **Spacing** - 8-point grid consistent
|
|
226
|
-
- [ ] **60-30-10** - Color ratio balanced
|
|
227
|
-
|
|
228
|
-
---
|
|
229
|
-
|
|
230
|
-
> **Remember:** Design systems create consistency. Define your tokens ONCE, use everywhere.
|
|
@@ -1,128 +0,0 @@
|
|
|
1
|
-
# UX Psychology Reference
|
|
2
|
-
|
|
3
|
-
> Core UX laws, emotional design, trust building, and cognitive load management.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## Core UX Laws
|
|
8
|
-
|
|
9
|
-
| Law | Principle | Application |
|
|
10
|
-
|-----|-----------|-------------|
|
|
11
|
-
| **Hick's Law** | More choices = slower decisions | Max 5-7 nav items, progressive disclosure |
|
|
12
|
-
| **Fitts' Law** | Bigger + closer = easier to click | CTAs min 44px height, touch 44×44px |
|
|
13
|
-
| **Miller's Law** | 7±2 items in working memory | Chunk content, group related items |
|
|
14
|
-
| **Von Restorff** | Different = memorable | Make CTAs visually distinct |
|
|
15
|
-
| **Serial Position** | First/last remembered | Key info at start and end |
|
|
16
|
-
|
|
17
|
-
---
|
|
18
|
-
|
|
19
|
-
## Emotional Design (Don Norman)
|
|
20
|
-
|
|
21
|
-
```
|
|
22
|
-
VISCERAL (instant) → First impression: colors, imagery, overall feel
|
|
23
|
-
"Wow, this looks beautiful!"
|
|
24
|
-
|
|
25
|
-
BEHAVIORAL (use) → Using it: speed, feedback, efficiency
|
|
26
|
-
"This works exactly how I expected!"
|
|
27
|
-
|
|
28
|
-
REFLECTIVE (memory) → After: identity, values, loyalty
|
|
29
|
-
"This brand represents who I am"
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
### Designing for Each Level
|
|
33
|
-
|
|
34
|
-
| Level | Focus | Implementation |
|
|
35
|
-
|-------|-------|----------------|
|
|
36
|
-
| **Visceral** | Beauty, first impression | Hero visuals, micro-interactions |
|
|
37
|
-
| **Behavioral** | Usability, feedback | Instant confirmations, smooth flows |
|
|
38
|
-
| **Reflective** | Identity, story | Brand values, testimonials, story |
|
|
39
|
-
|
|
40
|
-
---
|
|
41
|
-
|
|
42
|
-
## Trust Building
|
|
43
|
-
|
|
44
|
-
| Category | Elements | Placement |
|
|
45
|
-
|----------|----------|-----------|
|
|
46
|
-
| **Security** | SSL badges, encryption | Forms, checkout |
|
|
47
|
-
| **Social Proof** | Reviews, testimonials | Hero, product pages |
|
|
48
|
-
| **Transparency** | Clear pricing, policies | Footer, checkout |
|
|
49
|
-
| **Professional** | Consistent design | Everywhere |
|
|
50
|
-
| **Authority** | Certifications, media mentions | Header, about |
|
|
51
|
-
|
|
52
|
-
```
|
|
53
|
-
Trust Signal Placement:
|
|
54
|
-
┌─────────────────────────────────────────┐
|
|
55
|
-
│ HEADER: Trust banner, security icons │
|
|
56
|
-
├─────────────────────────────────────────┤
|
|
57
|
-
│ HERO: Social proof ("10,000+ users") │
|
|
58
|
-
├─────────────────────────────────────────┤
|
|
59
|
-
│ PRODUCT: Reviews, guarantees │
|
|
60
|
-
├─────────────────────────────────────────┤
|
|
61
|
-
│ CHECKOUT: Payment icons, SSL badge │
|
|
62
|
-
├─────────────────────────────────────────┤
|
|
63
|
-
│ FOOTER: Contact, policies, certs │
|
|
64
|
-
└─────────────────────────────────────────┘
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
---
|
|
68
|
-
|
|
69
|
-
## Cognitive Load Management
|
|
70
|
-
|
|
71
|
-
| Type | Definition | Designer's Role |
|
|
72
|
-
|------|------------|-----------------|
|
|
73
|
-
| **Intrinsic** | Task complexity | Break into smaller steps |
|
|
74
|
-
| **Extraneous** | Poor design load | **ELIMINATE THIS!** |
|
|
75
|
-
| **Germane** | Learning effort | Support and encourage |
|
|
76
|
-
|
|
77
|
-
### Reduction Strategies
|
|
78
|
-
|
|
79
|
-
1. **Simplify** - Remove visual noise, clean layouts
|
|
80
|
-
2. **Chunk** - Group into 5-7 item sets
|
|
81
|
-
3. **Progressive Disclosure** - Hide advanced options
|
|
82
|
-
4. **Familiar Patterns** - Standard placements
|
|
83
|
-
5. **Offload** - Don't make users remember
|
|
84
|
-
|
|
85
|
-
---
|
|
86
|
-
|
|
87
|
-
## Audience → Design Approach
|
|
88
|
-
|
|
89
|
-
| Audience | Colors | Typography | Layout | Trust |
|
|
90
|
-
|----------|--------|------------|--------|-------|
|
|
91
|
-
| **Gen Z** | Bold, vibrant | Large, experimental | Mobile-first, vertical | Peer reviews |
|
|
92
|
-
| **Millennials** | Muted, earth tones | Clean sans-serif | Card-based | Values, sustainability |
|
|
93
|
-
| **Gen X** | Professional | Conservative | Traditional hierarchy | Track record |
|
|
94
|
-
| **Boomers** | High contrast | Large (18px+) | Simple, linear | Phone numbers, people |
|
|
95
|
-
| **B2B** | Corporate blues | Professional | Data-focused | Certifications |
|
|
96
|
-
| **Luxury** | Black, gold | Elegant serif | Spacious, minimal | Exclusivity |
|
|
97
|
-
|
|
98
|
-
---
|
|
99
|
-
|
|
100
|
-
## Emotion Color Mapping
|
|
101
|
-
|
|
102
|
-
| Emotion | Colors | Industry Use |
|
|
103
|
-
|---------|--------|--------------|
|
|
104
|
-
| **Trust** | Blue, Green | Finance, Healthcare |
|
|
105
|
-
| **Excitement** | Red, Orange | Sales, Sports |
|
|
106
|
-
| **Calm** | Soft blue/green | Wellness, Spa |
|
|
107
|
-
| **Luxury** | Black, Gold | Premium brands |
|
|
108
|
-
| **Energy** | Yellow, Orange | Fitness, Kids |
|
|
109
|
-
| **Nature** | Green, Brown | Eco, Organic |
|
|
110
|
-
|
|
111
|
-
---
|
|
112
|
-
|
|
113
|
-
## Psychology Checklist
|
|
114
|
-
|
|
115
|
-
Before launch, verify:
|
|
116
|
-
|
|
117
|
-
- [ ] **Hick's Law** - Max 7 nav items
|
|
118
|
-
- [ ] **Fitts' Law** - Large, reachable CTAs
|
|
119
|
-
- [ ] **Miller's Law** - Content chunked properly
|
|
120
|
-
- [ ] **Von Restorff** - CTAs stand out
|
|
121
|
-
- [ ] **Trust signals** - Security, reviews visible
|
|
122
|
-
- [ ] **Cognitive load** - Clean, not overwhelming
|
|
123
|
-
- [ ] **Feedback** - All actions confirmed
|
|
124
|
-
- [ ] **Accessibility** - Inclusive for all users
|
|
125
|
-
|
|
126
|
-
---
|
|
127
|
-
|
|
128
|
-
> **Remember:** UX is psychology. Every design decision affects user behavior.
|
|
@@ -1,105 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: gitops-patterns
|
|
3
|
-
description: GitOps patterns with ArgoCD and Flux
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# GitOps Patterns
|
|
7
|
-
|
|
8
|
-
> Git as the source of truth for infrastructure.
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## GitOps Flow
|
|
13
|
-
|
|
14
|
-
```
|
|
15
|
-
Code Change → PR → Merge → CI Build → Image Push → Git Sync → Deploy
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
| Step | Tool |
|
|
19
|
-
|------|------|
|
|
20
|
-
| CI Build | Azure DevOps |
|
|
21
|
-
| Image Push | Azure Container Registry |
|
|
22
|
-
| Git Sync | ArgoCD / Flux |
|
|
23
|
-
| Deploy | AKS |
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## Repository Structure
|
|
28
|
-
|
|
29
|
-
```
|
|
30
|
-
gitops-repo/
|
|
31
|
-
├── base/ # Base manifests
|
|
32
|
-
│ ├── deployment.yaml
|
|
33
|
-
│ ├── service.yaml
|
|
34
|
-
│ └── kustomization.yaml
|
|
35
|
-
├── overlays/
|
|
36
|
-
│ ├── dev/
|
|
37
|
-
│ │ └── kustomization.yaml
|
|
38
|
-
│ ├── staging/
|
|
39
|
-
│ │ └── kustomization.yaml
|
|
40
|
-
│ └── prod/
|
|
41
|
-
│ └── kustomization.yaml
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
---
|
|
45
|
-
|
|
46
|
-
## ArgoCD Application
|
|
47
|
-
|
|
48
|
-
```yaml
|
|
49
|
-
apiVersion: argoproj.io/v1alpha1
|
|
50
|
-
kind: Application
|
|
51
|
-
metadata:
|
|
52
|
-
name: myapp
|
|
53
|
-
namespace: argocd
|
|
54
|
-
spec:
|
|
55
|
-
project: default
|
|
56
|
-
source:
|
|
57
|
-
repoURL: https://github.com/org/gitops-repo
|
|
58
|
-
targetRevision: HEAD
|
|
59
|
-
path: overlays/prod
|
|
60
|
-
destination:
|
|
61
|
-
server: https://kubernetes.default.svc
|
|
62
|
-
namespace: production
|
|
63
|
-
syncPolicy:
|
|
64
|
-
automated:
|
|
65
|
-
prune: true
|
|
66
|
-
selfHeal: true
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
---
|
|
70
|
-
|
|
71
|
-
## Flux Configuration
|
|
72
|
-
|
|
73
|
-
```yaml
|
|
74
|
-
apiVersion: source.toolkit.fluxcd.io/v1
|
|
75
|
-
kind: GitRepository
|
|
76
|
-
metadata:
|
|
77
|
-
name: myapp
|
|
78
|
-
spec:
|
|
79
|
-
interval: 1m
|
|
80
|
-
url: https://github.com/org/gitops-repo
|
|
81
|
-
ref:
|
|
82
|
-
branch: main
|
|
83
|
-
---
|
|
84
|
-
apiVersion: kustomize.toolkit.fluxcd.io/v1
|
|
85
|
-
kind: Kustomization
|
|
86
|
-
metadata:
|
|
87
|
-
name: myapp
|
|
88
|
-
spec:
|
|
89
|
-
interval: 10m
|
|
90
|
-
path: ./overlays/prod
|
|
91
|
-
sourceRef:
|
|
92
|
-
kind: GitRepository
|
|
93
|
-
name: myapp
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
---
|
|
97
|
-
|
|
98
|
-
## DO / DON'T
|
|
99
|
-
|
|
100
|
-
| ✅ Do | ❌ Don't |
|
|
101
|
-
|-------|---------|
|
|
102
|
-
| Git for all changes | kubectl apply manually |
|
|
103
|
-
| Automated sync | Manual deployments |
|
|
104
|
-
| Environment overlays | Duplicate manifests |
|
|
105
|
-
| PR reviews | Direct pushes |
|
|
@@ -1,107 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: grafana-logging
|
|
3
|
-
description: Grafana dashboards and metrics logging
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Grafana Logging
|
|
7
|
-
|
|
8
|
-
> Metrics, dashboards, and alerting with Grafana.
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Key Metrics
|
|
13
|
-
|
|
14
|
-
### Application Metrics
|
|
15
|
-
| Metric | Description |
|
|
16
|
-
|--------|-------------|
|
|
17
|
-
| Request rate | Requests per second |
|
|
18
|
-
| Error rate | Errors per second |
|
|
19
|
-
| Duration | Response time percentiles |
|
|
20
|
-
| Active requests | Concurrent requests |
|
|
21
|
-
|
|
22
|
-
### Infrastructure Metrics
|
|
23
|
-
| Metric | Description |
|
|
24
|
-
|--------|-------------|
|
|
25
|
-
| CPU usage | Percentage used |
|
|
26
|
-
| Memory usage | Bytes used |
|
|
27
|
-
| Disk I/O | Read/write operations |
|
|
28
|
-
| Network | Bytes in/out |
|
|
29
|
-
|
|
30
|
-
---
|
|
31
|
-
|
|
32
|
-
## Prometheus Metrics (ASP.NET)
|
|
33
|
-
|
|
34
|
-
```csharp
|
|
35
|
-
// Install package
|
|
36
|
-
// dotnet add package prometheus-net.AspNetCore
|
|
37
|
-
|
|
38
|
-
// Program.cs
|
|
39
|
-
app.UseMetricServer(); // /metrics endpoint
|
|
40
|
-
app.UseHttpMetrics(); // HTTP request metrics
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
45
|
-
## Custom Metrics
|
|
46
|
-
|
|
47
|
-
```csharp
|
|
48
|
-
using Prometheus;
|
|
49
|
-
|
|
50
|
-
public class OrderService
|
|
51
|
-
{
|
|
52
|
-
private static readonly Counter OrdersCreated = Metrics
|
|
53
|
-
.CreateCounter("orders_created_total", "Total orders created");
|
|
54
|
-
|
|
55
|
-
private static readonly Histogram OrderDuration = Metrics
|
|
56
|
-
.CreateHistogram("order_duration_seconds", "Order processing time");
|
|
57
|
-
|
|
58
|
-
public async Task CreateOrder(Order order)
|
|
59
|
-
{
|
|
60
|
-
using (OrderDuration.NewTimer())
|
|
61
|
-
{
|
|
62
|
-
await ProcessOrder(order);
|
|
63
|
-
OrdersCreated.Inc();
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
}
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
---
|
|
70
|
-
|
|
71
|
-
## Dashboard Queries
|
|
72
|
-
|
|
73
|
-
```promql
|
|
74
|
-
# Request rate
|
|
75
|
-
rate(http_requests_total[5m])
|
|
76
|
-
|
|
77
|
-
# Error rate
|
|
78
|
-
rate(http_requests_total{status=~"5.."}[5m])
|
|
79
|
-
|
|
80
|
-
# 95th percentile latency
|
|
81
|
-
histogram_quantile(0.95, rate(http_request_duration_seconds_bucket[5m]))
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
---
|
|
85
|
-
|
|
86
|
-
## Alerting
|
|
87
|
-
|
|
88
|
-
```yaml
|
|
89
|
-
# Alert rule
|
|
90
|
-
- alert: HighErrorRate
|
|
91
|
-
expr: rate(http_requests_total{status=~"5.."}[5m]) > 0.1
|
|
92
|
-
for: 5m
|
|
93
|
-
labels:
|
|
94
|
-
severity: critical
|
|
95
|
-
annotations:
|
|
96
|
-
summary: High error rate detected
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
---
|
|
100
|
-
|
|
101
|
-
## DO / DON'T
|
|
102
|
-
|
|
103
|
-
| ✅ Do | ❌ Don't |
|
|
104
|
-
|-------|---------|
|
|
105
|
-
| RED method (Rate, Error, Duration) | Track everything |
|
|
106
|
-
| Set alerting thresholds | Alert fatigue |
|
|
107
|
-
| Dashboard per service | One giant dashboard |
|
|
@@ -1,75 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: intelligent-routing
|
|
3
|
-
description: Auto-select best agent for each request
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Intelligent Routing
|
|
7
|
-
|
|
8
|
-
> Automatically select the best agent for each task.
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Routing Matrix
|
|
13
|
-
|
|
14
|
-
| Keywords | Agent |
|
|
15
|
-
|----------|-------|
|
|
16
|
-
| vue, component, pinia, frontend | frontend-specialist |
|
|
17
|
-
| api, controller, service, c#, aspnet | backend-specialist |
|
|
18
|
-
| sql, database, schema, query | database-architect |
|
|
19
|
-
| deploy, pipeline, aks, kubernetes | devops-engineer |
|
|
20
|
-
| security, keyvault, audit, owasp | security-auditor |
|
|
21
|
-
| test, xunit, vitest, coverage | test-engineer |
|
|
22
|
-
| bug, error, fix, debug | debugger |
|
|
23
|
-
| performance, slow, metrics | performance-optimizer |
|
|
24
|
-
| docs, readme, documentation | documentation-writer |
|
|
25
|
-
| analyze, explore, overview | explorer-agent |
|
|
26
|
-
| plan, design, architecture | project-planner |
|
|
27
|
-
| complex, multi-domain | orchestrator |
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
31
|
-
## Routing Protocol
|
|
32
|
-
|
|
33
|
-
### Step 1: Analyze Request
|
|
34
|
-
Identify keywords and domain indicators.
|
|
35
|
-
|
|
36
|
-
### Step 2: Match Agent
|
|
37
|
-
Use routing matrix to find best match.
|
|
38
|
-
|
|
39
|
-
### Step 3: Check Complexity
|
|
40
|
-
- Single domain → Direct to specialist
|
|
41
|
-
- Multi-domain → Route to orchestrator
|
|
42
|
-
|
|
43
|
-
### Step 4: Inform User
|
|
44
|
-
```markdown
|
|
45
|
-
🤖 **Applying `@[agent-name]`...**
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
---
|
|
49
|
-
|
|
50
|
-
## Multi-Domain Detection
|
|
51
|
-
|
|
52
|
-
| Indicators | Action |
|
|
53
|
-
|------------|--------|
|
|
54
|
-
| "full-stack" | orchestrator |
|
|
55
|
-
| Frontend + Backend | orchestrator |
|
|
56
|
-
| Multiple file types | orchestrator |
|
|
57
|
-
|
|
58
|
-
---
|
|
59
|
-
|
|
60
|
-
## Override Rules
|
|
61
|
-
|
|
62
|
-
| User Says | Action |
|
|
63
|
-
|-----------|--------|
|
|
64
|
-
| @agent-name | Use specified agent |
|
|
65
|
-
| /command | Follow command flow |
|
|
66
|
-
| "don't ask" | Skip Socratic Gate |
|
|
67
|
-
|
|
68
|
-
---
|
|
69
|
-
|
|
70
|
-
## Fallback
|
|
71
|
-
|
|
72
|
-
If no clear match:
|
|
73
|
-
1. Ask user to clarify
|
|
74
|
-
2. Default to `project-planner` for planning
|
|
75
|
-
3. Default to `orchestrator` for execution
|