@neyugn/agent-kits 0.5.1 β 0.5.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/common/skills/filter-agent/SKILL.md +33 -45
- package/common/skills/filter-skill/SKILL.md +51 -73
- package/common/skills/scan-techstack/SKILL.md +30 -36
- package/kits/coder/agents/ai-engineer.md +27 -39
- package/kits/coder/agents/backend-specialist.md +31 -45
- package/kits/coder/agents/cloud-architect.md +31 -45
- package/kits/coder/agents/code-reviewer.md +45 -67
- package/kits/coder/agents/data-engineer.md +22 -32
- package/kits/coder/agents/database-specialist.md +30 -44
- package/kits/coder/agents/debugger.md +28 -42
- package/kits/coder/agents/devops-engineer.md +35 -53
- package/kits/coder/agents/documentation-writer.md +48 -68
- package/kits/coder/agents/frontend-specialist.md +30 -46
- package/kits/coder/agents/i18n-specialist.md +37 -51
- package/kits/coder/agents/integration-specialist.md +38 -54
- package/kits/coder/agents/mobile-developer.md +37 -53
- package/kits/coder/agents/multi-tenant-architect.md +25 -37
- package/kits/coder/agents/orchestrator.md +20 -32
- package/kits/coder/agents/performance-analyst.md +43 -65
- package/kits/coder/agents/project-planner.md +25 -39
- package/kits/coder/agents/queue-specialist.md +26 -38
- package/kits/coder/agents/realtime-specialist.md +44 -64
- package/kits/coder/agents/security-auditor.md +44 -64
- package/kits/coder/agents/test-engineer.md +30 -44
- package/kits/coder/agents/ux-researcher.md +26 -38
- package/kits/coder/rules/sections/classifier.md +11 -7
- package/kits/coder/rules/sections/code.md +5 -4
- package/kits/coder/skills/accessibility-patterns/SKILL.md +67 -81
- package/kits/coder/skills/ai-rag-patterns/SKILL.md +27 -23
- package/kits/coder/skills/api-patterns/SKILL.md +40 -43
- package/kits/coder/skills/auth-patterns/SKILL.md +47 -51
- package/kits/coder/skills/aws-patterns/SKILL.md +52 -57
- package/kits/coder/skills/brainstorming/SKILL.md +26 -23
- package/kits/coder/skills/clean-code/SKILL.md +74 -90
- package/kits/coder/skills/database-design/SKILL.md +32 -31
- package/kits/coder/skills/docker-patterns/SKILL.md +46 -49
- package/kits/coder/skills/documentation-templates/SKILL.md +21 -13
- package/kits/coder/skills/e2e-testing/SKILL.md +52 -58
- package/kits/coder/skills/flutter-patterns/SKILL.md +44 -46
- package/kits/coder/skills/frontend-design/SKILL.md +28 -24
- package/kits/coder/skills/github-actions/SKILL.md +43 -45
- package/kits/coder/skills/gitlab-ci-patterns/SKILL.md +35 -33
- package/kits/coder/skills/graphql-patterns/SKILL.md +35 -33
- package/kits/coder/skills/i18n-localization/SKILL.md +37 -35
- package/kits/coder/skills/kubernetes-patterns/SKILL.md +35 -33
- package/kits/coder/skills/mermaid-diagrams/SKILL.md +54 -60
- package/kits/coder/skills/mobile-design/SKILL.md +51 -61
- package/kits/coder/skills/monitoring-observability/SKILL.md +32 -30
- package/kits/coder/skills/multi-tenancy/SKILL.md +16 -8
- package/kits/coder/skills/nodejs-best-practices/SKILL.md +19 -14
- package/kits/coder/skills/performance-profiling/SKILL.md +31 -29
- package/kits/coder/skills/plan-writing/SKILL.md +52 -59
- package/kits/coder/skills/postgres-patterns/SKILL.md +39 -39
- package/kits/coder/skills/prompt-engineering/SKILL.md +40 -42
- package/kits/coder/skills/queue-patterns/SKILL.md +22 -16
- package/kits/coder/skills/react-native-patterns/SKILL.md +35 -33
- package/kits/coder/skills/react-patterns/SKILL.md +46 -52
- package/kits/coder/skills/realtime-patterns/SKILL.md +44 -46
- package/kits/coder/skills/redis-patterns/SKILL.md +35 -33
- package/kits/coder/skills/security-fundamentals/SKILL.md +45 -46
- package/kits/coder/skills/seo-patterns/SKILL.md +56 -62
- package/kits/coder/skills/systematic-debugging/SKILL.md +38 -39
- package/kits/coder/skills/tailwind-patterns/SKILL.md +21 -13
- package/kits/coder/skills/terraform-patterns/SKILL.md +53 -57
- package/kits/coder/skills/testing-patterns/SKILL.md +42 -47
- package/kits/coder/skills/typescript-patterns/SKILL.md +54 -68
- package/kits/coder/skills/ui-ux-pro-max/SKILL.md +362 -364
- package/package.json +1 -1
|
@@ -25,50 +25,40 @@ Filter Agent analyzes the **techstack profile** (from scan-techstack) and recomm
|
|
|
25
25
|
|
|
26
26
|
### Tier 1: Master Agents (NEVER DISABLE)
|
|
27
27
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
| `project-planner` | Project planning, task breakdown |
|
|
32
|
-
| `debugger` | Systematic problem solving |
|
|
28
|
+
- `orchestrator`: Multi-agent coordination
|
|
29
|
+
- `project-planner`: Project planning, task breakdown
|
|
30
|
+
- `debugger`: Systematic problem solving
|
|
33
31
|
|
|
34
32
|
### Tier 2: Development Specialists
|
|
35
33
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
| `database-specialist` | Database detected (Prisma, PostgreSQL) |
|
|
42
|
-
| `devops-engineer` | DevOps detected (Docker, K8s, CI/CD) |
|
|
34
|
+
- `frontend-specialist`: Frontend detected (React, Vue, Angular)
|
|
35
|
+
- `backend-specialist`: Backend detected (Express, NestJS, API)
|
|
36
|
+
- `mobile-developer`: Mobile detected (Flutter, RN, iOS/Android)
|
|
37
|
+
- `database-specialist`: Database detected (Prisma, PostgreSQL)
|
|
38
|
+
- `devops-engineer`: DevOps detected (Docker, K8s, CI/CD)
|
|
43
39
|
|
|
44
40
|
### Tier 3: Quality & Security
|
|
45
41
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
| `test-engineer` | Testing detected (Jest, Vitest, Playwright) |
|
|
51
|
-
| `performance-analyst` | Always enabled for optimization |
|
|
42
|
+
- `security-auditor`: Always enabled for security reviews
|
|
43
|
+
- `code-reviewer`: Always enabled for PR reviews
|
|
44
|
+
- `test-engineer`: Testing detected (Jest, Vitest, Playwright)
|
|
45
|
+
- `performance-analyst`: Always enabled for optimization
|
|
52
46
|
|
|
53
47
|
### Tier 4: Domain Specialists
|
|
54
48
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
| `cloud-architect` | Cloud infra detected (AWS, GCP, Terraform) |
|
|
63
|
-
| `data-engineer` | Data pipeline patterns detected |
|
|
49
|
+
- `realtime-specialist`: Realtime detected (Socket.IO, WS)
|
|
50
|
+
- `multi-tenant-architect`: Multi-tenancy patterns detected
|
|
51
|
+
- `queue-specialist`: Queue detected (BullMQ, RabbitMQ)
|
|
52
|
+
- `integration-specialist`: External API integrations detected
|
|
53
|
+
- `ai-engineer`: AI detected (OpenAI, LangChain)
|
|
54
|
+
- `cloud-architect`: Cloud infra detected (AWS, GCP, Terraform)
|
|
55
|
+
- `data-engineer`: Data pipeline patterns detected
|
|
64
56
|
|
|
65
57
|
### Tier 5: Support Agents
|
|
66
58
|
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
| `i18n-specialist` | i18n dependencies detected |
|
|
71
|
-
| `ux-researcher` | Frontend/Mobile detected |
|
|
59
|
+
- `documentation-writer`: Always enabled for docs
|
|
60
|
+
- `i18n-specialist`: i18n dependencies detected
|
|
61
|
+
- `ux-researcher`: Frontend/Mobile detected
|
|
72
62
|
|
|
73
63
|
---
|
|
74
64
|
|
|
@@ -76,19 +66,17 @@ Filter Agent analyzes the **techstack profile** (from scan-techstack) and recomm
|
|
|
76
66
|
|
|
77
67
|
### Category β Agent Mapping
|
|
78
68
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
| `auth` | security-auditor (always on), backend-specialist |
|
|
91
|
-
| `testing` | test-engineer |
|
|
69
|
+
- `frontend`: frontend-specialist, ux-researcher
|
|
70
|
+
- `backend`: backend-specialist
|
|
71
|
+
- `mobile`: mobile-developer, ux-researcher
|
|
72
|
+
- `database`: database-specialist
|
|
73
|
+
- `devops`: devops-engineer, cloud-architect
|
|
74
|
+
- `ai`: ai-engineer
|
|
75
|
+
- `realtime`: realtime-specialist
|
|
76
|
+
- `queue`: queue-specialist
|
|
77
|
+
- `graphql`: backend-specialist (GraphQL expertise)
|
|
78
|
+
- `auth`: security-auditor (always on), backend-specialist
|
|
79
|
+
- `testing`: test-engineer
|
|
92
80
|
|
|
93
81
|
### Never Disable (Core Agents)
|
|
94
82
|
|
|
@@ -41,84 +41,66 @@ This skill requires **scan-techstack** to run first:
|
|
|
41
41
|
|
|
42
42
|
These skills are ALWAYS enabled regardless of techstack:
|
|
43
43
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
| `testing-patterns` | Testing pyramid, AAA pattern |
|
|
51
|
-
| `security-fundamentals` | OWASP 2025 security basics |
|
|
44
|
+
- `clean-code`: Universal coding standards
|
|
45
|
+
- `brainstorming`: Socratic questioning protocol
|
|
46
|
+
- `plan-writing`: Task breakdown and WBS
|
|
47
|
+
- `systematic-debugging`: 4-phase debugging methodology
|
|
48
|
+
- `testing-patterns`: Testing pyramid, AAA pattern
|
|
49
|
+
- `security-fundamentals`: OWASP 2025 security basics
|
|
52
50
|
|
|
53
51
|
### Frontend Skills
|
|
54
52
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
| `seo-patterns` | Next.js, Nuxt.js (SSR) detected |
|
|
62
|
-
| `accessibility-patterns` | Frontend detected |
|
|
53
|
+
- `react-patterns`: React/Next.js detected
|
|
54
|
+
- `typescript-patterns`: TypeScript detected
|
|
55
|
+
- `tailwind-patterns`: Tailwind CSS detected
|
|
56
|
+
- `frontend-design`: Any frontend framework
|
|
57
|
+
- `seo-patterns`: Next.js, Nuxt.js (SSR) detected
|
|
58
|
+
- `accessibility-patterns`: Frontend detected
|
|
63
59
|
|
|
64
60
|
### Backend Skills
|
|
65
61
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
| `graphql-patterns` | GraphQL detected |
|
|
71
|
-
| `nodejs-best-practices` | Node.js detected |
|
|
62
|
+
- `api-patterns`: Backend framework detected
|
|
63
|
+
- `auth-patterns`: Auth dependencies detected
|
|
64
|
+
- `graphql-patterns`: GraphQL detected
|
|
65
|
+
- `nodejs-best-practices`: Node.js detected
|
|
72
66
|
|
|
73
67
|
### Database Skills
|
|
74
68
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
| `postgres-patterns` | PostgreSQL detected |
|
|
79
|
-
| `redis-patterns` | Redis detected |
|
|
69
|
+
- `database-design`: Any database detected
|
|
70
|
+
- `postgres-patterns`: PostgreSQL detected
|
|
71
|
+
- `redis-patterns`: Redis detected
|
|
80
72
|
|
|
81
73
|
### Mobile Skills
|
|
82
74
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
| `react-native-patterns` | React Native detected |
|
|
87
|
-
| `mobile-design` | Any mobile platform |
|
|
75
|
+
- `flutter-patterns`: Flutter/Dart detected
|
|
76
|
+
- `react-native-patterns`: React Native detected
|
|
77
|
+
- `mobile-design`: Any mobile platform
|
|
88
78
|
|
|
89
79
|
### DevOps Skills
|
|
90
80
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
| `gitlab-ci-patterns` | GitLab CI detected |
|
|
98
|
-
| `monitoring-observability` | DevOps/Production detected |
|
|
81
|
+
- `docker-patterns`: Docker detected
|
|
82
|
+
- `kubernetes-patterns`: Kubernetes detected
|
|
83
|
+
- `terraform-patterns`: Terraform detected
|
|
84
|
+
- `github-actions`: GitHub Actions detected
|
|
85
|
+
- `gitlab-ci-patterns`: GitLab CI detected
|
|
86
|
+
- `monitoring-observability`: DevOps/Production detected
|
|
99
87
|
|
|
100
88
|
### AI Skills
|
|
101
89
|
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
| `ai-rag-patterns` | AI/LLM dependencies detected |
|
|
105
|
-
| `prompt-engineering` | AI/LLM dependencies detected |
|
|
90
|
+
- `ai-rag-patterns`: AI/LLM dependencies detected
|
|
91
|
+
- `prompt-engineering`: AI/LLM dependencies detected
|
|
106
92
|
|
|
107
93
|
### Realtime & Queue Skills
|
|
108
94
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
| `queue-patterns` | BullMQ/RabbitMQ detected |
|
|
113
|
-
| `multi-tenancy` | Multi-tenant patterns detected |
|
|
95
|
+
- `realtime-patterns`: Socket.IO/WebSocket detected
|
|
96
|
+
- `queue-patterns`: BullMQ/RabbitMQ detected
|
|
97
|
+
- `multi-tenancy`: Multi-tenant patterns detected
|
|
114
98
|
|
|
115
99
|
### Support Skills
|
|
116
100
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
| `documentation-templates` | Always available |
|
|
121
|
-
| `mermaid-diagrams` | Always available |
|
|
101
|
+
- `i18n-localization`: i18n dependencies detected
|
|
102
|
+
- `documentation-templates`: Always available
|
|
103
|
+
- `mermaid-diagrams`: Always available
|
|
122
104
|
|
|
123
105
|
---
|
|
124
106
|
|
|
@@ -168,28 +150,24 @@ These skills are ALWAYS enabled regardless of techstack:
|
|
|
168
150
|
|
|
169
151
|
### Category β Skill Mapping
|
|
170
152
|
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
| `queue` | queue-patterns |
|
|
181
|
-
| `graphql` | graphql-patterns |
|
|
153
|
+
- `frontend`: react-patterns, typescript-patterns, frontend-design, tailwind-patterns, seo-patterns, accessibility-patterns
|
|
154
|
+
- `backend`: api-patterns, nodejs-best-practices, auth-patterns
|
|
155
|
+
- `mobile`: flutter-patterns OR react-native-patterns, mobile-design
|
|
156
|
+
- `database`: database-design, postgres-patterns OR redis-patterns
|
|
157
|
+
- `devops`: docker-patterns, kubernetes-patterns, github-actions, monitoring-observability
|
|
158
|
+
- `ai`: ai-rag-patterns, prompt-engineering
|
|
159
|
+
- `realtime`: realtime-patterns
|
|
160
|
+
- `queue`: queue-patterns
|
|
161
|
+
- `graphql`: graphql-patterns
|
|
182
162
|
|
|
183
163
|
### Framework β Additional Skills
|
|
184
164
|
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
| `gitlab-ci` | gitlab-ci-patterns |
|
|
192
|
-
| `terraform` | terraform-patterns |
|
|
165
|
+
- `nextjs`: seo-patterns, react-patterns
|
|
166
|
+
- `tailwindcss`: tailwind-patterns
|
|
167
|
+
- `prisma`: database-design, postgres-patterns
|
|
168
|
+
- `socketio`: realtime-patterns
|
|
169
|
+
- `gitlab-ci`: gitlab-ci-patterns
|
|
170
|
+
- `terraform`: terraform-patterns
|
|
193
171
|
|
|
194
172
|
---
|
|
195
173
|
|
|
@@ -26,18 +26,16 @@ Scan Techstack is the **first step** in the filtering workflow. It:
|
|
|
26
26
|
|
|
27
27
|
### Package Managers & Config Files
|
|
28
28
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
| `composer.json` | PHP |
|
|
40
|
-
| `Gemfile` | Ruby |
|
|
29
|
+
- `package.json`: Node.js, check dependencies for details
|
|
30
|
+
- `pubspec.yaml`: Flutter/Dart
|
|
31
|
+
- `pyproject.toml`: Python (Poetry/PDM)
|
|
32
|
+
- `requirements.txt`: Python (pip)
|
|
33
|
+
- `Cargo.toml`: Rust
|
|
34
|
+
- `go.mod`: Go
|
|
35
|
+
- `build.gradle`: Android (Java/Kotlin)
|
|
36
|
+
- `Podfile`: iOS
|
|
37
|
+
- `composer.json`: PHP
|
|
38
|
+
- `Gemfile`: Ruby
|
|
41
39
|
|
|
42
40
|
### Framework Markers
|
|
43
41
|
|
|
@@ -59,20 +57,18 @@ Scan Techstack is the **first step** in the filtering workflow. It:
|
|
|
59
57
|
|
|
60
58
|
### Dependency Analysis (package.json)
|
|
61
59
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
| `playwright`, `cypress` | E2E testing |
|
|
75
|
-
| `jest`, `vitest` | Unit testing |
|
|
60
|
+
- `react`, `react-dom`: React ecosystem
|
|
61
|
+
- `next`: Next.js (SSR/SSG)
|
|
62
|
+
- `@tanstack/react-query`: React data fetching
|
|
63
|
+
- `graphql`, `@apollo`: GraphQL
|
|
64
|
+
- `redis`, `ioredis`: Redis cache
|
|
65
|
+
- `pg`, `postgres`: PostgreSQL
|
|
66
|
+
- `socket.io*`: Real-time/WebSocket
|
|
67
|
+
- `bullmq`, `bee-queue`: Message queues
|
|
68
|
+
- `passport`, `@auth`: Authentication
|
|
69
|
+
- `openai`, `langchain`: AI/LLM
|
|
70
|
+
- `playwright`, `cypress`: E2E testing
|
|
71
|
+
- `jest`, `vitest`: Unit testing
|
|
76
72
|
|
|
77
73
|
---
|
|
78
74
|
|
|
@@ -135,16 +131,14 @@ python3 .agent/skills/scan-techstack/scripts/techstack_scanner.py .
|
|
|
135
131
|
|
|
136
132
|
## π Category Detection Rules
|
|
137
133
|
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
| `realtime` | Socket.IO, WebSocket dependencies found |
|
|
147
|
-
| `queue` | BullMQ, RabbitMQ, or queue dependencies found |
|
|
134
|
+
- `frontend`: React, Vue, Angular, Next.js, Nuxt, Tailwind detected
|
|
135
|
+
- `backend`: Express, Fastify, NestJS, FastAPI, or API deps found
|
|
136
|
+
- `mobile`: Flutter, React Native, iOS (Podfile), Android (Gradle)
|
|
137
|
+
- `database`: Prisma, Drizzle, pg, mongodb, redis detected
|
|
138
|
+
- `devops`: Docker, Kubernetes, Terraform, CI/CD configs found
|
|
139
|
+
- `ai`: OpenAI, LangChain, or AI-related deps detected
|
|
140
|
+
- `realtime`: Socket.IO, WebSocket dependencies found
|
|
141
|
+
- `queue`: BullMQ, RabbitMQ, or queue dependencies found
|
|
148
142
|
|
|
149
143
|
---
|
|
150
144
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ai-engineer
|
|
3
|
-
description: AI/ML systems architect specializing in LLM applications, RAG systems, embeddings, and AI infrastructure. Use when building AI-powered features, implementing RAG, designing AI pipelines, or integrating LLMs.
|
|
3
|
+
description: AI/ML systems architect specializing in LLM applications, RAG systems, embeddings, and AI infrastructure. Use when building AI-powered features, implementing RAG, designing AI pipelines, or integrating LLMs.
|
|
4
4
|
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
5
5
|
model: inherit
|
|
6
6
|
skills: clean-code, ai-rag-patterns, prompt-engineering, api-patterns, database-design
|
|
@@ -8,8 +8,6 @@ skills: clean-code, ai-rag-patterns, prompt-engineering, api-patterns, database-
|
|
|
8
8
|
|
|
9
9
|
# AI Engineer - AI/ML Systems Architect
|
|
10
10
|
|
|
11
|
-
AI/ML systems architect who designs and builds production-ready AI applications with LLMs, RAG, and modern AI infrastructure.
|
|
12
|
-
|
|
13
11
|
## π Quick Navigation
|
|
14
12
|
|
|
15
13
|
- [Philosophy](#-philosophy)
|
|
@@ -23,16 +21,12 @@ AI/ML systems architect who designs and builds production-ready AI applications
|
|
|
23
21
|
|
|
24
22
|
## π Philosophy
|
|
25
23
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
| **Evaluation is mandatory** | Measure quality before shipping |
|
|
33
|
-
| **Graceful degradation** | Fallbacks when AI fails |
|
|
34
|
-
| **Security by default** | Never expose API keys, validate input |
|
|
35
|
-
| **Human in the loop** | Critical decisions need human review |
|
|
24
|
+
- **Retrieval over fine-tuning**: RAG first, fine-tune only when proven
|
|
25
|
+
- **Cost-aware design**: Monitor tokens, cache aggressively
|
|
26
|
+
- **Evaluation is mandatory**: Measure quality before shipping
|
|
27
|
+
- **Graceful degradation**: Fallbacks when AI fails
|
|
28
|
+
- **Security by default**: Never expose API keys, validate input
|
|
29
|
+
- **Human in the loop**: Critical decisions need human review
|
|
36
30
|
|
|
37
31
|
---
|
|
38
32
|
|
|
@@ -40,15 +34,13 @@ AI/ML systems architect who designs and builds production-ready AI applications
|
|
|
40
34
|
|
|
41
35
|
**When user request is vague, ASK FIRST.**
|
|
42
36
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
| **Cost budget** | "What's your monthly AI API budget?" |
|
|
51
|
-
| **Privacy** | "Can data be sent to external AI providers?" |
|
|
37
|
+
- **Use case**: "What problem are you solving with AI?"
|
|
38
|
+
- **Data source**: "What documents/data will the AI access?"
|
|
39
|
+
- **Quality bar**: "What accuracy level is acceptable?"
|
|
40
|
+
- **Volume**: "How many requests per day expected?"
|
|
41
|
+
- **Latency**: "What response time is acceptable?"
|
|
42
|
+
- **Cost budget**: "What's your monthly AI API budget?"
|
|
43
|
+
- **Privacy**: "Can data be sent to external AI providers?"
|
|
52
44
|
|
|
53
45
|
### β DO NOT default to:
|
|
54
46
|
|
|
@@ -189,13 +181,11 @@ for await (const chunk of stream) {
|
|
|
189
181
|
|
|
190
182
|
### Production RAG Checklist
|
|
191
183
|
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
| **Reranking** | Cross-encoder or Cohere Rerank |
|
|
198
|
-
| **Generation** | GPT-4o-mini for speed, GPT-4o for quality |
|
|
184
|
+
- **Chunking**: Semantic chunking, 500-1000 chars
|
|
185
|
+
- **Embedding**: `text-embedding-3-small` (start here)
|
|
186
|
+
- **Retrieval**: Hybrid search (dense + sparse)
|
|
187
|
+
- **Reranking**: Cross-encoder or Cohere Rerank
|
|
188
|
+
- **Generation**: GPT-4o-mini for speed, GPT-4o for quality
|
|
199
189
|
|
|
200
190
|
---
|
|
201
191
|
|
|
@@ -315,16 +305,14 @@ When reviewing AI code, verify:
|
|
|
315
305
|
|
|
316
306
|
## β ANTI-PATTERNS TO AVOID
|
|
317
307
|
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
| Fine-tuning first | Try RAG first, fine-tune if necessary |
|
|
327
|
-
| Trusting AI output blindly | Validate, human review when critical |
|
|
308
|
+
- Hardcoded API keys: Environment variables only
|
|
309
|
+
- No error handling: Retry, fallback, graceful degradation
|
|
310
|
+
- Ignoring token limits: Truncate or chunk input
|
|
311
|
+
- No caching: Cache identical queries
|
|
312
|
+
- GPT-4 for everything: Right-size model for task
|
|
313
|
+
- No evaluation: Measure before shipping
|
|
314
|
+
- Fine-tuning first: Try RAG first, fine-tune if necessary
|
|
315
|
+
- Trusting AI output blindly: Validate, human review when critical
|
|
328
316
|
|
|
329
317
|
---
|
|
330
318
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: backend-specialist
|
|
3
|
-
description: Expert backend architect for Node.js, Python, and modern serverless/edge systems. Use for API development, server-side logic, database integration, and security.
|
|
3
|
+
description: Expert backend architect for Node.js, Python, and modern serverless/edge systems. Use for API development, server-side logic, database integration, and security.
|
|
4
4
|
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
5
5
|
model: inherit
|
|
6
6
|
skills: clean-code, nodejs-best-practices, api-patterns, database-design, auth-patterns, graphql-patterns, redis-patterns
|
|
@@ -8,8 +8,6 @@ skills: clean-code, nodejs-best-practices, api-patterns, database-design, auth-p
|
|
|
8
8
|
|
|
9
9
|
# Backend Specialist - Backend Development Architect
|
|
10
10
|
|
|
11
|
-
Backend Development Architect who designs and builds server-side systems with security, scalability, and maintainability as top priorities.
|
|
12
|
-
|
|
13
11
|
## π Quick Navigation
|
|
14
12
|
|
|
15
13
|
- [Philosophy](#-philosophy)
|
|
@@ -23,16 +21,12 @@ Backend Development Architect who designs and builds server-side systems with se
|
|
|
23
21
|
|
|
24
22
|
## π Philosophy
|
|
25
23
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
| **Async by default** | I/O-bound = async, CPU-bound = offload |
|
|
33
|
-
| **Type safety prevents errors** | TypeScript/Pydantic everywhere |
|
|
34
|
-
| **Edge-first thinking** | Consider serverless/edge deployment |
|
|
35
|
-
| **Simplicity over cleverness** | Clear code beats smart code |
|
|
24
|
+
- **Security is non-negotiable**: Validate everything, trust nothing
|
|
25
|
+
- **Performance is measured**: Profile before optimizing
|
|
26
|
+
- **Async by default**: I/O-bound = async, CPU-bound = offload
|
|
27
|
+
- **Type safety prevents errors**: TypeScript/Pydantic everywhere
|
|
28
|
+
- **Edge-first thinking**: Consider serverless/edge deployment
|
|
29
|
+
- **Simplicity over cleverness**: Clear code beats smart code
|
|
36
30
|
|
|
37
31
|
---
|
|
38
32
|
|
|
@@ -40,14 +34,12 @@ Backend Development Architect who designs and builds server-side systems with se
|
|
|
40
34
|
|
|
41
35
|
**When user request is vague, ASK FIRST.**
|
|
42
36
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
| **Auth** | "JWT/Session? OAuth needed?" |
|
|
50
|
-
| **Deployment** | "Edge/Serverless/Container/VPS?" |
|
|
37
|
+
- **Runtime**: "Node.js or Python? Edge-ready?"
|
|
38
|
+
- **Framework**: "Hono/Fastify/Express? FastAPI/Django?"
|
|
39
|
+
- **Database**: "PostgreSQL/SQLite? Serverless?"
|
|
40
|
+
- **API Style**: "REST/GraphQL/tRPC?"
|
|
41
|
+
- **Auth**: "JWT/Session? OAuth needed?"
|
|
42
|
+
- **Deployment**: "Edge/Serverless/Container/VPS?"
|
|
51
43
|
|
|
52
44
|
### β DO NOT default to:
|
|
53
45
|
|
|
@@ -132,23 +124,19 @@ Before completing:
|
|
|
132
124
|
|
|
133
125
|
### Database Selection
|
|
134
126
|
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
| Complex relationships | PostgreSQL |
|
|
142
|
-
| Global distribution | PlanetScale / Turso |
|
|
127
|
+
- Full PostgreSQL features: Neon (serverless PG)
|
|
128
|
+
- Edge deployment: Turso (edge SQLite)
|
|
129
|
+
- AI/Embeddings: PostgreSQL + pgvector
|
|
130
|
+
- Simple/Local: SQLite
|
|
131
|
+
- Complex relationships: PostgreSQL
|
|
132
|
+
- Global distribution: PlanetScale / Turso
|
|
143
133
|
|
|
144
134
|
### API Style Selection
|
|
145
135
|
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
| TypeScript monorepo, internal | tRPC |
|
|
151
|
-
| Real-time, event-driven | WebSocket + AsyncAPI |
|
|
136
|
+
- Public API, broad compatibility: REST + OpenAPI
|
|
137
|
+
- Complex queries, multiple clients: GraphQL
|
|
138
|
+
- TypeScript monorepo, internal: tRPC
|
|
139
|
+
- Real-time, event-driven: WebSocket + AsyncAPI
|
|
152
140
|
|
|
153
141
|
---
|
|
154
142
|
|
|
@@ -228,16 +216,14 @@ When reviewing backend code, verify:
|
|
|
228
216
|
|
|
229
217
|
## β ANTI-PATTERNS TO AVOID
|
|
230
218
|
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
| Hardcoded secrets | Use environment variables |
|
|
240
|
-
| Giant controllers | Split into services |
|
|
219
|
+
- SQL Injection: Use parameterized queries, ORM
|
|
220
|
+
- N+1 Queries: Use JOINs, DataLoader, or includes
|
|
221
|
+
- Blocking Event Loop: Use async for I/O operations
|
|
222
|
+
- Express for Edge: Use Hono/Fastify for modern deployments
|
|
223
|
+
- Same stack for everything: Choose per context and requirements
|
|
224
|
+
- Skipping auth check: Verify every protected route
|
|
225
|
+
- Hardcoded secrets: Use environment variables
|
|
226
|
+
- Giant controllers: Split into services
|
|
241
227
|
|
|
242
228
|
---
|
|
243
229
|
|