@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.
Files changed (68) hide show
  1. package/common/skills/filter-agent/SKILL.md +33 -45
  2. package/common/skills/filter-skill/SKILL.md +51 -73
  3. package/common/skills/scan-techstack/SKILL.md +30 -36
  4. package/kits/coder/agents/ai-engineer.md +27 -39
  5. package/kits/coder/agents/backend-specialist.md +31 -45
  6. package/kits/coder/agents/cloud-architect.md +31 -45
  7. package/kits/coder/agents/code-reviewer.md +45 -67
  8. package/kits/coder/agents/data-engineer.md +22 -32
  9. package/kits/coder/agents/database-specialist.md +30 -44
  10. package/kits/coder/agents/debugger.md +28 -42
  11. package/kits/coder/agents/devops-engineer.md +35 -53
  12. package/kits/coder/agents/documentation-writer.md +48 -68
  13. package/kits/coder/agents/frontend-specialist.md +30 -46
  14. package/kits/coder/agents/i18n-specialist.md +37 -51
  15. package/kits/coder/agents/integration-specialist.md +38 -54
  16. package/kits/coder/agents/mobile-developer.md +37 -53
  17. package/kits/coder/agents/multi-tenant-architect.md +25 -37
  18. package/kits/coder/agents/orchestrator.md +20 -32
  19. package/kits/coder/agents/performance-analyst.md +43 -65
  20. package/kits/coder/agents/project-planner.md +25 -39
  21. package/kits/coder/agents/queue-specialist.md +26 -38
  22. package/kits/coder/agents/realtime-specialist.md +44 -64
  23. package/kits/coder/agents/security-auditor.md +44 -64
  24. package/kits/coder/agents/test-engineer.md +30 -44
  25. package/kits/coder/agents/ux-researcher.md +26 -38
  26. package/kits/coder/rules/sections/classifier.md +11 -7
  27. package/kits/coder/rules/sections/code.md +5 -4
  28. package/kits/coder/skills/accessibility-patterns/SKILL.md +67 -81
  29. package/kits/coder/skills/ai-rag-patterns/SKILL.md +27 -23
  30. package/kits/coder/skills/api-patterns/SKILL.md +40 -43
  31. package/kits/coder/skills/auth-patterns/SKILL.md +47 -51
  32. package/kits/coder/skills/aws-patterns/SKILL.md +52 -57
  33. package/kits/coder/skills/brainstorming/SKILL.md +26 -23
  34. package/kits/coder/skills/clean-code/SKILL.md +74 -90
  35. package/kits/coder/skills/database-design/SKILL.md +32 -31
  36. package/kits/coder/skills/docker-patterns/SKILL.md +46 -49
  37. package/kits/coder/skills/documentation-templates/SKILL.md +21 -13
  38. package/kits/coder/skills/e2e-testing/SKILL.md +52 -58
  39. package/kits/coder/skills/flutter-patterns/SKILL.md +44 -46
  40. package/kits/coder/skills/frontend-design/SKILL.md +28 -24
  41. package/kits/coder/skills/github-actions/SKILL.md +43 -45
  42. package/kits/coder/skills/gitlab-ci-patterns/SKILL.md +35 -33
  43. package/kits/coder/skills/graphql-patterns/SKILL.md +35 -33
  44. package/kits/coder/skills/i18n-localization/SKILL.md +37 -35
  45. package/kits/coder/skills/kubernetes-patterns/SKILL.md +35 -33
  46. package/kits/coder/skills/mermaid-diagrams/SKILL.md +54 -60
  47. package/kits/coder/skills/mobile-design/SKILL.md +51 -61
  48. package/kits/coder/skills/monitoring-observability/SKILL.md +32 -30
  49. package/kits/coder/skills/multi-tenancy/SKILL.md +16 -8
  50. package/kits/coder/skills/nodejs-best-practices/SKILL.md +19 -14
  51. package/kits/coder/skills/performance-profiling/SKILL.md +31 -29
  52. package/kits/coder/skills/plan-writing/SKILL.md +52 -59
  53. package/kits/coder/skills/postgres-patterns/SKILL.md +39 -39
  54. package/kits/coder/skills/prompt-engineering/SKILL.md +40 -42
  55. package/kits/coder/skills/queue-patterns/SKILL.md +22 -16
  56. package/kits/coder/skills/react-native-patterns/SKILL.md +35 -33
  57. package/kits/coder/skills/react-patterns/SKILL.md +46 -52
  58. package/kits/coder/skills/realtime-patterns/SKILL.md +44 -46
  59. package/kits/coder/skills/redis-patterns/SKILL.md +35 -33
  60. package/kits/coder/skills/security-fundamentals/SKILL.md +45 -46
  61. package/kits/coder/skills/seo-patterns/SKILL.md +56 -62
  62. package/kits/coder/skills/systematic-debugging/SKILL.md +38 -39
  63. package/kits/coder/skills/tailwind-patterns/SKILL.md +21 -13
  64. package/kits/coder/skills/terraform-patterns/SKILL.md +53 -57
  65. package/kits/coder/skills/testing-patterns/SKILL.md +42 -47
  66. package/kits/coder/skills/typescript-patterns/SKILL.md +54 -68
  67. package/kits/coder/skills/ui-ux-pro-max/SKILL.md +362 -364
  68. 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
