@qazuor/claude-code-config 0.4.0 → 0.6.0

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 (64) hide show
  1. package/README.md +395 -50
  2. package/dist/bin.cjs +3207 -165
  3. package/dist/bin.cjs.map +1 -1
  4. package/dist/bin.js +3207 -165
  5. package/dist/bin.js.map +1 -1
  6. package/dist/index.cjs +75 -58
  7. package/dist/index.cjs.map +1 -1
  8. package/dist/index.d.cts +284 -1
  9. package/dist/index.d.ts +284 -1
  10. package/dist/index.js +75 -58
  11. package/dist/index.js.map +1 -1
  12. package/package.json +24 -24
  13. package/templates/CLAUDE.md.template +60 -5
  14. package/templates/agents/README.md +58 -39
  15. package/templates/agents/_registry.json +43 -202
  16. package/templates/agents/engineering/{hono-engineer.md → api-engineer.md} +61 -70
  17. package/templates/agents/engineering/database-engineer.md +253 -0
  18. package/templates/agents/engineering/frontend-engineer.md +302 -0
  19. package/templates/docs/_registry.json +54 -0
  20. package/templates/docs/standards/code-standards.md +20 -0
  21. package/templates/docs/standards/design-standards.md +13 -0
  22. package/templates/docs/standards/documentation-standards.md +13 -0
  23. package/templates/docs/standards/performance-standards.md +524 -0
  24. package/templates/docs/standards/security-standards.md +496 -0
  25. package/templates/docs/standards/testing-standards.md +15 -0
  26. package/templates/hooks/on-notification.sh +0 -0
  27. package/templates/scripts/add-changelogs.sh +0 -0
  28. package/templates/scripts/generate-code-registry.ts +0 -0
  29. package/templates/scripts/health-check.sh +0 -0
  30. package/templates/scripts/sync-registry.sh +0 -0
  31. package/templates/scripts/telemetry-report.ts +0 -0
  32. package/templates/scripts/validate-docs.sh +0 -0
  33. package/templates/scripts/validate-registry.sh +0 -0
  34. package/templates/scripts/validate-structure.sh +0 -0
  35. package/templates/scripts/worktree-cleanup.sh +0 -0
  36. package/templates/scripts/worktree-create.sh +0 -0
  37. package/templates/skills/README.md +99 -90
  38. package/templates/skills/_registry.json +323 -16
  39. package/templates/skills/api-frameworks/express-patterns.md +411 -0
  40. package/templates/skills/api-frameworks/fastify-patterns.md +419 -0
  41. package/templates/skills/api-frameworks/hono-patterns.md +388 -0
  42. package/templates/skills/api-frameworks/nestjs-patterns.md +497 -0
  43. package/templates/skills/database/drizzle-patterns.md +449 -0
  44. package/templates/skills/database/mongoose-patterns.md +503 -0
  45. package/templates/skills/database/prisma-patterns.md +487 -0
  46. package/templates/skills/frontend-frameworks/astro-patterns.md +415 -0
  47. package/templates/skills/frontend-frameworks/nextjs-patterns.md +470 -0
  48. package/templates/skills/frontend-frameworks/react-patterns.md +516 -0
  49. package/templates/skills/frontend-frameworks/tanstack-start-patterns.md +469 -0
  50. package/templates/skills/patterns/atdd-methodology.md +364 -0
  51. package/templates/skills/patterns/bdd-methodology.md +281 -0
  52. package/templates/skills/patterns/clean-architecture.md +444 -0
  53. package/templates/skills/patterns/hexagonal-architecture.md +567 -0
  54. package/templates/skills/patterns/vertical-slice-architecture.md +502 -0
  55. package/templates/agents/engineering/astro-engineer.md +0 -293
  56. package/templates/agents/engineering/db-drizzle-engineer.md +0 -360
  57. package/templates/agents/engineering/express-engineer.md +0 -316
  58. package/templates/agents/engineering/fastify-engineer.md +0 -399
  59. package/templates/agents/engineering/mongoose-engineer.md +0 -473
  60. package/templates/agents/engineering/nestjs-engineer.md +0 -429
  61. package/templates/agents/engineering/nextjs-engineer.md +0 -451
  62. package/templates/agents/engineering/prisma-engineer.md +0 -432
  63. package/templates/agents/engineering/react-senior-dev.md +0 -394
  64. package/templates/agents/engineering/tanstack-start-engineer.md +0 -447
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qazuor/claude-code-config",
3
- "version": "0.4.0",
3
+ "version": "0.6.0",
4
4
  "description": "CLI tool to install and manage Claude Code configurations",
