Wordspecs

Blog

Hojas de especificaciones para agencias: un formato propio para cada cliente

Beta privada. El acceso es por lista de espera y los planes de pago se abren cuando termine la beta. Apúntate a la lista de espera.

Cuando cada responsable de proyecto construye desde cero un documento para el cliente, los clientes reciben archivos que parecen de empresas distintas. Un formato propio resuelve eso. Este artículo expone una plantilla, cómo encajan en ella las variantes por cliente, cómo se entregan los documentos y cómo un registro de cambios resuelve las discrepancias posteriores. La agencia y los clientes de los ejemplos son ficticios.

Qué notan los clientes

Los clientes notan si un documento es fácil de revisar. Las mismas secciones en el mismo orden, requisitos a los que pueden referirse por ID y un estado claro en cada página facilitan la revisión. Cuando el diseño cambia de un proyecto a otro, los clientes dedican su atención a encontrar cosas en lugar de comprobarlas.

Un formato propio con variantes

Una plantilla propia de ejemplo

Larkspur Creative es una agencia ficticia que crea sitios web y catálogos de productos. Cada documento de proyecto que produce tiene estas secciones, en este orden:

  1. Resumen. Un párrafo sobre qué se construye, para quién y por qué ahora.
  2. Alcance. Lo que construye la agencia, vinculado a una versión numerada del alcance, como v1.2.
  3. Entregables. Una lista con IDs (D1, D2 y así sucesivamente), cada uno con su hito de vencimiento.
  4. Fuera de alcance. Elementos concretos que no están incluidos, escritos de forma explícita para que nadie tenga que adivinar.
  5. Supuestos. Lo que la agencia necesita del cliente, como contenidos entregados en una fecha determinada o acceso a un servidor de staging.
  6. Requisitos. Una fila por requisito, con un ID (REQ-001), una prioridad de Debe, Debería o Podría, y una decisión por fila.
  7. Criterios de aceptación. Una condición verificable para cada entregable o requisito, con un resultado observable en lugar de un juicio como "funciona bien".
  8. Calendario e hitos. Una fecha para cada hito (M1, M2 y así sucesivamente).
  9. Proceso de cambios. Cómo se solicita un cambio, quién decide y dónde se registra.
  10. Aprobación. Los nombres y cargos de las personas que aprueban esta versión, la fecha y la etiqueta de versión.

Variantes por cliente

Tres clientes ficticios necesitan cada uno una sección adicional sobre la plantilla propia:

ClienteSección adicionalPor qué la necesita el cliente
Kestrel Dental GroupCumplimiento normativo y tratamiento de datosLos historiales de pacientes tienen normas legales de tratamiento. La sección indica dónde se almacenan los datos, quién puede acceder a ellos y cuánto tiempo se conservan.
Mapleton Water BoardAnexo de APISus ingenieros conectan el flujo de contadores a sus propios sistemas. El anexo enumera endpoints, campos de petición y códigos de error.
Orrin RetailTabla de localizaciónLa tienda se lanza en cuatro idiomas. La tabla enumera cada idioma, sus formatos de fecha y moneda, y el número de cadenas para traducir.

Cuándo una variante pasa a formar parte de la plantilla propia: cuando un segundo cliente pide la misma sección, o cuando una línea de servicio la necesita en todos los proyectos. Hasta entonces sigue siendo una variante. Así la plantilla propia se mantiene lo bastante corta para que el responsable de cada proyecto la rellene bien cada vez.

Entrega

Los clientes piden formatos distintos: un PDF para la aprobación, un archivo Word para comentar y Markdown para sus ingenieros. Conviene exportar los tres desde una sola fuente el mismo día. Las copias hechas a mano se separan en cuanto se edita una de ellas, y así es como dos versiones acaban en circulación.

