Créer un Document de Spike Technique

Créez des documents de spike technique délimités dans le temps pour investiguer les questions critiques qui doivent être résolues avant que le développement puisse procéder. Chaque spike se concentre sur une décision technique spécifique avec des livrables et des calendriers clairs.

Structure du Document

Créez des fichiers individuels dans le répertoire ${input:FolderPath|docs/spikes}. Nommez chaque fichier selon le modèle : [catégorie]-[courte-description]-spike.md (par ex. api-intégration-copilot-spike.md, performance-audio-temps-réel-spike.md).

---
title: "${input:SpikeTitle}"
category: "${input:Category|Technical}"
status: "🔴 Not Started"
priority: "${input:Priority|High}"
timebox: "${input:Timebox|1 week}"
created: [YYYY-MM-DD]
updated: [YYYY-MM-DD]
owner: "${input:Owner}"
tags: ["technical-spike", "${input:Category|technical}", "research"]
---

# ${input:SpikeTitle}

## Summary

**Spike Objective:** [Question ou décision claire et spécifique qui nécessite une résolution]

**Why This Matters:** [Impact sur les décisions de développement/architecture]

**Timebox:** [Durée allouée à ce spike]

**Decision Deadline:** [Quand cela doit être résolu pour éviter un blocage du développement]

## Research Question(s)

**Primary Question:** [Question technique principale qui nécessite une réponse]

**Secondary Questions:**

- [Question liée 1]
- [Question liée 2]
- [Question liée 3]

## Investigation Plan

### Research Tasks

- [ ] [Tâche de recherche spécifique 1]
- [ ] [Tâche de recherche spécifique 2]
- [ ] [Tâche de recherche spécifique 3]
- [ ] [Créer une preuve de concept/prototype]
- [ ] [Documenter les résultats et recommandations]

### Success Criteria

**Ce spike est complet quand:**

- [ ] [Critère spécifique 1]
- [ ] [Critère spécifique 2]
- [ ] [Recommandation claire documentée]
- [ ] [Preuve de concept complétée (le cas échéant)]

## Technical Context

**Related Components:** [Lister les composants système affectés par cette décision]

**Dependencies:** [Quels autres spikes ou décisions dépendent de la résolution de celui-ci]

**Constraints:** [Limitations connues ou exigences qui affectent la solution]

## Research Findings

### Investigation Results

[Documenter les résultats de recherche, les résultats des tests et les preuves rassemblées]

### Prototype/Testing Notes

[Résultats de tout prototype, spike ou expérience technique]

### External Resources

- [Lien vers la documentation pertinente]
- [Lien vers les références API]
- [Lien vers les discussions communautaires]
- [Lien vers les exemples/tutoriels]

## Decision

### Recommendation

[Recommandation claire basée sur les résultats de recherche]

### Rationale

[Pourquoi cette approche a été choisie plutôt que d'autres]

### Implementation Notes

[Considérations clés pour l'implémentation]

### Follow-up Actions

- [ ] [Élément d'action 1]
- [ ] [Élément d'action 2]
- [ ] [Mettre à jour les documents d'architecture]
- [ ] [Créer des tâches d'implémentation]

## Status History

| Date   | Status         | Notes                      |
| ------ | -------------- | -------------------------- |
| [Date] | 🔴 Not Started | Spike créé et défini       |
| [Date] | 🟡 In Progress | Recherche commencée        |
| [Date] | 🟢 Complete    | [Résumé de la résolution]  |

---

_Last updated: [Date] by [Name]_

Catégories pour les Spikes Techniques

API Integration

Capacités et limitations des API tiers
Modèles d'intégration et authentification
Limites de taux et caractéristiques de performance

Architecture & Design

Décisions d'architecture système
Applicabilité des modèles de conception
Modèles d'interaction des composants

Performance & Scalability

Exigences et contraintes de performance
Goulots d'étranglement de scalabilité et solutions
Modèles d'utilisation des ressources

Platform & Infrastructure

Capacités et limitations des plateformes
Exigences en matière d'infrastructure
Considérations de déploiement et d'hébergement

Security & Compliance

Exigences et implémentations de sécurité
Contraintes de conformité
Approches d'authentification et d'autorisation

User Experience

Modèles d'interaction utilisateur
Exigences d'accessibilité
Décisions de conception d'interface

Conventions de Nommage des Fichiers

Utilisez des noms descriptifs en kebab-case indiquant la catégorie et l'inconnue spécifique :

Exemples API/Intégration :

api-intégration-copilot-chat-spike.md
api-azure-speech-temps-réel-spike.md
api-capacités-extension-vscode-spike.md

Exemples Performance :

performance-latence-traitement-audio-spike.md
performance-limitations-hôte-extension-spike.md
performance-fiabilité-webrtc-spike.md

Exemples Architecture :

architecture-conception-pipeline-voix-spike.md
architecture-gestion-état-spike.md
architecture-stratégie-gestion-erreurs-spike.md

Bonnes Pratiques pour les Agents IA

Une Question Par Spike : Chaque document se concentre sur une seule décision technique ou question de recherche
Recherche Délimitée dans le Temps : Définir des limites de temps et des livrables spécifiques pour chaque spike
Décisions Basées sur des Preuves : Exiger des preuves concrètes (tests, prototypes, documentation) avant de marquer comme complet
Recommandations Claires : Documenter des recommandations spécifiques et le rationnelle pour l'implémentation
Suivi des Dépendances : Identifier comment les spikes se rapportent les uns aux autres et impactent les décisions de projet
Axé sur les Résultats : Chaque spike doit aboutir à une décision ou recommandation exploitable

Stratégie de Recherche

Phase 1 : Collecte d'Informations

Rechercher la documentation existante en utilisant les outils de recherche/récupération
Analyser la base de code pour les modèles et contraintes existants
Rechercher les ressources externes (APIs, bibliothèques, exemples)

Phase 2 : Validation & Tests

Créer des prototypes ciblés pour tester des hypothèses spécifiques
Exécuter des expériences ciblées pour valider les hypothèses
Documenter les résultats des tests avec des preuves à l'appui

Phase 3 : Décision & Documentation

Synthétiser les résultats en recommandations claires
Documenter les directives d'implémentation pour l'équipe de développement
Créer des tâches de suivi pour l'implémentation

Utilisation des Outils

search/searchResults : Rechercher les solutions existantes et la documentation
fetch/githubRepo : Analyser les APIs externes, bibliothèques et exemples
codebase : Comprendre les contraintes et modèles du système existant
runTasks : Exécuter les prototypes et tests de validation
editFiles : Mettre à jour la progression et les résultats de recherche
vscodeAPI : Tester les capacités et limitations de l'extension VS Code

Concentrez-vous sur la recherche délimitée dans le temps qui résout les décisions techniques critiques et débloque la progression du développement.

create-technical-spike