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
- Definir una plantilla propia: las secciones que tiene todo documento, en un orden fijo.
- Mantener variantes por cliente cuando necesitan secciones adicionales o una redacción distinta. Un cliente con obligaciones de cumplimiento normativo puede necesitar una sección que los demás no necesitan.
- Empezar cada documento nuevo desde la plantilla guardada, nunca desde el último proyecto terminado, de modo que los nombres y las cifras de clientes anteriores no se arrastren.
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:
- Resumen. Un párrafo sobre qué se construye, para quién y por qué ahora.
- Alcance. Lo que construye la agencia, vinculado a una versión numerada del alcance, como v1.2.
- Entregables. Una lista con IDs (D1, D2 y así sucesivamente), cada uno con su hito de vencimiento.
- Fuera de alcance. Elementos concretos que no están incluidos, escritos de forma explícita para que nadie tenga que adivinar.
- Supuestos. Lo que la agencia necesita del cliente, como contenidos entregados en una fecha determinada o acceso a un servidor de staging.
- 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.
- 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".
- Calendario e hitos. Una fecha para cada hito (M1, M2 y así sucesivamente).
- Proceso de cambios. Cómo se solicita un cambio, quién decide y dónde se registra.
- 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:
| Cliente | Sección adicional | Por qué la necesita el cliente |
|---|---|---|
| Kestrel Dental Group | Cumplimiento normativo y tratamiento de datos | Los 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 Board | Anexo de API | Sus ingenieros conectan el flujo de contadores a sus propios sistemas. El anexo enumera endpoints, campos de petición y códigos de error. |
| Orrin Retail | Tabla de localización | La 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:
- 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.
- 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.
- 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. - Exportar el archivo Word para comentarios como
orrin-retail-catalogue-scope_v1.2.docx, y el archivo Markdown para ingenieros comoorrin-retail-catalogue-scope_v1.2.md, con el mismo nombre base. - 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.
- 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.
- Registrar el envío en el registro de cambios: fecha, destinatarios por rol, nombres de archivo y fecha límite de aprobación.
- 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:
| Cambio | Fecha | Cambio solicitado | Solicitado por | Aprobado por | Efecto en los entregables | Efecto en el calendario | Resultado |
|---|---|---|---|---|---|---|---|
| CR-001 | 2026-09-22 | Añadir una página de guía de tallas a la plantilla de producto | Responsable de marketing del cliente | Responsable de producto del cliente y responsable de cuenta de la agencia | D3 gana un tipo de página. El alcance pasa a v1.1. | M2 pasa de 2026-10-02 a 2026-10-09 | Aprobado |
| CR-002 | 2026-10-05 | Mostrar los niveles de stock en tiempo real en las páginas de producto | Responsable de ingeniería del cliente | Responsable de producto del cliente y responsable de cuenta de la agencia | Ninguno. Registrado como fuera de alcance en v1.1. | Ninguno | Rechazado. Necesita su propio acuerdo de integración. |
| CR-003 | 2026-10-14 | Cambiar D5 de una guía en PDF a un archivo Markdown para los ingenieros del cliente | Responsable de ingeniería del cliente | Responsable de producto del cliente y responsable de proyecto de la agencia | Cambia el formato de D5. La misma fuente se exporta a Markdown, así que el trabajo en sí no cambia. | Ninguno | Aprobado. 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
- Se reutiliza el archivo de un proyecto terminado. Los nombres y las cifras de clientes antiguos llegan al siguiente cliente. Solución: empezar siempre desde la plantilla guardada.
- Las solicitudes se acuerdan por chat y nunca se anotan. Solución: añadir una entrada en el registro de cambios antes de empezar cualquier trabajo.
- Los requisitos no tienen IDs. Los comentarios de revisión señalan "el segundo punto". Solución: asignar un ID único a cada requisito y citarlo en los comentarios.
- Falta el fuera de alcance. El cliente supone lo que se dejó fuera. Solución: enumerar los tres elementos que el cliente más probablemente dará por incluidos.
- Los criterios de aceptación son juicios. "Funciona bien" no se puede probar. Solución: escribir un resultado observable, como un formulario que muestre los campos obligatorios.
- Las exportaciones se hacen a mano. El PDF y el archivo Word se separan. Solución: exportar cada formato desde una sola fuente el mismo día.
- La etiqueta de versión se reutiliza o falta. Nadie sabe qué copia se firmó. Solución: subir la versión con cada cambio aprobado y etiquetar los borradores por separado.
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.