Path C · Onboarding · ~1 hour, read-only Camino C · Onboarding · ~1 hora, solo lectura

Join a Codebase Únete a una Codebase

You inherited a codebase. Or you're returning after parental leave. Or you're a consultant taking over a system someone else built. You don't need a full audit yet — you need to know what the project is, how it works, and where to start. Heredaste una base de código. O estás regresando después de licencia parental. O eres consultor tomando un sistema que alguien más construyó. No necesitas una auditoría completa todavía — necesitas saber qué es el proyecto, cómo funciona, y dónde empezar.

Onboarding is read-only — a briefing, not a remediation. ~1 hour, no code changes. El onboarding es solo lectura — un briefing, no una remediación. ~1 hora, sin cambios de código.

Open your AI assistant in the project root. Same options as paths A and B. Abre tu asistente de IA en la raíz del proyecto. Mismas opciones que los caminos A y B.

Ask for the onboarding briefing. Onboarding is read-only — it doesn't change code. Even so, it's safer to do exploration on a branch in case the AI ends up writing notes or memory files into the repo. Pide el briefing de onboarding. El onboarding es solo lectura — no cambia código. Aun así, es más seguro hacer la exploración en una rama por si la IA termina escribiendo notas o archivos de memoria en el repo.

With PragmaWorks tools Con las herramientas de PragmaWorks