5
5
  "type": "module",
6
6
  "bin": {
@@ -19,27 +19,6 @@
19
19
  "dist",
20
20
  "templates"
21
21
  ],
22
- "scripts": {
23
- "dev": "tsup --watch",
24
- "build": "tsup",
25
- "start": "node dist/bin.js",
26
- "lint": "biome check .",
27
- "lint:fix": "biome check --write .",
28
- "format": "biome format --write .",
29
- "test": "vitest run",
30
- "test:watch": "vitest",
31
- "test:ui": "vitest --ui",
32
- "test:coverage": "vitest run --coverage",
33
- "test:integration": "vitest run --config vitest.integration.config.ts",
34
- "typecheck": "tsc --noEmit",
35
- "prepublishOnly": "pnpm build && pnpm test:coverage",
36
- "ci": "pnpm lint && pnpm typecheck && pnpm test:coverage",
37
- "release": "release-it",
38
- "release:patch": "release-it patch",
39
- "release:minor": "release-it minor",
40
- "release:major": "release-it major",
41
- "release:dry": "release-it --dry-run"
42
- },
43
22
  "dependencies": {
44
23
  "@inquirer/core": "^11.0.2",
45
24
  "@inquirer/prompts": "^7.2.0",
@@ -61,6 +40,7 @@
61
40
  "@types/node": "^22.10.2",
62
41
  "@vitest/coverage-v8": "^2.1.8",
63
42
  "@vitest/ui": "^2.1.8",
43
+ "dotenv-cli": "^11.0.0",
64
44
  "memfs": "^4.14.1",
65
45
  "release-it": "^19.1.0",
66
46
  "tsup": "^8.3.5",
@@ -89,5 +69,25 @@
89
69
  "url": "https://github.com/qazuor/claude-code-config/issues"
90
70
  },
91
71
  "homepage": "https://github.com/qazuor/claude-code-config#readme",
92
- "private": false
93
- }
72
+ "private": false,
73
+ "scripts": {
74
+ "dev": "tsup --watch",
75
+ "build": "tsup",
76
+ "start": "node dist/bin.js",
77
+ "lint": "biome check .",
78
+ "lint:fix": "biome check --write .",
79
+ "format": "biome format --write .",
80
+ "test": "vitest run",
81
+ "test:watch": "vitest",
82
+ "test:ui": "vitest --ui",
83
+ "test:coverage": "vitest run --coverage",
84
+ "test:integration": "vitest run --config vitest.integration.config.ts",
85
+ "typecheck": "tsc --noEmit",
86
+ "ci": "pnpm lint && pnpm typecheck && pnpm test:coverage",
87
+ "release": "dotenv release-it",
88
+ "release:patch": "dotenv release-it patch",
89
+ "release:minor": "dotenv release-it minor",
90
+ "release:major": "dotenv release-it major",
91
+ "release:dry": "dotenv release-it --dry-run"
92
+ }
93
+ }
@@ -72,22 +72,77 @@
72
72
 
73
73
  ### Code Standards
74
74
 
