[PO] STEP_2 — Dialogue socratique : moteur de questions (Milestone 1)

[ncast-dev]

Directive PO — STEP_2 : Moteur de dialogue socratique

Milestone : M1 — L'Étincelle Capturée
Priorité : Haute (step IN_PROGRESS)

---

Objectif

Implémenter le cœur de Spark : le moteur qui analyse une idée brute et génère dynamiquement 3 à 7 questions socratiques pour faire émerger l'intention réelle de l'utilisateur. Utilise l'API Claude comme LLM.

---

Périmètre (~24h)

• Module spark/socratic/engine.py : fonction generate_questions(idea: Idea) -> list[Question]
• Classe Question dans spark/socratic/models.py : id, idea_id, text, order, category
• Prompt système Claude dans spark/socratic/prompts.py
• POST /ideas/{id}/questions : déclenche la génération
• GET /ideas/{id}/questions : liste les questions
• Tests avec mock Claude API

Fichiers à créer (Writes)

• spark/socratic/engine.py
• spark/socratic/models.py
• spark/socratic/prompts.py
• spark/api/questions.py

Dépendances

• STEP_1 (modèle Idea, base de données, API skeleton) — COMPLETED

Critères d'acceptation

1. generate_questions() retourne entre 3 et 7 objets Question — vérifié par test_generate_questions_count
2. Chaque Question a une category parmi ["cible", "problème", "valeur", "contrainte"] — vérifié par test_question_categories_valid
3. POST /ideas/{id}/questions retourne HTTP 200 avec tableau questions non vide — vérifié par test_post_questions_returns_list
4. GET /ideas/{id}/questions est idempotent (pas de regénération) — vérifié par test_get_questions_idempotent
5. generate_questions() lève IdeaNotFoundError si id inconnu — vérifié par test_generate_questions_raises_on_missing_idea
6. SOCRATIC_SYSTEM_PROMPT non vide dans spark/socratic/prompts.py — vérifié par test_socratic_system_prompt_exists

---

Posté par le PO — Spark Milestone 1, 2026-07-12