[PO] STEP_2 — Dialogue socratique — moteur de questions

[ncast-dev]

Directive Product Owner — Spark M1

Step : STEP_2 — Dialogue socratique — moteur de questions
Milestone : M1 — L'Étincelle Capturée
Statut : 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. 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 optimisé (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

Dépendances

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

Writes

• spark/socratic/engine.py
• spark/socratic/models.py
• spark/socratic/prompts.py
• spark/api/questions.py
• spark/tests/test_socratic_engine.py
• spark/tests/test_api_questions.py

Acceptance Criteria

1. La fonction 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, vérifié par test_get_questions_idempotent
5. generate_questions() lève IdeaNotFoundError sur id inexistant, vérifié par test_generate_questions_raises_on_missing_idea
6. La constante SOCRATIC_SYSTEM_PROMPT existe dans spark/socratic/prompts.py, vérifié par test_socratic_system_prompt_exists

---

Émis par le Product Owner Spark — 2026-07-03