Merge pull request #232 from httpsphl/feat/catalog-games-roles

feat(catalog): seven game making roles

Author: httpsphl

app/src/features/catalog/AgencyGrid.tsx

@@ -29,6 +29,7 @@ const CATEGORIES: Category[] = [
   "finance",
   "people",
   "security",
+  "games",
   "legal",
 ];
 

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(115);
+    expect(await within(dialog).findAllByRole("listitem")).toHaveLength(122);
   });
 
   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(115);
+    expect(await within(dialog).findAllByRole("listitem")).toHaveLength(122);
 
     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(115);
+    expect(within(dialog).getAllByRole("listitem")).toHaveLength(122);
   });
 
   test("the same role twice gets another name", async () => {

app/src/i18n/en/catalog.ts

@@ -4,6 +4,7 @@ import { design } from "./catalogDesign";
 import { engineering } from "./catalogEngineering";
 import { engineeringMore } from "./catalogEngineeringMore";
 import { finance } from "./catalogFinance";
+import { games } from "./catalogGames";
 import { legal } from "./catalogLegal";
 import { marketing } from "./catalogMarketing";
 import { paidMedia } from "./catalogPaidMedia";
@@ -41,6 +42,7 @@ export const catalog = {
     finance: "Finance",
     people: "People & HR",
     security: "Security",
+    games: "Games",
     legal: "Legal",
   },
   none: "No bot matches that.",
@@ -75,5 +77,6 @@ export const catalog = {
     ...security,
     ...sectors,
     ...legal,
+    ...games,
   },
 };

app/src/i18n/en/catalogGames.ts

@@ -0,0 +1,77 @@
+// Game making roles (spec 26.3): what the owner reads about each. All make
+// original work and none designs anything meant to trick players into
+// spending.
+
+export const games = {
+  "game-designer": {
+    name: "Game Designer",
+    role: "Turns a game idea into clear rules and a loop that is fun to repeat: the goal, the choices, the feedback and a first small version to test",
+    summary:
+      "Turns your game idea into clear rules and a fun loop, with a small first version to test",
+    about:
+      "Starts from the experience you want the player to have, finds the loop they repeat and writes the rules in short, exact sentences, checking them for loopholes. It plans the smallest playable version and a test, and when something is not fun it offers two changes to try. The game stays yours.",
+    when: "When you have a game idea, digital or on a table, and want it to become something playable.",
+    pairs: "Narrative Designer, for the story, and Game Economy Designer, for the numbers.",
+  },
+  "game-narrative-designer": {
+    name: "Narrative Designer",
+    role: "Builds the story, characters and world of a game, and writes the text so it fits how the game is played",
+    summary:
+      "Builds the story, characters and world of your game and writes the text so it fits the play",
+    about:
+      "Builds the world on one page, makes characters with a want, a flaw and a voice and plans the story around the player's choices and the length of play. It writes the text in short lines with their context, so a developer can place them. Everything is original, and it tells you which age the sensitive themes suit.",
+    when: "When your game needs a world, a story, quests or characters that people remember.",
+    pairs: "Game Designer, for the rules, and Translator, for other languages.",
+  },
+  "level-designer": {
+    name: "Level Designer",
+    role: "Designs the levels, maps or scenarios of a game so that they teach, challenge and surprise in the right order",
+    summary:
+      "Designs the levels, maps or scenarios of your game so they teach, challenge and surprise in order",
+    about:
+      "Plans the order in which a player learns each mechanic, one new thing at a time, then describes each level with a map in text: the start, the goal, the route, the challenges and the rewards. It checks for places where a player can get stuck or skip the point, and writes a playtest list for each level.",
+    when: "When you have the rules of a game and need the levels or scenarios that use them.",
+    pairs: "Game Designer, to check the rules, and Narrative Designer, for the story beats.",
+  },
+  "game-economy-designer": {
+    name: "Game Economy Designer",
+    role: "Balances the numbers of a game: costs, rewards, progress and prices, so that it stays fair and interesting, without tricking players into spending",
+    summary:
+      "Balances the numbers of your game: costs, rewards and progress, fairly and without tricks",
+    about:
+      "Draws the flows of coins, items and time, puts the numbers in a spreadsheet with formulas and simulates players at different speeds. It finds resources that pile up and paths that are always best. If your game earns money, it proposes fair ways, and never hidden costs, fake countdowns, pay-to-win or paid random rewards aimed at children.",
+    when: "When your game has coins, items or progress and the numbers feel off, or you plan to earn money from it.",
+    pairs: "Game Designer, for the goals, and Data Analyst, for the simulations.",
+  },
+  "playtest-analyst": {
+    name: "Playtest Analyst",
+    role: "Plans playtests and turns what players did and said into clear findings and the changes most worth making",
+    summary:
+      "Plans playtests and turns what players did and said into clear findings and changes worth making",
+    about:
+      "Plans the session so you do not explain or defend the game, then turns your notes into findings: the problem, how many players hit it, where and why. It trusts what players did over what they said, ranks the changes by effect for the effort and suggests the next test. It never contacts players.",
+    when: "After people have tried your game and you are not sure what to change first.",
+    pairs: "Game Designer, who acts on the findings, and Level Designer.",
+  },
+  "game-audio-director": {
+    name: "Game Audio Brief Writer",
+    role: "Plans the sound and music of a game and writes clear briefs for whoever makes them: the mood, the list of sounds and how they play",
+    summary:
+      "Plans the sound and music of your game and writes clear briefs for whoever makes them",
+    about:
+      "Plans the music and the list of sounds in a table: when each plays, how it should feel and what the player must understand from it. It plans the mix and visual cues for players who cannot hear well, and writes one brief per piece so a composer or sound designer can start. It does not make audio, and reminds you to check rights.",
+    when: "When your game is playable and needs sound, or you hire a composer.",
+    pairs:
+      "Game Designer, for the moments that need sound, and Developer, for how sounds are triggered.",
+  },
+  "tabletop-game-master": {
+    name: "Tabletop Game Master",
+    role: "Helps run a tabletop role-playing game: prepares adventures, characters and rules answers, and keeps the story going at the table",
+    summary:
+      "Helps run a tabletop role-playing game: adventures, characters, rules answers and ideas for the table",
+    about:
+      "Asks about your system, your group and the tone, then prepares a short adventure with a hook, scenes with a choice each and several endings, plus quick characters. It answers rule questions from the book you have and says when it is not sure. During play it gives three options when you are stuck, and asks the group about limits.",
+    when: "When you run or play a role-playing game and want help preparing or improvising.",
+    pairs: "Narrative Designer, for deeper lore, and Designer, for maps and handouts.",
+  },
+};

app/src/i18n/es/catalog.ts

@@ -5,6 +5,7 @@ import { design } from "./catalogDesign";
 import { engineering } from "./catalogEngineering";
 import { engineeringMore } from "./catalogEngineeringMore";
 import { finance } from "./catalogFinance";
+import { games } from "./catalogGames";
 import { legal } from "./catalogLegal";
 import { marketing } from "./catalogMarketing";
 import { paidMedia } from "./catalogPaidMedia";
@@ -38,6 +39,7 @@ export const catalog: Messages["catalog"] = {
     finance: "Finanzas",
     people: "Personas y RR. HH.",
     security: "Seguridad",
+    games: "Juegos",
     legal: "Jurídico",
   },
   none: "Ningún bot coincide con eso.",
@@ -72,5 +74,6 @@ export const catalog: Messages["catalog"] = {
     ...security,
     ...sectors,
     ...legal,
+    ...games,
   },
 };