Paste this, edit your role/levelPega esto, edita tu rol/nivelUse pragmaworks to onboard me to this project. Find pragmaworks on npm, install what you need, create a working branch first (don't touch main), and produce an onboarding briefing as markdown. My role: [frontend / backend / full-stack / data / devops] Experience level: [junior / mid / senior / staff] Module I'm starting on: [optional — leave blank if you don't know yet] The briefing should cover: what this project is in three sentences, the architecture in one diagram, the conventions I must respect, what's surprising about this codebase, 2-3 first-task suggestions sized for my role and experience, and a cheat sheet for getting set up.Usa pragmaworks para hacer mi onboarding a este proyecto. Busca pragmaworks en npm, instala lo que necesites, crea una rama de trabajo primero (no toques main), y produce un briefing de onboarding como markdown. Mi rol: [frontend / backend / full-stack / data / devops] Nivel de experiencia: [junior / mid / senior / staff] Módulo donde empiezo: [opcional — déjalo en blanco si aún no sabes] El briefing debe cubrir: qué es este proyecto en tres oraciones, la arquitectura en un diagrama, las convenciones que debo respetar, qué es sorprendente de esta base de código, 2-3 sugerencias de primera tarea dimensionadas para mi rol y experiencia, y una cheat sheet para configurarme.

Pure GS (no tools) GS puro (sin herramientas)

Same output (markdown briefing), generated by walking the code conventionally. The discipline here is naming what the briefing must contain so two AI sessions land on the same shape: El mismo output (briefing markdown), generado caminando el código convencionalmente. La disciplina aquí es nombrar qué debe contener el briefing para que dos sesiones de IA aterricen en la misma forma:

Paste this, edit your role/levelPega esto, edita tu rol/nivelOnboard me to this project. Use git CLI to create a branch first (onboarding-YYYY-MM-DD); do not touch main. Then produce an onboarding briefing at reports/onboarding.md covering: My role: [frontend / backend / full-stack / data / devops] Experience level: [junior / mid / senior / staff] Module I'm starting on: [optional] 1. WHAT — three sentences naming the project, its users, and the business outcome it produces. 2. ARCHITECTURE — one ASCII or mermaid diagram showing the major components and the data flow between them. Cite file:line for each component. 3. CONVENTIONS — naming, file layout, error handling, logging format, test style, commit-message style. Each one cited to a representative file:line. 4. WHAT SURPRISES NEW DEVS — the 3-5 things in this codebase that look idiomatic but aren't, or that look weird but are load-bearing. Cite file:line. 5. FIRST TASKS — 2-3 concrete suggestions sized to my role and level. For each: the files involved, what to read first, rough effort estimate. 6. CHEAT SHEET — environment setup commands, where to find what, useful greps. Concrete enough to act on without rereading this document. Cite files and lines liberally. The briefing should be reproducible by anyone who can read the code; that's the test.Hazme onboarding a este proyecto. Usa git CLI para crear una rama primero (onboarding-YYYY-MM-DD); no toques main. Después produce un briefing de onboarding en reports/onboarding.md cubriendo: Mi rol: [frontend / backend / full-stack / data / devops] Nivel de experiencia: [junior / mid / senior / staff] Módulo donde empiezo: [opcional] 1. QUÉ — tres oraciones nombrando el proyecto, sus usuarios, y el outcome de negocio que produce. 2. ARQUITECTURA — un diagrama ASCII o mermaid mostrando los componentes mayores y el flujo de datos entre ellos. Cita file:line para cada componente. 3. CONVENCIONES — naming, layout de archivos, manejo de errores, formato de logging, estilo de pruebas, estilo de mensaje de commit. Cada una citada a un file:line representativo. 4. QUÉ SORPRENDE A DEVS NUEVOS — las 3-5 cosas en esta base de código que se ven idiomáticas pero no lo son, o que se ven raras pero son críticas. Cita file:line. 5. PRIMERAS TAREAS — 2-3 sugerencias concretas dimensionadas a mi rol y nivel. Para cada una: archivos involucrados, qué leer primero, estimación rough de esfuerzo. 6. CHEAT SHEET — comandos de setup de entorno, dónde encontrar qué, greps útiles. Concreto al punto de poder actuar sin re-leer este documento. Cita archivos y líneas liberalmente. El briefing debe ser reproducible por cualquiera que pueda leer el código; esa es la prueba.

Read the briefing. Markdown file, 4-8 pages. Designed to be read in 20-30 minutes. Architecture diagram, conventions, what surprises new devs, where to start. Cite the files and lines that support each claim — you can verify by reading. Lee el briefing. Archivo markdown, 4-8 páginas. Diseñado para leerse en 20-30 minutos. Diagrama de arquitectura, convenciones, qué sorprende a devs nuevos, dónde empezar. Cita los archivos y líneas que soportan cada afirmación — puedes verificar leyendo.

Pick a first task. The briefing ends with 2-3 concrete options sized to your role. Pick one. Start. Escoge una primera tarea. El briefing termina con 2-3 opciones concretas dimensionadas a tu rol. Escoge una. Empieza.

Optional — for takeover engagements: include team-habit analysis. If you're a consultant or freelancer adopting a codebase from another team, you want to know who to trust on which areas and where the recent fires were. Opcional — para engagements de takeover: incluye el análisis de hábitos del equipo. Si eres consultor o freelancer adoptando una base de código de otro equipo, quieres saber en quién confiar en qué áreas y dónde estuvieron los incendios recientes.

With PragmaWorks tools Con las herramientas de PragmaWorks

OptionalOpcionalInclude team-habit analysis in the briefing. Last 90 days of commit history: PR review density, regression coverage, AI-bug rate, who's been touching what.Incluye el análisis de hábitos del equipo en el briefing. Últimos 90 días de historial de commits: densidad de revisión de PRs, cobertura de regresión, tasa de bugs de IA, quién ha estado tocando qué.

Pure GS (no tools) GS puro (sin herramientas)

Same signals from git log directly. Same prompt as Path B step 7 — see there for the full version. Las mismas señales desde git log directamente. El mismo prompt que el paso 7 del Camino B — ver ahí la versión completa.

Paste thisPega estoAppend a team-habit section to the onboarding briefing. Compute from git log of the last 90 days: PR review density per author, regression test coverage of fix: commits, AI-introduced bug rate (detect AI co-authorship signals, correlate with subsequent fix: commits within 14 days), commit-size distribution, collaboration adjacency table. For each metric, one-line interpretation pitched at "who do I trust on what" decisions. Cite the git log queries used.Agrega una sección de hábitos del equipo al briefing de onboarding. Computa desde git log de los últimos 90 días: densidad de revisión de PRs por autor, cobertura de regresión de commits fix:, tasa de bugs introducidos por IA (detecta señales de co-autoría de IA, correlaciona con commits fix: posteriores dentro de 14 días), distribución de tamaño de commits, tabla de adyacencia de colaboración. Para cada métrica, interpretación de una línea pitched a decisiones de "en quién confío para qué". Cita las queries git log usadas.

Onboarding mode is read-only. It does not propose code changes. If you also want a remediation analysis (what's wrong with this project, what to fix), run Path B / Anneal separately. El modo onboarding es solo-lectura. No propone cambios de código. Si también quieres un análisis de remediación (qué está mal con este proyecto, qué arreglar), corre el Camino B / Recocer por separado.

Path A · New Project Camino A · Proyecto Nuevo

Greenfield: Start from Scratch → Greenfield: Empieza desde Cero →

Spec → cascade → sentinel → harness → build, full lifecycle Spec → cascada → sentinel → harness → construir, ciclo completo

Path B · Existing Project Camino B · Proyecto Existente

Anneal: Existing Project → Recocer: Proyecto Existente →

Audit → spec from code → sentinel → harness → remediation Auditoría → spec desde código → sentinel → harness → remediación

Diagnose Diagnóstico

Diagnose → Diagnóstico →

Score an existing codebase on all 7 GS properties Puntúa una base de código existente en las 7 propiedades GS

Cookbook Hub Hub del Recetario

Back to the Cookbook → Volver al Recetario →

All paths and recipes in one place Todos los caminos y recetas en un solo lugar