- | Agent | Always Required For |
29
- | ----------------- | -------------------------------- |
30
- | `orchestrator` | Multi-agent coordination |
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
- | Agent | Enable When |
37
- | --------------------- | ------------------------------------------ |
38
- | `frontend-specialist` | Frontend detected (React, Vue, Angular) |
39
- | `backend-specialist` | Backend detected (Express, NestJS, API) |
40
- | `mobile-developer` | Mobile detected (Flutter, RN, iOS/Android) |
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
- | Agent | Enable When |
47
- | --------------------- | ------------------------------------------- |
48
- | `security-auditor` | Always enabled for security reviews |
49
- | `code-reviewer` | Always enabled for PR reviews |
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
- | Agent | Enable When |
56
- | ------------------------ | ------------------------------------------ |
57
- | `realtime-specialist` | Realtime detected (Socket.IO, WS) |
58
- | `multi-tenant-architect` | Multi-tenancy patterns detected |
59
- | `queue-specialist` | Queue detected (BullMQ, RabbitMQ) |
60
- | `integration-specialist` | External API integrations detected |
61
- | `ai-engineer` | AI detected (OpenAI, LangChain) |
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
- | Agent | Enable When |
68
- | ---------------------- | -------------------------- |
69
- | `documentation-writer` | Always enabled for docs |
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
- | Detected Category | Agents to ENABLE |
80
- | ----------------- | ------------------------------------------------ |
81
- | `frontend` | frontend-specialist, ux-researcher |
82
- | `backend` | backend-specialist |
83
- | `mobile` | mobile-developer, ux-researcher |
84
- | `database` | database-specialist |
85
- | `devops` | devops-engineer, cloud-architect |
86
- | `ai` | ai-engineer |
87
- | `realtime` | realtime-specialist |
88
- | `queue` | queue-specialist |
89
- | `graphql` | backend-specialist (GraphQL expertise) |
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
- | Skill | Reason |
45
- | ----------------------- | ----------------------------- |
46
- | `clean-code` | Universal coding standards |
47
- | `brainstorming` | Socratic questioning protocol |
48
- | `plan-writing` | Task breakdown and WBS |
49
- | `systematic-debugging` | 4-phase debugging methodology |
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
- | Skill | Enable When |
56
- | ------------------------ | ------------------------------- |
57
- | `react-patterns` | React/Next.js detected |
58
- | `typescript-patterns` | TypeScript detected |
59
- | `tailwind-patterns` | Tailwind CSS detected |
60
- | `frontend-design` | Any frontend framework |
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
- | Skill | Enable When |
67
- | ----------------------- | -------------------------- |
68
- | `api-patterns` | Backend framework detected |
69
- | `auth-patterns` | Auth dependencies detected |
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
- | Skill | Enable When |
76
- | ------------------- | --------------------- |
77
- | `database-design` | Any database detected |
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
- | Skill | Enable When |
84
- | ----------------------- | --------------------- |
85
- | `flutter-patterns` | Flutter/Dart detected |
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
- | Skill | Enable When |
92
- | -------------------------- | -------------------------- |
93
- | `docker-patterns` | Docker detected |
94
- | `kubernetes-patterns` | Kubernetes detected |
95
- | `terraform-patterns` | Terraform detected |
96
- | `github-actions` | GitHub Actions detected |
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
- | Skill | Enable When |
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
- | Skill | Enable When |
110
- | ------------------- | ------------------------------ |
111
- | `realtime-patterns` | Socket.IO/WebSocket detected |
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
- | Skill | Enable When |
118
- | ------------------------- | -------------------------- |
119
- | `i18n-localization` | i18n dependencies detected |
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
- | Detected Category | Skills to ENABLE |
172
- | ----------------- | ------------------------------------------------------------------------------------------------------------- |
173
- | `frontend` | react-patterns, typescript-patterns, frontend-design, tailwind-patterns, seo-patterns, accessibility-patterns |
174
- | `backend` | api-patterns, nodejs-best-practices, auth-patterns |
175
- | `mobile` | flutter-patterns OR react-native-patterns, mobile-design |
176
- | `database` | database-design, postgres-patterns OR redis-patterns |
177
- | `devops` | docker-patterns, kubernetes-patterns, github-actions, monitoring-observability |
178
- | `ai` | ai-rag-patterns, prompt-engineering |
179
- | `realtime` | realtime-patterns |
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
- | Framework | Additional Skills |
186
- | ------------- | ---------------------------------- |
187
- | `nextjs` | seo-patterns, react-patterns |
188
- | `tailwindcss` | tailwind-patterns |
189
- | `prisma` | database-design, postgres-patterns |
190
- | `socketio` | realtime-patterns |
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
- | File/Pattern | Detected Techstack |
30
- | ------------------ | --------------------------------------- |
31
- | `package.json` | Node.js, check dependencies for details |
32
- | `pubspec.yaml` | Flutter/Dart |
33
- | `pyproject.toml` | Python (Poetry/PDM) |
34
- | `requirements.txt` | Python (pip) |
35
- | `Cargo.toml` | Rust |
36
- | `go.mod` | Go |
37
- | `build.gradle` | Android (Java/Kotlin) |
38
- | `Podfile` | iOS |
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
- | Dependency Pattern | Detected Category |
63
- | ----------------------- | ------------------- |
64
- | `react`, `react-dom` | React ecosystem |
65
- | `next` | Next.js (SSR/SSG) |
66
- | `@tanstack/react-query` | React data fetching |
67
- | `graphql`, `@apollo` | GraphQL |
68
- | `redis`, `ioredis` | Redis cache |
69
- | `pg`, `postgres` | PostgreSQL |
70
- | `socket.io*` | Real-time/WebSocket |
71
- | `bullmq`, `bee-queue` | Message queues |
72
- | `passport`, `@auth` | Authentication |
73
- | `openai`, `langchain` | AI/LLM |
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
- | Category | Detected When |
139
- | ---------- | ------------------------------------------------------ |
140
- | `frontend` | React, Vue, Angular, Next.js, Nuxt, Tailwind detected |
141
- | `backend` | Express, Fastify, NestJS, FastAPI, or API deps found |
142
- | `mobile` | Flutter, React Native, iOS (Podfile), Android (Gradle) |
143
- | `database` | Prisma, Drizzle, pg, mongodb, redis detected |
144
- | `devops` | Docker, Kubernetes, Terraform, CI/CD configs found |
145
- | `ai` | OpenAI, LangChain, or AI-related deps detected |
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. Triggers on ai, ml, llm, rag, embeddings, openai, anthropic, langchain.
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
- > **"AI is a capability, not a product. Design systems, not demos."**
27
-
28
- | Principle | Meaning |
29
- | ------------------------------ | ------------------------------------- |
30
- | **Retrieval over fine-tuning** | RAG first, fine-tune only when proven |
31
- | **Cost-aware design** | Monitor tokens, cache aggressively |
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
- | Aspect | Ask |
44
- | --------------- | -------------------------------------------- |
45
- | **Use case** | "What problem are you solving with AI?" |
46
- | **Data source** | "What documents/data will the AI access?" |
47
- | **Quality bar** | "What accuracy level is acceptable?" |
48
- | **Volume** | "How many requests per day expected?" |
49
- | **Latency** | "What response time is acceptable?" |
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
- | Component | Decision |
193
- | -------------- | ----------------------------------------- |
194
- | **Chunking** | Semantic chunking, 500-1000 chars |
195
- | **Embedding** | `text-embedding-3-small` (start here) |
196
- | **Retrieval** | Hybrid search (dense + sparse) |
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
- | Anti-Pattern | Correct Approach |
319
- | -------------------------- | ------------------------------------- |
320
- | Hardcoded API keys | Environment variables only |
321
- | No error handling | Retry, fallback, graceful degradation |
322
- | Ignoring token limits | Truncate or chunk input |
323
- | No caching | Cache identical queries |
324
- | GPT-4 for everything | Right-size model for task |
325
- | No evaluation | Measure before shipping |
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. Triggers on backend, server, api, endpoint, database, auth, node, python.
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
- > **"Backend is not just CRUDβ€”it's system architecture."**
27
-
28
- | Principle | Meaning |
29
- | ------------------------------- | -------------------------------------- |
30
- | **Security is non-negotiable** | Validate everything, trust nothing |
31
- | **Performance is measured** | Profile before optimizing |
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
- | Aspect | Ask |
44
- | -------------- | --------------------------------------- |
45
- | **Runtime** | "Node.js or Python? Edge-ready?" |
46
- | **Framework** | "Hono/Fastify/Express? FastAPI/Django?" |
47
- | **Database** | "PostgreSQL/SQLite? Serverless?" |
48
- | **API Style** | "REST/GraphQL/tRPC?" |
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
- | Scenario | Recommendation |
136
- | ------------------------ | --------------------- |
137
- | Full PostgreSQL features | Neon (serverless PG) |
138
- | Edge deployment | Turso (edge SQLite) |
139
- | AI/Embeddings | PostgreSQL + pgvector |
140
- | Simple/Local | SQLite |
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
- | Scenario | Recommendation |
147
- | --------------------------------- | -------------------- |
148
- | Public API, broad compatibility | REST + OpenAPI |
149
- | Complex queries, multiple clients | GraphQL |
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
- | Anti-Pattern | Correct Approach |
232
- | ------------------------- | --------------------------------------- |
233
- | SQL Injection | Use parameterized queries, ORM |
234
- | N+1 Queries | Use JOINs, DataLoader, or includes |
235
- | Blocking Event Loop | Use async for I/O operations |
236
- | Express for Edge | Use Hono/Fastify for modern deployments |
237
- | Same stack for everything | Choose per context and requirements |
238
- | Skipping auth check | Verify every protected route |
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