Para cada entrega, conviene seguir esta lista de comprobación:

  1. Confirmar que la fuente lleva la etiqueta de versión aprobada, por ejemplo v1.2, y que los borradores están etiquetados por separado, por ejemplo draft-3.
  2. Comprobar que están todas las secciones de la plantilla, que cada requisito y entregable tiene un ID único y que no quedan textos de marcador ni nombres de clientes antiguos.
  3. Exportar el PDF para la aprobación como orrin-retail-catalogue-scope_v1.2.pdf. Los nombres de archivo van en minúsculas, usan guiones en lugar de espacios y se leen en el orden cliente, documento, versión.
  4. Exportar el archivo Word para comentarios como orrin-retail-catalogue-scope_v1.2.docx, y el archivo Markdown para ingenieros como orrin-retail-catalogue-scope_v1.2.md, con el mismo nombre base.
  5. Abrir los tres archivos y comprobar que la etiqueta de versión, la fecha y los IDs REQ-004 y D5 coinciden en cada uno.
  6. Redactar una nota de portada breve con la versión, la fecha y los IDs de cambio incluidos desde la última versión, por ejemplo CR-003.
  7. Registrar el envío en el registro de cambios: fecha, destinatarios por rol, nombres de archivo y fecha límite de aprobación.
  8. Guardar el conjunto de exportaciones en la carpeta del proyecto y marcar las versiones anteriores como sustituidas en lugar de eliminarlas.

Un registro de cambios de ejemplo

Orrin Retail es un cliente ficticio. Firmó el alcance v1.0 el 2026-09-08. Toda solicitud posterior se anota en el registro de cambios antes de empezar cualquier trabajo. Este es el registro de las primeras semanas tras la firma:

CambioFechaCambio solicitadoSolicitado porAprobado porEfecto en los entregablesEfecto en el calendarioResultado
CR-0012026-09-22Añadir una página de guía de tallas a la plantilla de productoResponsable de marketing del clienteResponsable de producto del cliente y responsable de cuenta de la agenciaD3 gana un tipo de página. El alcance pasa a v1.1.M2 pasa de 2026-10-02 a 2026-10-09Aprobado
CR-0022026-10-05Mostrar los niveles de stock en tiempo real en las páginas de productoResponsable de ingeniería del clienteResponsable de producto del cliente y responsable de cuenta de la agenciaNinguno. Registrado como fuera de alcance en v1.1.NingunoRechazado. Necesita su propio acuerdo de integración.
CR-0032026-10-14Cambiar D5 de una guía en PDF a un archivo Markdown para los ingenieros del clienteResponsable de ingeniería del clienteResponsable de producto del cliente y responsable de proyecto de la agenciaCambia el formato de D5. La misma fuente se exporta a Markdown, así que el trabajo en sí no cambia.NingunoAprobado. Alcance v1.2.

El registro resuelve las discrepancias porque guarda fechas, nombres, cargos y la versión a la que se aplicaba cada decisión. Supongamos que el responsable de marketing del cliente escribe el 2026-10-20 que el stock en tiempo real siempre formó parte del proyecto. La agencia no discute desde la memoria. Muestra CR-002 con su fecha y su decisión, y señala la lista de fuera de alcance de v1.1, que el cliente firmó el 2026-10-06 y que menciona el stock en tiempo real. La discusión pasa entonces a ser sobre dos documentos firmados, y no sobre quién recuerda la llamada. El mismo registro muestra que la guía de tallas se añadió formalmente, con su efecto en el calendario, de modo que la agencia tampoco depende de la memoria ni de la confianza.

Errores habituales en las especificaciones de agencia

Cómo ayuda Wordspecs

Wordspecs ofrece plantillas fijas para especificaciones de producto, fichas técnicas y resúmenes de API, plantillas guardadas para el formato propio, exportación a Markdown, PDF y Word y, en el plan Team, plantillas compartidas e historial de versiones. La plantilla propia se guarda una vez, los documentos nuevos parten de ella y cada exportación procede de la misma fuente. Las hojas de ejemplo muestran cómo queda, y es posible apuntarse a la lista de espera.

Relacionado: hojas de especificaciones para equipos.

Apuntarme a la lista de espera