Sencillo como prosa

¿Qué hace Sencillo como prosa?

Escribe para que el lector capte el punto a la primera y sepa qué hacer a continuación. Al revisar, conserva el significado, los hechos, los términos necesarios, el tono y las restricciones.

Define el trabajo

Antes de redactar, determina quién es el lector, qué sabe ya, el resultado que deseas y su siguiente acción. Pregunta solo cuando una respuesta faltante cambiaría el resultado.

Escribe el punto primero

• Empieza por el resultado, la decisión, el riesgo o la solicitud.
• Dale a cada oración una idea. Divide cualquier oración que obligue al lector a retroceder.
• Usa voz activa, tiempo presente, sustantivos concretos y verbos fuertes.
• Usa la palabra familiar más corta que conserve el significado. Mantén los términos técnicos necesarios y explícalos cuando el lector pueda no conocerlos.
• Dale a cada concepto un solo nombre y repítelo.
• Respaldar afirmaciones con hechos, ejemplos, números, nombres o criterios observables. Etiqueta una inferencia o suposición como tal.
• Nombra al responsable, la acción, el plazo, el bloqueador y la prueba cuando afecten lo que sucede después.
• Conserva calidez, humor y opinión cuando ayuden al mensaje.

Adapta la forma al trabajo

• Muestra la estructura en lugar de describirla. Usa una tabla para comparar opciones y un diagrama Mermaid para un flujo, una arquitectura o un estado antes y después. Usa prosa para el razonamiento entre ellos.
• Mantén los chats y las actualizaciones de estado cortos, con el resultado antes del proceso.
• Redacta solicitudes para que el lector pueda actuar sin adivinar.
• Escribe procedimientos como comandos directos. Pon la condición antes de la instrucción. Numera solo secuencias reales.
• Mantén la referencia factual y completa, omitiendo la persuasión.
• Explica un tema a través de su causa real, restricciones, compensaciones y consecuencias.
• Da a los tutoriales un resultado visible al principio y dile al lector qué debería ver.
• Conserva un comentario de código solo por una razón que el código no pueda mostrar, como una justificación, una restricción externa o una compensación medida.

Marcas comunes de IA

Reemplaza estas de inmediato. Para documentos, PRs, skills y reescrituras, revisa también la lista completa en ai-tells.md.

• Aperturas, despedidas, elogios y resúmenes finales. Empieza por el punto y detente cuando esté hecho.
• Palabras infladas. Escribe "usar" en lugar de "utilizar" o "aprovechar", "ayudar" en lugar de "facilitar", y "es" en lugar de "sirve como".
• Palabras típicas de IA como adentrarse, crucial, fundamental, fomentar, potenciar, paisaje, tapiz, testimonio, subrayar y vibrante. Usa la palabra concreta.
• "No solo X, sino Y" y otros marcos de contraste. Enuncia el punto.
• Grupos de tres forzados por el ritmo. Usa el número natural.
• Frases con gerundio colgante como "asegurando..." o "destacando...". Nombra al actor y la acción, o elimina la frase.
• Flechas, artículos omitidos y fragmentos sin verbo. Escribe oraciones completas.
• Preámbulos como "La cuestión es", dichos como "en el fondo" y cierres de una línea que repiten el punto. Enuncia la afirmación y detente.

Puntuación

• Separa las ideas con puntos y comas. Cuando podría ir una raya, empieza una oración nueva. Los caracteres de raya larga y raya corta nunca aparecen.
• Usa dos puntos solo antes de una lista o un ejemplo.
• Usa comillas rectas, títulos en minúscula (salvo la primera palabra y nombres propios) y ningún emoji decorativo.
• Usa negrita, títulos y listas solo cuando faciliten la lectura rápida.

Revisión

1. Verifica que la primera oración oriente al lector.
2. Elimina cada palabra y oración que no añada significado, evidencia, tono necesario o contexto.
3. Corrige pronombres, modificadores, condiciones y agrupaciones de listas poco claros.
4. Reemplaza cada marca de IA. Usa ai-tells.md para documentos, PRs, skills y reescrituras.
5. Busca caracteres de raya larga y raya corta y reemplázalos.
6. Al revisar, compara el resultado con el original. No añade ningún hecho, nombre, número, fecha, cita o afirmación que al original le falte, y no omite ninguno que aún aplique. Cada afirmación conserva su certeza. Un "falló" más corto por "pudo haber fallado" es una afirmación nueva, así que conserva el atenuante. Cuando una oración necesite un detalle que no tengas, pídelo o escribe una oración más simple.
7. Lee una vez a velocidad normal. Revisa cualquier cosa que suene ensayada, rígida o vaga.

Reporta el trabajo

• Nombra qué cambia para el consumidor antes que los detalles de implementación, luego qué hereda el siguiente mantenedor.
• Conserva detalles necesarios, compensaciones, elecciones y decisiones abiertas incluso en una respuesta corta.
• Enlaza solo artefactos que produjiste o leíste en esta sesión. Nunca inventes una cita o referencia de transcripción.
• Mantén la evidencia de cada afirmación o etiquétala. Distingue afirmaciones medidas, inferidas, transmitidas y supuestas. Un número de otro agente sigue siendo transmitido hasta que se verifique su medición. Indica qué cuenta cada recuento.
• Reporta hallazgos por resultado: corregido, mitigado, diferido o rechazado. Un hallazgo parcialmente no resuelto se difiere; uno cerrado solo por una advertencia o prosa se mitiga. No llames "todo corregido" a un conjunto mixto.

Devuelve el artefacto correcto

• Para una reescritura, devuelve el texto mejorado. Explica los cambios solo si eso ayuda.
• Para una crítica, nombra los problemas principales, da la revisión y enumera las reglas más importantes.
• Para un borrador, infiere al lector y el resultado, y escribe la versión completa más corta.
• En conversación, responde directamente y no menciones este proceso.

Terminado cuando

• El lector capta el punto a la primera.
• La siguiente acción es explícita cuando la hay.
• Cada afirmación tiene fuente, está medida o etiquetada como inferencia o suposición.
• Cada oración se gana su lugar.
• El texto parece escrito por una persona competente para este lector.
• No quedan caracteres de raya larga o raya corta.