Specs

Les Specs, ou spécifications, sont des artefacts structurés qui formalisent le processus de développement pour les fonctionnalités et les corrections de bogues dans votre application. Elles offrent une approche systématique pour transformer des idées de haut niveau en plans de mise en œuvre détaillés avec un suivi et une responsabilisation clairs.

Avec les Specs de Kiro, vous pouvez :

• Décomposer les exigences en récits utilisateurs avec critères d'acceptation
• Créer des documents de conception avec des diagrammes de séquence et des plans d'architecture
• Suivre l'avancement de la mise en œuvre à travers des tâches distinctes
• Collaborer efficacement entre les équipes de produit et d'ingénierie

Chaque Spec génère trois fichiers clés qui forment le fondement de votre spécification :

• requirements.md (ou bugfix.md) - Capture les récits utilisateurs, les critères d'acceptation ou l'analyse de bogue dans une notation structurée
• design.md - Documente l'architecture technique, les diagrammes de séquence et les considérations de mise en œuvre
• tasks.md - Fournit un plan de mise en œuvre détaillé avec des tâches distinctes et traçables

Toutes les Specs suivent un flux de travail en trois phases qui transforme votre idée en une mise en œuvre exécutable :

Exigences ou analyse de bogue - Définir ce qui doit être construit ou corrigé

• Feature Specs : récits utilisateurs et critères d'acceptation dans requirements.md
• Bugfix Specs : analyse de bogue avec comportement actuel/attendu/inchangé dans bugfix.md

Conception - Créer l'architecture technique et l'approche de mise en œuvre dans design.md

• Architecture système et conception des composants
• Diagrammes de séquence et flux de données
• Gestion des erreurs et stratégie de test

Tâches - Générer des tâches de mise en œuvre distinctes et exécutables dans tasks.md

• Tâches traçables avec des résultats clairs
• Mises à jour du statut en temps réel au fil de la mise en œuvre
• Exécutez les tâches individuellement ou toutes à la fois

Lorsque vous exécutez toutes les tâches d'une Spec, Kiro analyse votre liste de tâches, détermine lesquelles dépendent les unes des autres et exécute les tâches indépendantes simultanément. Pour la plupart des Feature Specs, cela réduit considérablement le temps d'exécution sans aucune configuration.

Kiro construit un graphe de dépendances des tâches dans votre tasks.md et regroupe les tâches indépendantes en vagues :

• Vague 1 - toutes les tâches sans dépendances. Elles s'exécutent simultanément.
• Vague 2 - toutes les tâches dont les dépendances ont été satisfaites par la vague 1. Elles s'exécutent simultanément.
• Vague N - se poursuit jusqu'à ce que toutes les tâches soient terminées.

Les vagues s'exécutent séquentiellement; les tâches d'une même vague s'exécutent simultanément.

Kiro prend en charge deux types de Specs pour répondre à vos besoins de développement :

Pour créer de nouvelles fonctionnalités et capacités dans votre application. Les Feature Specs vous guident à travers la collecte des exigences, la conception technique et la planification de la mise en œuvre avec deux variantes de flux de travail : Requirements-First et Design-First. Pour les fonctionnalités bien comprises, vous pouvez aussi utiliser Quick Spec pour générer automatiquement les trois artefacts sans points de validation.

En savoir plus sur les Feature Specs →

Pour diagnostiquer et corriger systématiquement les bogues avec une précision chirurgicale tout en prévenant les régressions. Les Bugfix Specs vous aident à identifier les causes profondes, à concevoir des correctifs et à valider que rien d'autre n'est brisé.

En savoir plus sur les Bugfix Specs →

Approfondissez le système de Specs de Kiro avec ces guides :