MarsDawn

Modèle de spécification (PRD) en Markdown

Une spécification que votre agent peut remplir et que vous pouvez lire d’une traite : le problème, les objectifs, les exigences, un diagramme de flux et les critères d’acceptation. Quand vous modifiez une exigence, demandez à l’agent d’harmoniser le reste.

Le modèle

Télécharger spec.md

# Spécification : nom de la fonctionnalité

Statut : brouillon · Responsable : nom · Mise à jour : date

## Problème

_Ce qui ne va pas aujourd’hui, pour qui, et comment on le sait._

## Objectifs

- _Ce qui sera vrai une fois livré._

## Hors périmètre

- _Ce que cela ne fait pas, délibérément._

## Exigences

| ID | Exigence | Priorité |
|----|----------|----------|
| R1 | _Exigence_ | Indispensable |
| R2 | _Exigence_ | Souhaitable |

## Flux

```mermaid
flowchart LR
  A[Début] --> B[Étape] --> C[Résultat]
```

## Critères d’acceptation

- [ ] R1 : _Comment on le vérifie._
- [ ] R2 : _Comment on le vérifie._

## Questions ouvertes

- _Question._

À quoi il ressemble

La première page de spec.md, exportée en PDF avec marsdawn export.

Exporté avec marsdawn export spec.md. L’outil en ligne de commande gratuit produit le même rendu que l’aperçu de MarsDawn, diagramme compris.

Demandez à votre agent

Rédige une spécification pour [la fonctionnalité] dans spec.md, à partir du modèle disponible à https://marsdawn.southern-light.dev/fr/templates/spec/spec.md. Donne un identifiant à chaque exigence, et utilise les mêmes identifiants dans le flux et dans les critères d’acceptation. Une fois que c’est écrit, lance marsdawn open spec.md.

Le partager en PDF

marsdawn export spec.md écrit spec.pdf à côté, pour qui ne lit pas le Markdown.

Ce qu’il ne fait pas

MarsDawn affiche la spécification, le tableau et le diagramme. Il ne vérifie pas que les critères d’acceptation couvrent chaque exigence. C’est le travail de l’agent, et celui de votre relecture.

Questions

Le diagramme de flux nécessite-t-il d’installer quelque chose ?

Non. MarsDawn et marsdawn export dessinent Mermaid eux-mêmes, hors ligne.

Puis-je modifier la spécification dans MarsDawn ?

Oui. C’est un éditeur Markdown avec l’aperçu à côté du source. L’agent verra votre modification la prochaine fois qu’il lira le fichier.

Autres modèles