# Spécification: {Feature Name}

> Feature ID: {feature_id}
> Créé: {date}
> Statut: Draft | Review | Approved

## 1. Vue d'ensemble

### 1.1 Contexte
[Pourquoi cette feature existe]

### 1.2 Objectifs
- Objectif 1
- Objectif 2

### 1.3 Non-objectifs (Out of scope)
- Ce qui n'est PAS inclus

## 2. User Stories

### US-001: [Titre]
**En tant que** [type d'utilisateur]
**Je veux** [action]
**Afin de** [bénéfice]

**Critères d'acceptation**:
- [ ] Critère 1
- [ ] Critère 2

**Notes**: [Détails supplémentaires]

### US-002: [Titre]
...

## 3. Parcours Utilisateur

### 3.1 Parcours Principal (Happy Path)
1. L'utilisateur [action 1]
2. Le système [réponse 1]
3. L'utilisateur [action 2]
4. Le système [réponse 2]
5. Résultat attendu: [état final]

### 3.2 Parcours Alternatifs
#### Alt-A: [Nom du cas]
- Condition: [quand ce cas se produit]
- Étapes: [liste des étapes]
- Résultat: [état final]

### 3.3 Cas d'Erreur
#### Err-A: [Nom de l'erreur]
- Condition: [quand cette erreur survient]
- Message: [message affiché]
- Action: [ce que l'utilisateur peut faire]

## 4. Interfaces Utilisateur

### 4.1 Écrans/Pages concernés
- Page A: [description]
- Page B: [description]

### 4.2 Composants UI
- Composant X: [description, comportement]
- Composant Y: [description, comportement]

### 4.3 Maquettes
[Références aux maquettes si disponibles, sinon description textuelle]

## 5. Données

### 5.1 Modèles de données

### 5.2 Règles de validation
- field1: [règles]
- field2: [règles]

### 5.3 États et transitions

## 6. API (si applicable)

### 6.1 Endpoints
| Méthode | Path | Description |
|---------|------|-------------|
| POST | /api/x | Créer X |
| GET | /api/x/:id | Récupérer X |

### 6.2 Contrats API
```json
// POST /api/x
// Request
{
  "field1": "string",
  "field2": 123
}

// Response 200
{
  "id": "uuid",
  "field1": "string",
  "created_at": "ISO date"
}

// Response 400
{
  "error": "validation_error",
  "details": [...]
}

---

### Étape 3: Créer le Plan Technique

**Fichier**: `.heracles/sessions/{session_id}/specs/plan.md`

**Template**:

```markdown
# Plan Technique: {Feature Name}

> Feature ID: {feature_id}
> Basé sur: specification.md v{version}

## 1. Architecture

### 1.1 Composants impactés
- Frontend: [composants]
- Backend: [services/modules]
- Database: [tables/collections]

### 1.2 Diagramme d'architecture

### 1.3 Décisions architecturales
| Décision | Raison | Alternatives rejetées |
|----------|--------|----------------------|
| Utiliser X | Parce que Y | Z (car...) |

## 2. Modèles de Données

### 2.1 Schéma Database
```sql
CREATE TABLE feature_x (
  id UUID PRIMARY KEY,
  field1 VARCHAR(255) NOT NULL,
  field2 INTEGER,
  created_at TIMESTAMP DEFAULT NOW()
);

CREATE INDEX idx_feature_x_field1 ON feature_x(field1);

interface FeatureX {
  id: string;
  field1: string;
  field2?: number;
  createdAt: Date;
}

type CreateFeatureXInput = Omit<FeatureX, 'id' | 'createdAt'>;

// routes/featureX.ts
router.post('/feature-x', validateInput, createFeatureX);
router.get('/feature-x/:id', getFeatureX);
router.put('/feature-x/:id', validateInput, updateFeatureX);
router.delete('/feature-x/:id', deleteFeatureX);

const createSchema = z.object({
  field1: z.string().min(1).max(255),
  field2: z.number().optional(),
});

// store/featureX.ts
interface FeatureXState {
  items: FeatureX[];
  loading: boolean;
  error: string | null;
}

// hooks/useFeatureX.ts
function useFeatureX(id: string) {
  // ...
}

npm install package-a package-b
npm install -D package-c

---

### Étape 4: Créer les Tasks

**Fichier**: `.heracles/sessions/{session_id}/specs/tasks.md`

**Template**:

```markdown
# Tasks: {Feature Name}

> Généré depuis: plan.md
> Estimation totale: {X} heures

## Macro-Tasks

### MT-1: Setup & Infrastructure
- [ ] **T-1.1**: Créer migration DB
- [ ] **T-1.2**: Créer modèles/types
- [ ] **T-1.3**: Setup routes API

### MT-2: Backend Implementation
- [ ] **T-2.1**: Implémenter endpoint CREATE
- [ ] **T-2.2**: Implémenter endpoint READ
- [ ] **T-2.3**: Implémenter endpoint UPDATE
- [ ] **T-2.4**: Implémenter endpoint DELETE
- [ ] **T-2.5**: Ajouter validation
- [ ] **T-2.6**: Ajouter gestion erreurs

### MT-3: Frontend Implementation
- [ ] **T-3.1**: Créer composant Form
- [ ] **T-3.2**: Créer composant List
- [ ] **T-3.3**: Créer hooks custom
- [ ] **T-3.4**: Intégrer dans pages

### MT-4: Testing
- [ ] **T-4.1**: Écrire tests unitaires backend
- [ ] **T-4.2**: Écrire tests unitaires frontend
- [ ] **T-4.3**: Écrire tests intégration API
- [ ] **T-4.4**: Écrire tests E2E

### MT-5: Polish
- [ ] **T-5.1**: Review sécurité
- [ ] **T-5.2**: Optimisation performance
- [ ] **T-5.3**: Documentation

## Ordre d'exécution

## Dépendances entre tasks

| Task | Dépend de |
|------|-----------|
| T-2.1 | T-1.1, T-1.2 |
| T-3.1 | T-2.1, T-2.2 |
| T-4.3 | T-2.* |
| T-4.4 | T-3.* |

## Conditions Met
```yaml
init_complete: true
spec_complete: true  # <-- Changé à true
implementation_complete: false
tests_passed: false
review_passed: false
workflow_complete: false

---

## Chemins Dynamiques

Les chemins utilisés par ce skill sont définis dans `WORKFLOW_STATE.md > detected_structure` :

| Variable | Défaut | Description |
|----------|--------|-------------|
| `source_dir` | `src` | Répertoire des sources |
| `test_dir` | `test` | Répertoire des tests |
| `doc_dir` | `doc` | Répertoire de documentation |
| `spec_dir` | `spec` | Répertoire des specs projet |

Les specs de feature sont toujours dans `.heracles/sessions/{session_id}/specs/`.

---

## Checklist de Sortie

Avant de rendre la main à l'orchestrateur, vérifie :

- [ ] `.heracles/sessions/{session_id}/specs/specification.md` créé et complet
- [ ] `.heracles/sessions/{session_id}/specs/plan.md` créé et complet
- [ ] `.heracles/sessions/{session_id}/specs/tasks.md` créé avec toutes les tâches
- [ ] Toutes les questions ouvertes ont des réponses ou sont marquées
- [ ] `WORKFLOW_STATE.md` mis à jour avec `spec_complete: true`
- [ ] Entrée ajoutée dans History

---

## Communication avec l'Orchestrateur

À la fin de ton travail, retourne ce message :