MarsDawn

Plantilla de especificación (PRD) en Markdown

Una especificación que tu agente puede completar y tú puedes leer de una sentada: el problema, los objetivos, los requisitos, un diagrama del flujo y los criterios de aceptación. Cuando cambies un requisito, pídele al agente que ajuste el resto.

La plantilla

Descargar spec.md

# Especificación: nombre de la función

Estado: borrador · Responsable: nombre · Actualizado: fecha

## Problema

_Qué falla hoy, a quién afecta y cómo lo sabemos._

## Objetivos

- _Qué será cierto cuando esto salga._

## Fuera de alcance

- _Lo que esto no hace, a propósito._

## Requisitos

| ID | Requisito | Prioridad |
|----|-----------|-----------|
| R1 | _Requisito_ | Obligatorio |
| R2 | _Requisito_ | Recomendado |

## Flujo

```mermaid
flowchart LR
  A[Inicio] --> B[Paso] --> C[Resultado]
```

## Criterios de aceptación

- [ ] R1: _Cómo lo comprobamos._
- [ ] R2: _Cómo lo comprobamos._

## Preguntas abiertas

- _Pregunta._

Cómo se ve

La primera página de spec.md, exportada a PDF con marsdawn export.

Exportada con marsdawn export spec.md. La herramienta de línea de comandos gratuita renderiza igual que la vista previa de MarsDawn, diagrama incluido.

Pídeselo a tu agente

Escribe una especificación para [la función] en spec.md, usando la plantilla de https://marsdawn.southern-light.dev/es/templates/spec/spec.md. Dale un ID a cada requisito y usa los mismos ID en el flujo y en los criterios de aceptación. Cuando esté escrita, ejecuta marsdawn open spec.md.

Compártela en PDF

marsdawn export spec.md escribe spec.pdf junto al archivo, para quien no lee Markdown.

Lo que no hace

MarsDawn muestra la especificación, la tabla y el diagrama. No comprueba que los criterios de aceptación cubran cada requisito. Eso es trabajo del agente, y de tu lectura.

Preguntas

¿El diagrama de flujo necesita que instale algo?

No. MarsDawn y marsdawn export dibujan Mermaid por sí mismos, sin conexión.

¿Puedo editar la especificación en MarsDawn?

Sí. Es un editor de Markdown con la vista previa junto al código fuente. El agente verá tu cambio la próxima vez que lea el archivo.

Más plantillas