kit v9 · f417275 · escritura

Escritura

33 reglas con id fijo, un linter que las detecta y un hook que bloquea las graves: toda la prosa en español del grupo (informes, docs, README, mails, UI copy) cumple la norma de core/prosa. Score objetivo: menos de 1,0 violaciones por 100 palabras y 0 bloqueantes.

Cita cada regla por su id (P01 a P37; la numeración tiene huecos: P08, P09, P24 y P36 no existen). El id sobrevive a las reescrituras de la norma; la cita por texto no.

La voz de la casa

La base es la guía de estilo de developers.google.com, adaptada al español del grupo: hablas con el lector de tú, en activa y en presente, y la cifra va primero. Cada hábito con su par incorrecto y correcto.

<div class=stat>
  <span class=stat__value>0,3%</span>
  <span class=stat__label>error post-fix</span>
</div>

Reglas que bloquean (P01 a P07 y P33 a P35)

Tier bloquea: el hook detiene el Write/Edit del archivo. En el linter manual, --hook sale con código 2 si encuentra una. Cada regla con su tabla de dos columnas.

<table class=table>
  <thead><tr><th class=th-mal>Incorrecto</th><th class=th-bien>Correcto</th></tr></thead>
  <tbody><tr><td>...</td><td>...</td></tr></tbody>
</table>
<!-- .table es del kit (base/components.css); th-mal/th-bien tiñen con var(--err)/var(--ok) -->

Las tablas que siguen reutilizan ese mismo patrón.

Reglas que avisan (P10 a P23 y P37)

Tier avisa: el linter reporta y tú decides. Cuentan para el score (umbral 1,0 por 100 palabras) pero no detienen la edición.

Modo estricto (P25 a P32)

Para procedimientos, runbooks, mensajes de error y UI copy. Suma el régimen verbal del Español Técnico Simplificado: solo cinco formas verbales (infinitivo, infinitivo-imperativo, presente de indicativo en tercera persona, participio adjetival, futuro imperfecto en tercera persona) y tres perífrasis (está + participio, puede + infinitivo, debe + infinitivo). Tope: 25 palabras por oración y 6 oraciones por párrafo.

<span class="badge badge--err">Peligro</span> Cortar la energía antes de abrir el gabinete: ...
<span class="badge badge--warn">Precaución</span> Detener el servicio antes de editar la config: ...
<span class="badge badge--ok">Nota</span> El registro quedó guardado (id 4.812).

Glosario de la casa (P07, P20 y P21)

No hay un glosario global: cada repo declara el suyo en su .prosa.json y el linter lo aplica como P07 (variantes), P20 (regex propias) y P21 (palabras prohibidas). El ejemplo de referencia es el perfil del informe de medicamentos.

Términos fijos de la estructura del grupo: úsalos con su significado técnico, no como sinónimos decorativos.

// .prosa.json del repo (claves: modo, umbral, glosario, prohibidas, frases, desactivar)
{
  "modo": "prosa",
  "umbral": 1.0,
  "glosario": { "copago": ["co-pago", "pago compartido"] },
  "prohibidas": ["apalancar", "sinergias"],
  "frases": [ { "patron": "\\ba la brevedad\\b", "tier": "bloquea",
                "mensaje": "Di cuándo: fecha u hora concreta." } ]
}

Anti-reglas: lo que el linter no marca

Del catálogo Wikipedia con 25 años de ediciones: estas formas son más frecuentes en texto humano y castigarlas produce slop, no lo evita.

Cómo correr prosa-lint

El binario vive en /usr/local/bin/prosa-lint y acepta archivos o directorios. Estas son todas sus flags.

prosa-lint informe.md                  # reporte completo + score
prosa-lint --modo estricto runbook.md  # suma P25-P32 y baja los topes
prosa-lint --umbral 0.5 docs/          # score máximo aceptable (default 1.0)
prosa-lint --json archivo.md           # salida JSON para tooling
prosa-lint --texto "una frase"         # prueba rápida sin archivo
prosa-lint --hook archivo.md           # solo tier bloquea · exit 2 si hay
prosa-lint --stdin-json                # API: {"texto","modo","config"} por stdin

Fuentes

• /srv/projects/core/prosa/NORMA.md (v2) · las 33 reglas con id, los dos modos, tiers, anti-reglas, la sección Juicio y los seis principios de Orwell.
• /srv/projects/core/prosa/prosa_lint.py y /usr/local/bin/prosa-lint · flags verificadas contra el --help real: --modo, --umbral, --json, --hook, --texto, --stdin-json.
• /srv/projects/core/prosa/prosa.example.json · claves de configuración y el glosario de ejemplo (canasta, copago, gasto de bolsillo).
• /srv/projects/core/prosa/referencias/ · ETS (tesis Gobbi, U. Bolonia 2014), checklist ISO 24495-1 y señales Wikipedia de escritura IA.
• /srv/projects/CANON.md § Estilo editorial y § Prosa clara · español neutro/tú, cero em-dash, score objetivo y el hook por repo.
• /srv/projects/core/core-style/ESTRUCTURA.md (citado vía CANON § Estructura) · los términos marca, producto, auxiliar e infraestructura.
• base/tokens.css y base/components.css del kit v9 · .table, .badge, .stat y los colores --ok/--err/--warn de los ejemplos; el header de tokens.css prohíbe el em-dash en copy.
• developers.google.com/style · segunda persona, presente, voz activa, condición antes de la instrucción y listas numeradas solo para pasos (adaptación de la casa; no es un archivo del kit).