Merge pull request #228 from httpsphl/feat/catalog-engineering-roles-2

feat(catalog): eight more engineering roles

Author: httpsphl

app/src/features/catalog/agency.test.tsx

@@ -33,7 +33,7 @@ describe("the Bot agency", () => {
 
     fireEvent.click(within(invite).getByRole("button", { name: "See all bots" }));
     const dialog = await screen.findByRole("dialog", { name: "Bot agency" });
-    expect(await within(dialog).findAllByRole("listitem")).toHaveLength(86);
+    expect(await within(dialog).findAllByRole("listitem")).toHaveLength(94);
   });
 
   test("a crew with only its chief invites the owner to pick bots, and a click adds one", async () => {
@@ -82,7 +82,7 @@ describe("the Bot agency", () => {
     await openCrewWithChief();
     fireEvent.click(screen.getByRole("button", { name: "Bot agency" }));
     const dialog = await screen.findByRole("dialog", { name: "Bot agency" });
-    expect(await within(dialog).findAllByRole("listitem")).toHaveLength(86);
+    expect(await within(dialog).findAllByRole("listitem")).toHaveLength(94);
 
     fireEvent.click(within(dialog).getByRole("button", { name: "Marketing & sales" }));
     expect(within(dialog).getAllByRole("listitem")).toHaveLength(24);
@@ -129,7 +129,7 @@ describe("the Bot agency", () => {
     expect(addCalls(fake)[0]).toMatchObject({ templateId: "code-reviewer" });
 
     fireEvent.click(within(dialog).getByRole("button", { name: "Back to all bots" }));
-    expect(within(dialog).getAllByRole("listitem")).toHaveLength(86);
+    expect(within(dialog).getAllByRole("listitem")).toHaveLength(94);
   });
 
   test("the same role twice gets another name", async () => {

app/src/i18n/en/catalog.ts

@@ -2,6 +2,7 @@ import { base } from "./catalogBase";
 import { contentAndLearning } from "./catalogContent";
 import { design } from "./catalogDesign";
 import { engineering } from "./catalogEngineering";
+import { engineeringMore } from "./catalogEngineeringMore";
 import { finance } from "./catalogFinance";
 import { marketing } from "./catalogMarketing";
 import { paidMedia } from "./catalogPaidMedia";
@@ -65,5 +66,6 @@ export const catalog = {
     ...finance,
     ...paidMedia,
     ...people,
+    ...engineeringMore,
   },
 };

app/src/i18n/en/catalogEngineeringMore.ts

@@ -0,0 +1,85 @@
+// More engineering roles (spec 26.3): what the owner reads about each. All
+// work on the owner's own code, with the Manual mode's approvals.
+
+export const engineeringMore = {
+  "technical-writer": {
+    name: "Technical Writer",
+    role: "Writes clear documentation from the real code and setup: guides, references and how-tos that match what the system does",
+    summary:
+      "Writes clear docs from your real code and setup: guides, how-tos and references that stay true",
+    about:
+      "Reads your code and runs the commands it documents on a copy, so the steps and the output are real. It writes for one reader at a time: the most common task first, numbered steps, what you should see after each one and what to do when it fails. It tells you what it tested and what it only read.",
+    when: "When your project has no README, the docs are out of date, or someone new has to take over.",
+    pairs: "Codebase Guide, for the big picture, and Code Reviewer, to check the technical claims.",
+  },
+  "sre-engineer": {
+    name: "Reliability Engineer",
+    role: "Makes your service dependable: defines what good looks like, sets up alerts that matter and writes the steps to follow when it breaks",
+    summary:
+      "Makes your service dependable: clear targets, alerts that matter and steps to follow when it breaks",
+    about:
+      "Turns what your users feel into a few targets in numbers, maps where the service can fail and proposes alerts that mean a person must act now, each with the first thing to check. It writes short runbooks for the usual failures and a blameless review after an incident. It never restarts or changes anything in production on its own.",
+    when: "When your service goes down too often, or you get alerts you ignore.",
+    pairs: "DevOps Engineer, for the infrastructure, and Backend Developer, for the fixes in code.",
+  },
+  "release-engineer": {
+    name: "Release Engineer",
+    role: "Plans and prepares releases: version numbers, change notes, checks before shipping and a way back, without publishing for you",
+    summary:
+      "Plans and prepares your releases, with notes, a checklist and a way back, and never ships by itself",
+    about:
+      "Reads what changed since the last release, groups it by what users notice and proposes the version number and the notes in plain words. It writes a checklist, the steps to ship and the steps to undo, and says which one is hard to undo. You make the tag, the upload and the announcement yourself, and it never touches your signing keys.",
+    when: "Before every release of an app, a library or a site.",
+    pairs: "QA Tester, to run the checklist, and DevOps Engineer, for the pipeline.",
+  },
+  "codebase-guide": {
+    name: "Codebase Guide",
+    role: "Explains an unfamiliar codebase: the big picture, where things live, how a request flows and where to start changing",
+    summary:
+      "Explains an unfamiliar codebase: the big picture, where things live and where to start",
+    about:
+      "Tailors a tour to what you need to do, traces one real path from start to end by file and function and points out the conventions, the risky areas and the tests. It says what it is sure of and what it inferred, and ends with a small first task. It only reads; it changes nothing unless you ask.",
+    when: "When you inherit code, join a project or have to change something you did not write.",
+    pairs: "Technical Writer, to turn the tour into docs, and Software Architect.",
+  },
+  "prompt-engineer": {
+    name: "Instruction Writer for AI",
+    role: "Writes and improves the instructions you give to AI models, then tests them on real examples before you rely on them",
+    summary:
+      "Writes and improves instructions for AI models and tests them on real examples before you trust them",
+    about:
+      "Asks for real examples, including hard ones, writes the instruction with a clear goal, rules, answer format and examples, and tests it, changing one thing at a time. You get a table of results for each version and the weak spots that remain. It warns you when the instruction will read untrusted text that could give orders.",
+    when: "When an AI feature in your app or workflow gives answers you cannot rely on.",
+    pairs: "Backend Developer, to wire it in, and QA Tester, to try more cases.",
+  },
+  "rapid-prototyper": {
+    name: "Prototype Builder",
+    role: "Builds a quick working version of an idea to test it with real people, in the simplest way that works, and says what is faked",
+    summary:
+      "Builds a quick working version of your idea to test with real people, and says what is faked",
+    about:
+      "Starts from the question the prototype must answer and builds only that, with made-up data and no real accounts. It writes a short test for the people who will try it and a note saying what is faked and what a real version needs, so nobody ships the prototype by accident.",
+    when: "When you have an idea and want to know if people care before you build it properly.",
+    pairs: "Designer, for the look, and UX Researcher, to run the test.",
+  },
+  "localization-engineer": {
+    name: "Localization Engineer",
+    role: "Prepares software for several languages and countries: moves text out of the code, handles dates, numbers and plurals, and checks the result",
+    summary:
+      "Prepares your software for several languages and countries and checks that nothing breaks",
+    about:
+      "Moves the text out of your code into translation files, with one sentence per key and placeholders instead of joined pieces. It handles plurals, dates, numbers and currencies by the user's region, checks layouts with long words and adds a test that fails when a language is missing a string. It hands the new strings to a translator.",
+    when: "When you want your app or site in a second language, or a country with different formats.",
+    pairs: "Translator, for the strings, and Frontend Developer, for the layout.",
+  },
+  "refactoring-engineer": {
+    name: "Code Cleanup Engineer",
+    role: "Cleans up code in small, safe steps without changing what it does, proving each step with tests",
+    summary:
+      "Cleans up your code in small, safe steps without changing what it does, with tests for each step",
+    about:
+      "Starts from a reason, makes sure tests exist before it touches anything and then changes one thing at a time, each as its own small commit. It does not mix a cleanup with a behavior change, and it never edits a test just to make a cleanup pass. It lists what it saw but left alone.",
+    when: "When code is hard to change or understand and you want it better without breaking it.",
+    pairs: "Code Reviewer, to check each step, and QA Tester, to try the behavior.",
+  },
+};

app/src/i18n/es/catalog.ts

@@ -3,6 +3,7 @@ import { base } from "./catalogBase";
 import { contentAndLearning } from "./catalogContent";
 import { design } from "./catalogDesign";
 import { engineering } from "./catalogEngineering";
+import { engineeringMore } from "./catalogEngineeringMore";
 import { finance } from "./catalogFinance";
 import { marketing } from "./catalogMarketing";
 import { paidMedia } from "./catalogPaidMedia";
@@ -62,5 +63,6 @@ export const catalog: Messages["catalog"] = {
     ...finance,
     ...paidMedia,
     ...people,
+    ...engineeringMore,
   },
 };

app/src/i18n/es/catalogEngineeringMore.ts

@@ -0,0 +1,85 @@
+import type { engineeringMore as en } from "../en/catalogEngineeringMore";
+
+export const engineeringMore: typeof en = {
+  "technical-writer": {
+    name: "Redactor técnico",
+    role: "Escribe documentación clara a partir del código y la configuración reales: guías, referencias y pasos que coinciden con lo que hace el sistema",
+    summary:
+      "Escribe documentación clara a partir de tu código y tu configuración reales, que sigue siendo verdadera",
+    about:
+      "Lee tu código y ejecuta en una copia los comandos que documenta, para que los pasos y la salida sean reales. Escribe para un lector cada vez: la tarea más común primero, pasos numerados, lo que deberías ver tras cada uno y qué hacer cuando falla. Dice lo que probó y lo que solo leyó.",
+    when: "Cuando tu proyecto no tiene README, la documentación está vieja o alguien nuevo va a hacerse cargo.",
+    pairs:
+      "Guía del código, para el panorama general, y Revisor de código, para comprobar las afirmaciones técnicas.",
+  },
+  "sre-engineer": {
+    name: "Ingeniero de fiabilidad",
+    role: "Hace tu servicio fiable: define qué es bueno en números, monta alertas que importan y escribe los pasos para cuando falle",
+    summary:
+      "Hace tu servicio fiable: metas claras, alertas que importan y pasos para cuando falle",
+    about:
+      "Convierte lo que sienten tus usuarios en pocas metas en números, mapea dónde puede fallar el servicio y propone alertas que significan que alguien debe actuar ya, cada una con lo primero que revisar. Escribe guías cortas para los fallos comunes y una revisión sin culpables tras un incidente. Nunca reinicia ni cambia nada en producción por su cuenta.",
+    when: "Cuando tu servicio se cae demasiado, o recibes alertas que ignoras.",
+    pairs:
+      "Ingeniero DevOps, para la infraestructura, y Desarrollador back-end, para las correcciones en el código.",
+  },
+  "release-engineer": {
+    name: "Ingeniero de lanzamientos",
+    role: "Planifica y prepara lanzamientos: números de versión, notas de cambios, comprobaciones antes de publicar y un camino de vuelta, sin publicar por ti",
+    summary:
+      "Planifica y prepara tus lanzamientos, con notas, lista de comprobación y camino de vuelta, y nunca publica solo",
+    about:
+      "Lee lo que cambió desde el último lanzamiento, lo agrupa por lo que notan los usuarios y propone el número de versión y las notas en palabras sencillas. Escribe una lista de comprobación, los pasos para publicar y los pasos para deshacer, y dice cuál es difícil de deshacer. La etiqueta, la subida y el anuncio los haces tú, y nunca toca tus claves de firma.",
+    when: "Antes de cada lanzamiento de una app, una biblioteca o un sitio.",
+    pairs: "Tester, para ejecutar la lista, e Ingeniero DevOps, para la cadena de publicación.",
+  },
+  "codebase-guide": {
+    name: "Guía del código",
+    role: "Explica un código desconocido: el panorama general, dónde está cada cosa, cómo recorre una petición el sistema y por dónde empezar a cambiar",
+    summary:
+      "Explica un código desconocido: el panorama general, dónde está cada cosa y por dónde empezar",
+    about:
+      "Adapta la visita a lo que necesitas hacer, sigue un camino real de principio a fin por archivo y función y señala las convenciones, las zonas de riesgo y las pruebas. Dice de qué está seguro y qué dedujo, y termina con una primera tarea pequeña. Solo lee; no cambia nada si no se lo pides.",
+    when: "Cuando heredas código, entras en un proyecto o tienes que cambiar algo que no escribiste.",
+    pairs: "Redactor técnico, para convertirlo en documentación, y Arquitecto de software.",
+  },
+  "prompt-engineer": {
+    name: "Redactor de instrucciones para IA",
+    role: "Escribe y mejora las instrucciones que das a modelos de IA y las prueba con ejemplos reales antes de que confíes en ellas",
+    summary:
+      "Escribe y mejora instrucciones para modelos de IA y las prueba con ejemplos reales antes de que confíes",
+    about:
+      "Pide ejemplos reales, también difíciles, escribe la instrucción con un objetivo claro, reglas, formato de la respuesta y ejemplos, y la prueba cambiando una cosa a la vez. Recibes una tabla de resultados de cada versión y los puntos débiles que quedan. Avisa cuando la instrucción va a leer un texto externo que podría dar órdenes.",
+    when: "Cuando una función de IA en tu app o flujo da respuestas en las que no puedes confiar.",
+    pairs: "Desarrollador back-end, para conectarlo, y Tester, para probar más casos.",
+  },
+  "rapid-prototyper": {
+    name: "Creador de prototipos",
+    role: "Monta rápido una versión que funciona de una idea para probarla con personas reales, de la forma más simple, y dice qué es de mentira",
+    summary:
+      "Monta rápido una versión de tu idea para probarla con personas reales y dice qué es de mentira",
+    about:
+      "Parte de la pregunta que el prototipo debe responder y construye solo eso, con datos inventados y sin cuentas reales. Escribe una prueba corta para quienes lo van a probar y una nota que dice qué es de mentira y qué necesita una versión real, para que nadie publique el prototipo por error.",
+    when: "Cuando tienes una idea y quieres saber si a la gente le importa antes de construirla bien.",
+    pairs: "Diseñador, para el aspecto, e Investigador de usuarios, para dirigir la prueba.",
+  },
+  "localization-engineer": {
+    name: "Ingeniero de localización",
+    role: "Prepara el software para varios idiomas y países: saca el texto del código, trata fechas, números y plurales y comprueba el resultado",
+    summary: "Prepara tu software para varios idiomas y países y comprueba que nada se rompe",
+    about:
+      "Saca el texto de tu código a archivos de traducción, con una frase por clave y marcadores en lugar de trozos pegados. Trata plurales, fechas, números y monedas según la región del usuario, comprueba el diseño con palabras largas y crea una prueba que falla cuando falta un texto en un idioma. Entrega los textos nuevos a un traductor.",
+    when: "Cuando quieres tu app o sitio en un segundo idioma, o en un país con formatos distintos.",
+    pairs: "Traductor, para los textos, y Desarrollador front-end, para el diseño.",
+  },
+  "refactoring-engineer": {
+    name: "Ingeniero de limpieza de código",
+    role: "Ordena el código en pasos pequeños y seguros, sin cambiar lo que hace, demostrando cada paso con pruebas",
+    summary:
+      "Ordena tu código en pasos pequeños y seguros, sin cambiar lo que hace, con pruebas en cada paso",
+    about:
+      "Parte de un motivo, se asegura de que existan pruebas antes de tocar nada y cambia una cosa a la vez, cada una en un commit pequeño. No mezcla una limpieza con un cambio de comportamiento y nunca modifica una prueba solo para que la limpieza pase. Lista lo que vio y dejó quieto.",
+    when: "Cuando el código es difícil de cambiar o de entender y quieres mejorarlo sin romperlo.",
+    pairs: "Revisor de código, para comprobar cada paso, y Tester, para probar el comportamiento.",
+  },
+};

app/src/i18n/pt-BR/catalog.ts

@@ -3,6 +3,7 @@ import { base } from "./catalogBase";
 import { contentAndLearning } from "./catalogContent";
 import { design } from "./catalogDesign";
 import { engineering } from "./catalogEngineering";
+import { engineeringMore } from "./catalogEngineeringMore";
 import { finance } from "./catalogFinance";
 import { marketing } from "./catalogMarketing";
 import { paidMedia } from "./catalogPaidMedia";
@@ -62,5 +63,6 @@ export const catalog: Messages["catalog"] = {
     ...finance,
     ...paidMedia,
     ...people,
+    ...engineeringMore,
   },
 };