app/src/i18n/es/catalogGames.ts

@@ -0,0 +1,78 @@
+import type { games as en } from "../en/catalogGames";
+
+export const games: typeof en = {
+  "game-designer": {
+    name: "Diseñador de juegos",
+    role: "Convierte una idea de juego en reglas claras y un ciclo divertido de repetir: el objetivo, las decisiones, la respuesta y una primera versión pequeña para probar",
+    summary:
+      "Convierte tu idea de juego en reglas claras y un ciclo divertido, con una primera versión pequeña para probar",
+    about:
+      "Parte de la experiencia que quieres que tenga el jugador, encuentra el ciclo que repite y escribe las reglas en frases cortas y exactas, comprobando si hay resquicios. Planifica la versión jugable más pequeña y una prueba, y cuando algo no es divertido ofrece dos cambios para intentar. El juego sigue siendo tuyo.",
+    when: "Cuando tienes una idea de juego, digital o de mesa, y quieres que se convierta en algo jugable.",
+    pairs:
+      "Diseñador de narrativa, para la historia, y Diseñador de economía de juegos, para los números.",
+  },
+  "game-narrative-designer": {
+    name: "Diseñador de narrativa",
+    role: "Crea la historia, los personajes y el mundo de un juego, y escribe los textos para que encajen con la forma de jugar",
+    summary:
+      "Crea la historia, los personajes y el mundo de tu juego y escribe los textos para que encajen con el juego",
+    about:
+      "Arma el mundo en una página, crea personajes con un deseo, un defecto y una voz y planifica la historia en torno a las decisiones del jugador y la duración del juego. Escribe los textos en líneas cortas con su contexto, para que un desarrollador los coloque. Todo es original, y te dice para qué edad sirven los temas sensibles.",
+    when: "Cuando tu juego necesita un mundo, una historia, misiones o personajes que la gente recuerde.",
+    pairs: "Diseñador de juegos, para las reglas, y Traductor, para otros idiomas.",
+  },
+  "level-designer": {
+    name: "Diseñador de niveles",
+    role: "Diseña los niveles, mapas o escenarios de un juego para que enseñen, desafíen y sorprendan en el orden correcto",
+    summary:
+      "Diseña los niveles, mapas o escenarios de tu juego para que enseñen, desafíen y sorprendan en orden",
+    about:
+      "Planifica el orden en que el jugador aprende cada mecánica, una novedad a la vez, y describe cada nivel con un mapa en texto: el inicio, el objetivo, la ruta, los desafíos y las recompensas. Comprueba si hay sitios donde el jugador puede atascarse o saltarse el sentido del nivel, y escribe una lista de prueba para cada uno.",
+    when: "Cuando tienes las reglas de un juego y necesitas los niveles o escenarios que las usan.",
+    pairs:
+      "Diseñador de juegos, para revisar las reglas, y Diseñador de narrativa, para los momentos de la historia.",
+  },
+  "game-economy-designer": {
+    name: "Diseñador de economía de juegos",
+    role: "Equilibra los números de un juego: costos, recompensas, progreso y precios, para que sea justo e interesante, sin engañar al jugador para que gaste",
+    summary:
+      "Equilibra los números de tu juego: costos, recompensas y progreso, de forma justa y sin trucos",
+    about:
+      "Dibuja los flujos de monedas, objetos y tiempo, pone los números en una hoja de cálculo con fórmulas y simula jugadores a distintos ritmos. Encuentra recursos que se acumulan y caminos que siempre son los mejores. Si tu juego gana dinero, propone formas justas, y nunca costos ocultos, cuentas atrás falsas, ventaja por pago ni premios aleatorios de pago dirigidos a niños.",
+    when: "Cuando tu juego tiene monedas, objetos o progreso y los números parecen raros, o piensas ganar dinero con él.",
+    pairs: "Diseñador de juegos, para los objetivos, y Analista de datos, para las simulaciones.",
+  },
+  "playtest-analyst": {
+    name: "Analista de pruebas de juego",
+    role: "Planifica pruebas con jugadores y convierte lo que hicieron y dijeron en hallazgos claros y en los cambios que más valen la pena",
+    summary:
+      "Planifica pruebas con jugadores y convierte lo que hicieron y dijeron en hallazgos y cambios que valen la pena",
+    about:
+      "Planifica la sesión para que no expliques ni defiendas el juego y luego convierte tus notas en hallazgos: el problema, cuántos jugadores lo encontraron, dónde y por qué. Se fía más de lo que hicieron los jugadores que de lo que dijeron, ordena los cambios por efecto frente al esfuerzo y sugiere la siguiente prueba. Nunca contacta a los jugadores.",
+    when: "Después de que personas hayan probado tu juego y no sepas qué cambiar primero.",
+    pairs: "Diseñador de juegos, que actúa sobre los hallazgos, y Diseñador de niveles.",
+  },
+  "game-audio-director": {
+    name: "Redactor de guías de audio para juegos",
+    role: "Planifica el sonido y la música de un juego y escribe guías claras para quien los hace: el ambiente, la lista de sonidos y cómo suenan",
+    summary:
+      "Planifica el sonido y la música de tu juego y escribe guías claras para quien los va a hacer",
+    about:
+      "Planifica la música y la lista de sonidos en una tabla: cuándo suena cada uno, cómo debe sentirse y qué debe entender el jugador con él. Planifica la mezcla y avisos visuales para quien no oye bien, y escribe una guía por pieza para que un compositor o diseñador de sonido empiece. No hace el audio y te recuerda comprobar los derechos.",
+    when: "Cuando tu juego ya es jugable y necesita sonido, o vas a contratar a un compositor.",
+    pairs:
+      "Diseñador de juegos, para los momentos que piden sonido, y Desarrollador, para cómo se activan los sonidos.",
+  },
+  "tabletop-game-master": {
+    name: "Director de juegos de rol de mesa",
+    role: "Ayuda a dirigir un juego de rol de mesa: prepara aventuras, personajes y respuestas sobre reglas, y mantiene la historia en marcha en la mesa",
+    summary:
+      "Ayuda a dirigir un juego de rol de mesa: aventuras, personajes, respuestas sobre reglas e ideas para la mesa",
+    about:
+      "Pregunta por tu sistema, tu grupo y el tono, y prepara una aventura corta con un gancho, escenas con una decisión cada una y varios finales, además de personajes rápidos. Responde dudas de reglas con el libro que tienes y dice cuando no está seguro. Durante la partida da tres opciones cuando te atascas y pregunta al grupo por sus límites.",
+    when: "Cuando diriges o juegas un juego de rol y quieres ayuda para preparar o improvisar.",
+    pairs:
+      "Diseñador de narrativa, para un trasfondo más profundo, y Diseñador, para mapas y materiales.",
+  },
+};

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

@@ -5,6 +5,7 @@ import { design } from "./catalogDesign";
 import { engineering } from "./catalogEngineering";
 import { engineeringMore } from "./catalogEngineeringMore";
 import { finance } from "./catalogFinance";
+import { games } from "./catalogGames";
 import { legal } from "./catalogLegal";
 import { marketing } from "./catalogMarketing";
 import { paidMedia } from "./catalogPaidMedia";
@@ -38,6 +39,7 @@ export const catalog: Messages["catalog"] = {
     finance: "Finanças",
     people: "Pessoas e RH",
     security: "Segurança",
+    games: "Jogos",
     legal: "Jurídico",
   },
   none: "Nenhum bot combina com isso.",
@@ -72,5 +74,6 @@ export const catalog: Messages["catalog"] = {
     ...security,
     ...sectors,
     ...legal,
+    ...games,
   },
 };