mlai-code 0.0.0-stage → 0.3.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 +12 -2
- package/bin/mlai.mjs +3 -0
- package/package.json +18 -3
- package/src/browser-setup.mjs +77 -0
- package/src/cli-ext.mjs +146 -0
- package/src/cli.mjs +534 -0
- package/src/cloud.mjs +29 -0
- package/src/completion.mjs +159 -0
- package/src/credentials.mjs +54 -0
- package/src/deploy.mjs +134 -0
- package/src/distribution.mjs +373 -0
- package/src/engine-key.mjs +4 -0
- package/src/engine.mjs +167 -0
- package/src/headless.mjs +196 -0
- package/src/home.mjs +22 -0
- package/src/host.mjs +123 -0
- package/src/local-models.mjs +64 -0
- package/src/modes.mjs +38 -0
- package/src/netbox.mjs +97 -0
- package/src/netjail.py +59 -0
- package/src/offline.mjs +98 -0
- package/src/parity.mjs +86 -0
- package/src/project.mjs +68 -0
- package/src/relay.mjs +140 -0
- package/src/render.mjs +73 -0
- package/src/restricted.mjs +47 -0
- package/src/review.mjs +70 -0
- package/src/runner.mjs +127 -0
- package/src/runtime.mjs +75 -0
- package/src/sandbox.mjs +135 -0
- package/src/sdk.mjs +11 -0
- package/src/server.mjs +110 -0
- package/src/session.mjs +290 -0
- package/src/settings.mjs +135 -0
- package/src/shared-data.mjs +3 -0
- package/src/tui/acp.mjs +145 -0
- package/src/tui/agents-cli.mjs +114 -0
- package/src/tui/agents-local.mjs +65 -0
- package/src/tui/ansi.mjs +123 -0
- package/src/tui/app.mjs +710 -0
- package/src/tui/approval.mjs +88 -0
- package/src/tui/bg.mjs +172 -0
- package/src/tui/bgterm.mjs +79 -0
- package/src/tui/chat.mjs +230 -0
- package/src/tui/clipboard.mjs +74 -0
- package/src/tui/cloud-cli.mjs +57 -0
- package/src/tui/cloud-run.mjs +123 -0
- package/src/tui/cmd-agents.mjs +130 -0
- package/src/tui/cmd-auto-review.mjs +94 -0
- package/src/tui/cmd-cloud.mjs +17 -0
- package/src/tui/cmd-config.mjs +104 -0
- package/src/tui/cmd-core.mjs +160 -0
- package/src/tui/cmd-distribution.mjs +15 -0
- package/src/tui/cmd-ecosystem.mjs +169 -0
- package/src/tui/cmd-extensibility.mjs +333 -0
- package/src/tui/cmd-remote.mjs +18 -0
- package/src/tui/cmd-review.mjs +58 -0
- package/src/tui/cmd-session-extra.mjs +152 -0
- package/src/tui/cmd-tui.mjs +200 -0
- package/src/tui/commands.mjs +160 -0
- package/src/tui/custom-commands.mjs +98 -0
- package/src/tui/diff.mjs +60 -0
- package/src/tui/editor.mjs +190 -0
- package/src/tui/ext-state.mjs +16 -0
- package/src/tui/extensions-local.mjs +140 -0
- package/src/tui/files.mjs +72 -0
- package/src/tui/handoff.mjs +110 -0
- package/src/tui/import-setups.mjs +151 -0
- package/src/tui/init.mjs +104 -0
- package/src/tui/keymap.mjs +70 -0
- package/src/tui/keys.mjs +101 -0
- package/src/tui/loop.mjs +75 -0
- package/src/tui/markdown.mjs +118 -0
- package/src/tui/mcp-config.mjs +225 -0
- package/src/tui/mcp-oauth.mjs +162 -0
- package/src/tui/permissions.mjs +189 -0
- package/src/tui/plain.mjs +32 -0
- package/src/tui/plugins-local.mjs +103 -0
- package/src/tui/remote.mjs +125 -0
- package/src/tui/review-cli.mjs +332 -0
- package/src/tui/review-github.mjs +59 -0
- package/src/tui/screen.mjs +60 -0
- package/src/tui/session-ops.mjs +104 -0
- package/src/tui/skills-local.mjs +92 -0
- package/src/tui/snapshots.mjs +87 -0
- package/src/tui/statusline.mjs +98 -0
- package/src/tui/transcript.mjs +116 -0
- package/src/two-words.mjs +36 -0
- package/src/wakeups.mjs +53 -0
- package/src/winenv.mjs +94 -0
- package/src/winsandbox.py +351 -0
- package/src/workspace-api.mjs +621 -0
- package/src/worktree.mjs +128 -0
- package/vendor/client-sdk/controller.cjs +115 -0
- package/vendor/client-sdk/files.cjs +38 -0
- package/vendor/client-sdk/index.cjs +133 -0
- package/vendor/client-sdk/login.cjs +52 -0
- package/vendor/client-sdk/updates.cjs +41 -0
- package/vendor/cloud-cli/mlai.mjs +394 -0
- package/worker/architecture_parse.cjs +23 -0
- package/worker/architecture_worker.py +394 -0
- package/worker/ask_first.py +96 -0
- package/worker/attachment_reader.py +66 -0
- package/worker/background_jobs.py +111 -0
- package/worker/brief_questions.py +56 -0
- package/worker/browser_local.py +49 -0
- package/worker/browser_pane.py +89 -0
- package/worker/browser_tool.py +101 -0
- package/worker/build_planner.py +187 -0
- package/worker/chat_fork.py +277 -0
- package/worker/checkpoints.py +133 -0
- package/worker/cloud_pty.py +351 -0
- package/worker/command_policy.py +39 -0
- package/worker/command_safety.py +717 -0
- package/worker/computer_card.sh +23 -0
- package/worker/computer_setup.sh +86 -0
- package/worker/computer_use.py +221 -0
- package/worker/connector_search.py +43 -0
- package/worker/context_manager.py +60 -0
- package/worker/conversation.py +144 -0
- package/worker/deploy_pack.py +116 -0
- package/worker/design_director.py +240 -0
- package/worker/dev_jobs.py +166 -0
- package/worker/edit_guard.py +99 -0
- package/worker/env_setup.py +129 -0
- package/worker/evidence.py +109 -0
- package/worker/fast_search.py +24 -0
- package/worker/git_sync.py +333 -0
- package/worker/goals.py +156 -0
- package/worker/handover.py +98 -0
- package/worker/harness_memory.py +194 -0
- package/worker/image_generation.py +173 -0
- package/worker/intelligence.py +149 -0
- package/worker/intent_model.py +78 -0
- package/worker/intent_weights.json +1 -0
- package/worker/ios_simulator.py +87 -0
- package/worker/kimi_bridge.py +997 -0
- package/worker/kimi_compact.py +93 -0
- package/worker/kimi_gates.py +304 -0
- package/worker/kimi_hook.py +617 -0
- package/worker/lifecycle.py +95 -0
- package/worker/lsp.py +77 -0
- package/worker/mcp_local.py +293 -0
- package/worker/memory.py +99 -0
- package/worker/mlai_auto_review.py +177 -0
- package/worker/mlai_hooks.py +966 -0
- package/worker/mlai_mcp.py +441 -0
- package/worker/mlai_permissions.py +283 -0
- package/worker/model_stream.py +75 -0
- package/worker/nested_repos.py +76 -0
- package/worker/offline_guard.py +17 -0
- package/worker/preview.py +806 -0
- package/worker/proc_watch.py +124 -0
- package/worker/project_context.py +72 -0
- package/worker/project_rules.py +99 -0
- package/worker/quality.py +180 -0
- package/worker/reply_language.py +56 -0
- package/worker/repo_hygiene.py +132 -0
- package/worker/repo_memory.py +101 -0
- package/worker/repo_policy.py +269 -0
- package/worker/roles.json +3173 -0
- package/worker/roles.py +303 -0
- package/worker/runner.py +1795 -0
- package/worker/runtime_control.py +205 -0
- package/worker/secret_scan.py +168 -0
- package/worker/session_hub.py +80 -0
- package/worker/skill_library.py +129 -0
- package/worker/skill_pack.py +533 -0
- package/worker/subagents.py +91 -0
- package/worker/task_controller.py +139 -0
- package/worker/task_skills.py +159 -0
- package/worker/team_checkpoint.py +33 -0
- package/worker/token_count.py +32 -0
- package/worker/tool_catalog.py +38 -0
- package/worker/upload_storage.py +531 -0
- package/worker/verification.py +725 -0
- package/worker/vision.py +84 -0
- package/worker/wakeups.py +63 -0
- package/worker/web_tools.py +203 -0
- package/worker/winproc.py +135 -0
- package/worker/work_ledger.py +117 -0
- package/worker/worktrees.py +79 -0
|
@@ -0,0 +1,3173 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 2,
|
|
3
|
+
"roles": [
|
|
4
|
+
{
|
|
5
|
+
"id": "auto",
|
|
6
|
+
"label": "Auto",
|
|
7
|
+
"title": "Auto",
|
|
8
|
+
"group": "Auto",
|
|
9
|
+
"icon": "Sparkles",
|
|
10
|
+
"tagline": "Picks the right engineer for the job. Frontend leads design on anything with a screen.",
|
|
11
|
+
"ui": true,
|
|
12
|
+
"skills": [],
|
|
13
|
+
"focus": [],
|
|
14
|
+
"done": [
|
|
15
|
+
"Uses the done-check of the role it picks"
|
|
16
|
+
],
|
|
17
|
+
"gate": {},
|
|
18
|
+
"phase1": "",
|
|
19
|
+
"detect": {},
|
|
20
|
+
"tools": [],
|
|
21
|
+
"decides": []
|
|
22
|
+
},
|
|
23
|
+
{
|
|
24
|
+
"id": "fullstack",
|
|
25
|
+
"label": "Full stack",
|
|
26
|
+
"title": "Full-stack engineer",
|
|
27
|
+
"group": "Product",
|
|
28
|
+
"icon": "Layers",
|
|
29
|
+
"tagline": "Database, API and UI as one working product. No fake data.",
|
|
30
|
+
"ui": true,
|
|
31
|
+
"skills": [
|
|
32
|
+
"postgres-orm",
|
|
33
|
+
"nextjs-app",
|
|
34
|
+
"supabase",
|
|
35
|
+
"clerk-auth",
|
|
36
|
+
"secrets-and-env",
|
|
37
|
+
"e2e-playwright"
|
|
38
|
+
],
|
|
39
|
+
"focus": [
|
|
40
|
+
"Build every layer the feature needs: data model and migrations, server-side API or server actions with validation, auth where users exist, and a UI that reads and writes through that API.",
|
|
41
|
+
"Persist to a real store (Postgres/SQLite/Supabase or the project's existing database). Seed data goes in a seed script, never inside UI components.",
|
|
42
|
+
"Wire loading, empty and error states to real responses. Keep secrets server-side and read them from environment variables.",
|
|
43
|
+
"Prove it end to end: create a record through the UI or API, reload, and show it came back from the database."
|
|
44
|
+
],
|
|
45
|
+
"done": [
|
|
46
|
+
"Data is stored in a real database or durable store",
|
|
47
|
+
"UI reads and writes through a real API, not hardcoded arrays",
|
|
48
|
+
"At least one end-to-end or API check passes on the current code"
|
|
49
|
+
],
|
|
50
|
+
"gate": {
|
|
51
|
+
"noMock": true,
|
|
52
|
+
"artifacts": [
|
|
53
|
+
{
|
|
54
|
+
"label": "Server-side API or data layer",
|
|
55
|
+
"globs": [
|
|
56
|
+
"app/api/**",
|
|
57
|
+
"pages/api/**",
|
|
58
|
+
"server/**",
|
|
59
|
+
"src/server/**",
|
|
60
|
+
"api/**",
|
|
61
|
+
"backend/**",
|
|
62
|
+
"services/**",
|
|
63
|
+
"src/routes/**",
|
|
64
|
+
"routes/**",
|
|
65
|
+
"src/api/**",
|
|
66
|
+
"functions/**",
|
|
67
|
+
"supabase/functions/**",
|
|
68
|
+
"**/*.sql",
|
|
69
|
+
"prisma/schema.prisma",
|
|
70
|
+
"drizzle/**",
|
|
71
|
+
"**/migrations/**",
|
|
72
|
+
"src/db/**",
|
|
73
|
+
"db/**",
|
|
74
|
+
"**/models.py",
|
|
75
|
+
"**/views.py",
|
|
76
|
+
"**/main.py",
|
|
77
|
+
"**/app.py",
|
|
78
|
+
"**/server.*",
|
|
79
|
+
"**/*.go",
|
|
80
|
+
"cmd/**",
|
|
81
|
+
"internal/**"
|
|
82
|
+
]
|
|
83
|
+
}
|
|
84
|
+
]
|
|
85
|
+
},
|
|
86
|
+
"phase1": "Phase 1 must be a thin vertical slice through every layer: a real database table, a real API or server action, and a UI that creates and lists records through it. No hardcoded or random data anywhere in the UI.",
|
|
87
|
+
"detect": {
|
|
88
|
+
"keywords": {
|
|
89
|
+
"full stack": 5,
|
|
90
|
+
"full-stack": 5,
|
|
91
|
+
"fullstack": 5,
|
|
92
|
+
"saas": 3,
|
|
93
|
+
"crud": 3,
|
|
94
|
+
"login": 2,
|
|
95
|
+
"sign up": 2,
|
|
96
|
+
"signup": 2,
|
|
97
|
+
"accounts": 2,
|
|
98
|
+
"users can": 2,
|
|
99
|
+
"dashboard": 1,
|
|
100
|
+
"admin panel": 2,
|
|
101
|
+
"marketplace": 3,
|
|
102
|
+
"database": 1,
|
|
103
|
+
"end to end": 2,
|
|
104
|
+
"end-to-end": 2,
|
|
105
|
+
"web app": 2,
|
|
106
|
+
"app with": 1,
|
|
107
|
+
"backend and frontend": 5,
|
|
108
|
+
"frontend and backend": 5,
|
|
109
|
+
"payments": 2,
|
|
110
|
+
"subscription": 2
|
|
111
|
+
},
|
|
112
|
+
"files": []
|
|
113
|
+
},
|
|
114
|
+
"tools": [
|
|
115
|
+
"Next.js / React",
|
|
116
|
+
"Postgres (Supabase or Neon) with Drizzle or Prisma",
|
|
117
|
+
"Clerk or Supabase Auth",
|
|
118
|
+
"Stripe",
|
|
119
|
+
"Resend",
|
|
120
|
+
"Playwright",
|
|
121
|
+
"Vercel",
|
|
122
|
+
"Sentry and PostHog"
|
|
123
|
+
],
|
|
124
|
+
"decides": [
|
|
125
|
+
"Data model and auth boundary",
|
|
126
|
+
"Which layer owns each rule (server action vs client)",
|
|
127
|
+
"Page and API structure",
|
|
128
|
+
"What ships in phase 1 versus later"
|
|
129
|
+
]
|
|
130
|
+
},
|
|
131
|
+
{
|
|
132
|
+
"id": "frontend",
|
|
133
|
+
"label": "Frontend",
|
|
134
|
+
"title": "Frontend engineer",
|
|
135
|
+
"group": "Product",
|
|
136
|
+
"icon": "PanelsTopLeft",
|
|
137
|
+
"tagline": "Designs and builds the interface: art direction, layout, motion, real data.",
|
|
138
|
+
"ui": true,
|
|
139
|
+
"skills": [
|
|
140
|
+
"frontend-design",
|
|
141
|
+
"ui-shadcn-tailwind",
|
|
142
|
+
"nextjs-app",
|
|
143
|
+
"design-engineering-motion",
|
|
144
|
+
"accessibility-wcag",
|
|
145
|
+
"web-performance",
|
|
146
|
+
"image-generation",
|
|
147
|
+
"e2e-playwright",
|
|
148
|
+
"product-analytics"
|
|
149
|
+
],
|
|
150
|
+
"focus": [
|
|
151
|
+
"Design before code. Write a five-line brief: who it is for, the one job of each screen, the mood in three words, the chosen direction, and the one thing that makes it memorable. Follow the project's selected design direction when one exists, and never ship the default template look.",
|
|
152
|
+
"Own the interface: component structure, state ownership, responsive layout from 360px up, keyboard and screen-reader access, motion that respects reduced-motion, and Core Web Vitals.",
|
|
153
|
+
"Fetch from existing APIs when they exist. If no backend exists and the user did not ask for one, put sample data in a clearly named fixtures file and say so in the summary.",
|
|
154
|
+
"Build every state, not just the happy path: loading skeletons, empty views with a next step, errors with retry, long content, and forms that validate inline and keep what the user typed.",
|
|
155
|
+
"Check the result in the browser at phone and desktop widths before finishing, and fix what looks off: alignment, overflow, contrast, crops and spacing."
|
|
156
|
+
],
|
|
157
|
+
"design": [
|
|
158
|
+
"Tokens before screens: one accent plus calm neutrals with checked contrast (4.5:1 for text), one display face and one text face on a five or six step type scale, a 4 or 8 px spacing scale, two radii and two shadow levels. Define them once as variables and use them everywhere; no one-off colours or font sizes.",
|
|
159
|
+
"Composition: every screen has one focal point and a clear reading order. Use a consistent grid, generous whitespace and grouped controls, and vary section rhythm on long pages (full-bleed, split, grid, quote, stat band) so it never repeats one card layout.",
|
|
160
|
+
"Typography does the work: confident headings with tight tracking, body lines of 60 to 75 characters at 1.5 line height, tabular numerals for data, no orphaned words in headings.",
|
|
161
|
+
"Real content: write specific copy for this product (names, numbers, benefits). No lorem ipsum and no generic welcome lines.",
|
|
162
|
+
"Imagery: where a real product would show pictures (hero, product, people, places, backgrounds), create them with the generate_image tool. It is included with the task at no extra credits, four images per run. Keep one art direction, no text inside images, set alt text and sizes. Use the icon library for icons, and CSS or SVG for charts, patterns and decoration. Never leave grey boxes, broken links or hotlinked stock photos. If the image tool is unavailable, use CSS or SVG art instead.",
|
|
163
|
+
"Interaction states: hover, focus-visible, active and disabled on every control, 44 px touch targets, consistent icon sizes, and skeletons rather than layout shift.",
|
|
164
|
+
"Motion with purpose: 120 to 400 ms, transform and opacity only, one signature moment per page at most, and a reduced-motion fallback.",
|
|
165
|
+
"Responsive by design: phone first, no sideways scroll at 360 px, navigation that collapses properly, images that crop well, and light and dark themes when the product has both.",
|
|
166
|
+
"Use the platform's own toolkit and the repo's existing design system before adding anything new (web, native mobile, desktop or game UI)."
|
|
167
|
+
],
|
|
168
|
+
"designShort": "Keep the existing design system: reuse its colour, type and spacing tokens, match neighbouring components, keep hover, focus, disabled, loading, empty and error states intact, check contrast, and look at the change in the browser at phone and desktop widths when a preview exists. For new imagery use the generate_image tool (included, no extra credits); use CSS or SVG for icons and decoration.",
|
|
169
|
+
"done": [
|
|
170
|
+
"Builds without type errors",
|
|
171
|
+
"Checked in the browser at phone and desktop widths",
|
|
172
|
+
"Any sample data lives in a labelled fixtures file",
|
|
173
|
+
"Colour, type and spacing come from one set of tokens",
|
|
174
|
+
"Loading, empty and error states exist for every data view",
|
|
175
|
+
"Images are real assets with alt text, with no placeholders or broken links"
|
|
176
|
+
],
|
|
177
|
+
"gate": {
|
|
178
|
+
"noMock": false,
|
|
179
|
+
"artifacts": []
|
|
180
|
+
},
|
|
181
|
+
"phase1": "Phase 1 must be a polished, working screen flow the user can open and click through, built on the design tokens, with real data if an API exists or a clearly labelled fixtures file if not.",
|
|
182
|
+
"detect": {
|
|
183
|
+
"keywords": {
|
|
184
|
+
"frontend": 5,
|
|
185
|
+
"front end": 5,
|
|
186
|
+
"front-end": 5,
|
|
187
|
+
"landing page": 4,
|
|
188
|
+
"ui": 2,
|
|
189
|
+
"ux": 2,
|
|
190
|
+
"css": 3,
|
|
191
|
+
"tailwind": 3,
|
|
192
|
+
"component": 2,
|
|
193
|
+
"responsive": 3,
|
|
194
|
+
"animation": 2,
|
|
195
|
+
"design system": 3,
|
|
196
|
+
"figma": 3,
|
|
197
|
+
"homepage": 3,
|
|
198
|
+
"website": 2,
|
|
199
|
+
"portfolio": 3,
|
|
200
|
+
"react component": 4,
|
|
201
|
+
"accessibility": 3,
|
|
202
|
+
"redesign": 4,
|
|
203
|
+
"web design": 4,
|
|
204
|
+
"ui design": 4,
|
|
205
|
+
"look and feel": 3,
|
|
206
|
+
"design": 2,
|
|
207
|
+
"hero section": 3,
|
|
208
|
+
"navbar": 2,
|
|
209
|
+
"layout": 2,
|
|
210
|
+
"web page": 3,
|
|
211
|
+
"webpage": 3,
|
|
212
|
+
"microsite": 3,
|
|
213
|
+
"dashboard ui": 3,
|
|
214
|
+
"user interface": 4,
|
|
215
|
+
"single page": 2,
|
|
216
|
+
"beautiful": 2
|
|
217
|
+
},
|
|
218
|
+
"files": []
|
|
219
|
+
},
|
|
220
|
+
"tools": [
|
|
221
|
+
"React / Next.js or the repo framework",
|
|
222
|
+
"Tailwind and shadcn/ui or the existing design system",
|
|
223
|
+
"Design tokens as CSS variables",
|
|
224
|
+
"generate_image for original imagery",
|
|
225
|
+
"Browser tool screenshots at 360, 768 and 1280 px",
|
|
226
|
+
"Storybook",
|
|
227
|
+
"Playwright and axe-core",
|
|
228
|
+
"Lighthouse",
|
|
229
|
+
"Framer Motion",
|
|
230
|
+
"PostHog events"
|
|
231
|
+
],
|
|
232
|
+
"decides": [
|
|
233
|
+
"Art direction: palette, type pairing and imagery style",
|
|
234
|
+
"Component boundaries and state ownership",
|
|
235
|
+
"Responsive breakpoints and layout grid",
|
|
236
|
+
"Loading, empty and error states",
|
|
237
|
+
"Accessibility and motion budget"
|
|
238
|
+
]
|
|
239
|
+
},
|
|
240
|
+
{
|
|
241
|
+
"id": "backend",
|
|
242
|
+
"label": "Backend",
|
|
243
|
+
"title": "Backend engineer",
|
|
244
|
+
"group": "Product",
|
|
245
|
+
"icon": "Server",
|
|
246
|
+
"tagline": "APIs, data models, auth, jobs and tests. Complete, not stubbed.",
|
|
247
|
+
"ui": false,
|
|
248
|
+
"skills": [
|
|
249
|
+
"backend-api",
|
|
250
|
+
"postgres-orm",
|
|
251
|
+
"secrets-and-env",
|
|
252
|
+
"docker-containers",
|
|
253
|
+
"observability-otel"
|
|
254
|
+
],
|
|
255
|
+
"focus": [
|
|
256
|
+
"Design the API contract first (resources, request/response shapes, status codes, errors, pagination, idempotency for writes) and keep it in an OpenAPI file or typed schema when the stack supports it.",
|
|
257
|
+
"Model data with migrations, constraints and indexes. Validate every input at the boundary and return structured errors.",
|
|
258
|
+
"Handle auth/authz, rate limits, retries and timeouts for external calls, background jobs for slow work, and structured logs with request ids.",
|
|
259
|
+
"Do not build a UI unless asked. Prove behaviour with automated API tests that hit a real (local or containerised) database, plus a curl example in the summary."
|
|
260
|
+
],
|
|
261
|
+
"done": [
|
|
262
|
+
"Endpoints persist to a real database with migrations",
|
|
263
|
+
"Automated API tests pass against the current code",
|
|
264
|
+
"No stubbed handlers or hardcoded responses"
|
|
265
|
+
],
|
|
266
|
+
"gate": {
|
|
267
|
+
"noMock": true,
|
|
268
|
+
"artifacts": [
|
|
269
|
+
{
|
|
270
|
+
"label": "API or service code",
|
|
271
|
+
"globs": [
|
|
272
|
+
"app/api/**",
|
|
273
|
+
"pages/api/**",
|
|
274
|
+
"server/**",
|
|
275
|
+
"src/server/**",
|
|
276
|
+
"api/**",
|
|
277
|
+
"backend/**",
|
|
278
|
+
"services/**",
|
|
279
|
+
"src/routes/**",
|
|
280
|
+
"routes/**",
|
|
281
|
+
"src/api/**",
|
|
282
|
+
"functions/**",
|
|
283
|
+
"supabase/functions/**",
|
|
284
|
+
"**/*.sql",
|
|
285
|
+
"prisma/schema.prisma",
|
|
286
|
+
"drizzle/**",
|
|
287
|
+
"**/migrations/**",
|
|
288
|
+
"src/db/**",
|
|
289
|
+
"db/**",
|
|
290
|
+
"**/models.py",
|
|
291
|
+
"**/views.py",
|
|
292
|
+
"**/main.py",
|
|
293
|
+
"**/app.py",
|
|
294
|
+
"**/server.*",
|
|
295
|
+
"**/*.go",
|
|
296
|
+
"cmd/**",
|
|
297
|
+
"internal/**"
|
|
298
|
+
]
|
|
299
|
+
},
|
|
300
|
+
{
|
|
301
|
+
"label": "Automated tests",
|
|
302
|
+
"globs": [
|
|
303
|
+
"tests/**",
|
|
304
|
+
"test/**",
|
|
305
|
+
"**/__tests__/**",
|
|
306
|
+
"**/*.test.*",
|
|
307
|
+
"**/*.spec.*",
|
|
308
|
+
"**/test_*.py",
|
|
309
|
+
"**/*_test.py",
|
|
310
|
+
"**/*_test.go",
|
|
311
|
+
"**/*Test.java",
|
|
312
|
+
"**/*_spec.rb",
|
|
313
|
+
"e2e/**",
|
|
314
|
+
"spec/**"
|
|
315
|
+
]
|
|
316
|
+
}
|
|
317
|
+
]
|
|
318
|
+
},
|
|
319
|
+
"phase1": "Phase 1 must be a running service: the data model with migrations, the first real endpoints persisted to a real database, input validation and error handling, and passing API tests. No UI unless the user asked for one.",
|
|
320
|
+
"detect": {
|
|
321
|
+
"keywords": {
|
|
322
|
+
"backend": 5,
|
|
323
|
+
"back end": 5,
|
|
324
|
+
"back-end": 5,
|
|
325
|
+
"api": 3,
|
|
326
|
+
"rest": 2,
|
|
327
|
+
"graphql": 4,
|
|
328
|
+
"endpoint": 3,
|
|
329
|
+
"endpoints": 3,
|
|
330
|
+
"webhook": 3,
|
|
331
|
+
"webhooks": 3,
|
|
332
|
+
"microservice": 4,
|
|
333
|
+
"server": 2,
|
|
334
|
+
"queue": 2,
|
|
335
|
+
"worker": 1,
|
|
336
|
+
"cron": 2,
|
|
337
|
+
"database schema": 3,
|
|
338
|
+
"migrations": 3,
|
|
339
|
+
"fastapi": 4,
|
|
340
|
+
"django": 4,
|
|
341
|
+
"flask": 4,
|
|
342
|
+
"express": 3,
|
|
343
|
+
"nestjs": 4,
|
|
344
|
+
"spring": 3,
|
|
345
|
+
"golang": 3,
|
|
346
|
+
"grpc": 4,
|
|
347
|
+
"auth service": 3,
|
|
348
|
+
"rate limit": 3,
|
|
349
|
+
"postgres": 2,
|
|
350
|
+
"postgresql": 2,
|
|
351
|
+
"mysql": 2,
|
|
352
|
+
"mongodb": 2,
|
|
353
|
+
"redis": 2,
|
|
354
|
+
"jwt": 2,
|
|
355
|
+
"oauth": 2,
|
|
356
|
+
"cli": 4,
|
|
357
|
+
"command line": 4,
|
|
358
|
+
"sdk": 3,
|
|
359
|
+
"rest api": 2,
|
|
360
|
+
"background jobs": 3,
|
|
361
|
+
"stripe webhook": 3
|
|
362
|
+
},
|
|
363
|
+
"files": [
|
|
364
|
+
"prisma/schema.prisma",
|
|
365
|
+
"manage.py",
|
|
366
|
+
"go.mod",
|
|
367
|
+
"**/migrations/**",
|
|
368
|
+
"openapi.*"
|
|
369
|
+
]
|
|
370
|
+
},
|
|
371
|
+
"tools": [
|
|
372
|
+
"FastAPI / Express / NestJS / Go or the repo stack",
|
|
373
|
+
"Postgres with migrations (Drizzle, Prisma, Alembic)",
|
|
374
|
+
"Redis and a job queue (BullMQ, Celery)",
|
|
375
|
+
"OpenAPI and zod/pydantic validation",
|
|
376
|
+
"Docker compose for local databases",
|
|
377
|
+
"curl, httpie and API tests"
|
|
378
|
+
],
|
|
379
|
+
"decides": [
|
|
380
|
+
"API contract, versioning and error shape",
|
|
381
|
+
"Schema, indexes and transaction boundaries",
|
|
382
|
+
"Idempotency, retries and timeouts",
|
|
383
|
+
"What runs inline versus in a background job"
|
|
384
|
+
]
|
|
385
|
+
},
|
|
386
|
+
{
|
|
387
|
+
"id": "mobile",
|
|
388
|
+
"label": "Mobile",
|
|
389
|
+
"title": "Mobile engineer",
|
|
390
|
+
"group": "Product",
|
|
391
|
+
"icon": "Smartphone",
|
|
392
|
+
"tagline": "iOS and Android apps with native feel, offline and push.",
|
|
393
|
+
"ui": true,
|
|
394
|
+
"skills": [
|
|
395
|
+
"expo-mobile",
|
|
396
|
+
"clerk-auth",
|
|
397
|
+
"supabase",
|
|
398
|
+
"secrets-and-env"
|
|
399
|
+
],
|
|
400
|
+
"focus": [
|
|
401
|
+
"Build with the project's mobile stack (Expo/React Native by default; native Swift/Kotlin when present).",
|
|
402
|
+
"Respect platform conventions: safe areas, navigation patterns, haptics, dark mode, dynamic type, and 44pt touch targets.",
|
|
403
|
+
"Plan for flaky networks: optimistic updates, retries, offline cache. Keep keys out of the bundle; call your own backend.",
|
|
404
|
+
"Verify with type checks, unit tests and an Expo web or simulator run when available."
|
|
405
|
+
],
|
|
406
|
+
"done": [
|
|
407
|
+
"Type checks and tests pass",
|
|
408
|
+
"Runs in Expo web or a simulator where available",
|
|
409
|
+
"Network calls go through a real backend"
|
|
410
|
+
],
|
|
411
|
+
"gate": {
|
|
412
|
+
"noMock": true,
|
|
413
|
+
"artifacts": []
|
|
414
|
+
},
|
|
415
|
+
"phase1": "Phase 1 must be an app the user can open in Expo (or a simulator) with real navigation and at least one screen backed by a real API.",
|
|
416
|
+
"detect": {
|
|
417
|
+
"keywords": {
|
|
418
|
+
"mobile": 4,
|
|
419
|
+
"ios": 4,
|
|
420
|
+
"android": 4,
|
|
421
|
+
"iphone": 3,
|
|
422
|
+
"react native": 5,
|
|
423
|
+
"expo": 5,
|
|
424
|
+
"flutter": 5,
|
|
425
|
+
"swift": 3,
|
|
426
|
+
"kotlin": 3,
|
|
427
|
+
"app store": 4,
|
|
428
|
+
"play store": 4,
|
|
429
|
+
"push notification": 3
|
|
430
|
+
},
|
|
431
|
+
"files": [
|
|
432
|
+
"app.json",
|
|
433
|
+
"eas.json",
|
|
434
|
+
"ios/**",
|
|
435
|
+
"android/**",
|
|
436
|
+
"pubspec.yaml"
|
|
437
|
+
]
|
|
438
|
+
},
|
|
439
|
+
"tools": [
|
|
440
|
+
"Expo and React Native (or Swift / Kotlin when the repo is native)",
|
|
441
|
+
"EAS Build and Expo Go",
|
|
442
|
+
"Expo Router",
|
|
443
|
+
"Clerk / Supabase",
|
|
444
|
+
"Jest and Detox or Maestro",
|
|
445
|
+
"Xcode and Android emulators"
|
|
446
|
+
],
|
|
447
|
+
"decides": [
|
|
448
|
+
"Navigation structure and offline strategy",
|
|
449
|
+
"Native module versus pure JS",
|
|
450
|
+
"Permission prompts and store compliance",
|
|
451
|
+
"Release channel and OTA update policy"
|
|
452
|
+
]
|
|
453
|
+
},
|
|
454
|
+
{
|
|
455
|
+
"id": "embedded",
|
|
456
|
+
"label": "Embedded",
|
|
457
|
+
"title": "Embedded and firmware engineer",
|
|
458
|
+
"group": "Product",
|
|
459
|
+
"icon": "Cpu",
|
|
460
|
+
"tagline": "Firmware, drivers and devices with tight memory and timing.",
|
|
461
|
+
"ui": false,
|
|
462
|
+
"skills": [
|
|
463
|
+
"embedded-firmware",
|
|
464
|
+
"github-actions-ci"
|
|
465
|
+
],
|
|
466
|
+
"focus": [
|
|
467
|
+
"Work within the target's constraints: flash/RAM budgets, interrupt safety, timing, power and the vendor toolchain already in the repo.",
|
|
468
|
+
"Separate hardware access behind a thin HAL so logic can be unit-tested on the host. Never guess register addresses; cite the datasheet or existing headers.",
|
|
469
|
+
"Build with the real toolchain when available and report size; otherwise compile host tests and state what needs hardware to verify."
|
|
470
|
+
],
|
|
471
|
+
"done": [
|
|
472
|
+
"Builds with the project toolchain or host tests pass",
|
|
473
|
+
"Hardware-only behaviour is listed for manual verification"
|
|
474
|
+
],
|
|
475
|
+
"gate": {
|
|
476
|
+
"noMock": false,
|
|
477
|
+
"artifacts": []
|
|
478
|
+
},
|
|
479
|
+
"phase1": "Phase 1 must build with the project toolchain (or host test harness) and demonstrate one working behaviour with a test or a documented on-device check.",
|
|
480
|
+
"detect": {
|
|
481
|
+
"keywords": {
|
|
482
|
+
"firmware": 5,
|
|
483
|
+
"embedded": 5,
|
|
484
|
+
"microcontroller": 5,
|
|
485
|
+
"mcu": 4,
|
|
486
|
+
"arduino": 5,
|
|
487
|
+
"esp32": 5,
|
|
488
|
+
"stm32": 5,
|
|
489
|
+
"pic18": 5,
|
|
490
|
+
"rtos": 5,
|
|
491
|
+
"freertos": 5,
|
|
492
|
+
"zephyr": 5,
|
|
493
|
+
"usb hid": 4,
|
|
494
|
+
"driver": 2,
|
|
495
|
+
"i2c": 4,
|
|
496
|
+
"spi": 3,
|
|
497
|
+
"uart": 4,
|
|
498
|
+
"gpio": 4,
|
|
499
|
+
"bootloader": 4
|
|
500
|
+
},
|
|
501
|
+
"files": [
|
|
502
|
+
"platformio.ini",
|
|
503
|
+
"**/nbproject/**",
|
|
504
|
+
"**/usb_descriptors.c",
|
|
505
|
+
"**/*.mcp",
|
|
506
|
+
"**/*.uvprojx",
|
|
507
|
+
"**/*.ioc",
|
|
508
|
+
"**/*.ino",
|
|
509
|
+
"**/CMakeLists.txt",
|
|
510
|
+
"**/*.ld",
|
|
511
|
+
"**/*.hex",
|
|
512
|
+
"sdkconfig",
|
|
513
|
+
"**/*.X/**"
|
|
514
|
+
]
|
|
515
|
+
},
|
|
516
|
+
"tools": [
|
|
517
|
+
"GCC/Clang cross toolchains, CMake, PlatformIO",
|
|
518
|
+
"Vendor HALs and SDKs (STM32Cube, ESP-IDF, Zephyr, nRF)",
|
|
519
|
+
"Logic analyser, oscilloscope, JTAG/SWD debuggers",
|
|
520
|
+
"Unity / CMocka host tests, Renode or QEMU",
|
|
521
|
+
"Static analysis (cppcheck, clang-tidy)"
|
|
522
|
+
],
|
|
523
|
+
"decides": [
|
|
524
|
+
"Memory and power budgets",
|
|
525
|
+
"Interrupt priorities and timing guarantees",
|
|
526
|
+
"HAL boundary and portability",
|
|
527
|
+
"Bootloader, OTA and field-update strategy"
|
|
528
|
+
]
|
|
529
|
+
},
|
|
530
|
+
{
|
|
531
|
+
"id": "devops",
|
|
532
|
+
"label": "DevOps",
|
|
533
|
+
"title": "DevOps engineer",
|
|
534
|
+
"group": "Platform",
|
|
535
|
+
"icon": "Infinity",
|
|
536
|
+
"tagline": "Containers, CI/CD, infrastructure as code and safe deploys.",
|
|
537
|
+
"ui": false,
|
|
538
|
+
"skills": [
|
|
539
|
+
"docker-containers",
|
|
540
|
+
"github-actions-ci",
|
|
541
|
+
"terraform-iac",
|
|
542
|
+
"kubernetes-deploy",
|
|
543
|
+
"vercel-deploy",
|
|
544
|
+
"secrets-and-env"
|
|
545
|
+
],
|
|
546
|
+
"focus": [
|
|
547
|
+
"Everything as code: Dockerfiles (multi-stage, non-root, pinned bases), CI pipelines with caching and required checks, infrastructure in Terraform/Pulumi/Helm, and environment config with secrets from a secret store.",
|
|
548
|
+
"Design deploys to be reversible: health checks, readiness probes, rolling or blue-green strategy, and a documented rollback.",
|
|
549
|
+
"Validate locally before claiming done: docker build, terraform fmt/validate/plan, helm template or kubectl --dry-run, actionlint where available.",
|
|
550
|
+
"Never apply changes to real cloud accounts or production without explicit approval; produce the plan output instead."
|
|
551
|
+
],
|
|
552
|
+
"done": [
|
|
553
|
+
"Infrastructure or pipeline is committed as code",
|
|
554
|
+
"Validated with build, lint or plan commands",
|
|
555
|
+
"Rollback path documented"
|
|
556
|
+
],
|
|
557
|
+
"gate": {
|
|
558
|
+
"noMock": false,
|
|
559
|
+
"artifacts": [
|
|
560
|
+
{
|
|
561
|
+
"label": "Infrastructure, container or pipeline as code",
|
|
562
|
+
"globs": [
|
|
563
|
+
"Dockerfile",
|
|
564
|
+
"**/Dockerfile*",
|
|
565
|
+
"docker-compose*.y*ml",
|
|
566
|
+
"compose*.y*ml",
|
|
567
|
+
".github/workflows/**",
|
|
568
|
+
".gitlab-ci.yml",
|
|
569
|
+
".circleci/**",
|
|
570
|
+
"**/*.tf",
|
|
571
|
+
"**/*.tfvars",
|
|
572
|
+
"k8s/**",
|
|
573
|
+
"kubernetes/**",
|
|
574
|
+
"helm/**",
|
|
575
|
+
"charts/**",
|
|
576
|
+
"deploy/**",
|
|
577
|
+
"infra/**",
|
|
578
|
+
"ansible/**",
|
|
579
|
+
"Makefile",
|
|
580
|
+
"vercel.json",
|
|
581
|
+
"fly.toml",
|
|
582
|
+
"render.yaml",
|
|
583
|
+
"Procfile",
|
|
584
|
+
"skaffold.yaml",
|
|
585
|
+
"kustomization.yaml",
|
|
586
|
+
"pulumi/**",
|
|
587
|
+
"cdk/**",
|
|
588
|
+
"**/*.Pulumi.yaml"
|
|
589
|
+
]
|
|
590
|
+
}
|
|
591
|
+
]
|
|
592
|
+
},
|
|
593
|
+
"phase1": "Phase 1 must be the app building and running in a container with a CI pipeline that runs tests on every push, all validated locally.",
|
|
594
|
+
"detect": {
|
|
595
|
+
"keywords": {
|
|
596
|
+
"devops": 5,
|
|
597
|
+
"ci/cd": 5,
|
|
598
|
+
"ci cd": 4,
|
|
599
|
+
"pipeline": 1,
|
|
600
|
+
"github actions": 4,
|
|
601
|
+
"gitlab ci": 4,
|
|
602
|
+
"docker": 4,
|
|
603
|
+
"dockerfile": 5,
|
|
604
|
+
"container": 3,
|
|
605
|
+
"kubernetes": 5,
|
|
606
|
+
"k8s": 5,
|
|
607
|
+
"helm": 5,
|
|
608
|
+
"terraform": 5,
|
|
609
|
+
"pulumi": 5,
|
|
610
|
+
"ansible": 5,
|
|
611
|
+
"deploy": 2,
|
|
612
|
+
"deployment": 2,
|
|
613
|
+
"infrastructure": 3,
|
|
614
|
+
"infra": 3,
|
|
615
|
+
"aws": 2,
|
|
616
|
+
"gcp": 2,
|
|
617
|
+
"azure": 2,
|
|
618
|
+
"ecs": 3,
|
|
619
|
+
"eks": 4,
|
|
620
|
+
"argocd": 5
|
|
621
|
+
},
|
|
622
|
+
"files": [
|
|
623
|
+
"Dockerfile",
|
|
624
|
+
"docker-compose.yml",
|
|
625
|
+
"**/*.tf",
|
|
626
|
+
".github/workflows/**",
|
|
627
|
+
"helm/**",
|
|
628
|
+
"k8s/**"
|
|
629
|
+
]
|
|
630
|
+
},
|
|
631
|
+
"tools": [
|
|
632
|
+
"Docker and compose",
|
|
633
|
+
"GitHub Actions / GitLab CI",
|
|
634
|
+
"Terraform or Pulumi",
|
|
635
|
+
"Kubernetes, Helm, Kustomize, ArgoCD",
|
|
636
|
+
"Vercel, Fly, AWS, GCP, Azure CLIs",
|
|
637
|
+
"Secret managers (Vault, SSM, Doppler)"
|
|
638
|
+
],
|
|
639
|
+
"decides": [
|
|
640
|
+
"Build and release pipeline shape",
|
|
641
|
+
"Environment promotion and rollback path",
|
|
642
|
+
"Image, runtime and base pinning policy",
|
|
643
|
+
"Where secrets and config live"
|
|
644
|
+
]
|
|
645
|
+
},
|
|
646
|
+
{
|
|
647
|
+
"id": "sre",
|
|
648
|
+
"label": "SRE",
|
|
649
|
+
"title": "Site reliability and platform engineer",
|
|
650
|
+
"group": "Platform",
|
|
651
|
+
"icon": "Activity",
|
|
652
|
+
"tagline": "SLOs, alerting, runbooks, capacity and incident readiness.",
|
|
653
|
+
"ui": false,
|
|
654
|
+
"skills": [
|
|
655
|
+
"sre-reliability",
|
|
656
|
+
"observability-otel",
|
|
657
|
+
"kubernetes-deploy",
|
|
658
|
+
"error-monitoring"
|
|
659
|
+
],
|
|
660
|
+
"focus": [
|
|
661
|
+
"Start from user-facing SLIs and SLOs with error budgets; alert on burn rate, not on every metric.",
|
|
662
|
+
"Instrument with OpenTelemetry traces, RED/USE metrics and structured logs; add health and readiness endpoints.",
|
|
663
|
+
"Write runbooks for each alert (symptoms, dashboards, mitigation, escalation) and make failure modes explicit: timeouts, retries with jitter, circuit breakers, graceful degradation, backpressure.",
|
|
664
|
+
"Verify alert rules and dashboards render (promtool check rules, config validation) and load-test critical paths when feasible."
|
|
665
|
+
],
|
|
666
|
+
"done": [
|
|
667
|
+
"SLOs and alert rules committed and validated",
|
|
668
|
+
"Each alert has a runbook",
|
|
669
|
+
"Instrumentation emits the metrics the alerts use"
|
|
670
|
+
],
|
|
671
|
+
"gate": {
|
|
672
|
+
"noMock": false,
|
|
673
|
+
"artifacts": [
|
|
674
|
+
{
|
|
675
|
+
"label": "SLOs, alerts, dashboards or runbooks",
|
|
676
|
+
"globs": [
|
|
677
|
+
"**/slo*",
|
|
678
|
+
"**/*slo*.y*ml",
|
|
679
|
+
"**/runbook*",
|
|
680
|
+
"**/runbooks/**",
|
|
681
|
+
"**/alert*",
|
|
682
|
+
"**/alerts/**",
|
|
683
|
+
"monitoring/**",
|
|
684
|
+
"observability/**",
|
|
685
|
+
"**/prometheus*.y*ml",
|
|
686
|
+
"**/grafana/**",
|
|
687
|
+
"dashboards/**",
|
|
688
|
+
"**/otel*",
|
|
689
|
+
"**/*health*"
|
|
690
|
+
]
|
|
691
|
+
}
|
|
692
|
+
]
|
|
693
|
+
},
|
|
694
|
+
"phase1": "Phase 1 must define SLIs/SLOs for the critical user journey, instrument them, and ship validated alert rules with runbooks.",
|
|
695
|
+
"detect": {
|
|
696
|
+
"keywords": {
|
|
697
|
+
"sre": 5,
|
|
698
|
+
"site reliability": 5,
|
|
699
|
+
"slo": 5,
|
|
700
|
+
"sla": 3,
|
|
701
|
+
"sli": 5,
|
|
702
|
+
"error budget": 5,
|
|
703
|
+
"on-call": 4,
|
|
704
|
+
"oncall": 4,
|
|
705
|
+
"incident": 3,
|
|
706
|
+
"postmortem": 4,
|
|
707
|
+
"uptime": 3,
|
|
708
|
+
"latency": 2,
|
|
709
|
+
"observability": 4,
|
|
710
|
+
"monitoring": 3,
|
|
711
|
+
"alerting": 4,
|
|
712
|
+
"prometheus": 5,
|
|
713
|
+
"grafana": 5,
|
|
714
|
+
"opentelemetry": 4,
|
|
715
|
+
"capacity": 3,
|
|
716
|
+
"load test": 3,
|
|
717
|
+
"chaos": 4,
|
|
718
|
+
"platform engineering": 4
|
|
719
|
+
},
|
|
720
|
+
"files": [
|
|
721
|
+
"prometheus.yml",
|
|
722
|
+
"**/alerts/**",
|
|
723
|
+
"**/runbooks/**"
|
|
724
|
+
]
|
|
725
|
+
},
|
|
726
|
+
"tools": [
|
|
727
|
+
"Prometheus, Grafana, Loki, Tempo",
|
|
728
|
+
"OpenTelemetry",
|
|
729
|
+
"Datadog / New Relic when present",
|
|
730
|
+
"PagerDuty or Opsgenie",
|
|
731
|
+
"k6 or Locust for load",
|
|
732
|
+
"Chaos tooling (Litmus, fault injection)"
|
|
733
|
+
],
|
|
734
|
+
"decides": [
|
|
735
|
+
"SLIs, SLOs and error budgets",
|
|
736
|
+
"Alert thresholds and paging policy",
|
|
737
|
+
"Capacity, autoscaling and limits",
|
|
738
|
+
"Incident process and postmortem actions"
|
|
739
|
+
]
|
|
740
|
+
},
|
|
741
|
+
{
|
|
742
|
+
"id": "security",
|
|
743
|
+
"label": "Security",
|
|
744
|
+
"title": "Security engineer",
|
|
745
|
+
"group": "Quality and security",
|
|
746
|
+
"icon": "ShieldCheck",
|
|
747
|
+
"tagline": "Threat models, secure fixes, dependency and secret hygiene.",
|
|
748
|
+
"ui": false,
|
|
749
|
+
"skills": [
|
|
750
|
+
"security-appsec",
|
|
751
|
+
"secrets-and-env",
|
|
752
|
+
"github-actions-ci"
|
|
753
|
+
],
|
|
754
|
+
"focus": [
|
|
755
|
+
"Threat-model the change (assets, entry points, trust boundaries) and check the OWASP Top 10 and ASVS controls that apply.",
|
|
756
|
+
"Fix root causes: parameterised queries, output encoding, authz checks on every object access, CSRF/SSRF protections, secure cookies and headers, least-privilege tokens.",
|
|
757
|
+
"Run the scanners available (npm audit/pip-audit, semgrep, gitleaks/trufflehog, trivy) and triage findings by exploitability.",
|
|
758
|
+
"Every fix ships with a regression test that reproduces the attack. Never print or commit secrets you find; report their location and rotate."
|
|
759
|
+
],
|
|
760
|
+
"done": [
|
|
761
|
+
"Findings report with severity and evidence",
|
|
762
|
+
"Each fix has a test reproducing the attack",
|
|
763
|
+
"Scanner results attached or their absence explained"
|
|
764
|
+
],
|
|
765
|
+
"gate": {
|
|
766
|
+
"noMock": false,
|
|
767
|
+
"artifacts": [
|
|
768
|
+
{
|
|
769
|
+
"label": "Security report, policy or regression tests",
|
|
770
|
+
"globs": [
|
|
771
|
+
"SECURITY*.md",
|
|
772
|
+
"**/security/**",
|
|
773
|
+
"docs/security/**",
|
|
774
|
+
"**/threat-model*",
|
|
775
|
+
"**/THREAT*",
|
|
776
|
+
"**/.semgrep*",
|
|
777
|
+
"**/.gitleaks*",
|
|
778
|
+
"tests/**",
|
|
779
|
+
"test/**",
|
|
780
|
+
"**/__tests__/**",
|
|
781
|
+
"**/*.test.*",
|
|
782
|
+
"**/*.spec.*",
|
|
783
|
+
"**/test_*.py",
|
|
784
|
+
"**/*_test.py",
|
|
785
|
+
"**/*_test.go",
|
|
786
|
+
"**/*Test.java",
|
|
787
|
+
"**/*_spec.rb",
|
|
788
|
+
"e2e/**",
|
|
789
|
+
"spec/**"
|
|
790
|
+
]
|
|
791
|
+
}
|
|
792
|
+
]
|
|
793
|
+
},
|
|
794
|
+
"phase1": "Phase 1 must be a threat model and prioritised findings for the critical paths, with the highest-severity issue fixed and covered by a regression test.",
|
|
795
|
+
"detect": {
|
|
796
|
+
"keywords": {
|
|
797
|
+
"security": 4,
|
|
798
|
+
"secure": 2,
|
|
799
|
+
"vulnerability": 5,
|
|
800
|
+
"vulnerabilities": 5,
|
|
801
|
+
"cve": 5,
|
|
802
|
+
"owasp": 5,
|
|
803
|
+
"pentest": 5,
|
|
804
|
+
"penetration": 4,
|
|
805
|
+
"xss": 5,
|
|
806
|
+
"csrf": 5,
|
|
807
|
+
"sql injection": 5,
|
|
808
|
+
"ssrf": 5,
|
|
809
|
+
"threat model": 5,
|
|
810
|
+
"devsecops": 5,
|
|
811
|
+
"secrets scan": 4,
|
|
812
|
+
"audit": 2,
|
|
813
|
+
"hardening": 4,
|
|
814
|
+
"rbac": 3,
|
|
815
|
+
"compliance": 2,
|
|
816
|
+
"soc 2": 3
|
|
817
|
+
},
|
|
818
|
+
"files": [
|
|
819
|
+
"SECURITY.md",
|
|
820
|
+
".gitleaks.toml"
|
|
821
|
+
]
|
|
822
|
+
},
|
|
823
|
+
"tools": [
|
|
824
|
+
"Semgrep, CodeQL, Bandit, ESLint security rules",
|
|
825
|
+
"Trivy, Grype, npm audit, pip-audit",
|
|
826
|
+
"Gitleaks and TruffleHog",
|
|
827
|
+
"OWASP ZAP and Burp",
|
|
828
|
+
"SBOM (Syft) and dependency review",
|
|
829
|
+
"Threat-model templates (STRIDE)"
|
|
830
|
+
],
|
|
831
|
+
"decides": [
|
|
832
|
+
"Threat model and trust boundaries",
|
|
833
|
+
"AuthN/AuthZ model and session policy",
|
|
834
|
+
"Secret handling and rotation",
|
|
835
|
+
"Which findings block a release"
|
|
836
|
+
]
|
|
837
|
+
},
|
|
838
|
+
{
|
|
839
|
+
"id": "qa",
|
|
840
|
+
"label": "QA",
|
|
841
|
+
"title": "QA and test automation engineer",
|
|
842
|
+
"group": "Quality and security",
|
|
843
|
+
"icon": "FlaskConical",
|
|
844
|
+
"tagline": "Test strategy, automation and flaky-test hunting.",
|
|
845
|
+
"ui": false,
|
|
846
|
+
"skills": [
|
|
847
|
+
"qa-automation",
|
|
848
|
+
"e2e-playwright",
|
|
849
|
+
"github-actions-ci"
|
|
850
|
+
],
|
|
851
|
+
"focus": [
|
|
852
|
+
"Map the risk first: critical journeys, boundaries, error paths. Build a pyramid: fast unit tests, contract/integration tests at service boundaries, a few end-to-end journeys.",
|
|
853
|
+
"Tests must assert behaviour the user cares about, be deterministic (no sleeps, fixed clocks and seeds) and isolated (own data, cleaned up).",
|
|
854
|
+
"Reproduce reported bugs as failing tests before fixes. Quarantine and root-cause flaky tests instead of retrying blindly.",
|
|
855
|
+
"Wire the suite into CI and report coverage of the critical journeys, not just line coverage."
|
|
856
|
+
],
|
|
857
|
+
"done": [
|
|
858
|
+
"New or improved automated tests committed",
|
|
859
|
+
"Suite passes on the current code",
|
|
860
|
+
"Critical journeys listed with their coverage"
|
|
861
|
+
],
|
|
862
|
+
"gate": {
|
|
863
|
+
"noMock": false,
|
|
864
|
+
"artifacts": [
|
|
865
|
+
{
|
|
866
|
+
"label": "Automated tests",
|
|
867
|
+
"globs": [
|
|
868
|
+
"tests/**",
|
|
869
|
+
"test/**",
|
|
870
|
+
"**/__tests__/**",
|
|
871
|
+
"**/*.test.*",
|
|
872
|
+
"**/*.spec.*",
|
|
873
|
+
"**/test_*.py",
|
|
874
|
+
"**/*_test.py",
|
|
875
|
+
"**/*_test.go",
|
|
876
|
+
"**/*Test.java",
|
|
877
|
+
"**/*_spec.rb",
|
|
878
|
+
"e2e/**",
|
|
879
|
+
"spec/**"
|
|
880
|
+
]
|
|
881
|
+
}
|
|
882
|
+
]
|
|
883
|
+
},
|
|
884
|
+
"phase1": "Phase 1 must cover the most critical user journey with deterministic automated tests running in CI.",
|
|
885
|
+
"detect": {
|
|
886
|
+
"keywords": {
|
|
887
|
+
"qa": 5,
|
|
888
|
+
"quality assurance": 5,
|
|
889
|
+
"test automation": 5,
|
|
890
|
+
"write tests": 4,
|
|
891
|
+
"unit tests": 4,
|
|
892
|
+
"integration tests": 4,
|
|
893
|
+
"e2e tests": 5,
|
|
894
|
+
"end-to-end tests": 5,
|
|
895
|
+
"playwright": 4,
|
|
896
|
+
"cypress": 5,
|
|
897
|
+
"selenium": 5,
|
|
898
|
+
"flaky": 5,
|
|
899
|
+
"test coverage": 5,
|
|
900
|
+
"regression suite": 5,
|
|
901
|
+
"test plan": 4
|
|
902
|
+
},
|
|
903
|
+
"files": [
|
|
904
|
+
"playwright.config.*",
|
|
905
|
+
"cypress.config.*",
|
|
906
|
+
"pytest.ini"
|
|
907
|
+
]
|
|
908
|
+
},
|
|
909
|
+
"tools": [
|
|
910
|
+
"Playwright and Cypress",
|
|
911
|
+
"Vitest / Jest / pytest",
|
|
912
|
+
"Pact or schema contract tests",
|
|
913
|
+
"k6 for performance checks",
|
|
914
|
+
"axe-core for accessibility",
|
|
915
|
+
"CI test sharding and flaky-test reports"
|
|
916
|
+
],
|
|
917
|
+
"decides": [
|
|
918
|
+
"Risk map and what gets automated first",
|
|
919
|
+
"Test pyramid split and fixtures strategy",
|
|
920
|
+
"Flaky test quarantine rules",
|
|
921
|
+
"Release readiness criteria"
|
|
922
|
+
]
|
|
923
|
+
},
|
|
924
|
+
{
|
|
925
|
+
"id": "data-eng",
|
|
926
|
+
"label": "Data engineering",
|
|
927
|
+
"title": "Data engineer",
|
|
928
|
+
"group": "Data and AI",
|
|
929
|
+
"icon": "Database",
|
|
930
|
+
"tagline": "Reliable pipelines, warehouses and data quality checks.",
|
|
931
|
+
"ui": false,
|
|
932
|
+
"skills": [
|
|
933
|
+
"data-pipelines",
|
|
934
|
+
"postgres-orm",
|
|
935
|
+
"docker-containers"
|
|
936
|
+
],
|
|
937
|
+
"focus": [
|
|
938
|
+
"Model sources, staging and marts explicitly; make every job idempotent and re-runnable for a date range, with incremental loads and backfills.",
|
|
939
|
+
"Enforce schemas and data contracts; add data-quality tests (not-null, unique, accepted values, freshness, row-count deltas).",
|
|
940
|
+
"Use the orchestrator already in the repo (Airflow, Dagster, Prefect, dbt, cron) and record lineage. Never invent sample rows in pipeline code; use fixtures for tests only.",
|
|
941
|
+
"Prove it with a run on a small real or fixture dataset and the quality checks passing."
|
|
942
|
+
],
|
|
943
|
+
"done": [
|
|
944
|
+
"Pipeline runs idempotently on a sample",
|
|
945
|
+
"Data-quality tests pass",
|
|
946
|
+
"Schemas or contracts committed"
|
|
947
|
+
],
|
|
948
|
+
"gate": {
|
|
949
|
+
"noMock": true,
|
|
950
|
+
"artifacts": [
|
|
951
|
+
{
|
|
952
|
+
"label": "Pipeline, model or SQL code",
|
|
953
|
+
"globs": [
|
|
954
|
+
"pipelines/**",
|
|
955
|
+
"dags/**",
|
|
956
|
+
"etl/**",
|
|
957
|
+
"elt/**",
|
|
958
|
+
"dbt_project.yml",
|
|
959
|
+
"models/**",
|
|
960
|
+
"**/*.sql",
|
|
961
|
+
"**/assets/**",
|
|
962
|
+
"flows/**",
|
|
963
|
+
"jobs/**",
|
|
964
|
+
"**/*pipeline*"
|
|
965
|
+
]
|
|
966
|
+
},
|
|
967
|
+
{
|
|
968
|
+
"label": "Data-quality tests",
|
|
969
|
+
"globs": [
|
|
970
|
+
"tests/**",
|
|
971
|
+
"test/**",
|
|
972
|
+
"**/__tests__/**",
|
|
973
|
+
"**/*.test.*",
|
|
974
|
+
"**/*.spec.*",
|
|
975
|
+
"**/test_*.py",
|
|
976
|
+
"**/*_test.py",
|
|
977
|
+
"**/*_test.go",
|
|
978
|
+
"**/*Test.java",
|
|
979
|
+
"**/*_spec.rb",
|
|
980
|
+
"e2e/**",
|
|
981
|
+
"spec/**",
|
|
982
|
+
"**/schema.yml",
|
|
983
|
+
"**/*expectations*",
|
|
984
|
+
"**/great_expectations/**",
|
|
985
|
+
"**/tests/**/*.sql"
|
|
986
|
+
]
|
|
987
|
+
}
|
|
988
|
+
]
|
|
989
|
+
},
|
|
990
|
+
"phase1": "Phase 1 must be one source landing in the warehouse through an idempotent job with schema and data-quality tests passing on a sample.",
|
|
991
|
+
"detect": {
|
|
992
|
+
"keywords": {
|
|
993
|
+
"data engineering": 5,
|
|
994
|
+
"data engineer": 5,
|
|
995
|
+
"etl": 5,
|
|
996
|
+
"elt": 5,
|
|
997
|
+
"data pipeline": 5,
|
|
998
|
+
"warehouse": 4,
|
|
999
|
+
"snowflake": 5,
|
|
1000
|
+
"bigquery": 5,
|
|
1001
|
+
"redshift": 5,
|
|
1002
|
+
"dbt": 5,
|
|
1003
|
+
"airflow": 5,
|
|
1004
|
+
"dagster": 5,
|
|
1005
|
+
"prefect": 5,
|
|
1006
|
+
"spark": 4,
|
|
1007
|
+
"kafka": 4,
|
|
1008
|
+
"cdc": 4,
|
|
1009
|
+
"lakehouse": 5,
|
|
1010
|
+
"delta lake": 5,
|
|
1011
|
+
"ingestion": 4,
|
|
1012
|
+
"batch job": 3
|
|
1013
|
+
},
|
|
1014
|
+
"files": [
|
|
1015
|
+
"dbt_project.yml",
|
|
1016
|
+
"dags/**",
|
|
1017
|
+
"airflow.cfg"
|
|
1018
|
+
]
|
|
1019
|
+
},
|
|
1020
|
+
"tools": [
|
|
1021
|
+
"Airflow, Dagster or Prefect",
|
|
1022
|
+
"dbt",
|
|
1023
|
+
"Spark / DuckDB / Polars",
|
|
1024
|
+
"BigQuery, Snowflake, Redshift, Postgres",
|
|
1025
|
+
"Kafka or Kinesis",
|
|
1026
|
+
"Great Expectations or dbt tests",
|
|
1027
|
+
"Fivetran / Airbyte connectors"
|
|
1028
|
+
],
|
|
1029
|
+
"decides": [
|
|
1030
|
+
"Batch versus streaming per source",
|
|
1031
|
+
"Data contracts, schemas and partitioning",
|
|
1032
|
+
"Idempotency and backfill strategy",
|
|
1033
|
+
"Freshness and quality SLAs"
|
|
1034
|
+
]
|
|
1035
|
+
},
|
|
1036
|
+
{
|
|
1037
|
+
"id": "data-science",
|
|
1038
|
+
"label": "Data science",
|
|
1039
|
+
"title": "Data scientist and analyst",
|
|
1040
|
+
"group": "Data and AI",
|
|
1041
|
+
"icon": "ChartScatter",
|
|
1042
|
+
"tagline": "Analysis, experiments and models with honest statistics.",
|
|
1043
|
+
"ui": false,
|
|
1044
|
+
"skills": [
|
|
1045
|
+
"data-analysis",
|
|
1046
|
+
"ml-training"
|
|
1047
|
+
],
|
|
1048
|
+
"focus": [
|
|
1049
|
+
"State the question, the metric and the decision it informs. Inspect the data first: shape, missingness, leakage, time ordering.",
|
|
1050
|
+
"Use reproducible code (scripts or notebooks with pinned seeds and saved outputs). Report effect sizes with confidence intervals; use proper baselines and holdouts; avoid p-hacking.",
|
|
1051
|
+
"Every number in the summary must come from code that ran in this workspace. If data is missing, say so; never fabricate results.",
|
|
1052
|
+
"Save charts and a short findings report with limitations."
|
|
1053
|
+
],
|
|
1054
|
+
"done": [
|
|
1055
|
+
"Analysis code ran and produced the reported numbers",
|
|
1056
|
+
"Findings report with method and limitations",
|
|
1057
|
+
"Charts saved as files"
|
|
1058
|
+
],
|
|
1059
|
+
"gate": {
|
|
1060
|
+
"noMock": true,
|
|
1061
|
+
"artifacts": [
|
|
1062
|
+
{
|
|
1063
|
+
"label": "Analysis code or notebook",
|
|
1064
|
+
"globs": [
|
|
1065
|
+
"**/*.ipynb",
|
|
1066
|
+
"notebooks/**",
|
|
1067
|
+
"analysis/**",
|
|
1068
|
+
"**/*.py",
|
|
1069
|
+
"**/*.R",
|
|
1070
|
+
"**/*.sql"
|
|
1071
|
+
]
|
|
1072
|
+
},
|
|
1073
|
+
{
|
|
1074
|
+
"label": "Findings report or saved outputs",
|
|
1075
|
+
"globs": [
|
|
1076
|
+
"reports/**",
|
|
1077
|
+
"**/*report*",
|
|
1078
|
+
"**/*findings*",
|
|
1079
|
+
"**/*.md",
|
|
1080
|
+
"outputs/**",
|
|
1081
|
+
"results/**",
|
|
1082
|
+
"**/*.png",
|
|
1083
|
+
"**/*.csv"
|
|
1084
|
+
]
|
|
1085
|
+
}
|
|
1086
|
+
]
|
|
1087
|
+
},
|
|
1088
|
+
"phase1": "Phase 1 must be a reproducible exploratory analysis that answers the core question on the real data, with a short findings report.",
|
|
1089
|
+
"detect": {
|
|
1090
|
+
"keywords": {
|
|
1091
|
+
"data science": 5,
|
|
1092
|
+
"data scientist": 5,
|
|
1093
|
+
"analysis": 2,
|
|
1094
|
+
"analyze": 2,
|
|
1095
|
+
"analyse": 2,
|
|
1096
|
+
"analytics": 2,
|
|
1097
|
+
"statistics": 4,
|
|
1098
|
+
"a/b test": 5,
|
|
1099
|
+
"ab test": 4,
|
|
1100
|
+
"experiment results": 4,
|
|
1101
|
+
"regression analysis": 5,
|
|
1102
|
+
"forecast": 4,
|
|
1103
|
+
"notebook": 3,
|
|
1104
|
+
"pandas": 4,
|
|
1105
|
+
"jupyter": 4,
|
|
1106
|
+
"cohort": 3,
|
|
1107
|
+
"churn": 3,
|
|
1108
|
+
"insights": 2
|
|
1109
|
+
},
|
|
1110
|
+
"files": [
|
|
1111
|
+
"**/*.ipynb",
|
|
1112
|
+
"notebooks/**"
|
|
1113
|
+
]
|
|
1114
|
+
},
|
|
1115
|
+
"tools": [
|
|
1116
|
+
"Python: pandas, Polars, scikit-learn, statsmodels",
|
|
1117
|
+
"Jupyter and notebooks as scripts",
|
|
1118
|
+
"Plotly / matplotlib / seaborn",
|
|
1119
|
+
"SQL on the warehouse",
|
|
1120
|
+
"Experiment and power calculators",
|
|
1121
|
+
"Quarto or Markdown reports"
|
|
1122
|
+
],
|
|
1123
|
+
"decides": [
|
|
1124
|
+
"Question framing and success metric",
|
|
1125
|
+
"Statistical method and its assumptions",
|
|
1126
|
+
"Segmentation and exclusion rules",
|
|
1127
|
+
"What is a finding versus a hypothesis"
|
|
1128
|
+
]
|
|
1129
|
+
},
|
|
1130
|
+
{
|
|
1131
|
+
"id": "ml",
|
|
1132
|
+
"label": "ML engineering",
|
|
1133
|
+
"title": "Machine learning engineer",
|
|
1134
|
+
"group": "Data and AI",
|
|
1135
|
+
"icon": "BrainCircuit",
|
|
1136
|
+
"tagline": "Training, fine-tuning and evaluation that you can reproduce.",
|
|
1137
|
+
"ui": false,
|
|
1138
|
+
"skills": [
|
|
1139
|
+
"ml-training",
|
|
1140
|
+
"mlops-lifecycle",
|
|
1141
|
+
"docker-containers"
|
|
1142
|
+
],
|
|
1143
|
+
"focus": [
|
|
1144
|
+
"Define the task, metric and baseline before training. Split data without leakage and freeze an evaluation set.",
|
|
1145
|
+
"Write config-driven training (PyTorch, Hugging Face Transformers/TRL, PEFT/LoRA as fits) with seeds, checkpointing, mixed precision and logged metrics.",
|
|
1146
|
+
"Size compute honestly (params, sequence length, batch, memory). Without a GPU here, run a smoke test on a tiny subset on CPU and give the exact command and hardware for the full run.",
|
|
1147
|
+
"Report metrics from runs that actually happened, compared with the baseline, and save them to a file."
|
|
1148
|
+
],
|
|
1149
|
+
"done": [
|
|
1150
|
+
"Training and evaluation code is config-driven",
|
|
1151
|
+
"A smoke run passed and wrote metrics to a file",
|
|
1152
|
+
"Full-run command and hardware are specified"
|
|
1153
|
+
],
|
|
1154
|
+
"gate": {
|
|
1155
|
+
"noMock": true,
|
|
1156
|
+
"artifacts": [
|
|
1157
|
+
{
|
|
1158
|
+
"label": "Training or evaluation code",
|
|
1159
|
+
"globs": [
|
|
1160
|
+
"**/train*",
|
|
1161
|
+
"**/eval*",
|
|
1162
|
+
"**/finetune*",
|
|
1163
|
+
"**/fine_tune*",
|
|
1164
|
+
"**/sft*",
|
|
1165
|
+
"**/grpo*",
|
|
1166
|
+
"**/lora*",
|
|
1167
|
+
"configs/**",
|
|
1168
|
+
"**/*.yaml",
|
|
1169
|
+
"**/*.yml",
|
|
1170
|
+
"**/model*.py",
|
|
1171
|
+
"**/dataset*.py"
|
|
1172
|
+
]
|
|
1173
|
+
},
|
|
1174
|
+
{
|
|
1175
|
+
"label": "Recorded metrics or results",
|
|
1176
|
+
"globs": [
|
|
1177
|
+
"**/metrics*",
|
|
1178
|
+
"**/results*",
|
|
1179
|
+
"**/eval_results/**",
|
|
1180
|
+
"reports/**",
|
|
1181
|
+
"outputs/**",
|
|
1182
|
+
"runs/**",
|
|
1183
|
+
"**/*.jsonl"
|
|
1184
|
+
]
|
|
1185
|
+
}
|
|
1186
|
+
]
|
|
1187
|
+
},
|
|
1188
|
+
"phase1": "Phase 1 must be a baseline evaluation plus a config-driven training script that passes a smoke run on a tiny subset and writes metrics to a file.",
|
|
1189
|
+
"detect": {
|
|
1190
|
+
"keywords": {
|
|
1191
|
+
"machine learning": 5,
|
|
1192
|
+
"ml model": 5,
|
|
1193
|
+
"train a model": 5,
|
|
1194
|
+
"training": 3,
|
|
1195
|
+
"fine-tune": 5,
|
|
1196
|
+
"fine tune": 5,
|
|
1197
|
+
"finetune": 5,
|
|
1198
|
+
"lora": 5,
|
|
1199
|
+
"qlora": 5,
|
|
1200
|
+
"sft": 4,
|
|
1201
|
+
"rlhf": 5,
|
|
1202
|
+
"grpo": 5,
|
|
1203
|
+
"dpo": 4,
|
|
1204
|
+
"pytorch": 5,
|
|
1205
|
+
"tensorflow": 5,
|
|
1206
|
+
"jax": 4,
|
|
1207
|
+
"transformers": 3,
|
|
1208
|
+
"hugging face": 3,
|
|
1209
|
+
"huggingface": 3,
|
|
1210
|
+
"classifier": 3,
|
|
1211
|
+
"embedding model": 3,
|
|
1212
|
+
"distillation": 4,
|
|
1213
|
+
"weights": 2,
|
|
1214
|
+
"gpu": 3,
|
|
1215
|
+
"cuda": 4,
|
|
1216
|
+
"dataset": 2,
|
|
1217
|
+
"benchmark": 2
|
|
1218
|
+
},
|
|
1219
|
+
"files": [
|
|
1220
|
+
"**/train.py",
|
|
1221
|
+
"**/*.ckpt",
|
|
1222
|
+
"**/*.safetensors",
|
|
1223
|
+
"requirements-train.txt"
|
|
1224
|
+
]
|
|
1225
|
+
},
|
|
1226
|
+
"tools": [
|
|
1227
|
+
"PyTorch, Transformers, TRL, PEFT/LoRA",
|
|
1228
|
+
"Weights & Biases or MLflow",
|
|
1229
|
+
"Hugging Face Hub and datasets",
|
|
1230
|
+
"vLLM / TGI for serving checks",
|
|
1231
|
+
"Evaluation harnesses (lm-eval, custom evals)",
|
|
1232
|
+
"GPU runtimes (CUDA, Modal, RunPod, Lambda)"
|
|
1233
|
+
],
|
|
1234
|
+
"decides": [
|
|
1235
|
+
"Model family, size and training recipe",
|
|
1236
|
+
"Data splits, leakage checks and eval set",
|
|
1237
|
+
"Metric that counts and the baseline",
|
|
1238
|
+
"When a checkpoint is good enough to ship"
|
|
1239
|
+
]
|
|
1240
|
+
},
|
|
1241
|
+
{
|
|
1242
|
+
"id": "mlops",
|
|
1243
|
+
"label": "MLOps",
|
|
1244
|
+
"title": "MLOps engineer",
|
|
1245
|
+
"group": "Data and AI",
|
|
1246
|
+
"icon": "Workflow",
|
|
1247
|
+
"tagline": "Model pipelines, registries, serving and drift monitoring.",
|
|
1248
|
+
"ui": false,
|
|
1249
|
+
"skills": [
|
|
1250
|
+
"mlops-lifecycle",
|
|
1251
|
+
"docker-containers",
|
|
1252
|
+
"kubernetes-deploy",
|
|
1253
|
+
"github-actions-ci",
|
|
1254
|
+
"observability-otel"
|
|
1255
|
+
],
|
|
1256
|
+
"focus": [
|
|
1257
|
+
"Make the model lifecycle reproducible: versioned data (DVC/lakeFS), tracked experiments (MLflow/W&B), a model registry with stages, and CI that retrains or evaluates on change.",
|
|
1258
|
+
"Serve with the right engine (vLLM/TGI/Triton/BentoML/FastAPI), containerised, with health checks, batching, autoscaling and GPU requests set explicitly.",
|
|
1259
|
+
"Gate promotion on evaluation thresholds; monitor latency, throughput, cost, data and prediction drift; support shadow or canary rollouts with rollback.",
|
|
1260
|
+
"Validate configs and containers locally; never push to production registries or clusters without approval."
|
|
1261
|
+
],
|
|
1262
|
+
"done": [
|
|
1263
|
+
"Pipeline, registry or serving config committed as code",
|
|
1264
|
+
"Container or pipeline validated locally",
|
|
1265
|
+
"Promotion gate and monitoring defined"
|
|
1266
|
+
],
|
|
1267
|
+
"gate": {
|
|
1268
|
+
"noMock": false,
|
|
1269
|
+
"artifacts": [
|
|
1270
|
+
{
|
|
1271
|
+
"label": "ML pipeline, registry or serving config",
|
|
1272
|
+
"globs": [
|
|
1273
|
+
"MLproject",
|
|
1274
|
+
"dvc.yaml",
|
|
1275
|
+
"**/mlflow*",
|
|
1276
|
+
"serving/**",
|
|
1277
|
+
"**/serve*",
|
|
1278
|
+
"**/inference*",
|
|
1279
|
+
"bentofile.yaml",
|
|
1280
|
+
"**/model-registry*",
|
|
1281
|
+
"pipelines/**",
|
|
1282
|
+
"**/kserve*",
|
|
1283
|
+
"**/triton*",
|
|
1284
|
+
"**/vllm*",
|
|
1285
|
+
"Dockerfile",
|
|
1286
|
+
"**/Dockerfile*",
|
|
1287
|
+
"docker-compose*.y*ml",
|
|
1288
|
+
"compose*.y*ml",
|
|
1289
|
+
".github/workflows/**",
|
|
1290
|
+
".gitlab-ci.yml",
|
|
1291
|
+
".circleci/**",
|
|
1292
|
+
"**/*.tf",
|
|
1293
|
+
"**/*.tfvars",
|
|
1294
|
+
"k8s/**",
|
|
1295
|
+
"kubernetes/**",
|
|
1296
|
+
"helm/**",
|
|
1297
|
+
"charts/**",
|
|
1298
|
+
"deploy/**",
|
|
1299
|
+
"infra/**",
|
|
1300
|
+
"ansible/**",
|
|
1301
|
+
"Makefile",
|
|
1302
|
+
"vercel.json",
|
|
1303
|
+
"fly.toml",
|
|
1304
|
+
"render.yaml",
|
|
1305
|
+
"Procfile",
|
|
1306
|
+
"skaffold.yaml",
|
|
1307
|
+
"kustomization.yaml",
|
|
1308
|
+
"pulumi/**",
|
|
1309
|
+
"cdk/**",
|
|
1310
|
+
"**/*.Pulumi.yaml"
|
|
1311
|
+
]
|
|
1312
|
+
}
|
|
1313
|
+
]
|
|
1314
|
+
},
|
|
1315
|
+
"phase1": "Phase 1 must be a reproducible train-evaluate-register pipeline with the model served from a container behind a health check, validated locally.",
|
|
1316
|
+
"detect": {
|
|
1317
|
+
"keywords": {
|
|
1318
|
+
"mlops": 6,
|
|
1319
|
+
"model serving": 5,
|
|
1320
|
+
"serve the model": 5,
|
|
1321
|
+
"inference server": 5,
|
|
1322
|
+
"vllm": 5,
|
|
1323
|
+
"tgi": 4,
|
|
1324
|
+
"triton": 5,
|
|
1325
|
+
"bentoml": 5,
|
|
1326
|
+
"kserve": 5,
|
|
1327
|
+
"mlflow": 5,
|
|
1328
|
+
"weights and biases": 4,
|
|
1329
|
+
"wandb": 4,
|
|
1330
|
+
"model registry": 5,
|
|
1331
|
+
"feature store": 5,
|
|
1332
|
+
"drift": 4,
|
|
1333
|
+
"model monitoring": 5,
|
|
1334
|
+
"dvc": 5,
|
|
1335
|
+
"kubeflow": 5,
|
|
1336
|
+
"sagemaker": 5,
|
|
1337
|
+
"vertex ai": 5,
|
|
1338
|
+
"retraining": 4
|
|
1339
|
+
},
|
|
1340
|
+
"files": [
|
|
1341
|
+
"MLproject",
|
|
1342
|
+
"dvc.yaml",
|
|
1343
|
+
"bentofile.yaml"
|
|
1344
|
+
]
|
|
1345
|
+
},
|
|
1346
|
+
"tools": [
|
|
1347
|
+
"MLflow or W&B model registry",
|
|
1348
|
+
"DVC / LakeFS for data versioning",
|
|
1349
|
+
"vLLM, Triton, BentoML, KServe",
|
|
1350
|
+
"Kubernetes and GPU autoscaling",
|
|
1351
|
+
"Evidently / WhyLabs for drift",
|
|
1352
|
+
"GitHub Actions for training and promotion pipelines"
|
|
1353
|
+
],
|
|
1354
|
+
"decides": [
|
|
1355
|
+
"Promotion gates between stages",
|
|
1356
|
+
"Serving architecture and rollout (canary, shadow)",
|
|
1357
|
+
"Monitoring signals and retrain triggers",
|
|
1358
|
+
"Cost and latency budgets per model"
|
|
1359
|
+
]
|
|
1360
|
+
},
|
|
1361
|
+
{
|
|
1362
|
+
"id": "ai-eng",
|
|
1363
|
+
"label": "AI engineering",
|
|
1364
|
+
"title": "AI engineer",
|
|
1365
|
+
"group": "Data and AI",
|
|
1366
|
+
"icon": "Bot",
|
|
1367
|
+
"tagline": "LLM features, RAG, agents and evals that hold up in production.",
|
|
1368
|
+
"ui": false,
|
|
1369
|
+
"skills": [
|
|
1370
|
+
"llm-rag-agents",
|
|
1371
|
+
"ai-features",
|
|
1372
|
+
"secrets-and-env",
|
|
1373
|
+
"observability-otel"
|
|
1374
|
+
],
|
|
1375
|
+
"focus": [
|
|
1376
|
+
"Call real model APIs from the server with keys from the environment; stream responses; handle rate limits, timeouts and retries; cap tokens and cost per request.",
|
|
1377
|
+
"For retrieval: chunk with structure, embed, store in a real vector index (pgvector or the project's store), retrieve with filters, cite sources, and handle no-answer cases.",
|
|
1378
|
+
"For agents: typed tool schemas, step limits, human approval for risky actions, and full traces of prompts, tool calls and outputs.",
|
|
1379
|
+
"Build an evaluation set (golden questions with expected answers or rubrics) and run it; report accuracy, latency and cost. Never hardcode fake model replies outside tests."
|
|
1380
|
+
],
|
|
1381
|
+
"done": [
|
|
1382
|
+
"Real model calls go through the server with keys from env",
|
|
1383
|
+
"An evaluation set ran and its scores are reported",
|
|
1384
|
+
"Traces or logs capture prompts and tool calls"
|
|
1385
|
+
],
|
|
1386
|
+
"gate": {
|
|
1387
|
+
"noMock": true,
|
|
1388
|
+
"artifacts": [
|
|
1389
|
+
{
|
|
1390
|
+
"label": "Evaluation set or tests",
|
|
1391
|
+
"globs": [
|
|
1392
|
+
"evals/**",
|
|
1393
|
+
"eval/**",
|
|
1394
|
+
"**/eval*",
|
|
1395
|
+
"**/golden*",
|
|
1396
|
+
"**/*.jsonl",
|
|
1397
|
+
"tests/**",
|
|
1398
|
+
"test/**",
|
|
1399
|
+
"**/__tests__/**",
|
|
1400
|
+
"**/*.test.*",
|
|
1401
|
+
"**/*.spec.*",
|
|
1402
|
+
"**/test_*.py",
|
|
1403
|
+
"**/*_test.py",
|
|
1404
|
+
"**/*_test.go",
|
|
1405
|
+
"**/*Test.java",
|
|
1406
|
+
"**/*_spec.rb",
|
|
1407
|
+
"e2e/**",
|
|
1408
|
+
"spec/**"
|
|
1409
|
+
]
|
|
1410
|
+
}
|
|
1411
|
+
]
|
|
1412
|
+
},
|
|
1413
|
+
"phase1": "Phase 1 must be a working LLM feature calling a real model through the server, with a small evaluation set that runs and reports scores.",
|
|
1414
|
+
"detect": {
|
|
1415
|
+
"keywords": {
|
|
1416
|
+
"ai engineer": 6,
|
|
1417
|
+
"llm": 5,
|
|
1418
|
+
"rag": 5,
|
|
1419
|
+
"retrieval": 3,
|
|
1420
|
+
"vector": 3,
|
|
1421
|
+
"embeddings": 4,
|
|
1422
|
+
"pgvector": 5,
|
|
1423
|
+
"chatbot": 4,
|
|
1424
|
+
"chat bot": 4,
|
|
1425
|
+
"agent": 3,
|
|
1426
|
+
"agents": 3,
|
|
1427
|
+
"agentic": 4,
|
|
1428
|
+
"prompt": 2,
|
|
1429
|
+
"openai": 4,
|
|
1430
|
+
"anthropic": 4,
|
|
1431
|
+
"claude": 3,
|
|
1432
|
+
"gpt": 3,
|
|
1433
|
+
"gemini": 3,
|
|
1434
|
+
"langchain": 5,
|
|
1435
|
+
"llamaindex": 5,
|
|
1436
|
+
"mcp server": 4,
|
|
1437
|
+
"tool calling": 4,
|
|
1438
|
+
"function calling": 4,
|
|
1439
|
+
"evals": 4,
|
|
1440
|
+
"copilot": 3
|
|
1441
|
+
},
|
|
1442
|
+
"files": [
|
|
1443
|
+
"evals/**",
|
|
1444
|
+
"**/prompts/**"
|
|
1445
|
+
]
|
|
1446
|
+
},
|
|
1447
|
+
"tools": [
|
|
1448
|
+
"Vercel AI SDK, OpenAI / Anthropic / OpenRouter SDKs",
|
|
1449
|
+
"pgvector, Pinecone, Qdrant, Weaviate",
|
|
1450
|
+
"LangGraph / custom agent loops",
|
|
1451
|
+
"promptfoo, Braintrust, LangSmith",
|
|
1452
|
+
"Structured outputs with zod / pydantic",
|
|
1453
|
+
"Streaming UIs and tool-calling"
|
|
1454
|
+
],
|
|
1455
|
+
"decides": [
|
|
1456
|
+
"Model and provider per task with fallbacks",
|
|
1457
|
+
"Retrieval strategy, chunking and citations",
|
|
1458
|
+
"Tool boundaries and what the agent may do alone",
|
|
1459
|
+
"Eval set and quality bar before launch"
|
|
1460
|
+
]
|
|
1461
|
+
},
|
|
1462
|
+
{
|
|
1463
|
+
"id": "aiops",
|
|
1464
|
+
"label": "AIOps",
|
|
1465
|
+
"title": "AIOps engineer",
|
|
1466
|
+
"group": "Data and AI",
|
|
1467
|
+
"icon": "Radar",
|
|
1468
|
+
"tagline": "Anomaly detection, alert correlation and safe auto-remediation.",
|
|
1469
|
+
"ui": false,
|
|
1470
|
+
"skills": [
|
|
1471
|
+
"aiops-automation",
|
|
1472
|
+
"observability-otel",
|
|
1473
|
+
"sre-reliability"
|
|
1474
|
+
],
|
|
1475
|
+
"focus": [
|
|
1476
|
+
"Ingest real telemetry (metrics, logs, traces, events) through existing collectors; normalise and enrich with service and deploy metadata.",
|
|
1477
|
+
"Detect anomalies with methods you can explain (seasonal baselines, robust z-scores, change-point detection) before reaching for ML; correlate alerts into incidents by topology and time.",
|
|
1478
|
+
"Automate remediation as runbooks with dry-run mode, blast-radius limits and human approval for anything destructive; log every automated action.",
|
|
1479
|
+
"Evaluate on replayed historical incidents: precision, recall, time to detect, alert noise reduction."
|
|
1480
|
+
],
|
|
1481
|
+
"done": [
|
|
1482
|
+
"Detection or correlation runs on replayed real or fixture telemetry",
|
|
1483
|
+
"Precision/recall or noise reduction reported",
|
|
1484
|
+
"Remediation is approval-gated with dry run"
|
|
1485
|
+
],
|
|
1486
|
+
"gate": {
|
|
1487
|
+
"noMock": true,
|
|
1488
|
+
"artifacts": [
|
|
1489
|
+
{
|
|
1490
|
+
"label": "Detection, correlation or remediation code",
|
|
1491
|
+
"globs": [
|
|
1492
|
+
"aiops/**",
|
|
1493
|
+
"**/detect*",
|
|
1494
|
+
"**/anomal*",
|
|
1495
|
+
"**/correlat*",
|
|
1496
|
+
"**/remediat*",
|
|
1497
|
+
"**/runbooks/**",
|
|
1498
|
+
"**/alerts/**"
|
|
1499
|
+
]
|
|
1500
|
+
},
|
|
1501
|
+
{
|
|
1502
|
+
"label": "Replay tests or evaluation",
|
|
1503
|
+
"globs": [
|
|
1504
|
+
"tests/**",
|
|
1505
|
+
"test/**",
|
|
1506
|
+
"**/__tests__/**",
|
|
1507
|
+
"**/*.test.*",
|
|
1508
|
+
"**/*.spec.*",
|
|
1509
|
+
"**/test_*.py",
|
|
1510
|
+
"**/*_test.py",
|
|
1511
|
+
"**/*_test.go",
|
|
1512
|
+
"**/*Test.java",
|
|
1513
|
+
"**/*_spec.rb",
|
|
1514
|
+
"e2e/**",
|
|
1515
|
+
"spec/**",
|
|
1516
|
+
"**/replay*",
|
|
1517
|
+
"**/fixtures/**"
|
|
1518
|
+
]
|
|
1519
|
+
}
|
|
1520
|
+
]
|
|
1521
|
+
},
|
|
1522
|
+
"phase1": "Phase 1 must detect anomalies on replayed telemetry for one service and report precision, recall and noise reduction against labelled incidents.",
|
|
1523
|
+
"detect": {
|
|
1524
|
+
"keywords": {
|
|
1525
|
+
"aiops": 6,
|
|
1526
|
+
"anomaly detection": 5,
|
|
1527
|
+
"anomaly": 3,
|
|
1528
|
+
"alert fatigue": 5,
|
|
1529
|
+
"alert noise": 5,
|
|
1530
|
+
"root cause analysis": 5,
|
|
1531
|
+
"rca": 4,
|
|
1532
|
+
"auto-remediation": 5,
|
|
1533
|
+
"auto remediation": 5,
|
|
1534
|
+
"auto-remediate": 5,
|
|
1535
|
+
"remediate": 3,
|
|
1536
|
+
"remediation": 3,
|
|
1537
|
+
"anomalies": 3,
|
|
1538
|
+
"self-heal": 5,
|
|
1539
|
+
"self-healing": 5,
|
|
1540
|
+
"incident correlation": 5,
|
|
1541
|
+
"log analysis": 4,
|
|
1542
|
+
"pagerduty": 4,
|
|
1543
|
+
"datadog": 4,
|
|
1544
|
+
"splunk": 4,
|
|
1545
|
+
"elk": 3
|
|
1546
|
+
},
|
|
1547
|
+
"files": []
|
|
1548
|
+
},
|
|
1549
|
+
"tools": [
|
|
1550
|
+
"Prometheus, Datadog, Elastic for telemetry",
|
|
1551
|
+
"Anomaly detection (Prophet, isolation forest, seasonal baselines)",
|
|
1552
|
+
"Alert routers (Alertmanager, PagerDuty)",
|
|
1553
|
+
"Runbook automation (Rundeck, Ansible, StackStorm)",
|
|
1554
|
+
"Incident timelines and correlation stores"
|
|
1555
|
+
],
|
|
1556
|
+
"decides": [
|
|
1557
|
+
"Detection sensitivity versus noise",
|
|
1558
|
+
"Correlation rules that group alerts into incidents",
|
|
1559
|
+
"Which remediations run automatically and which need approval",
|
|
1560
|
+
"Audit trail and rollback for every action"
|
|
1561
|
+
]
|
|
1562
|
+
},
|
|
1563
|
+
{
|
|
1564
|
+
"id": "architect",
|
|
1565
|
+
"label": "Architect",
|
|
1566
|
+
"title": "Tech lead and architect",
|
|
1567
|
+
"group": "Leadership",
|
|
1568
|
+
"icon": "Compass",
|
|
1569
|
+
"tagline": "System design, ADRs, trade-offs and migration plans.",
|
|
1570
|
+
"ui": false,
|
|
1571
|
+
"skills": [
|
|
1572
|
+
"architecture-adr",
|
|
1573
|
+
"backend-api",
|
|
1574
|
+
"sre-reliability"
|
|
1575
|
+
],
|
|
1576
|
+
"focus": [
|
|
1577
|
+
"Clarify requirements and constraints (scale, latency, consistency, cost, team skills, compliance) and write them down as assumptions.",
|
|
1578
|
+
"Compare at least two options with explicit trade-offs; choose one and record it as an ADR. Describe components, data flows and failure modes (C4 context and container level, as Mermaid when useful).",
|
|
1579
|
+
"Plan delivery in reversible increments with migration and rollback steps, and identify the riskiest assumption to prove first.",
|
|
1580
|
+
"Ground every claim about the current system in files you read; cite them."
|
|
1581
|
+
],
|
|
1582
|
+
"done": [
|
|
1583
|
+
"Design doc or ADR committed",
|
|
1584
|
+
"Options and trade-offs compared",
|
|
1585
|
+
"Phased delivery plan with risks"
|
|
1586
|
+
],
|
|
1587
|
+
"gate": {
|
|
1588
|
+
"noMock": false,
|
|
1589
|
+
"artifacts": [
|
|
1590
|
+
{
|
|
1591
|
+
"label": "Design doc or ADR",
|
|
1592
|
+
"globs": [
|
|
1593
|
+
"docs/adr/**",
|
|
1594
|
+
"adr/**",
|
|
1595
|
+
"**/ADR*",
|
|
1596
|
+
"ARCHITECTURE.md",
|
|
1597
|
+
"docs/architecture/**",
|
|
1598
|
+
"DESIGN.md",
|
|
1599
|
+
"docs/design/**",
|
|
1600
|
+
"PLAN.md",
|
|
1601
|
+
"**/RFC*",
|
|
1602
|
+
"docs/rfcs/**"
|
|
1603
|
+
]
|
|
1604
|
+
}
|
|
1605
|
+
]
|
|
1606
|
+
},
|
|
1607
|
+
"phase1": "Phase 1 must be a decision-ready design doc: requirements, options with trade-offs, the chosen architecture as an ADR, and the riskiest assumption proven with a spike.",
|
|
1608
|
+
"detect": {
|
|
1609
|
+
"keywords": {
|
|
1610
|
+
"architecture": 4,
|
|
1611
|
+
"architect": 5,
|
|
1612
|
+
"system design": 5,
|
|
1613
|
+
"design doc": 5,
|
|
1614
|
+
"adr": 5,
|
|
1615
|
+
"rfc": 4,
|
|
1616
|
+
"trade-off": 3,
|
|
1617
|
+
"tradeoffs": 3,
|
|
1618
|
+
"scalability": 3,
|
|
1619
|
+
"migration plan": 4,
|
|
1620
|
+
"monolith": 3,
|
|
1621
|
+
"tech lead": 5,
|
|
1622
|
+
"technical strategy": 4
|
|
1623
|
+
},
|
|
1624
|
+
"files": [
|
|
1625
|
+
"docs/adr/**",
|
|
1626
|
+
"ARCHITECTURE.md"
|
|
1627
|
+
]
|
|
1628
|
+
},
|
|
1629
|
+
"tools": [
|
|
1630
|
+
"ADR templates and docs/adr",
|
|
1631
|
+
"C4 / Mermaid / Structurizr diagrams",
|
|
1632
|
+
"Spikes and prototypes",
|
|
1633
|
+
"Load models and cost calculators",
|
|
1634
|
+
"RFC review process",
|
|
1635
|
+
"Dependency and module boundary analysis"
|
|
1636
|
+
],
|
|
1637
|
+
"decides": [
|
|
1638
|
+
"System boundaries and integration contracts",
|
|
1639
|
+
"Build versus buy and technology choices",
|
|
1640
|
+
"Consistency, availability and cost trade-offs",
|
|
1641
|
+
"Migration phases and the riskiest assumption to prove first"
|
|
1642
|
+
]
|
|
1643
|
+
},
|
|
1644
|
+
{
|
|
1645
|
+
"id": "design-eng",
|
|
1646
|
+
"label": "Design eng",
|
|
1647
|
+
"title": "Design engineer",
|
|
1648
|
+
"group": "Product",
|
|
1649
|
+
"icon": "PenTool",
|
|
1650
|
+
"tagline": "Design systems, motion and the final 10% of polish that makes a product feel finished.",
|
|
1651
|
+
"ui": true,
|
|
1652
|
+
"skills": [
|
|
1653
|
+
"design-engineering-motion",
|
|
1654
|
+
"ui-shadcn-tailwind",
|
|
1655
|
+
"accessibility-wcag",
|
|
1656
|
+
"e2e-playwright"
|
|
1657
|
+
],
|
|
1658
|
+
"focus": [
|
|
1659
|
+
"Start from tokens: colour, type scale, spacing, radius and shadows as variables with semantic names, light and dark values. Reuse the existing primitives before adding new ones.",
|
|
1660
|
+
"Every component gets its full state set (default, hover, focus, active, disabled, loading, empty, error) and lives in Storybook or an internal design route.",
|
|
1661
|
+
"Motion is purposeful and short (120 to 400 ms), uses standard easing, respects prefers-reduced-motion and never loops forever.",
|
|
1662
|
+
"Finish pass before done: grid alignment, consistent icon sizes, tabular numerals, 44 px touch targets, focus rings, checked at 360, 768 and 1280 px and in dark mode."
|
|
1663
|
+
],
|
|
1664
|
+
"done": [
|
|
1665
|
+
"Tokens and components are consistent across the touched screens",
|
|
1666
|
+
"All interactive states exist and are keyboard reachable",
|
|
1667
|
+
"Screenshots at mobile, tablet and desktop widths in light and dark"
|
|
1668
|
+
],
|
|
1669
|
+
"gate": {
|
|
1670
|
+
"noMock": false,
|
|
1671
|
+
"artifacts": []
|
|
1672
|
+
},
|
|
1673
|
+
"phase1": "Phase 1 must be the token layer plus the core components with every state, visible in a Storybook or a design route the user can open.",
|
|
1674
|
+
"detect": {
|
|
1675
|
+
"keywords": {
|
|
1676
|
+
"design system": 6,
|
|
1677
|
+
"design tokens": 6,
|
|
1678
|
+
"storybook": 5,
|
|
1679
|
+
"micro-interaction": 5,
|
|
1680
|
+
"micro interactions": 5,
|
|
1681
|
+
"motion design": 5,
|
|
1682
|
+
"animation": 3,
|
|
1683
|
+
"animations": 3,
|
|
1684
|
+
"polish the ui": 5,
|
|
1685
|
+
"polish": 2,
|
|
1686
|
+
"pixel perfect": 5,
|
|
1687
|
+
"dark mode": 3,
|
|
1688
|
+
"theme": 2,
|
|
1689
|
+
"typography": 3,
|
|
1690
|
+
"brand refresh": 4,
|
|
1691
|
+
"design engineer": 6
|
|
1692
|
+
},
|
|
1693
|
+
"files": [
|
|
1694
|
+
".storybook/**",
|
|
1695
|
+
"**/*.stories.*",
|
|
1696
|
+
"tokens.json",
|
|
1697
|
+
"design-tokens/**"
|
|
1698
|
+
]
|
|
1699
|
+
},
|
|
1700
|
+
"tools": [
|
|
1701
|
+
"Figma (reading specs and tokens)",
|
|
1702
|
+
"Tailwind and CSS variables",
|
|
1703
|
+
"Storybook and Chromatic",
|
|
1704
|
+
"Framer Motion / CSS animations",
|
|
1705
|
+
"Radix or shadcn primitives",
|
|
1706
|
+
"Playwright screenshots and axe-core"
|
|
1707
|
+
],
|
|
1708
|
+
"decides": [
|
|
1709
|
+
"Token names and theming model",
|
|
1710
|
+
"Component API and variants",
|
|
1711
|
+
"Motion durations, easing and when not to animate",
|
|
1712
|
+
"What counts as finished"
|
|
1713
|
+
]
|
|
1714
|
+
},
|
|
1715
|
+
{
|
|
1716
|
+
"id": "api",
|
|
1717
|
+
"label": "API",
|
|
1718
|
+
"title": "API and integrations engineer",
|
|
1719
|
+
"group": "Product",
|
|
1720
|
+
"icon": "Plug",
|
|
1721
|
+
"tagline": "Public APIs, SDKs, webhooks and third-party integrations with a written contract.",
|
|
1722
|
+
"ui": false,
|
|
1723
|
+
"skills": [
|
|
1724
|
+
"api-design-openapi",
|
|
1725
|
+
"backend-api",
|
|
1726
|
+
"secrets-and-env",
|
|
1727
|
+
"qa-automation"
|
|
1728
|
+
],
|
|
1729
|
+
"focus": [
|
|
1730
|
+
"Contract first: OpenAPI or GraphQL schema before handlers, with resources, pagination, idempotency keys, error shape and versioning written down.",
|
|
1731
|
+
"Integrations are resilient: signed webhooks, retries with backoff, dead-letter handling, rate-limit awareness and sandbox credentials from the Vault.",
|
|
1732
|
+
"Generate clients and types from the contract instead of hand-writing them; keep a contract test that proves routes match the spec.",
|
|
1733
|
+
"Document every endpoint with a working curl example and ship a changelog entry for breaking changes."
|
|
1734
|
+
],
|
|
1735
|
+
"done": [
|
|
1736
|
+
"openapi.yaml (or schema) matches the implemented routes",
|
|
1737
|
+
"Webhooks are signature-verified and idempotent",
|
|
1738
|
+
"Contract and API tests pass against the current code"
|
|
1739
|
+
],
|
|
1740
|
+
"gate": {
|
|
1741
|
+
"noMock": true,
|
|
1742
|
+
"artifacts": [
|
|
1743
|
+
{
|
|
1744
|
+
"label": "API contract",
|
|
1745
|
+
"globs": [
|
|
1746
|
+
"openapi.*",
|
|
1747
|
+
"**/openapi.*",
|
|
1748
|
+
"swagger.*",
|
|
1749
|
+
"**/schema.graphql",
|
|
1750
|
+
"**/*.graphql",
|
|
1751
|
+
"api/**/*.yaml",
|
|
1752
|
+
"docs/api/**"
|
|
1753
|
+
]
|
|
1754
|
+
},
|
|
1755
|
+
{
|
|
1756
|
+
"label": "Automated tests",
|
|
1757
|
+
"globs": [
|
|
1758
|
+
"tests/**",
|
|
1759
|
+
"test/**",
|
|
1760
|
+
"**/__tests__/**",
|
|
1761
|
+
"**/*.test.*",
|
|
1762
|
+
"**/*.spec.*",
|
|
1763
|
+
"**/test_*.py",
|
|
1764
|
+
"**/*_test.py",
|
|
1765
|
+
"**/*_test.go",
|
|
1766
|
+
"e2e/**",
|
|
1767
|
+
"spec/**"
|
|
1768
|
+
]
|
|
1769
|
+
}
|
|
1770
|
+
]
|
|
1771
|
+
},
|
|
1772
|
+
"phase1": "Phase 1 must be the contract (OpenAPI or schema) plus the first real endpoints implemented against it, with a contract test and one working integration.",
|
|
1773
|
+
"detect": {
|
|
1774
|
+
"keywords": {
|
|
1775
|
+
"openapi": 6,
|
|
1776
|
+
"swagger": 6,
|
|
1777
|
+
"api design": 5,
|
|
1778
|
+
"public api": 6,
|
|
1779
|
+
"sdk": 4,
|
|
1780
|
+
"webhooks": 4,
|
|
1781
|
+
"webhook": 4,
|
|
1782
|
+
"integration": 3,
|
|
1783
|
+
"integrations": 3,
|
|
1784
|
+
"third-party api": 5,
|
|
1785
|
+
"third party api": 5,
|
|
1786
|
+
"connect to the": 1,
|
|
1787
|
+
"api contract": 6,
|
|
1788
|
+
"graphql schema": 5,
|
|
1789
|
+
"rate limiting": 3,
|
|
1790
|
+
"api versioning": 6,
|
|
1791
|
+
"oauth app": 4,
|
|
1792
|
+
"zapier": 4,
|
|
1793
|
+
"slack app": 4,
|
|
1794
|
+
"shopify app": 4
|
|
1795
|
+
},
|
|
1796
|
+
"files": [
|
|
1797
|
+
"openapi.*",
|
|
1798
|
+
"swagger.*",
|
|
1799
|
+
"**/schema.graphql"
|
|
1800
|
+
]
|
|
1801
|
+
},
|
|
1802
|
+
"tools": [
|
|
1803
|
+
"OpenAPI / Swagger editors and openapi-typescript, orval",
|
|
1804
|
+
"zod / pydantic validation",
|
|
1805
|
+
"Postman, Bruno, httpie",
|
|
1806
|
+
"ngrok or Hookdeck for webhook testing",
|
|
1807
|
+
"Pact for contract tests",
|
|
1808
|
+
"Sandbox accounts for Stripe, Slack, Shopify and similar"
|
|
1809
|
+
],
|
|
1810
|
+
"decides": [
|
|
1811
|
+
"Resource model, naming and versioning",
|
|
1812
|
+
"Auth scheme and scopes",
|
|
1813
|
+
"Rate limits, pagination and idempotency",
|
|
1814
|
+
"Compatibility policy for breaking changes"
|
|
1815
|
+
]
|
|
1816
|
+
},
|
|
1817
|
+
{
|
|
1818
|
+
"id": "desktop",
|
|
1819
|
+
"label": "Desktop",
|
|
1820
|
+
"title": "Desktop app engineer",
|
|
1821
|
+
"group": "Product",
|
|
1822
|
+
"icon": "Monitor",
|
|
1823
|
+
"tagline": "Electron and Tauri apps with native menus, file access, auto-update and installers.",
|
|
1824
|
+
"ui": true,
|
|
1825
|
+
"skills": [
|
|
1826
|
+
"desktop-electron-tauri",
|
|
1827
|
+
"ui-shadcn-tailwind",
|
|
1828
|
+
"secrets-and-env",
|
|
1829
|
+
"e2e-playwright"
|
|
1830
|
+
],
|
|
1831
|
+
"focus": [
|
|
1832
|
+
"Choose Tauri 2 by default for small secure binaries; Electron when Node APIs or Chromium parity are required. Never introduce a second shell.",
|
|
1833
|
+
"Keep privileged work in the main/Rust side behind a narrow typed IPC; contextIsolation on, nodeIntegration off, capabilities scoped per window.",
|
|
1834
|
+
"Deliver the desktop basics: native menu with shortcuts, window state persistence, file dialogs, tray or dock behaviour, deep links, graceful quit.",
|
|
1835
|
+
"Build config and signing live in the repo without certificates; prove the app packages with a real build command."
|
|
1836
|
+
],
|
|
1837
|
+
"done": [
|
|
1838
|
+
"App runs in dev and a production build packages",
|
|
1839
|
+
"IPC surface is narrow, typed and tested",
|
|
1840
|
+
"Menus, shortcuts and file dialogs work"
|
|
1841
|
+
],
|
|
1842
|
+
"gate": {
|
|
1843
|
+
"noMock": false,
|
|
1844
|
+
"artifacts": [
|
|
1845
|
+
{
|
|
1846
|
+
"label": "Desktop shell config",
|
|
1847
|
+
"globs": [
|
|
1848
|
+
"src-tauri/**",
|
|
1849
|
+
"tauri.conf.json",
|
|
1850
|
+
"electron/**",
|
|
1851
|
+
"electron-builder.*",
|
|
1852
|
+
"forge.config.*",
|
|
1853
|
+
"main/**",
|
|
1854
|
+
"**/main.ts",
|
|
1855
|
+
"**/preload.ts"
|
|
1856
|
+
]
|
|
1857
|
+
}
|
|
1858
|
+
]
|
|
1859
|
+
},
|
|
1860
|
+
"phase1": "Phase 1 must be the desktop shell running with the main window, native menu, one real IPC command and a packaged build.",
|
|
1861
|
+
"detect": {
|
|
1862
|
+
"keywords": {
|
|
1863
|
+
"electron": 6,
|
|
1864
|
+
"tauri": 6,
|
|
1865
|
+
"desktop app": 6,
|
|
1866
|
+
"desktop application": 6,
|
|
1867
|
+
"menu bar app": 6,
|
|
1868
|
+
"menubar app": 6,
|
|
1869
|
+
"tray app": 5,
|
|
1870
|
+
"mac app": 4,
|
|
1871
|
+
"windows app": 4,
|
|
1872
|
+
"native desktop": 5,
|
|
1873
|
+
"installer": 3,
|
|
1874
|
+
"dmg": 3,
|
|
1875
|
+
"msi": 3
|
|
1876
|
+
},
|
|
1877
|
+
"files": [
|
|
1878
|
+
"src-tauri/**",
|
|
1879
|
+
"tauri.conf.json",
|
|
1880
|
+
"electron-builder.*",
|
|
1881
|
+
"forge.config.*"
|
|
1882
|
+
]
|
|
1883
|
+
},
|
|
1884
|
+
"tools": [
|
|
1885
|
+
"Tauri 2 CLI and Rust toolchain",
|
|
1886
|
+
"Electron, electron-builder, electron-forge",
|
|
1887
|
+
"Vite / React for the renderer",
|
|
1888
|
+
"Code signing and notarisation tooling",
|
|
1889
|
+
"Updater servers (Tauri updater, electron-updater)",
|
|
1890
|
+
"Playwright for Electron or WebDriver"
|
|
1891
|
+
],
|
|
1892
|
+
"decides": [
|
|
1893
|
+
"Shell framework and IPC surface",
|
|
1894
|
+
"Security model (CSP, permissions, allowlist)",
|
|
1895
|
+
"Update and release channel strategy",
|
|
1896
|
+
"Which features are native versus web"
|
|
1897
|
+
]
|
|
1898
|
+
},
|
|
1899
|
+
{
|
|
1900
|
+
"id": "extension",
|
|
1901
|
+
"label": "Extension",
|
|
1902
|
+
"title": "Browser extension engineer",
|
|
1903
|
+
"group": "Product",
|
|
1904
|
+
"icon": "Puzzle",
|
|
1905
|
+
"tagline": "Manifest V3 extensions for Chrome, Edge and Firefox with safe permissions.",
|
|
1906
|
+
"ui": true,
|
|
1907
|
+
"skills": [
|
|
1908
|
+
"browser-extension",
|
|
1909
|
+
"ui-shadcn-tailwind",
|
|
1910
|
+
"secrets-and-env"
|
|
1911
|
+
],
|
|
1912
|
+
"focus": [
|
|
1913
|
+
"Manifest V3 only: service worker background, declarativeNetRequest, least-privilege permissions, host_permissions listed explicitly, optional permissions requested on demand.",
|
|
1914
|
+
"Isolate content scripts and talk through typed messages; keep settings in chrome.storage.sync; keep the popup and options pages small.",
|
|
1915
|
+
"Stay cross-browser with the webextension polyfill and browser-specific manifest overrides.",
|
|
1916
|
+
"Prove it by building and loading the unpacked extension; lint with web-ext; document what each permission is for in the README."
|
|
1917
|
+
],
|
|
1918
|
+
"done": [
|
|
1919
|
+
"manifest.json is MV3 with least-privilege permissions",
|
|
1920
|
+
"Popup, content script and storage work in the loaded build",
|
|
1921
|
+
"web-ext lint passes"
|
|
1922
|
+
],
|
|
1923
|
+
"gate": {
|
|
1924
|
+
"noMock": false,
|
|
1925
|
+
"artifacts": [
|
|
1926
|
+
{
|
|
1927
|
+
"label": "Extension manifest",
|
|
1928
|
+
"globs": [
|
|
1929
|
+
"manifest.json",
|
|
1930
|
+
"**/manifest.json",
|
|
1931
|
+
"src/manifest.*"
|
|
1932
|
+
]
|
|
1933
|
+
}
|
|
1934
|
+
]
|
|
1935
|
+
},
|
|
1936
|
+
"phase1": "Phase 1 must be a loadable MV3 extension: manifest, popup, one content script and persisted settings.",
|
|
1937
|
+
"detect": {
|
|
1938
|
+
"keywords": {
|
|
1939
|
+
"chrome extension": 7,
|
|
1940
|
+
"browser extension": 7,
|
|
1941
|
+
"firefox extension": 7,
|
|
1942
|
+
"firefox addon": 7,
|
|
1943
|
+
"firefox add-on": 7,
|
|
1944
|
+
"manifest v3": 7,
|
|
1945
|
+
"content script": 5,
|
|
1946
|
+
"web extension": 6,
|
|
1947
|
+
"extension that": 3,
|
|
1948
|
+
"safari extension": 6,
|
|
1949
|
+
"edge extension": 6
|
|
1950
|
+
},
|
|
1951
|
+
"files": [
|
|
1952
|
+
"manifest.json",
|
|
1953
|
+
"src/manifest.*"
|
|
1954
|
+
]
|
|
1955
|
+
},
|
|
1956
|
+
"tools": [
|
|
1957
|
+
"Chrome and Firefox developer modes",
|
|
1958
|
+
"web-ext and Chrome Web Store CLI",
|
|
1959
|
+
"Vite with CRXJS or Plasmo",
|
|
1960
|
+
"webextension-polyfill",
|
|
1961
|
+
"chrome.storage and declarativeNetRequest APIs",
|
|
1962
|
+
"Store listing assets"
|
|
1963
|
+
],
|
|
1964
|
+
"decides": [
|
|
1965
|
+
"Permission set and justification",
|
|
1966
|
+
"Message protocol between popup, worker and pages",
|
|
1967
|
+
"Storage and sync model",
|
|
1968
|
+
"Store distribution and update cadence"
|
|
1969
|
+
]
|
|
1970
|
+
},
|
|
1971
|
+
{
|
|
1972
|
+
"id": "game",
|
|
1973
|
+
"label": "Game",
|
|
1974
|
+
"title": "Game developer",
|
|
1975
|
+
"group": "Product",
|
|
1976
|
+
"icon": "Gamepad2",
|
|
1977
|
+
"tagline": "Phaser, PixiJS, Three.js, Godot or Unity games with a real loop and good feel.",
|
|
1978
|
+
"ui": true,
|
|
1979
|
+
"skills": [
|
|
1980
|
+
"game-dev",
|
|
1981
|
+
"ui-shadcn-tailwind",
|
|
1982
|
+
"web-performance"
|
|
1983
|
+
],
|
|
1984
|
+
"focus": [
|
|
1985
|
+
"Match the engine in the repo (Godot, Unity, Phaser, Three.js, PixiJS); never add a second one. Keep game state in a plain model separate from rendering.",
|
|
1986
|
+
"Core loop first: input, fixed-timestep update, render, win/lose and restart. Then feel: easing, hit feedback, particles, sound hooks.",
|
|
1987
|
+
"Assets are generated or placeholder, stored under assets/ with a manifest; never hotlinked.",
|
|
1988
|
+
"Performance is checked: object pooling, atlases, capped delta time, 60 fps on desktop and touch controls on a phone viewport in the browser tool."
|
|
1989
|
+
],
|
|
1990
|
+
"done": [
|
|
1991
|
+
"Playable loop with win/lose and restart",
|
|
1992
|
+
"Runs at a stable frame rate in the preview",
|
|
1993
|
+
"Touch and keyboard controls both work"
|
|
1994
|
+
],
|
|
1995
|
+
"gate": {
|
|
1996
|
+
"noMock": false,
|
|
1997
|
+
"artifacts": []
|
|
1998
|
+
},
|
|
1999
|
+
"phase1": "Phase 1 must be a playable core loop the user can open: movement, one mechanic, a fail state and restart.",
|
|
2000
|
+
"detect": {
|
|
2001
|
+
"keywords": {
|
|
2002
|
+
"game": 5,
|
|
2003
|
+
"games": 4,
|
|
2004
|
+
"phaser": 7,
|
|
2005
|
+
"pixijs": 7,
|
|
2006
|
+
"pixi.js": 7,
|
|
2007
|
+
"three.js": 5,
|
|
2008
|
+
"threejs": 5,
|
|
2009
|
+
"godot": 7,
|
|
2010
|
+
"unity": 6,
|
|
2011
|
+
"unreal": 6,
|
|
2012
|
+
"sprite": 4,
|
|
2013
|
+
"sprites": 4,
|
|
2014
|
+
"platformer": 7,
|
|
2015
|
+
"puzzle game": 7,
|
|
2016
|
+
"arcade": 5,
|
|
2017
|
+
"game loop": 7,
|
|
2018
|
+
"multiplayer game": 7,
|
|
2019
|
+
"roguelike": 7,
|
|
2020
|
+
"tower defense": 7,
|
|
2021
|
+
"shooter": 5,
|
|
2022
|
+
"leaderboard": 2
|
|
2023
|
+
},
|
|
2024
|
+
"files": [
|
|
2025
|
+
"project.godot",
|
|
2026
|
+
"**/*.tscn",
|
|
2027
|
+
"Assets/**/*.unity",
|
|
2028
|
+
"ProjectSettings/**"
|
|
2029
|
+
]
|
|
2030
|
+
},
|
|
2031
|
+
"tools": [
|
|
2032
|
+
"Phaser 3, PixiJS, Three.js / R3F",
|
|
2033
|
+
"Godot 4 and GDScript, Unity and C#",
|
|
2034
|
+
"Tiled and Aseprite exports",
|
|
2035
|
+
"Howler.js or engine audio",
|
|
2036
|
+
"Browser performance profiler",
|
|
2037
|
+
"Colyseus or Supabase Realtime for multiplayer"
|
|
2038
|
+
],
|
|
2039
|
+
"decides": [
|
|
2040
|
+
"Engine and rendering approach",
|
|
2041
|
+
"Core mechanic scope for phase 1",
|
|
2042
|
+
"Frame budget and asset pipeline",
|
|
2043
|
+
"Input scheme across keyboard, touch and gamepad"
|
|
2044
|
+
]
|
|
2045
|
+
},
|
|
2046
|
+
{
|
|
2047
|
+
"id": "cli",
|
|
2048
|
+
"label": "CLI",
|
|
2049
|
+
"title": "CLI and developer tooling engineer",
|
|
2050
|
+
"group": "Product",
|
|
2051
|
+
"icon": "Terminal",
|
|
2052
|
+
"tagline": "Command-line tools, codemods and dev scripts people can trust in a pipeline.",
|
|
2053
|
+
"ui": false,
|
|
2054
|
+
"skills": [
|
|
2055
|
+
"cli-tooling",
|
|
2056
|
+
"qa-automation",
|
|
2057
|
+
"github-actions-ci",
|
|
2058
|
+
"secrets-and-env"
|
|
2059
|
+
],
|
|
2060
|
+
"focus": [
|
|
2061
|
+
"Use a real argument parser; every command has --help with examples, --json output, --dry-run for writes and meaningful exit codes.",
|
|
2062
|
+
"Respect the environment: NO_COLOR, CI, XDG paths, stdin piping; never prompt when stdout is not a TTY; no network at start-up.",
|
|
2063
|
+
"Errors say what failed and what to do next; logs go to stderr, results to stdout.",
|
|
2064
|
+
"Package it: bin entry or console script, executable bit, smoke test that runs the built binary, and a release workflow when publishing."
|
|
2065
|
+
],
|
|
2066
|
+
"done": [
|
|
2067
|
+
"The binary runs from a packed install (npm pack / pipx) with --help",
|
|
2068
|
+
"Exit codes and --json output are tested",
|
|
2069
|
+
"Writes are guarded by --dry-run or confirmation"
|
|
2070
|
+
],
|
|
2071
|
+
"gate": {
|
|
2072
|
+
"noMock": true,
|
|
2073
|
+
"artifacts": [
|
|
2074
|
+
{
|
|
2075
|
+
"label": "CLI entry point",
|
|
2076
|
+
"globs": [
|
|
2077
|
+
"bin/**",
|
|
2078
|
+
"cli/**",
|
|
2079
|
+
"src/cli/**",
|
|
2080
|
+
"cmd/**",
|
|
2081
|
+
"**/cli.*",
|
|
2082
|
+
"**/__main__.py",
|
|
2083
|
+
"**/main.go"
|
|
2084
|
+
]
|
|
2085
|
+
},
|
|
2086
|
+
{
|
|
2087
|
+
"label": "Automated tests",
|
|
2088
|
+
"globs": [
|
|
2089
|
+
"tests/**",
|
|
2090
|
+
"test/**",
|
|
2091
|
+
"**/__tests__/**",
|
|
2092
|
+
"**/*.test.*",
|
|
2093
|
+
"**/*.spec.*",
|
|
2094
|
+
"**/test_*.py",
|
|
2095
|
+
"**/*_test.py",
|
|
2096
|
+
"**/*_test.go",
|
|
2097
|
+
"e2e/**",
|
|
2098
|
+
"spec/**"
|
|
2099
|
+
]
|
|
2100
|
+
}
|
|
2101
|
+
]
|
|
2102
|
+
},
|
|
2103
|
+
"phase1": "Phase 1 must be an installable CLI with --help, one real command end to end, --json output and a smoke test.",
|
|
2104
|
+
"detect": {
|
|
2105
|
+
"keywords": {
|
|
2106
|
+
"cli": 6,
|
|
2107
|
+
"command line": 6,
|
|
2108
|
+
"command-line": 6,
|
|
2109
|
+
"terminal tool": 6,
|
|
2110
|
+
"cli tool": 7,
|
|
2111
|
+
"npx": 3,
|
|
2112
|
+
"codemod": 6,
|
|
2113
|
+
"dev tool": 4,
|
|
2114
|
+
"developer tool": 5,
|
|
2115
|
+
"shell script": 4,
|
|
2116
|
+
"bash script": 4,
|
|
2117
|
+
"scaffolding tool": 5,
|
|
2118
|
+
"generator": 2
|
|
2119
|
+
},
|
|
2120
|
+
"files": [
|
|
2121
|
+
"bin/**",
|
|
2122
|
+
"cmd/**",
|
|
2123
|
+
"src/cli/**",
|
|
2124
|
+
"**/__main__.py"
|
|
2125
|
+
]
|
|
2126
|
+
},
|
|
2127
|
+
"tools": [
|
|
2128
|
+
"commander, oclif, clipanion (Node); typer, click (Python); cobra (Go)",
|
|
2129
|
+
"chalk / rich for output, ora for spinners",
|
|
2130
|
+
"npm pack, pipx, goreleaser",
|
|
2131
|
+
"Shell completion generators",
|
|
2132
|
+
"Snapshot tests for help and output",
|
|
2133
|
+
"GitHub Releases"
|
|
2134
|
+
],
|
|
2135
|
+
"decides": [
|
|
2136
|
+
"Command and flag design",
|
|
2137
|
+
"Output contract (human versus --json)",
|
|
2138
|
+
"Config file and env precedence",
|
|
2139
|
+
"Distribution channel and versioning"
|
|
2140
|
+
]
|
|
2141
|
+
},
|
|
2142
|
+
{
|
|
2143
|
+
"id": "dba",
|
|
2144
|
+
"label": "Database",
|
|
2145
|
+
"title": "Database engineer",
|
|
2146
|
+
"group": "Platform",
|
|
2147
|
+
"icon": "DatabaseZap",
|
|
2148
|
+
"tagline": "Schema design, migrations, indexing, query tuning and safe data changes.",
|
|
2149
|
+
"ui": false,
|
|
2150
|
+
"skills": [
|
|
2151
|
+
"database-performance",
|
|
2152
|
+
"postgres-orm",
|
|
2153
|
+
"supabase",
|
|
2154
|
+
"secrets-and-env"
|
|
2155
|
+
],
|
|
2156
|
+
"focus": [
|
|
2157
|
+
"Model with constraints: keys, foreign keys with delete rules, NOT NULL and CHECK, unique business keys, timestamps; consistent id strategy.",
|
|
2158
|
+
"Every change is a reversible migration file; large tables get concurrent indexes and batched backfills; nothing is edited by hand.",
|
|
2159
|
+
"Tune with evidence: EXPLAIN (ANALYZE, BUFFERS) before and after, the right composite or covering index, keyset pagination, N+1 removed.",
|
|
2160
|
+
"Destructive SQL, production runs and data moves need explicit approval and a backup or snapshot first."
|
|
2161
|
+
],
|
|
2162
|
+
"done": [
|
|
2163
|
+
"Migrations apply and roll back cleanly on a fresh database",
|
|
2164
|
+
"Slow queries have before/after plans and timings",
|
|
2165
|
+
"No destructive statement ran without approval"
|
|
2166
|
+
],
|
|
2167
|
+
"gate": {
|
|
2168
|
+
"noMock": false,
|
|
2169
|
+
"artifacts": [
|
|
2170
|
+
{
|
|
2171
|
+
"label": "Schema or migration",
|
|
2172
|
+
"globs": [
|
|
2173
|
+
"**/migrations/**",
|
|
2174
|
+
"prisma/schema.prisma",
|
|
2175
|
+
"drizzle/**",
|
|
2176
|
+
"supabase/migrations/**",
|
|
2177
|
+
"**/*.sql",
|
|
2178
|
+
"alembic/**",
|
|
2179
|
+
"db/**"
|
|
2180
|
+
]
|
|
2181
|
+
}
|
|
2182
|
+
]
|
|
2183
|
+
},
|
|
2184
|
+
"phase1": "Phase 1 must be the schema with constraints and indexes as migrations, applied to a real database, with the slowest query measured.",
|
|
2185
|
+
"detect": {
|
|
2186
|
+
"keywords": {
|
|
2187
|
+
"database schema": 5,
|
|
2188
|
+
"schema design": 7,
|
|
2189
|
+
"index": 3,
|
|
2190
|
+
"indexes": 4,
|
|
2191
|
+
"indexing": 4,
|
|
2192
|
+
"slow query": 7,
|
|
2193
|
+
"slow queries": 7,
|
|
2194
|
+
"query plan": 7,
|
|
2195
|
+
"explain analyze": 7,
|
|
2196
|
+
"normalize": 4,
|
|
2197
|
+
"normalise": 4,
|
|
2198
|
+
"deadlock": 6,
|
|
2199
|
+
"postgres tuning": 7,
|
|
2200
|
+
"db performance": 7,
|
|
2201
|
+
"database performance": 7,
|
|
2202
|
+
"dba": 7,
|
|
2203
|
+
"vacuum": 5,
|
|
2204
|
+
"partitioning": 5,
|
|
2205
|
+
"replication": 4,
|
|
2206
|
+
"backfill": 5,
|
|
2207
|
+
"data migration": 5
|
|
2208
|
+
},
|
|
2209
|
+
"files": [
|
|
2210
|
+
"alembic/**",
|
|
2211
|
+
"supabase/migrations/**"
|
|
2212
|
+
]
|
|
2213
|
+
},
|
|
2214
|
+
"tools": [
|
|
2215
|
+
"psql, pgcli, pg_stat_statements",
|
|
2216
|
+
"EXPLAIN visualisers (explain.dalibo, pev2)",
|
|
2217
|
+
"Prisma / Drizzle / Alembic / Flyway",
|
|
2218
|
+
"pgbouncer, Neon branching, Supabase",
|
|
2219
|
+
"pg_dump / snapshots before risky changes",
|
|
2220
|
+
"Load generators for query benchmarks"
|
|
2221
|
+
],
|
|
2222
|
+
"decides": [
|
|
2223
|
+
"Normalisation level and id strategy",
|
|
2224
|
+
"Index set and write-cost trade-off",
|
|
2225
|
+
"Migration order and downtime plan",
|
|
2226
|
+
"Retention, archiving and partitioning"
|
|
2227
|
+
]
|
|
2228
|
+
},
|
|
2229
|
+
{
|
|
2230
|
+
"id": "perf",
|
|
2231
|
+
"label": "Performance",
|
|
2232
|
+
"title": "Performance engineer",
|
|
2233
|
+
"group": "Platform",
|
|
2234
|
+
"icon": "Gauge",
|
|
2235
|
+
"tagline": "Measured speed-ups: Core Web Vitals, bundles, server latency and database time.",
|
|
2236
|
+
"ui": false,
|
|
2237
|
+
"skills": [
|
|
2238
|
+
"web-performance",
|
|
2239
|
+
"database-performance",
|
|
2240
|
+
"observability-otel",
|
|
2241
|
+
"e2e-playwright"
|
|
2242
|
+
],
|
|
2243
|
+
"focus": [
|
|
2244
|
+
"Measure before changing anything: Lighthouse, bundle analysis, server timings, query plans. Write the baseline down with the command used.",
|
|
2245
|
+
"Fix by impact: render-blocking requests, oversized images, unused JavaScript, request waterfalls, layout shift, long tasks; then N+1 queries, missing indexes and cache misses.",
|
|
2246
|
+
"Re-measure after each change and report before/after numbers; never say faster without them.",
|
|
2247
|
+
"Leave a budget behind: a Lighthouse or bundle-size check in CI when the project has one."
|
|
2248
|
+
],
|
|
2249
|
+
"done": [
|
|
2250
|
+
"Before/after numbers for every optimisation with the measuring command",
|
|
2251
|
+
"No regression in tests or behaviour",
|
|
2252
|
+
"A performance budget or check is recorded"
|
|
2253
|
+
],
|
|
2254
|
+
"gate": {
|
|
2255
|
+
"noMock": false,
|
|
2256
|
+
"artifacts": []
|
|
2257
|
+
},
|
|
2258
|
+
"phase1": "Phase 1 must be the measured baseline plus the single highest-impact fix with its before/after numbers.",
|
|
2259
|
+
"detect": {
|
|
2260
|
+
"keywords": {
|
|
2261
|
+
"performance": 5,
|
|
2262
|
+
"slow": 3,
|
|
2263
|
+
"too slow": 5,
|
|
2264
|
+
"faster": 3,
|
|
2265
|
+
"speed up": 5,
|
|
2266
|
+
"lighthouse": 7,
|
|
2267
|
+
"core web vitals": 7,
|
|
2268
|
+
"web vitals": 7,
|
|
2269
|
+
"lcp": 6,
|
|
2270
|
+
"cls": 5,
|
|
2271
|
+
"inp": 5,
|
|
2272
|
+
"bundle size": 7,
|
|
2273
|
+
"latency": 4,
|
|
2274
|
+
"optimize performance": 7,
|
|
2275
|
+
"optimise performance": 7,
|
|
2276
|
+
"page load": 5,
|
|
2277
|
+
"load time": 5,
|
|
2278
|
+
"memory leak": 5,
|
|
2279
|
+
"profiling": 5,
|
|
2280
|
+
"profile the": 4
|
|
2281
|
+
},
|
|
2282
|
+
"files": [
|
|
2283
|
+
"lighthouserc.*",
|
|
2284
|
+
".lighthouserc.*",
|
|
2285
|
+
"budget.json"
|
|
2286
|
+
]
|
|
2287
|
+
},
|
|
2288
|
+
"tools": [
|
|
2289
|
+
"Lighthouse and WebPageTest",
|
|
2290
|
+
"Chrome DevTools performance and memory panels",
|
|
2291
|
+
"Bundle analyzers (next/bundle-analyzer, vite visualizer)",
|
|
2292
|
+
"k6 and autocannon",
|
|
2293
|
+
"EXPLAIN ANALYZE and pg_stat_statements",
|
|
2294
|
+
"OpenTelemetry traces and flame graphs"
|
|
2295
|
+
],
|
|
2296
|
+
"decides": [
|
|
2297
|
+
"What to measure and the target numbers",
|
|
2298
|
+
"Order of fixes by impact and risk",
|
|
2299
|
+
"Caching layers and invalidation",
|
|
2300
|
+
"Performance budget enforced in CI"
|
|
2301
|
+
]
|
|
2302
|
+
},
|
|
2303
|
+
{
|
|
2304
|
+
"id": "release",
|
|
2305
|
+
"label": "Migration",
|
|
2306
|
+
"title": "Migration and modernisation engineer",
|
|
2307
|
+
"group": "Platform",
|
|
2308
|
+
"icon": "ArrowRightLeft",
|
|
2309
|
+
"tagline": "Framework upgrades, library swaps, platform and database moves in safe reviewable steps.",
|
|
2310
|
+
"ui": false,
|
|
2311
|
+
"skills": [
|
|
2312
|
+
"legacy-migration",
|
|
2313
|
+
"qa-automation",
|
|
2314
|
+
"github-actions-ci",
|
|
2315
|
+
"database-performance"
|
|
2316
|
+
],
|
|
2317
|
+
"focus": [
|
|
2318
|
+
"Characterise first: inventory versions, deprecations, coverage and entry points; write a phased plan where each phase leaves the app working, and get it approved.",
|
|
2319
|
+
"One axis at a time (runtime, then framework, then libraries); official codemods before hand edits; small reversible commits.",
|
|
2320
|
+
"Add characterisation tests around behaviour that must survive; run the full suite after every phase. Database moves use dual writes or backfill plus cutover, never a big bang.",
|
|
2321
|
+
"Each phase ends with build, tests, a smoke run and a written rollback."
|
|
2322
|
+
],
|
|
2323
|
+
"done": [
|
|
2324
|
+
"Phased migration plan exists and each completed phase builds and passes tests",
|
|
2325
|
+
"Deprecated APIs in scope are removed or documented",
|
|
2326
|
+
"Rollback for the current phase is written down"
|
|
2327
|
+
],
|
|
2328
|
+
"gate": {
|
|
2329
|
+
"noMock": false,
|
|
2330
|
+
"artifacts": [
|
|
2331
|
+
{
|
|
2332
|
+
"label": "Migration plan or notes",
|
|
2333
|
+
"globs": [
|
|
2334
|
+
"MIGRATION*.md",
|
|
2335
|
+
"docs/migration/**",
|
|
2336
|
+
"docs/adr/**",
|
|
2337
|
+
"UPGRADE*.md",
|
|
2338
|
+
"CHANGELOG.md",
|
|
2339
|
+
"PLAN.md"
|
|
2340
|
+
]
|
|
2341
|
+
}
|
|
2342
|
+
]
|
|
2343
|
+
},
|
|
2344
|
+
"phase1": "Phase 1 must be the characterisation (inventory, tests around critical behaviour) plus the first upgrade axis completed with a green build.",
|
|
2345
|
+
"detect": {
|
|
2346
|
+
"keywords": {
|
|
2347
|
+
"migrate": 5,
|
|
2348
|
+
"migrate to": 6,
|
|
2349
|
+
"migration": 3,
|
|
2350
|
+
"upgrade": 5,
|
|
2351
|
+
"upgrade to": 6,
|
|
2352
|
+
"modernize": 7,
|
|
2353
|
+
"modernise": 7,
|
|
2354
|
+
"legacy": 5,
|
|
2355
|
+
"port to": 6,
|
|
2356
|
+
"convert to": 4,
|
|
2357
|
+
"move from": 5,
|
|
2358
|
+
"move to": 3,
|
|
2359
|
+
"deprecated": 4,
|
|
2360
|
+
"breaking changes": 5,
|
|
2361
|
+
"rewrite in": 5,
|
|
2362
|
+
"rewrite": 3,
|
|
2363
|
+
"react 19": 5,
|
|
2364
|
+
"next 15": 5,
|
|
2365
|
+
"next 16": 5,
|
|
2366
|
+
"python 3": 3,
|
|
2367
|
+
"typescript migration": 7,
|
|
2368
|
+
"monorepo migration": 7,
|
|
2369
|
+
"switch from": 5
|
|
2370
|
+
},
|
|
2371
|
+
"files": []
|
|
2372
|
+
},
|
|
2373
|
+
"tools": [
|
|
2374
|
+
"Official codemods (@next/codemod, react-codemod, pyupgrade, rector)",
|
|
2375
|
+
"Dependency analyzers (npm-check-updates, depcheck, madge)",
|
|
2376
|
+
"Characterisation tests and snapshot tests",
|
|
2377
|
+
"Feature flags and strangler routing",
|
|
2378
|
+
"Dual-write and backfill scripts",
|
|
2379
|
+
"CI matrix across versions"
|
|
2380
|
+
],
|
|
2381
|
+
"decides": [
|
|
2382
|
+
"Phase boundaries and order",
|
|
2383
|
+
"What behaviour must be preserved exactly",
|
|
2384
|
+
"Cutover and rollback mechanics",
|
|
2385
|
+
"When to stop and ship a phase"
|
|
2386
|
+
]
|
|
2387
|
+
},
|
|
2388
|
+
{
|
|
2389
|
+
"id": "a11y",
|
|
2390
|
+
"label": "Accessibility",
|
|
2391
|
+
"title": "Accessibility engineer",
|
|
2392
|
+
"group": "Quality and security",
|
|
2393
|
+
"icon": "Accessibility",
|
|
2394
|
+
"tagline": "WCAG 2.2 AA audits and fixes: keyboard, screen readers, contrast and focus.",
|
|
2395
|
+
"ui": true,
|
|
2396
|
+
"skills": [
|
|
2397
|
+
"accessibility-wcag",
|
|
2398
|
+
"ui-shadcn-tailwind",
|
|
2399
|
+
"e2e-playwright"
|
|
2400
|
+
],
|
|
2401
|
+
"focus": [
|
|
2402
|
+
"Semantics first: native elements before ARIA, labels on every control, alt text on every image, headings in order, landmarks on every page.",
|
|
2403
|
+
"Keyboard everything: sensible tab order, visible focus, Escape closes, focus trapped in modals and returned on close, no keyboard traps.",
|
|
2404
|
+
"Contrast 4.5:1 for text and 3:1 for UI, state not conveyed by colour alone, reduced-motion respected, live regions for async status.",
|
|
2405
|
+
"Prove it with axe-core (CLI or Playwright) and a manual keyboard pass of the main flow; fix every serious and critical finding."
|
|
2406
|
+
],
|
|
2407
|
+
"done": [
|
|
2408
|
+
"axe-core reports zero serious or critical issues on touched pages",
|
|
2409
|
+
"Main flow completes with keyboard only",
|
|
2410
|
+
"Focus management in dialogs and menus is correct"
|
|
2411
|
+
],
|
|
2412
|
+
"gate": {
|
|
2413
|
+
"noMock": false,
|
|
2414
|
+
"artifacts": []
|
|
2415
|
+
},
|
|
2416
|
+
"phase1": "Phase 1 must be the audit (axe results plus keyboard pass) and the fixes for every serious or critical issue on the primary flow.",
|
|
2417
|
+
"detect": {
|
|
2418
|
+
"keywords": {
|
|
2419
|
+
"accessibility": 7,
|
|
2420
|
+
"accessible": 5,
|
|
2421
|
+
"a11y": 7,
|
|
2422
|
+
"wcag": 7,
|
|
2423
|
+
"screen reader": 7,
|
|
2424
|
+
"screen readers": 7,
|
|
2425
|
+
"aria": 5,
|
|
2426
|
+
"keyboard navigation": 6,
|
|
2427
|
+
"keyboard accessible": 7,
|
|
2428
|
+
"contrast": 4,
|
|
2429
|
+
"color contrast": 6,
|
|
2430
|
+
"colour contrast": 6,
|
|
2431
|
+
"focus ring": 5,
|
|
2432
|
+
"voiceover": 6,
|
|
2433
|
+
"nvda": 6,
|
|
2434
|
+
"ada compliance": 7,
|
|
2435
|
+
"section 508": 7
|
|
2436
|
+
},
|
|
2437
|
+
"files": []
|
|
2438
|
+
},
|
|
2439
|
+
"tools": [
|
|
2440
|
+
"axe-core (CLI, Playwright, browser extension)",
|
|
2441
|
+
"VoiceOver, NVDA, TalkBack",
|
|
2442
|
+
"Lighthouse accessibility audit",
|
|
2443
|
+
"Contrast checkers and APCA",
|
|
2444
|
+
"eslint-plugin-jsx-a11y",
|
|
2445
|
+
"Storybook a11y addon"
|
|
2446
|
+
],
|
|
2447
|
+
"decides": [
|
|
2448
|
+
"Conformance target (AA) and exceptions",
|
|
2449
|
+
"Focus order and management patterns",
|
|
2450
|
+
"ARIA usage policy",
|
|
2451
|
+
"What blocks release"
|
|
2452
|
+
]
|
|
2453
|
+
},
|
|
2454
|
+
{
|
|
2455
|
+
"id": "docs",
|
|
2456
|
+
"label": "Docs",
|
|
2457
|
+
"title": "Documentation engineer and technical writer",
|
|
2458
|
+
"group": "Quality and security",
|
|
2459
|
+
"icon": "BookOpenText",
|
|
2460
|
+
"tagline": "READMEs, guides, API references and ADRs that match the code and actually run.",
|
|
2461
|
+
"ui": false,
|
|
2462
|
+
"skills": [
|
|
2463
|
+
"docs-technical-writing",
|
|
2464
|
+
"api-design-openapi",
|
|
2465
|
+
"github-actions-ci"
|
|
2466
|
+
],
|
|
2467
|
+
"focus": [
|
|
2468
|
+
"Write for the reader: what it is, who it is for, install, first success in five minutes, configuration, troubleshooting. One task per guide page; Diataxis for structure.",
|
|
2469
|
+
"Every command and snippet is copied from the repo or executed; output pasted is real. Reference is generated from source where possible.",
|
|
2470
|
+
"Docs live in the repo (docs/ with Docusaurus, MkDocs or Nextra when a site is wanted) with link checks and a strict build in CI.",
|
|
2471
|
+
"Keep a CHANGELOG with user-facing changes; never document behaviour that does not exist yet."
|
|
2472
|
+
],
|
|
2473
|
+
"done": [
|
|
2474
|
+
"Every documented command was executed and works",
|
|
2475
|
+
"Docs build and link check pass",
|
|
2476
|
+
"README covers install, first run, config and troubleshooting"
|
|
2477
|
+
],
|
|
2478
|
+
"gate": {
|
|
2479
|
+
"noMock": false,
|
|
2480
|
+
"artifacts": [
|
|
2481
|
+
{
|
|
2482
|
+
"label": "Documentation",
|
|
2483
|
+
"globs": [
|
|
2484
|
+
"README*",
|
|
2485
|
+
"docs/**",
|
|
2486
|
+
"**/*.md",
|
|
2487
|
+
"**/*.mdx",
|
|
2488
|
+
"CHANGELOG*",
|
|
2489
|
+
"mkdocs.yml",
|
|
2490
|
+
"docusaurus.config.*"
|
|
2491
|
+
]
|
|
2492
|
+
}
|
|
2493
|
+
]
|
|
2494
|
+
},
|
|
2495
|
+
"phase1": "Phase 1 must be an accurate README and the single most-needed guide, each command verified, with a docs build if a site exists.",
|
|
2496
|
+
"detect": {
|
|
2497
|
+
"keywords": {
|
|
2498
|
+
"documentation": 7,
|
|
2499
|
+
"document the": 5,
|
|
2500
|
+
"docs": 3,
|
|
2501
|
+
"readme": 3,
|
|
2502
|
+
"write a guide": 6,
|
|
2503
|
+
"tutorial": 5,
|
|
2504
|
+
"api reference": 6,
|
|
2505
|
+
"changelog": 5,
|
|
2506
|
+
"docusaurus": 7,
|
|
2507
|
+
"mkdocs": 7,
|
|
2508
|
+
"technical writing": 7,
|
|
2509
|
+
"onboarding guide": 5,
|
|
2510
|
+
"runbook": 2,
|
|
2511
|
+
"write up": 3,
|
|
2512
|
+
"user manual": 6,
|
|
2513
|
+
"write a readme": 7,
|
|
2514
|
+
"readme for": 6,
|
|
2515
|
+
"update the docs": 6
|
|
2516
|
+
},
|
|
2517
|
+
"files": [
|
|
2518
|
+
"mkdocs.yml",
|
|
2519
|
+
"docusaurus.config.*",
|
|
2520
|
+
"docs/**/*.mdx"
|
|
2521
|
+
]
|
|
2522
|
+
},
|
|
2523
|
+
"tools": [
|
|
2524
|
+
"Docusaurus, MkDocs Material, Nextra, Mintlify",
|
|
2525
|
+
"typedoc, Sphinx, pdoc, Redoc / Scalar for OpenAPI",
|
|
2526
|
+
"markdown-link-check and Vale",
|
|
2527
|
+
"Mermaid diagrams",
|
|
2528
|
+
"asciinema / screenshots",
|
|
2529
|
+
"GitHub Pages or Vercel for hosting"
|
|
2530
|
+
],
|
|
2531
|
+
"decides": [
|
|
2532
|
+
"Information architecture and page types",
|
|
2533
|
+
"Voice, terminology and style rules",
|
|
2534
|
+
"What is generated versus hand-written",
|
|
2535
|
+
"Versioning of docs with releases"
|
|
2536
|
+
]
|
|
2537
|
+
},
|
|
2538
|
+
{
|
|
2539
|
+
"id": "analytics",
|
|
2540
|
+
"label": "Analytics",
|
|
2541
|
+
"title": "Analytics engineer",
|
|
2542
|
+
"group": "Data and AI",
|
|
2543
|
+
"icon": "ChartNoAxesCombined",
|
|
2544
|
+
"tagline": "dbt models, metric definitions, tested SQL and dashboards people trust.",
|
|
2545
|
+
"ui": false,
|
|
2546
|
+
"skills": [
|
|
2547
|
+
"analytics-dbt-bi",
|
|
2548
|
+
"data-pipelines",
|
|
2549
|
+
"data-analysis",
|
|
2550
|
+
"secrets-and-env"
|
|
2551
|
+
],
|
|
2552
|
+
"focus": [
|
|
2553
|
+
"Layer models: staging, intermediate, marts. One definition per metric with its grain stated and documented.",
|
|
2554
|
+
"Tests on every model (not_null, unique, accepted_values, relationships) plus source freshness; dbt build passes before any dashboard reads it.",
|
|
2555
|
+
"SQL that scales: incremental models, partition keys, named CTEs, no SELECT *.",
|
|
2556
|
+
"Dashboards show the question, the number, the trend and a link to the definition; numbers are verified against a raw query before publishing."
|
|
2557
|
+
],
|
|
2558
|
+
"done": [
|
|
2559
|
+
"dbt build (or the SQL test suite) passes",
|
|
2560
|
+
"Each metric has one documented definition",
|
|
2561
|
+
"Dashboard numbers reconciled against a raw query"
|
|
2562
|
+
],
|
|
2563
|
+
"gate": {
|
|
2564
|
+
"noMock": true,
|
|
2565
|
+
"artifacts": [
|
|
2566
|
+
{
|
|
2567
|
+
"label": "Models or SQL",
|
|
2568
|
+
"globs": [
|
|
2569
|
+
"models/**",
|
|
2570
|
+
"dbt/**",
|
|
2571
|
+
"**/*.sql",
|
|
2572
|
+
"metrics/**",
|
|
2573
|
+
"semantic/**",
|
|
2574
|
+
"looker/**",
|
|
2575
|
+
"**/*.lkml"
|
|
2576
|
+
]
|
|
2577
|
+
}
|
|
2578
|
+
]
|
|
2579
|
+
},
|
|
2580
|
+
"phase1": "Phase 1 must be the staging and first mart models with tests passing and one verified metric on a dashboard or query.",
|
|
2581
|
+
"detect": {
|
|
2582
|
+
"keywords": {
|
|
2583
|
+
"dbt": 7,
|
|
2584
|
+
"warehouse": 5,
|
|
2585
|
+
"data warehouse": 6,
|
|
2586
|
+
"bigquery": 4,
|
|
2587
|
+
"snowflake": 4,
|
|
2588
|
+
"redshift": 4,
|
|
2589
|
+
"metrics layer": 7,
|
|
2590
|
+
"semantic layer": 7,
|
|
2591
|
+
"kpi dashboard": 6,
|
|
2592
|
+
"bi dashboard": 7,
|
|
2593
|
+
"looker": 7,
|
|
2594
|
+
"metabase": 7,
|
|
2595
|
+
"tableau": 6,
|
|
2596
|
+
"power bi": 6,
|
|
2597
|
+
"analytics engineer": 7,
|
|
2598
|
+
"analytics engineering": 7,
|
|
2599
|
+
"metric definitions": 6,
|
|
2600
|
+
"kpis": 3,
|
|
2601
|
+
"reporting layer": 6
|
|
2602
|
+
},
|
|
2603
|
+
"files": [
|
|
2604
|
+
"dbt_project.yml",
|
|
2605
|
+
"models/**/*.sql",
|
|
2606
|
+
"**/*.lkml"
|
|
2607
|
+
]
|
|
2608
|
+
},
|
|
2609
|
+
"tools": [
|
|
2610
|
+
"dbt Core / dbt Cloud",
|
|
2611
|
+
"BigQuery, Snowflake, Redshift, Postgres, DuckDB",
|
|
2612
|
+
"Metabase, Looker, Lightdash, Evidence",
|
|
2613
|
+
"dbt tests, Elementary, Great Expectations",
|
|
2614
|
+
"sqlfluff",
|
|
2615
|
+
"Cube or MetricFlow semantic layers"
|
|
2616
|
+
],
|
|
2617
|
+
"decides": [
|
|
2618
|
+
"Model layering and naming",
|
|
2619
|
+
"Metric grain and definitions",
|
|
2620
|
+
"Test coverage and freshness SLAs",
|
|
2621
|
+
"Which dashboard is the source of truth"
|
|
2622
|
+
]
|
|
2623
|
+
},
|
|
2624
|
+
{
|
|
2625
|
+
"id": "prompt-eval",
|
|
2626
|
+
"label": "Evals",
|
|
2627
|
+
"title": "Prompt and evaluation engineer",
|
|
2628
|
+
"group": "Data and AI",
|
|
2629
|
+
"icon": "ClipboardCheck",
|
|
2630
|
+
"tagline": "Eval sets, graders and regression gates so prompt and agent changes are measured, not guessed.",
|
|
2631
|
+
"ui": false,
|
|
2632
|
+
"skills": [
|
|
2633
|
+
"llm-evals",
|
|
2634
|
+
"llm-rag-agents",
|
|
2635
|
+
"data-analysis",
|
|
2636
|
+
"secrets-and-env"
|
|
2637
|
+
],
|
|
2638
|
+
"focus": [
|
|
2639
|
+
"Start with a dataset of real or realistic cases (30 to 200) in JSONL with expected behaviour and tags; hold out a regression slice; keep it in evals/.",
|
|
2640
|
+
"Graders are structured where possible (schema, contains, numeric tolerance); rubric model grading only for open text, with the rubric written down. Report per-tag pass rate, cost and latency.",
|
|
2641
|
+
"Prompt changes are experiments: one change, whole set, compare to last run, keep prompts and results versioned; wire a threshold into CI.",
|
|
2642
|
+
"Production: log inputs/outputs with ids, sample for review, add guardrails. Never claim quality without the eval numbers."
|
|
2643
|
+
],
|
|
2644
|
+
"done": [
|
|
2645
|
+
"An eval set and runner exist in the repo and ran on the current prompt",
|
|
2646
|
+
"Per-tag pass rates, cost and latency reported before and after",
|
|
2647
|
+
"A regression threshold is enforced or documented"
|
|
2648
|
+
],
|
|
2649
|
+
"gate": {
|
|
2650
|
+
"noMock": false,
|
|
2651
|
+
"artifacts": [
|
|
2652
|
+
{
|
|
2653
|
+
"label": "Eval set or runner",
|
|
2654
|
+
"globs": [
|
|
2655
|
+
"evals/**",
|
|
2656
|
+
"eval/**",
|
|
2657
|
+
"**/*.eval.*",
|
|
2658
|
+
"promptfooconfig.*",
|
|
2659
|
+
"**/evals/**",
|
|
2660
|
+
"prompts/**"
|
|
2661
|
+
]
|
|
2662
|
+
}
|
|
2663
|
+
]
|
|
2664
|
+
},
|
|
2665
|
+
"phase1": "Phase 1 must be the eval dataset, a runner with graders and the baseline numbers for the current prompt.",
|
|
2666
|
+
"detect": {
|
|
2667
|
+
"keywords": {
|
|
2668
|
+
"eval": 5,
|
|
2669
|
+
"evals": 7,
|
|
2670
|
+
"evaluation set": 7,
|
|
2671
|
+
"eval set": 7,
|
|
2672
|
+
"prompt engineering": 7,
|
|
2673
|
+
"system prompt": 4,
|
|
2674
|
+
"improve the prompt": 6,
|
|
2675
|
+
"hallucination": 5,
|
|
2676
|
+
"hallucinations": 5,
|
|
2677
|
+
"llm quality": 7,
|
|
2678
|
+
"grader": 6,
|
|
2679
|
+
"golden set": 7,
|
|
2680
|
+
"promptfoo": 7,
|
|
2681
|
+
"braintrust": 6,
|
|
2682
|
+
"langsmith": 5,
|
|
2683
|
+
"regression suite for the model": 7,
|
|
2684
|
+
"benchmark the prompt": 7
|
|
2685
|
+
},
|
|
2686
|
+
"files": [
|
|
2687
|
+
"promptfooconfig.*",
|
|
2688
|
+
"evals/**"
|
|
2689
|
+
]
|
|
2690
|
+
},
|
|
2691
|
+
"tools": [
|
|
2692
|
+
"promptfoo, Braintrust, LangSmith, OpenAI Evals",
|
|
2693
|
+
"JSONL datasets and tags",
|
|
2694
|
+
"Structured-output validators (zod, pydantic)",
|
|
2695
|
+
"Model-graded rubrics with calibration",
|
|
2696
|
+
"Cost and latency logging",
|
|
2697
|
+
"CI thresholds"
|
|
2698
|
+
],
|
|
2699
|
+
"decides": [
|
|
2700
|
+
"What the eval set must cover",
|
|
2701
|
+
"Grader design and acceptable error",
|
|
2702
|
+
"Pass threshold for shipping a prompt",
|
|
2703
|
+
"Sampling and review cadence in production"
|
|
2704
|
+
]
|
|
2705
|
+
},
|
|
2706
|
+
{
|
|
2707
|
+
"id": "search",
|
|
2708
|
+
"label": "Search",
|
|
2709
|
+
"title": "Search and recommendations engineer",
|
|
2710
|
+
"group": "Data and AI",
|
|
2711
|
+
"icon": "SearchCode",
|
|
2712
|
+
"tagline": "Full-text, vector and hybrid search with ranking, filters and measured relevance.",
|
|
2713
|
+
"ui": false,
|
|
2714
|
+
"skills": [
|
|
2715
|
+
"search-recsys",
|
|
2716
|
+
"postgres-orm",
|
|
2717
|
+
"llm-rag-agents",
|
|
2718
|
+
"secrets-and-env"
|
|
2719
|
+
],
|
|
2720
|
+
"focus": [
|
|
2721
|
+
"Choose by scale: Postgres tsvector + pgvector for most apps, Meilisearch or Typesense for instant search, Elasticsearch or OpenSearch for large corpora, hosted when already paid for.",
|
|
2722
|
+
"Index design: analyzers, synonyms, typo tolerance, weighted fields, facets, stable document ids; indexing is idempotent and incremental.",
|
|
2723
|
+
"Hybrid ranking with reciprocal rank fusion, business boosts applied last, cursor pagination.",
|
|
2724
|
+
"Relevance is measured with a judged query set (recall@k, nDCG) before and after; zero-result queries are logged. Recommendations come with an explanation."
|
|
2725
|
+
],
|
|
2726
|
+
"done": [
|
|
2727
|
+
"Indexing job is idempotent and incremental",
|
|
2728
|
+
"Relevance numbers on a judged query set before and after",
|
|
2729
|
+
"Search UI or API returns ranked, filterable results from real data"
|
|
2730
|
+
],
|
|
2731
|
+
"gate": {
|
|
2732
|
+
"noMock": true,
|
|
2733
|
+
"artifacts": [
|
|
2734
|
+
{
|
|
2735
|
+
"label": "Search or index code",
|
|
2736
|
+
"globs": [
|
|
2737
|
+
"**/search/**",
|
|
2738
|
+
"**/index*.ts",
|
|
2739
|
+
"**/index*.py",
|
|
2740
|
+
"**/*embed*",
|
|
2741
|
+
"**/*vector*",
|
|
2742
|
+
"**/*.sql"
|
|
2743
|
+
]
|
|
2744
|
+
}
|
|
2745
|
+
]
|
|
2746
|
+
},
|
|
2747
|
+
"phase1": "Phase 1 must be the index built from real data, a working query path with filters and the baseline relevance numbers.",
|
|
2748
|
+
"detect": {
|
|
2749
|
+
"keywords": {
|
|
2750
|
+
"full text search": 7,
|
|
2751
|
+
"full-text search": 7,
|
|
2752
|
+
"vector search": 7,
|
|
2753
|
+
"semantic search": 7,
|
|
2754
|
+
"hybrid search": 7,
|
|
2755
|
+
"search engine": 6,
|
|
2756
|
+
"site search": 6,
|
|
2757
|
+
"search feature": 6,
|
|
2758
|
+
"add search": 6,
|
|
2759
|
+
"embeddings": 4,
|
|
2760
|
+
"ranking": 4,
|
|
2761
|
+
"relevance": 5,
|
|
2762
|
+
"recommendation": 6,
|
|
2763
|
+
"recommendations": 6,
|
|
2764
|
+
"recommender": 7,
|
|
2765
|
+
"recommend products": 6,
|
|
2766
|
+
"typesense": 7,
|
|
2767
|
+
"meilisearch": 7,
|
|
2768
|
+
"elasticsearch": 7,
|
|
2769
|
+
"opensearch": 7,
|
|
2770
|
+
"pgvector": 6,
|
|
2771
|
+
"algolia": 7,
|
|
2772
|
+
"autocomplete": 4,
|
|
2773
|
+
"typeahead": 5
|
|
2774
|
+
},
|
|
2775
|
+
"files": [
|
|
2776
|
+
"**/meilisearch*",
|
|
2777
|
+
"**/typesense*",
|
|
2778
|
+
"**/elasticsearch*"
|
|
2779
|
+
]
|
|
2780
|
+
},
|
|
2781
|
+
"tools": [
|
|
2782
|
+
"Postgres tsvector and pgvector",
|
|
2783
|
+
"Meilisearch, Typesense, Elasticsearch / OpenSearch",
|
|
2784
|
+
"Algolia, Pinecone, Qdrant, Weaviate",
|
|
2785
|
+
"Embedding models (OpenAI, Cohere, open weights)",
|
|
2786
|
+
"Judged query sets and ranx / custom nDCG scripts",
|
|
2787
|
+
"Query logging and zero-result dashboards"
|
|
2788
|
+
],
|
|
2789
|
+
"decides": [
|
|
2790
|
+
"Engine choice and index schema",
|
|
2791
|
+
"Ranking formula and boosts",
|
|
2792
|
+
"Freshness versus reindex cost",
|
|
2793
|
+
"Relevance metric and threshold"
|
|
2794
|
+
]
|
|
2795
|
+
},
|
|
2796
|
+
{
|
|
2797
|
+
"id": "realtime",
|
|
2798
|
+
"label": "Realtime",
|
|
2799
|
+
"title": "Realtime systems engineer",
|
|
2800
|
+
"group": "Platform",
|
|
2801
|
+
"icon": "Waves",
|
|
2802
|
+
"tagline": "WebSockets, SSE, presence, queues and event streams that survive reconnects and load.",
|
|
2803
|
+
"ui": false,
|
|
2804
|
+
"skills": [
|
|
2805
|
+
"realtime-streaming",
|
|
2806
|
+
"backend-api",
|
|
2807
|
+
"observability-otel",
|
|
2808
|
+
"secrets-and-env"
|
|
2809
|
+
],
|
|
2810
|
+
"focus": [
|
|
2811
|
+
"Pick the transport by need (SSE, WebSockets, a durable queue); on serverless use a managed realtime layer instead of long-lived sockets.",
|
|
2812
|
+
"Protocol with versioned message types, ids and timestamps, heartbeats, backoff reconnect with resume, idempotent handlers.",
|
|
2813
|
+
"Server-authoritative state; optimistic clients reconcile; CRDTs (Yjs, Automerge) for collaboration instead of hand-rolled merging.",
|
|
2814
|
+
"Prove it with two clients: delivery under a second, replay after reconnect, server survives a vanished client; add backpressure and connection limits."
|
|
2815
|
+
],
|
|
2816
|
+
"done": [
|
|
2817
|
+
"Two-client test shows delivery and replay after reconnect",
|
|
2818
|
+
"Messages are versioned, idempotent and resumable",
|
|
2819
|
+
"Backpressure and connection limits exist"
|
|
2820
|
+
],
|
|
2821
|
+
"gate": {
|
|
2822
|
+
"noMock": true,
|
|
2823
|
+
"artifacts": [
|
|
2824
|
+
{
|
|
2825
|
+
"label": "Realtime server or channel code",
|
|
2826
|
+
"globs": [
|
|
2827
|
+
"**/ws/**",
|
|
2828
|
+
"**/socket*",
|
|
2829
|
+
"**/realtime/**",
|
|
2830
|
+
"**/sse*",
|
|
2831
|
+
"**/stream*",
|
|
2832
|
+
"**/channels/**",
|
|
2833
|
+
"**/consumers.py",
|
|
2834
|
+
"**/*.proto"
|
|
2835
|
+
]
|
|
2836
|
+
},
|
|
2837
|
+
{
|
|
2838
|
+
"label": "Automated tests",
|
|
2839
|
+
"globs": [
|
|
2840
|
+
"tests/**",
|
|
2841
|
+
"test/**",
|
|
2842
|
+
"**/__tests__/**",
|
|
2843
|
+
"**/*.test.*",
|
|
2844
|
+
"**/*.spec.*",
|
|
2845
|
+
"**/test_*.py",
|
|
2846
|
+
"**/*_test.py",
|
|
2847
|
+
"**/*_test.go",
|
|
2848
|
+
"e2e/**",
|
|
2849
|
+
"spec/**"
|
|
2850
|
+
]
|
|
2851
|
+
}
|
|
2852
|
+
]
|
|
2853
|
+
},
|
|
2854
|
+
"phase1": "Phase 1 must be a working channel end to end: server endpoint, client with reconnect and resume, one real event type and the two-client test.",
|
|
2855
|
+
"detect": {
|
|
2856
|
+
"keywords": {
|
|
2857
|
+
"websocket": 7,
|
|
2858
|
+
"websockets": 7,
|
|
2859
|
+
"realtime": 6,
|
|
2860
|
+
"real-time": 6,
|
|
2861
|
+
"real time": 4,
|
|
2862
|
+
"live updates": 6,
|
|
2863
|
+
"presence": 5,
|
|
2864
|
+
"pub/sub": 6,
|
|
2865
|
+
"pubsub": 6,
|
|
2866
|
+
"kafka": 5,
|
|
2867
|
+
"redis streams": 7,
|
|
2868
|
+
"sse": 5,
|
|
2869
|
+
"server-sent events": 7,
|
|
2870
|
+
"collaborative editing": 7,
|
|
2871
|
+
"live cursors": 7,
|
|
2872
|
+
"crdt": 7,
|
|
2873
|
+
"yjs": 7,
|
|
2874
|
+
"liveblocks": 7,
|
|
2875
|
+
"socket.io": 7,
|
|
2876
|
+
"event stream": 6,
|
|
2877
|
+
"live chat": 6,
|
|
2878
|
+
"chat app": 4
|
|
2879
|
+
},
|
|
2880
|
+
"files": [
|
|
2881
|
+
"**/socket.io*",
|
|
2882
|
+
"**/*.proto"
|
|
2883
|
+
]
|
|
2884
|
+
},
|
|
2885
|
+
"tools": [
|
|
2886
|
+
"ws, Socket.IO, uWebSockets, Django Channels",
|
|
2887
|
+
"Redis Pub/Sub and Streams, NATS, Kafka",
|
|
2888
|
+
"Supabase Realtime, Ably, Pusher, Liveblocks, PartyKit",
|
|
2889
|
+
"Yjs and Automerge",
|
|
2890
|
+
"k6 WebSocket load tests",
|
|
2891
|
+
"OpenTelemetry for connection metrics"
|
|
2892
|
+
],
|
|
2893
|
+
"decides": [
|
|
2894
|
+
"Transport and delivery guarantees",
|
|
2895
|
+
"Message schema and versioning",
|
|
2896
|
+
"Authority model and conflict handling",
|
|
2897
|
+
"Scale-out and fan-out strategy"
|
|
2898
|
+
]
|
|
2899
|
+
},
|
|
2900
|
+
{
|
|
2901
|
+
"id": "growth",
|
|
2902
|
+
"label": "Growth",
|
|
2903
|
+
"title": "Growth engineer",
|
|
2904
|
+
"group": "Product",
|
|
2905
|
+
"icon": "TrendingUp",
|
|
2906
|
+
"tagline": "Funnels, experiments, SEO and activation changes tied to measured outcomes.",
|
|
2907
|
+
"ui": true,
|
|
2908
|
+
"skills": [
|
|
2909
|
+
"growth-experiments",
|
|
2910
|
+
"product-analytics",
|
|
2911
|
+
"nextjs-app",
|
|
2912
|
+
"email-resend"
|
|
2913
|
+
],
|
|
2914
|
+
"focus": [
|
|
2915
|
+
"Instrument first: funnel events with a shared naming scheme through the existing analytics, with user and session ids; verify events arrive before building on them.",
|
|
2916
|
+
"Experiments have a hypothesis, primary metric, estimated sample size, deterministic bucketing and single exposure logging; no peeking.",
|
|
2917
|
+
"SEO and sharing basics: titles, descriptions, canonicals, Open Graph images, sitemap, robots, structured data, fast LCP.",
|
|
2918
|
+
"Activation: remove steps before adding features, show progress, sensible defaults, the one lifecycle email that matters. Every change is tied to a number in the summary."
|
|
2919
|
+
],
|
|
2920
|
+
"done": [
|
|
2921
|
+
"Funnel events verified arriving in analytics",
|
|
2922
|
+
"Experiment has a flag, hypothesis and metric written down",
|
|
2923
|
+
"SEO checks pass (Lighthouse SEO, valid OG tags)"
|
|
2924
|
+
],
|
|
2925
|
+
"gate": {
|
|
2926
|
+
"noMock": false,
|
|
2927
|
+
"artifacts": []
|
|
2928
|
+
},
|
|
2929
|
+
"phase1": "Phase 1 must be the instrumented funnel with verified events plus the first experiment or SEO fix shipped behind a flag.",
|
|
2930
|
+
"detect": {
|
|
2931
|
+
"keywords": {
|
|
2932
|
+
"a/b test": 7,
|
|
2933
|
+
"ab test": 7,
|
|
2934
|
+
"a/b testing": 7,
|
|
2935
|
+
"experiment": 4,
|
|
2936
|
+
"experiments": 4,
|
|
2937
|
+
"feature flag": 5,
|
|
2938
|
+
"feature flags": 5,
|
|
2939
|
+
"conversion": 5,
|
|
2940
|
+
"conversion rate": 7,
|
|
2941
|
+
"funnel": 6,
|
|
2942
|
+
"seo": 7,
|
|
2943
|
+
"onboarding flow": 6,
|
|
2944
|
+
"signup flow": 6,
|
|
2945
|
+
"activation": 4,
|
|
2946
|
+
"retention": 4,
|
|
2947
|
+
"growth": 5,
|
|
2948
|
+
"referral": 5,
|
|
2949
|
+
"referral program": 7,
|
|
2950
|
+
"landing page conversion": 7,
|
|
2951
|
+
"waitlist": 4,
|
|
2952
|
+
"growth hack": 6,
|
|
2953
|
+
"open graph": 6,
|
|
2954
|
+
"sitemap": 5
|
|
2955
|
+
},
|
|
2956
|
+
"files": [
|
|
2957
|
+
"sitemap.xml",
|
|
2958
|
+
"app/sitemap.*",
|
|
2959
|
+
"robots.txt",
|
|
2960
|
+
"posthog.*"
|
|
2961
|
+
]
|
|
2962
|
+
},
|
|
2963
|
+
"tools": [
|
|
2964
|
+
"PostHog, GA4, Segment, Amplitude",
|
|
2965
|
+
"Feature flag systems (PostHog, LaunchDarkly, Statsig)",
|
|
2966
|
+
"Lighthouse SEO and Google Search Console",
|
|
2967
|
+
"Resend / Customer.io for lifecycle email",
|
|
2968
|
+
"OG image generation (next/og)",
|
|
2969
|
+
"Statistical calculators for sample size"
|
|
2970
|
+
],
|
|
2971
|
+
"decides": [
|
|
2972
|
+
"Funnel definition and event taxonomy",
|
|
2973
|
+
"Experiment design and stopping rule",
|
|
2974
|
+
"SEO structure and content targets",
|
|
2975
|
+
"Which activation step to fix first"
|
|
2976
|
+
]
|
|
2977
|
+
},
|
|
2978
|
+
{
|
|
2979
|
+
"id": "web3",
|
|
2980
|
+
"label": "Web3",
|
|
2981
|
+
"title": "Smart contract and web3 engineer",
|
|
2982
|
+
"group": "Product",
|
|
2983
|
+
"icon": "Hexagon",
|
|
2984
|
+
"tagline": "Solidity with Foundry or Hardhat, wallet frontends, and nothing on mainnet without approval.",
|
|
2985
|
+
"ui": true,
|
|
2986
|
+
"skills": [
|
|
2987
|
+
"web3-solidity",
|
|
2988
|
+
"security-appsec",
|
|
2989
|
+
"ui-shadcn-tailwind",
|
|
2990
|
+
"secrets-and-env"
|
|
2991
|
+
],
|
|
2992
|
+
"focus": [
|
|
2993
|
+
"Use Foundry (or the existing Hardhat setup): pinned compiler, OpenZeppelin standards, Checks-Effects-Interactions, reentrancy guards, access control, events for every state change.",
|
|
2994
|
+
"Tests cover happy paths, reverts with custom errors, fuzzing and invariants; run forge test and slither where available and fix findings first.",
|
|
2995
|
+
"Frontend with wagmi + viem, typed ABIs from artifacts, chain switching, pending/confirmed/failed states and simulated calls before sending.",
|
|
2996
|
+
"Deploy only to local or test networks without explicit approval; mainnet deploys and upgrades are irreversible and need a verified source and a key-management plan."
|
|
2997
|
+
],
|
|
2998
|
+
"done": [
|
|
2999
|
+
"forge test (or hardhat test) passes including reverts and fuzz cases",
|
|
3000
|
+
"No mainnet deployment or key request without approval",
|
|
3001
|
+
"Frontend handles pending, confirmed and failed transactions"
|
|
3002
|
+
],
|
|
3003
|
+
"gate": {
|
|
3004
|
+
"noMock": false,
|
|
3005
|
+
"artifacts": [
|
|
3006
|
+
{
|
|
3007
|
+
"label": "Contracts",
|
|
3008
|
+
"globs": [
|
|
3009
|
+
"**/*.sol",
|
|
3010
|
+
"contracts/**",
|
|
3011
|
+
"src/**/*.sol",
|
|
3012
|
+
"foundry.toml",
|
|
3013
|
+
"hardhat.config.*"
|
|
3014
|
+
]
|
|
3015
|
+
},
|
|
3016
|
+
{
|
|
3017
|
+
"label": "Automated tests",
|
|
3018
|
+
"globs": [
|
|
3019
|
+
"tests/**",
|
|
3020
|
+
"test/**",
|
|
3021
|
+
"**/__tests__/**",
|
|
3022
|
+
"**/*.test.*",
|
|
3023
|
+
"**/*.spec.*",
|
|
3024
|
+
"**/test_*.py",
|
|
3025
|
+
"**/*_test.py",
|
|
3026
|
+
"**/*_test.go",
|
|
3027
|
+
"e2e/**",
|
|
3028
|
+
"spec/**",
|
|
3029
|
+
"test/**/*.t.sol",
|
|
3030
|
+
"**/*.t.sol"
|
|
3031
|
+
]
|
|
3032
|
+
}
|
|
3033
|
+
]
|
|
3034
|
+
},
|
|
3035
|
+
"phase1": "Phase 1 must be the contract with tests passing on a local chain and, when a UI is asked for, a wallet-connected screen calling it on a test network.",
|
|
3036
|
+
"detect": {
|
|
3037
|
+
"keywords": {
|
|
3038
|
+
"solidity": 7,
|
|
3039
|
+
"smart contract": 7,
|
|
3040
|
+
"smart contracts": 7,
|
|
3041
|
+
"web3": 7,
|
|
3042
|
+
"ethereum": 6,
|
|
3043
|
+
"evm": 6,
|
|
3044
|
+
"erc20": 7,
|
|
3045
|
+
"erc-20": 7,
|
|
3046
|
+
"erc721": 7,
|
|
3047
|
+
"erc-721": 7,
|
|
3048
|
+
"nft": 6,
|
|
3049
|
+
"wallet connect": 6,
|
|
3050
|
+
"walletconnect": 6,
|
|
3051
|
+
"wagmi": 7,
|
|
3052
|
+
"viem": 6,
|
|
3053
|
+
"hardhat": 7,
|
|
3054
|
+
"foundry": 6,
|
|
3055
|
+
"defi": 7,
|
|
3056
|
+
"onchain": 7,
|
|
3057
|
+
"on-chain": 7,
|
|
3058
|
+
"dapp": 7,
|
|
3059
|
+
"token contract": 7,
|
|
3060
|
+
"solana": 6,
|
|
3061
|
+
"anchor program": 7,
|
|
3062
|
+
"blockchain": 5
|
|
3063
|
+
},
|
|
3064
|
+
"files": [
|
|
3065
|
+
"foundry.toml",
|
|
3066
|
+
"hardhat.config.*",
|
|
3067
|
+
"**/*.sol"
|
|
3068
|
+
]
|
|
3069
|
+
},
|
|
3070
|
+
"tools": [
|
|
3071
|
+
"Foundry (forge, cast, anvil) and Hardhat",
|
|
3072
|
+
"OpenZeppelin contracts",
|
|
3073
|
+
"Slither, Mythril, Echidna",
|
|
3074
|
+
"wagmi, viem, ethers, RainbowKit",
|
|
3075
|
+
"Alchemy / Infura RPCs, Etherscan verification",
|
|
3076
|
+
"Tenderly simulations"
|
|
3077
|
+
],
|
|
3078
|
+
"decides": [
|
|
3079
|
+
"Contract architecture and upgradeability",
|
|
3080
|
+
"Access control and admin keys",
|
|
3081
|
+
"Gas versus readability trade-offs",
|
|
3082
|
+
"Deployment network and verification steps"
|
|
3083
|
+
]
|
|
3084
|
+
},
|
|
3085
|
+
{
|
|
3086
|
+
"id": "i18n",
|
|
3087
|
+
"label": "i18n",
|
|
3088
|
+
"title": "Internationalisation engineer",
|
|
3089
|
+
"group": "Product",
|
|
3090
|
+
"icon": "Languages",
|
|
3091
|
+
"tagline": "Locale support done right: catalogs, plurals, dates and currencies, RTL and translation workflow.",
|
|
3092
|
+
"ui": true,
|
|
3093
|
+
"skills": [
|
|
3094
|
+
"i18n-l10n",
|
|
3095
|
+
"nextjs-app",
|
|
3096
|
+
"ui-shadcn-tailwind",
|
|
3097
|
+
"e2e-playwright"
|
|
3098
|
+
],
|
|
3099
|
+
"focus": [
|
|
3100
|
+
"Use the framework i18n library; no string concatenation; ICU messages for plurals and gender; Intl for dates, numbers and currencies; locale in the URL or cookie with a sensible default.",
|
|
3101
|
+
"Extract every user-visible string into the catalog with stable keys; keep the source locale complete and add a missing-keys check.",
|
|
3102
|
+
"Layout survives: logical CSS properties, dir=rtl, text expansion room, no text in images, locale-aware sorting and search.",
|
|
3103
|
+
"Verify by switching to at least two locales in the browser tool (one RTL when supported) and checking plurals, a date and a price."
|
|
3104
|
+
],
|
|
3105
|
+
"done": [
|
|
3106
|
+
"All user-visible strings come from the catalog",
|
|
3107
|
+
"Missing-keys check passes for every locale",
|
|
3108
|
+
"Two locales verified in the browser including a formatted date and price"
|
|
3109
|
+
],
|
|
3110
|
+
"gate": {
|
|
3111
|
+
"noMock": false,
|
|
3112
|
+
"artifacts": [
|
|
3113
|
+
{
|
|
3114
|
+
"label": "Message catalogs",
|
|
3115
|
+
"globs": [
|
|
3116
|
+
"locales/**",
|
|
3117
|
+
"messages/**",
|
|
3118
|
+
"i18n/**",
|
|
3119
|
+
"**/locales/**",
|
|
3120
|
+
"**/*.po",
|
|
3121
|
+
"**/*.arb",
|
|
3122
|
+
"public/locales/**"
|
|
3123
|
+
]
|
|
3124
|
+
}
|
|
3125
|
+
]
|
|
3126
|
+
},
|
|
3127
|
+
"phase1": "Phase 1 must be the i18n setup with the source catalog extracted, one additional locale and locale switching working in the browser.",
|
|
3128
|
+
"detect": {
|
|
3129
|
+
"keywords": {
|
|
3130
|
+
"i18n": 7,
|
|
3131
|
+
"l10n": 7,
|
|
3132
|
+
"internationalization": 7,
|
|
3133
|
+
"internationalisation": 7,
|
|
3134
|
+
"localization": 7,
|
|
3135
|
+
"localisation": 7,
|
|
3136
|
+
"translate the app": 7,
|
|
3137
|
+
"translations": 6,
|
|
3138
|
+
"translation": 4,
|
|
3139
|
+
"multi-language": 7,
|
|
3140
|
+
"multilingual": 7,
|
|
3141
|
+
"multiple languages": 6,
|
|
3142
|
+
"rtl": 6,
|
|
3143
|
+
"right-to-left": 6,
|
|
3144
|
+
"locale": 5,
|
|
3145
|
+
"locales": 6,
|
|
3146
|
+
"spanish version": 5,
|
|
3147
|
+
"in spanish and english": 6,
|
|
3148
|
+
"language switcher": 7
|
|
3149
|
+
},
|
|
3150
|
+
"files": [
|
|
3151
|
+
"locales/**",
|
|
3152
|
+
"messages/**",
|
|
3153
|
+
"public/locales/**",
|
|
3154
|
+
"**/*.po"
|
|
3155
|
+
]
|
|
3156
|
+
},
|
|
3157
|
+
"tools": [
|
|
3158
|
+
"next-intl, react-intl, i18next, Lingui",
|
|
3159
|
+
"FormatJS / i18next extractors",
|
|
3160
|
+
"Intl APIs and ICU MessageFormat",
|
|
3161
|
+
"Crowdin, Lokalise, Weblate",
|
|
3162
|
+
"DeepL or model translation for first drafts (human-reviewed)",
|
|
3163
|
+
"Playwright locale switching"
|
|
3164
|
+
],
|
|
3165
|
+
"decides": [
|
|
3166
|
+
"Locale routing and default",
|
|
3167
|
+
"Key naming and catalog structure",
|
|
3168
|
+
"What is translated by machine versus people",
|
|
3169
|
+
"RTL and layout policy"
|
|
3170
|
+
]
|
|
3171
|
+
}
|
|
3172
|
+
]
|
|
3173
|
+
}
|