75
- - Follow TypeScript best practices
76
- - Use named exports (no default exports)
77
- - Maximum 500 lines per file
75
+ - Primary language: {{PRIMARY_LANGUAGE}}
76
+ - Follow {{PRIMARY_LANGUAGE}} best practices
77
+ {{#if NAMED_EXPORTS_ONLY}}
78
+ - Use named exports only (no default exports)
79
+ {{/if}}
80
+ - Maximum {{MAX_FILE_LINES}} lines per file
81
+ {{#if JSDOC_REQUIRED}}
78
82
  - Document all exports with JSDoc
83
+ {{/if}}
84
+ {{#if RORO_PATTERN}}
85
+ - Use RO-RO pattern (Receive Object, Return Object)
86
+ {{/if}}
79
87
 
80
88
  ### Testing
81
89
 
82
- - Write tests first (TDD)
90
+ {{#if TDD_REQUIRED}}
91
+ - Methodology: TDD (Test-Driven Development)
92
+ - Write tests first: Red -> Green -> Refactor
93
+ {{else}}
94
+ - Write comprehensive tests for all features
95
+ {{/if}}
83
96
  - Maintain {{COVERAGE_TARGET}}%+ code coverage
84
- - Use AAA pattern (Arrange, Act, Assert)
97
+ - Test pattern: {{TEST_PATTERN}}
98
+ {{#if TEST_LOCATION}}
99
+ - Test location: {{TEST_LOCATION}}
100
+ {{/if}}
85
101
 
86
102
  ### Git Workflow
87
103
 
88
104
  - Use conventional commits: `type(scope): description`
89
105
  - Types: feat, fix, docs, style, refactor, test, chore
90
106
  - Keep commits atomic and focused
107
+ {{#if INCLUDE_CO_AUTHOR}}
108
+
109
+ #### Commit Attribution
110
+
111
+ Include the following in commit messages:
112
+ ```
113
+ 🤖 Generated with [Claude Code](https://claude.com/claude-code)
114
+
115
+ Co-Authored-By: Claude <noreply@anthropic.com>
116
+ ```
117
+ {{/if}}
118
+
119
+ ## Claude Behavior Guidelines
120
+
121
+ ### Critical Thinking
122
+
123
+ - You are an expert who double-checks things, you are skeptical and do research
124
+ - Neither the user nor you are always right, but both strive for accuracy
125
+ - When the user asks something, reason with these questions:
126
+ - "Why might the user be wrong?"
127
+ - "What arguments exist against what the user thinks?"
128
+ - "Act as devil's advocate - why might this proposal fail?"
129
+ - "Imagine you're in a debate - how would you refute this?"
130
+ - Always ask to better understand the context of the requested change before implementing
131
+
132
+ ### Communication Style
133
+
134
+ {{#if RESPONSE_LANGUAGE}}
135
+ - Respond in {{RESPONSE_LANGUAGE}}
136
+ {{/if}}
137
+ - Code and comments should always be in English
138
+ - Be direct and concise
139
+ - Explain the "why" behind decisions when relevant
140
+
141
+ ### Writing Style
142
+
143
+ - Systematically replace em-dashes ("—") with a period (".") to start a new sentence, or a comma (",") to continue the sentence
144
+ - Avoid unnecessary filler words
145
+ - Use clear, technical language
91
146
 
92
147
  ## Claude Configuration
93
148
 
@@ -2,11 +2,29 @@
2
2
 
3
3
  This directory contains **specialized AI agents** that can be configured for any project. Each agent is an expert in specific areas and can be invoked during development workflow.
4
4
 
5
- ## ⚙️ Configuration Required
5
+ ## Architecture
6
+
7
+ Agents are **generic by role** and use **skills for framework-specific patterns**:
8
+
9
+ ```text
10
+ Agent (generic role) Skills (specific frameworks)
11
+ ───────────────────── ─────────────────────────────
12
+ api-engineer ───────> hono-patterns, express-patterns,
13
+ fastify-patterns, nestjs-patterns
14
+
15
+ database-engineer ───────> drizzle-patterns, prisma-patterns,
16
+ mongoose-patterns
17
+
18
+ frontend-engineer ───────> react-patterns, nextjs-patterns,
19
+ astro-patterns, tanstack-start-patterns
20
+ ```
21
+
22
+ ## Configuration Required
6
23
 
7
24
  All agents include a `config_required` section in their YAML frontmatter. Before using an agent, ensure you've configured the required settings in your project's `CLAUDE.md` or configuration files.
8
25
 
9
26
  **Example agent frontmatter:**
27
+
10
28
  ```yaml
11
29
  ---
12
30
  name: agent-name
@@ -15,6 +33,8 @@ tools: Read, Write, Edit, Glob, Grep, Bash
15
33
  model: sonnet
16
34
  config_required:
17
35
  - setting_name: "Description of what to configure"
36
+ related_skills:
37
+ - skill-category/skill-name (if using X)
18
38
  ---
19
39
  ```
20
40
 
@@ -33,27 +53,14 @@ config_required:
33
53
  |-------|-------------|-------|
34
54
  | [tech-lead](engineering/tech-lead.md) | Architectural oversight, code quality, security/performance validation | All |
35
55
 
36
- ### Backend Development (6 agents)
37
-
38
- | Agent | Description | Phase |
39
- |-------|-------------|-------|
40
- | [hono-engineer](engineering/hono-engineer.md) | API development with Hono framework | Phase 2 |
41
- | [express-engineer](engineering/express-engineer.md) | API development with Express framework | Phase 2 |
42
- | [fastify-engineer](engineering/fastify-engineer.md) | API development with Fastify framework | Phase 2 |
43
- | [nestjs-engineer](engineering/nestjs-engineer.md) | API development with NestJS framework | Phase 2 |
44
- | [db-drizzle-engineer](engineering/db-drizzle-engineer.md) | Database schemas with Drizzle ORM | Phase 2 |
45
- | [mongoose-engineer](engineering/mongoose-engineer.md) | Database schemas with Mongoose ODM | Phase 2 |
46
- | [prisma-engineer](engineering/prisma-engineer.md) | Database schemas with Prisma ORM | Phase 2 |
47
- | [node-typescript-engineer](engineering/node-typescript-engineer.md) | Shared packages, utilities, Node.js/TypeScript | Phase 2 |
48
-
49
- ### Frontend Development (4 agents)
56
+ ### Engineering (4 agents)
50
57
 
51
- | Agent | Description | Phase |
52
- |-------|-------------|-------|
53
- | [astro-engineer](engineering/astro-engineer.md) | Web apps with Astro, SSR, static generation | Phase 2 |
54
- | [nextjs-engineer](engineering/nextjs-engineer.md) | Web apps with Next.js | Phase 2 |
55
- | [react-senior-dev](engineering/react-senior-dev.md) | React components, hooks, state management | Phase 2 |
56
- | [tanstack-start-engineer](engineering/tanstack-start-engineer.md) | Admin dashboards with TanStack Start | Phase 2 |
58
+ | Agent | Description | Related Skills |
59
+ |-------|-------------|----------------|
60
+ | [api-engineer](engineering/api-engineer.md) | API routes, middleware, server logic | `api-frameworks/*` |
61
+ | [database-engineer](engineering/database-engineer.md) | Database schemas, migrations, models | `database/*` |
62
+ | [frontend-engineer](engineering/frontend-engineer.md) | Components, state management, UI | `frontend-frameworks/*` |
63
+ | [node-typescript-engineer](engineering/node-typescript-engineer.md) | Shared packages, utilities, Node.js/TypeScript | - |
57
64
 
58
65
  ### Design & UX (2 agents)
59
66
 
@@ -87,10 +94,28 @@ Use the Task tool with subagent_type="agent-name"
87
94
  ```
88
95
 
89
96
  **Examples:**
97
+
90
98
  ```text
91
99
  "Invoke product-functional to create the PDR"
92
100
  "Use tech-lead to review architecture"
93
- "Call db-drizzle-engineer to design database schema"
101
+ "Call database-engineer to design the schema"
102
+ "Use api-engineer to implement the routes"
103
+ ```
104
+
105
+ ## Agent + Skill Pattern
106
+
107
+ When using engineering agents, they reference skills for framework-specific patterns:
108
+
109
+ 1. **Agent provides**: Generic responsibilities, best practices, testing strategy
110
+ 2. **Skill provides**: Framework-specific code examples, patterns, configurations
111
+
112
+ **Example workflow:**
113
+
114
+ ```text
115
+ 1. User configures: API_FRAMEWORK=hono, ORM=drizzle
116
+ 2. api-engineer is invoked
117
+ 3. Agent references hono-patterns skill for Hono-specific code
118
+ 4. database-engineer references drizzle-patterns skill for Drizzle-specific code
94
119
  ```
95
120
 
96
121
  ## Agent File Format
@@ -103,6 +128,7 @@ Each agent file includes:
103
128
  - `tools`: Allowed tools (comma-separated)
104
129
  - `model`: sonnet/opus/haiku (optional)
105
130
  - `config_required`: Configuration directives
131
+ - `related_skills`: Skills for specific frameworks
106
132
 
107
133
  2. **Configuration Section**
108
134
  - Table of required settings
@@ -110,7 +136,7 @@ Each agent file includes:
110
136
 
111
137
  3. **Agent Content**
112
138
  - Role and responsibilities
113
- - Core workflow
139
+ - Core workflow (universal patterns)
114
140
  - Best practices
115
141
  - Quality checklist
116
142
 
@@ -124,18 +150,10 @@ agents/
124
150
  │ └── product-technical.md
125
151
  ├── engineering/
126
152
  │ ├── tech-lead.md
127
- │ ├── hono-engineer.md
128
- │ ├── express-engineer.md
129
- │ ├── fastify-engineer.md
130
- ├── nestjs-engineer.md
131
- │ ├── db-drizzle-engineer.md
132
- │ ├── mongoose-engineer.md
133
- │ ├── prisma-engineer.md
134
- │ ├── node-typescript-engineer.md
135
- │ ├── astro-engineer.md
136
- │ ├── nextjs-engineer.md
137
- │ ├── react-senior-dev.md
138
- │ └── tanstack-start-engineer.md
153
+ │ ├── api-engineer.md # Generic API agent
154
+ │ ├── database-engineer.md # Generic database agent
155
+ │ ├── frontend-engineer.md # Generic frontend agent
156
+ └── node-typescript-engineer.md
139
157
  ├── quality/
140
158
  │ ├── qa-engineer.md
141
159
  │ └── debugger.md
@@ -154,11 +172,12 @@ agents/
154
172
  1. Create `.md` file in appropriate category folder
155
173
  2. Use naming convention: `kebab-case-name.md`
156
174
  3. Include YAML frontmatter with `config_required`
157
- 4. Add `⚙️ Configuration` section with settings table
158
- 5. Keep content concise (200-400 lines target)
159
- 6. Update this README
175
+ 4. Add `related_skills` if agent uses framework-specific skills
176
+ 5. Add `⚙️ Configuration` section with settings table
177
+ 6. Keep content generic (no framework-specific code)
178
+ 7. Update this README
160
179
 
161
180
  ## Related
162
181
 
182
+ - [Skills](../skills/README.md) - Framework-specific patterns
163
183
  - [Commands](../commands/README.md)
164
- - [Skills](../skills/README.md)
@@ -53,147 +53,67 @@
53
53
  ],
54
54
  "whenToUse": "After Product Functional creates the PDR, use this to plan the technical implementation.",
55
55
  "skillLevel": "advanced",
56
- "relatedModules": ["product-functional", "tech-lead", "db-drizzle-engineer"]
56
+ "relatedModules": ["product-functional", "tech-lead", "database-engineer"]
57
57
  },
58
58
  {
59
- "id": "hono-engineer",
60
- "name": "Hono Engineer",
61
- "description": "Backend API development with Hono framework",
62
- "file": "engineering/hono-engineer.md",
63
- "tags": ["backend", "api", "hono"],
64
- "longDescription": "Specialized in building high-performance APIs using the Hono framework. Creates RESTful endpoints, handles middleware, and implements business logic with TypeScript.",
59
+ "id": "api-engineer",
60
+ "name": "API Engineer",
61
+ "description": "Generic backend API development - framework-agnostic",
62
+ "file": "engineering/api-engineer.md",
63
+ "tags": ["backend", "api", "generic"],
64
+ "longDescription": "Framework-agnostic API engineer that implements backend services following best practices. Uses framework-specific skills (hono-patterns, express-patterns, etc.) based on project configuration.",
65
65
  "whatItDoes": [
66
- "Creates RESTful API endpoints with Hono",
66
+ "Creates RESTful API endpoints",
67
67
  "Implements middleware for auth, validation, logging",
68
68
  "Handles request/response processing",
69
69
  "Integrates with database and external services",
70
70
  "Implements error handling and response formatting"
71
71
  ],
72
- "whenToUse": "When building backend APIs with Hono framework.",
73
- "techStack": ["Hono", "TypeScript", "Node.js", "Zod"],
74
- "alternativeTo": ["express-engineer", "fastify-engineer", "nestjs-engineer"],
72
+ "whenToUse": "When building backend APIs with any Node.js framework. Configure API_FRAMEWORK to specify which patterns to use.",
73
+ "techStack": ["Node.js", "TypeScript", "Zod"],
75
74
  "skillLevel": "intermediate",
76
- "relatedModules": ["db-drizzle-engineer", "node-typescript-engineer"]
75
+ "relatedModules": ["database-engineer", "node-typescript-engineer"],
76
+ "relatedSkills": ["hono-patterns", "express-patterns", "fastify-patterns", "nestjs-patterns"]
77
77
  },
78
78
  {
79
- "id": "express-engineer",
80
- "name": "Express Engineer",
81
- "description": "Backend API development with Express.js",
82
- "file": "engineering/express-engineer.md",
83
- "tags": ["backend", "api", "express"],
84
- "longDescription": "Specialized in building REST APIs with Express.js. Creates modular routes, middleware chains, and implements robust error handling with TypeScript.",
79
+ "id": "database-engineer",
80
+ "name": "Database Engineer",
81
+ "description": "Generic database design and development - ORM-agnostic",
82
+ "file": "engineering/database-engineer.md",
83
+ "tags": ["backend", "database", "generic"],
84
+ "longDescription": "ORM-agnostic database engineer that handles schema design, migrations, and queries. Uses ORM-specific skills (drizzle-patterns, prisma-patterns, etc.) based on project configuration.",
85
85
  "whatItDoes": [
86
- "Creates RESTful API endpoints with Express",
87
- "Implements middleware for auth, validation, logging",
88
- "Builds controller-service architecture",
89
- "Handles async errors and HTTP status codes",
90
- "Documents APIs with Swagger/OpenAPI"
91
- ],
92
- "whenToUse": "When building backend APIs with Express.js.",
93
- "techStack": ["Express.js", "TypeScript", "Zod"],
94
- "alternativeTo": ["hono-engineer", "fastify-engineer", "nestjs-engineer"],
95
- "skillLevel": "intermediate",
96
- "relatedModules": ["prisma-engineer", "db-drizzle-engineer", "node-typescript-engineer"]
97
- },
98
- {
99
- "id": "fastify-engineer",
100
- "name": "Fastify Engineer",
101
- "description": "High-performance API development with Fastify",
102
- "file": "engineering/fastify-engineer.md",
103
- "tags": ["backend", "api", "fastify"],
104
- "longDescription": "Builds high-performance APIs with Fastify's plugin architecture. Uses schema-based validation for automatic type inference and OpenAPI docs.",
105
- "whatItDoes": [
106
- "Creates typed routes with schema validation",
107
- "Builds reusable plugins with encapsulation",
108
- "Implements decorators for shared utilities",
109
- "Generates OpenAPI docs from schemas",
110
- "Optimizes for high-throughput performance"
111
- ],
112
- "whenToUse": "When building high-performance APIs with Fastify. Excellent for microservices and high-throughput applications.",
113
- "techStack": ["Fastify", "TypeBox", "TypeScript"],
114
- "alternativeTo": ["hono-engineer", "express-engineer", "nestjs-engineer"],
115
- "skillLevel": "intermediate",
116
- "relatedModules": ["prisma-engineer", "db-drizzle-engineer", "node-typescript-engineer"]
117
- },
118
- {
119
- "id": "nestjs-engineer",
120
- "name": "NestJS Engineer",
121
- "description": "Enterprise backend development with NestJS",
122
- "file": "engineering/nestjs-engineer.md",
123
- "tags": ["backend", "api", "nestjs", "enterprise"],
124
- "longDescription": "Builds scalable enterprise applications with NestJS. Uses dependency injection, modular architecture, and enterprise patterns like CQRS.",
125
- "whatItDoes": [
126
- "Creates modular application architecture",
127
- "Implements dependency injection patterns",
128
- "Builds guards, interceptors, and pipes",
129
- "Creates REST and GraphQL APIs",
130
- "Implements enterprise patterns (CQRS, events)"
131
- ],
132
- "whenToUse": "When building enterprise-scale applications that need strong architecture and dependency injection.",
133
- "techStack": ["NestJS", "TypeScript", "class-validator"],
134
- "alternativeTo": ["express-engineer", "fastify-engineer", "hono-engineer"],
135
- "skillLevel": "advanced",
136
- "relatedModules": ["prisma-engineer", "node-typescript-engineer"]
137
- },
138
- {
139
- "id": "db-drizzle-engineer",
140
- "name": "DB Drizzle Engineer",
141
- "description": "Database design and development with Drizzle ORM",
142
- "file": "engineering/db-drizzle-engineer.md",
143
- "tags": ["backend", "database", "drizzle"],
144
- "longDescription": "Expert in database design and implementation using Drizzle ORM. Handles schema design, migrations, queries, and database optimization with a focus on type safety.",
145
- "whatItDoes": [
146
- "Designs database schemas with Drizzle",
86
+ "Designs database schemas and relationships",
147
87
  "Creates and manages migrations",
148
88
  "Writes type-safe queries and transactions",
149
- "Implements database models and relationships",
89
+ "Implements database models",
150
90
  "Optimizes query performance"
151
91
  ],
152
- "whenToUse": "When using Drizzle ORM for database access.",
153
- "techStack": ["Drizzle ORM", "PostgreSQL", "SQLite", "MySQL", "TypeScript"],
154
- "alternativeTo": ["prisma-engineer", "mongoose-engineer"],
155
- "skillLevel": "intermediate",
156
- "relatedModules": ["hono-engineer", "node-typescript-engineer"]
157
- },
158
- {
159
- "id": "prisma-engineer",
160
- "name": "Prisma Engineer",
161
- "description": "Database design and development with Prisma ORM",
162
- "file": "engineering/prisma-engineer.md",
163
- "tags": ["backend", "database", "prisma"],
164
- "longDescription": "Expert in database design using Prisma ORM. Handles schema design, migrations, type-safe queries, and database optimization across multiple database engines.",
165
- "whatItDoes": [
166
- "Designs database schemas with Prisma",
167
- "Creates and manages migrations",
168
- "Writes type-safe queries with Prisma Client",
169
- "Implements relations and nested operations",
170
- "Handles transactions and database optimization"
171
- ],
172
- "whenToUse": "When using Prisma ORM for database access.",
173
- "techStack": ["Prisma", "PostgreSQL", "MySQL", "SQLite", "MongoDB", "TypeScript"],
174
- "alternativeTo": ["db-drizzle-engineer", "mongoose-engineer"],
92
+ "whenToUse": "When working with databases using any ORM. Configure ORM to specify which patterns to use.",
93
+ "techStack": ["PostgreSQL", "MySQL", "SQLite", "MongoDB", "TypeScript"],
175
94
  "skillLevel": "intermediate",
176
- "relatedModules": ["hono-engineer", "express-engineer", "node-typescript-engineer"]
95
+ "relatedModules": ["api-engineer", "node-typescript-engineer"],
96
+ "relatedSkills": ["drizzle-patterns", "prisma-patterns", "mongoose-patterns"]
177
97
  },
178
98
  {
179
- "id": "mongoose-engineer",
180
- "name": "Mongoose Engineer",
181
- "description": "MongoDB development with Mongoose ODM",
182
- "file": "engineering/mongoose-engineer.md",
183
- "tags": ["backend", "database", "mongodb", "mongoose"],
184
- "longDescription": "Expert in MongoDB with Mongoose ODM. Designs document schemas, writes aggregation pipelines, and implements NoSQL best practices.",
99
+ "id": "frontend-engineer",
100
+ "name": "Frontend Engineer",
101
+ "description": "Generic frontend development - framework-agnostic",
102
+ "file": "engineering/frontend-engineer.md",
103
+ "tags": ["frontend", "generic"],
104
+ "longDescription": "Framework-agnostic frontend engineer that builds user interfaces following best practices. Uses framework-specific skills (react-patterns, nextjs-patterns, etc.) based on project configuration.",
185
105
  "whatItDoes": [
186
- "Designs MongoDB document schemas",
187
- "Implements typed models with TypeScript",
188
- "Writes aggregation pipelines",
189
- "Creates middleware and virtuals",
190
- "Optimizes with indexes and query patterns"
106
+ "Creates reusable UI components",
107
+ "Implements state management patterns",
108
+ "Handles routing and navigation",
109
+ "Builds accessible and responsive interfaces",
110
+ "Optimizes performance and bundle size"
191
111
  ],
192
- "whenToUse": "When using MongoDB as your database.",
193
- "techStack": ["Mongoose", "MongoDB", "TypeScript"],
194
- "alternativeTo": ["prisma-engineer", "db-drizzle-engineer"],
112
+ "whenToUse": "When building frontend applications with any framework. Configure FRONTEND_FRAMEWORK to specify which patterns to use.",
113
+ "techStack": ["TypeScript", "Tailwind CSS"],
195
114
  "skillLevel": "intermediate",
196
- "relatedModules": ["express-engineer", "fastify-engineer", "node-typescript-engineer"]
115
+ "relatedModules": ["ux-ui-designer", "seo-ai-specialist"],
116
+ "relatedSkills": ["react-patterns", "nextjs-patterns", "astro-patterns", "tanstack-start-patterns"]
197
117
  },
198
118
  {
199
119
  "id": "node-typescript-engineer",
@@ -212,86 +132,7 @@
212
132
  "whenToUse": "For any shared code, utilities, or packages that are used across different parts of the application.",
213
133
  "techStack": ["TypeScript", "Node.js", "Zod", "ESM"],
214
134
  "skillLevel": "intermediate",
215
- "relatedModules": ["hono-engineer", "db-drizzle-engineer", "react-senior-dev"]
216
- },
217
- {
218
- "id": "astro-engineer",
219
- "name": "Astro Engineer",
220
- "description": "Astro framework development for static/SSR sites",
221
- "file": "engineering/astro-engineer.md",
222
- "tags": ["frontend", "astro", "ssr"],
223
- "longDescription": "Builds fast, content-focused websites using Astro. Specializes in static site generation, partial hydration, and integrating with various UI frameworks.",
224
- "whatItDoes": [
225
- "Creates Astro pages and layouts",
226
- "Implements content collections",
227
- "Configures SSG and SSR modes",
228
- "Integrates React/Vue/Svelte components",
229
- "Optimizes for performance and SEO"
230
- ],
231
- "whenToUse": "When building content-focused websites, blogs, or marketing sites with Astro.",
232
- "techStack": ["Astro", "TypeScript", "Tailwind CSS", "MDX"],
233
- "alternativeTo": ["nextjs-engineer"],
234
- "skillLevel": "intermediate",
235
- "relatedModules": ["react-senior-dev", "seo-ai-specialist"]
236
- },
237
- {
238
- "id": "nextjs-engineer",
239
- "name": "Next.js Engineer",
240
- "description": "Full-stack development with Next.js App Router",
241
- "file": "engineering/nextjs-engineer.md",
242
- "tags": ["frontend", "fullstack", "nextjs"],
243
- "longDescription": "Expert in Next.js App Router for building full-stack React applications. Handles Server Components, Server Actions, and data fetching patterns.",
244
- "whatItDoes": [
245
- "Creates pages with App Router architecture",
246
- "Implements Server and Client Components",
247
- "Builds Server Actions for form handling",
248
- "Handles SSR, SSG, and ISR patterns",
249
- "Creates API Routes and middleware"
250
- ],
251
- "whenToUse": "When building full-stack React applications with Next.js.",
252
- "techStack": ["Next.js", "React", "TypeScript", "Tailwind CSS", "Server Actions"],
253
- "alternativeTo": ["tanstack-start-engineer", "astro-engineer"],
254
- "skillLevel": "advanced",
255
- "relatedModules": ["react-senior-dev", "prisma-engineer"]
256
- },
257
- {
258
- "id": "tanstack-start-engineer",
259
- "name": "TanStack Start Engineer",
260
- "description": "TanStack Start/Router development for admin dashboards",
261
- "file": "engineering/tanstack-start-engineer.md",
262
- "tags": ["frontend", "tanstack", "admin"],
263
- "longDescription": "Expert in TanStack Start and Router for building type-safe, full-stack React applications. Specializes in admin dashboards and complex data-driven interfaces.",
264
- "whatItDoes": [
265
- "Creates routes with TanStack Router",
266
- "Implements server functions with TanStack Start",
267
- "Builds type-safe data fetching patterns",
268
- "Creates admin dashboard layouts",
269
- "Implements authentication flows"
270
- ],
271
- "whenToUse": "When building admin panels or complex React applications with TanStack Start/Router.",
272
- "techStack": ["TanStack Start", "TanStack Router", "TanStack Query", "React", "TypeScript"],
273
- "alternativeTo": ["nextjs-engineer"],
274
- "skillLevel": "advanced",
275
- "relatedModules": ["react-senior-dev", "hono-engineer"]
276
- },
277
- {
278
- "id": "react-senior-dev",
279
- "name": "React Senior Dev",
280
- "description": "React component development and UI architecture",
281
- "file": "engineering/react-senior-dev.md",
282
- "tags": ["frontend", "react", "components"],
283
- "longDescription": "Senior-level React developer focused on component architecture, state management, and UI best practices. Builds reusable, accessible, and performant components.",
284
- "whatItDoes": [
285
- "Creates reusable React components",
286
- "Implements state management patterns",
287
- "Builds accessible UI with proper ARIA",
288
- "Optimizes component performance",
289
- "Creates component libraries and design systems"
290
- ],
291
- "whenToUse": "For any React-based frontend development, component libraries, or UI architecture.",
292
- "techStack": ["React", "TypeScript", "Tailwind CSS", "TanStack Query"],
293
- "skillLevel": "advanced",
294
- "relatedModules": ["tanstack-start-engineer", "ux-ui-designer", "astro-engineer"]
135
+ "relatedModules": ["api-engineer", "database-engineer", "frontend-engineer"]
295
136
  },
296
137
  {
297
138
  "id": "ux-ui-designer",
@@ -309,7 +150,7 @@
309
150
  ],
310
151
  "whenToUse": "When designing new features or improving existing user interfaces.",
311
152
  "skillLevel": "intermediate",
312
- "relatedModules": ["react-senior-dev", "product-functional", "content-writer"]
153
+ "relatedModules": ["frontend-engineer", "product-functional", "content-writer"]
313
154
  },
314
155
  {
315
156
  "id": "content-writer",
@@ -400,7 +241,7 @@
400
241
  ],
401
242
  "whenToUse": "When building applications that need to support multiple languages or locales.",
402
243
  "skillLevel": "intermediate",
403
- "relatedModules": ["react-senior-dev", "nextjs-engineer"]
244
+ "relatedModules": ["frontend-engineer"]
404
245
  },
405
246
  {
406
247
  "id": "enrichment-agent",
@@ -437,7 +278,7 @@
437
278
  "whenToUse": "When building public-facing websites that need search engine visibility.",
438
279
  "techStack": ["Schema.org", "JSON-LD", "Open Graph", "Sitemap"],
439
280
  "skillLevel": "intermediate",
440
- "relatedModules": ["astro-engineer", "tech-writer", "content-writer"]
281
+ "relatedModules": ["frontend-engineer", "tech-writer", "content-writer"]
441
282
  }
442
283
  ]
443
284
  }