Especificaciones del Proyecto · Documento (por pasos)

Un formulario guiado, didáctico y visual (modo oscuro, sin degradados). Al final te genera un JSON con todas las particularidades del documento.

Paso 1 de 8
Auto-guardado

Nombre + Meta del Documento

Define el objetivo y el nombre. Esto sirve como “ancla”: todo lo demás (audiencias, estructura, formato) debería alinearse con esta meta.

Ejemplo: “Guía de Onboarding para Soporte · Q1 2026”.
¿Qué debe lograr el documento? Piensa en: acción/decisión, audiencia y resultado.
Tip didáctico: escribe la meta con esta fórmula:
Para [audiencia], este documento sirve para [acción/decisión], logrando [resultado medible].

Trasfondo del Documento (y reglas)

Contexto que explica por qué existe el documento, qué decisiones ya están tomadas y qué restricciones hay. Si existen reglas, indícalo y escríbelas.

Incluye: historia, dolor actual, antecedentes, limitantes, términos o definiciones, supuestos y riesgos.
Idea: si el documento tiene que “convencer”, aquí agrega el “por qué ahora” y el “qué pasa si no”.
Ejemplos: tono, compliance, estilo, referencias obligatorias, definición de términos.
Tip: si no hay reglas formales, puedes escribir “No hay reglas establecidas; se prioriza claridad y consistencia.”

Estructura del Documento (atomización + HITL)

Divide el documento en componentes (secciones, bloques, piezas). Para cada componente define: entradas → proceso → salidas, y marca los touchpoints human-in-the-loop (dónde una persona revisa, aprueba o interviene).

Componentes atomizados

Piensa en “piezas mínimas útiles”. Ej: “Resumen ejecutivo”, “Definiciones”, “Procedimiento paso a paso”, “Checklist”.
Tip HITL: Si un componente puede causar errores o riesgos (legales, técnicos, reputacionales), agrega un touchpoint humano con un criterio claro de aprobación.
Orden sugerido, reglas de navegación, referencias cruzadas, glosario, etc.
✅ Mini-guía de atomización: 1) ¿Cuál es el bloque? 2) ¿Para qué existe? 3) ¿Qué necesita como entrada? 4) ¿Qué produce como salida? 5) ¿Qué revisión humana requiere y cuándo?

Audiencia(s)

Declara quién leerá el documento y qué necesita. Si hay múltiples audiencias, esto ayuda a decidir lenguaje, nivel de detalle y orden de la información.

Lista de audiencias

Ejemplos: “Equipo interno”, “Clientes”, “Directivos”, “Auditoría”, “Usuarios técnicos”, “Usuarios no técnicos”.
Tip: por audiencia, anota: qué sabe ya, qué le preocupa, y qué decisión tomará después de leer.

Información Necesaria

Lista de datos que necesitas para escribir/revisar el documento: fuentes, responsables y si es obligatorio. Esto evita “huecos” de información y reduce iteraciones.

Checklist de información

Ejemplos: “Política actual”, “Métricas Q4”, “Lista de stakeholders”, “Enlaces a sistemas”, “Glosario”.
Tip: si una fuente es “la única verdad” (single source of truth), escríbela explícitamente.

Nicho

Describe el contexto de industria/tema. Agrega palabras clave para alinear terminología y ayudar a que el documento “suene” al nicho correcto.

Industria, subtema, marco conceptual, tipo de producto/servicio, restricciones del dominio.
Escribe una palabra y presiona Enter para agregarla. Usa esto para términos clave, acrónimos, herramientas, frameworks.
Tip: agrega también “palabras prohibidas” si hay jerga que se debe evitar.

Formato de salida

Define cómo se entregará el documento: bullets o no, guiones (dashes), párrafos, títulos y notas de estilo. Te muestro una mini-vista previa basada en tus selecciones.

Solo aplica si activaste bullets.
Solo aplica si activaste párrafos.
Ej: “Evitar voz pasiva”, “Incluir ejemplos”, “Formato tipo SOP”, “Incluir tabla al final”.
Esto es un ejemplo para “sentir” el formato. No es tu documento real.
Tip: si el documento será usado como instrucción operativa, suele funcionar bien: encabezados + pasos con dashes + checklist con bullets.

Revisión y JSON final

Aquí tienes el JSON estructurado con todas las particularidades del documento. Puedes copiarlo o descargarlo.

Un vistazo a lo capturado (esto no reemplaza el JSON; solo orienta).
JSON generado 
{}
Consejo: si vas a usar este JSON en un flujo automatizado, mantén estables los nombres de claves (por ejemplo, estructura_documento.atomizacion) para que sea fácil parsearlo.

Guardado local (localStorage). Si iniciaste sesión, el botón Guardar también sincroniza en tu cuenta (Supabase).

Añadir componente

Define un componente del documento. Puedes añadir entradas/salidas como listas, y touchpoints humanos si aplica.

Ej: “Resumen ejecutivo”, “Checklist final”, “Procedimiento”.
¿Qué hace este componente y por qué existe?
Escribe y presiona Enter para agregar.
¿Qué produce este componente? Ej: decisiones, listas, texto final.

Touchpoints human-in-the-loop (HITL)

Un touchpoint es un momento donde una persona revisa, valida o aprueba (por riesgo, calidad, consistencia o compliance).
Tip: define criterios verificables. Ej: “Aprobado si cumple X, no incluye Y, y cita Z”.
Se guardará en: estructura_documento.atomizacion

Añadir audiencia

Define quién leerá el documento y qué necesita. Esto guía tono, nivel de detalle y estructura.

Ej: “Clientes”, “Equipo interno”, “Directores”.
Ej: formal, cercano, técnico, ejecutivo, instructivo.
¿Qué necesita entender? ¿Qué decisión toma? ¿Qué le importa?
Se guardará en: audiencias

Añadir información necesaria

Define un dato requerido, su fuente, y si es obligatorio (para no bloquear el documento).

Ej: “Métrica SLA”, “Política de devoluciones”, “Lista de roles”.
Ej: Confluence, Jira, URL, persona responsable, repositorio.
Dependencias, cómo obtenerlo, formato esperado, sensibilidad, etc.
Se guardará en: informacion_necesaria