Stage 1 · Heating · Activation & Diagnosis
Etapa 1 · Calentamiento · Activación y Diagnóstico
Read What Exists, or Ground the Idea
Lee Lo que Existe, o Aterriza la Idea
Heating is where the metal becomes workable. For an existing codebase, that means reading it cold and running a full diagnostic — you cannot specify what you haven't seen clearly. For a new project, it means grounding a fuzzy idea into something concrete enough to mold. Pick your track.
El Calentamiento es donde el metal se vuelve trabajable. Para una base de código existente, eso significa leerla en frío y correr un diagnóstico completo — no puedes especificar lo que no has visto con claridad. Para un proyecto nuevo, significa aterrizar una idea difusa en algo lo bastante concreto para moldear. Elige tu camino.
Track A — New Project: Ground the Idea
Camino A — Proyecto Nuevo: Aterriza la Idea
A guided discussion before the spec
Una discusión guiada antes de la especificación
A new project has no code to read — but it usually has a fuzzy idea. Before the mold, bring it down to earth. This guided discussion turns "I want to build X" into the concrete raw material the spec interview needs. If your idea is already sharp, skip straight to Mold.
Un proyecto nuevo no tiene código que leer — pero normalmente tiene una idea difusa. Antes del molde, bájala a la tierra. Esta discusión guiada convierte "quiero construir X" en la materia prima concreta que necesita la entrevista de la especificación. Si tu idea ya está afilada, salta directo al Molde.
Paste this — ground the ideaPega esto — aterriza la ideaBe my thinking partner, not a yes-man. I have a project idea I want to ground before writing a specification. Ask me one question at a time, and push back when an answer is vague.
1. In one sentence — what is it, and who is it for?
2. What is the single most important thing it must do well? (if everything is important, nothing is)
3. Who is the user the day it ships, and what do they do in the first five minutes?
4. What is explicitly NOT in version one? Name three things you are tempted to build but will not.
5. What is the riskiest assumption — the thing that, if wrong, sinks the project?
6. What does "good enough to show someone" look like? Be concrete.
After my answers, reflect back: the one-sentence pitch, the MVP scope, the top three non-goals, and the riskiest assumption. If any answer was hand-wavy, tell me which and why. Do not write any spec or code yet.Sé mi compañero de pensamiento, no un adulador. Tengo una idea de proyecto que quiero aterrizar antes de escribir una especificación. Hazme una pregunta a la vez, y cuestióname cuando una respuesta sea vaga.
1. En una oración — ¿qué es, y para quién es?
2. ¿Cuál es la única cosa más importante que debe hacer bien? (si todo es importante, nada lo es)
3. ¿Quién es el usuario el día que se lanza, y qué hace en los primeros cinco minutos?
4. ¿Qué NO está, explícitamente, en la versión uno? Nombra tres cosas que estás tentado a construir pero no lo harás.
5. ¿Cuál es el supuesto más riesgoso — la cosa que, si está mal, hunde el proyecto?
6. ¿Cómo se ve "lo bastante bueno para mostrárselo a alguien"? Sé concreto.
Después de mis respuestas, refléjame de vuelta: el pitch de una oración, el alcance del MVP, los tres principales no-objetivos, y el supuesto más riesgoso. Si alguna respuesta fue vaga, dime cuál y por qué. No escribas ninguna especificación ni código todavía.
This is the only stage a new project may skip — if the idea is already concrete, go straight to Mold. But most fuzzy ideas get sharper here, and a sharper idea makes a tighter mold.
Esta es la única etapa que un proyecto nuevo puede saltar — si la idea ya es concreta, ve directo al Molde. Pero la mayoría de las ideas difusas se afilan aquí, y una idea más afilada hace un molde más ajustado.
Track B — Existing Project: Cold Read + Audit
Camino B — Proyecto Existente: Lectura en Frío + Auditoría
See what the AI sees — then score it
Mira lo que ve la IA — luego puntúalo
An existing codebase must be read before it can be specified. First the cold read — three questions that expose the gap between what's implicit and what's written. Then the full GS audit — eight dimensions, a 0–14 score, and a remediation roadmap.
Una base de código existente debe leerse antes de poder especificarla. Primero la lectura en frío — tres preguntas que exponen el gap entre lo que es implícito y lo que está escrito. Luego la auditoría GS completa — ocho dimensiones, un puntaje 0–14 y una hoja de ruta de remediación.
Sub-step 1 — Cold Read
Sub-paso 1 — Lectura en Frío
Paste this — cold readPega esto — lectura en fríoAsk me these three questions about this codebase, one at a time. Read the code to answer — do not ask me.
1. In one paragraph: what does this system do and who uses it?
2. Pick a structural decision visible in the code (a module boundary, a data model, a service split). Explain why it was made that way.
3. What should this system never do? What are its explicit constraints and non-goals?Hazme estas tres preguntas sobre esta base de código, una a la vez. Lee el código para responder — no me preguntes.
1. En un párrafo: ¿qué hace este sistema y quién lo usa?
2. Elige una decisión estructural visible en el código (un límite de módulo, un modelo de datos, una separación de servicio). Explica por qué se tomó así.
3. ¿Qué nunca debe hacer este sistema? ¿Cuáles son sus restricciones y no-objetivos explícitos?
Where the AI answers with silence, invention, or low confidence — that is exactly what your sentinel will need to make explicit.
Donde la IA responde con silencio, invención o baja confianza — eso es exactamente lo que tu sentinel necesitará hacer explícito.
Sub-step 2 — Full GS Audit
Sub-paso 2 — Auditoría GS Completa
Now run the full audit. It scores eight dimensions — the same report the pragmaworks CLI produces — and ends with a prioritized remediation plan. The complete paste-able template is on the GS Audit page.
Ahora corre la auditoría completa. Puntúa ocho dimensiones — el mismo reporte que produce el CLI de pragmaworks — y termina con un plan de remediación priorizado. La plantilla completa para pegar está en la página de Auditoría GS.
1 Property Scorecard (0–14) · 2 Total & Band · 3 Structural Disciplines · 4 Test Pyramid · 5 Documentation Health · 6 Security & Logging · 7 Team Habits (git history) · 8 Remediation Plan
1 Tarjeta de Propiedades (0–14) · 2 Total y Banda · 3 Disciplinas Estructurales · 4 Pirámide de Tests · 5 Salud de Documentación · 6 Seguridad y Logging · 7 Hábitos de Equipo (historial git) · 8 Plan de Remediación