@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.
- package/README.md +395 -50
- package/dist/bin.cjs +3207 -165
- package/dist/bin.cjs.map +1 -1
- package/dist/bin.js +3207 -165
- package/dist/bin.js.map +1 -1
- package/dist/index.cjs +75 -58
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +284 -1
- package/dist/index.d.ts +284 -1
- package/dist/index.js +75 -58
- package/dist/index.js.map +1 -1
- package/package.json +24 -24
- package/templates/CLAUDE.md.template +60 -5
- package/templates/agents/README.md +58 -39
- package/templates/agents/_registry.json +43 -202
- package/templates/agents/engineering/{hono-engineer.md → api-engineer.md} +61 -70
- package/templates/agents/engineering/database-engineer.md +253 -0
- package/templates/agents/engineering/frontend-engineer.md +302 -0
- package/templates/docs/_registry.json +54 -0
- package/templates/docs/standards/code-standards.md +20 -0
- package/templates/docs/standards/design-standards.md +13 -0
- package/templates/docs/standards/documentation-standards.md +13 -0
- package/templates/docs/standards/performance-standards.md +524 -0
- package/templates/docs/standards/security-standards.md +496 -0
- package/templates/docs/standards/testing-standards.md +15 -0
- package/templates/hooks/on-notification.sh +0 -0
- package/templates/scripts/add-changelogs.sh +0 -0
- package/templates/scripts/generate-code-registry.ts +0 -0
- package/templates/scripts/health-check.sh +0 -0
- package/templates/scripts/sync-registry.sh +0 -0
- package/templates/scripts/telemetry-report.ts +0 -0
- package/templates/scripts/validate-docs.sh +0 -0
- package/templates/scripts/validate-registry.sh +0 -0
- package/templates/scripts/validate-structure.sh +0 -0
- package/templates/scripts/worktree-cleanup.sh +0 -0
- package/templates/scripts/worktree-create.sh +0 -0
- package/templates/skills/README.md +99 -90
- package/templates/skills/_registry.json +323 -16
- package/templates/skills/api-frameworks/express-patterns.md +411 -0
- package/templates/skills/api-frameworks/fastify-patterns.md +419 -0
- package/templates/skills/api-frameworks/hono-patterns.md +388 -0
- package/templates/skills/api-frameworks/nestjs-patterns.md +497 -0
- package/templates/skills/database/drizzle-patterns.md +449 -0
- package/templates/skills/database/mongoose-patterns.md +503 -0
- package/templates/skills/database/prisma-patterns.md +487 -0
- package/templates/skills/frontend-frameworks/astro-patterns.md +415 -0
- package/templates/skills/frontend-frameworks/nextjs-patterns.md +470 -0
- package/templates/skills/frontend-frameworks/react-patterns.md +516 -0
- package/templates/skills/frontend-frameworks/tanstack-start-patterns.md +469 -0
- package/templates/skills/patterns/atdd-methodology.md +364 -0
- package/templates/skills/patterns/bdd-methodology.md +281 -0
- package/templates/skills/patterns/clean-architecture.md +444 -0
- package/templates/skills/patterns/hexagonal-architecture.md +567 -0
- package/templates/skills/patterns/vertical-slice-architecture.md +502 -0
- package/templates/agents/engineering/astro-engineer.md +0 -293
- package/templates/agents/engineering/db-drizzle-engineer.md +0 -360
- package/templates/agents/engineering/express-engineer.md +0 -316
- package/templates/agents/engineering/fastify-engineer.md +0 -399
- package/templates/agents/engineering/mongoose-engineer.md +0 -473
- package/templates/agents/engineering/nestjs-engineer.md +0 -429
- package/templates/agents/engineering/nextjs-engineer.md +0 -451
- package/templates/agents/engineering/prisma-engineer.md +0 -432
- package/templates/agents/engineering/react-senior-dev.md +0 -394
- 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.
|
|
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
|
-
-
|
|
76
|
-
-
|
|
77
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
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
|
-
##
|
|
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
|
-
###
|
|
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 |
|
|
52
|
-
|
|
53
|
-
| [
|
|
54
|
-
| [
|
|
55
|
-
| [
|
|
56
|
-
| [
|
|
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
|
|
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
|
-
│ ├──
|
|
128
|
-
│ ├──
|
|
129
|
-
│ ├──
|
|
130
|
-
│
|
|
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
|
|
158
|
-
5.
|
|
159
|
-
6.
|
|
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", "
|
|
56
|
+
"relatedModules": ["product-functional", "tech-lead", "database-engineer"]
|
|
57
57
|
},
|
|
58
58
|
{
|
|
59
|
-
"id": "
|
|
60
|
-
"name": "
|
|
61
|
-
"description": "
|
|
62
|
-
"file": "engineering/
|
|
63
|
-
"tags": ["backend", "api", "
|
|
64
|
-
"longDescription": "
|
|
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
|
|
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
|
|
73
|
-
"techStack": ["
|
|
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": ["
|
|
75
|
+
"relatedModules": ["database-engineer", "node-typescript-engineer"],
|
|
76
|
+
"relatedSkills": ["hono-patterns", "express-patterns", "fastify-patterns", "nestjs-patterns"]
|
|
77
77
|
},
|
|
78
78
|
{
|
|
79
|
-
"id": "
|
|
80
|
-
"name": "
|
|
81
|
-
"description": "
|
|
82
|
-
"file": "engineering/
|
|
83
|
-
"tags": ["backend", "
|
|
84
|
-
"longDescription": "
|
|
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
|
-
"
|
|
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
|
|
89
|
+
"Implements database models",
|
|
150
90
|
"Optimizes query performance"
|
|
151
91
|
],
|
|
152
|
-
"whenToUse": "When using
|
|
153
|
-
"techStack": ["
|
|
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": ["
|
|
95
|
+
"relatedModules": ["api-engineer", "node-typescript-engineer"],
|
|
96
|
+
"relatedSkills": ["drizzle-patterns", "prisma-patterns", "mongoose-patterns"]
|
|
177
97
|
},
|
|
178
98
|
{
|
|
179
|
-
"id": "
|
|
180
|
-
"name": "
|
|
181
|
-
"description": "
|
|
182
|
-
"file": "engineering/
|
|
183
|
-
"tags": ["
|
|
184
|
-
"longDescription": "
|
|
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
|
-
"
|
|
187
|
-
"Implements
|
|
188
|
-
"
|
|
189
|
-
"
|
|
190
|
-
"Optimizes
|
|
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
|
|
193
|
-
"techStack": ["
|
|
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": ["
|
|
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": ["
|
|
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": ["
|
|
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": ["
|
|
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": ["
|
|
281
|
+
"relatedModules": ["frontend-engineer", "tech-writer", "content-writer"]
|
|
441
282
|
}
|
|
442
283
|
]
|
|
443
284
|
}
|