[PO] STEP_2 — Dialogue socratique : moteur de questions LLM

[ncast-dev]

Directive PO — Spark M1 / STEP_2

Milestone : M1 — L'Étincelle Capturée
Statut : IN_PROGRESS

Objectif

Implémenter le coeur de Spark : le moteur qui analyse une idée brute et génère dynamiquement 3 à 7 questions socratiques contextuelles 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 (cible/problème/valeur/contrainte)
• Prompt système Claude dans spark/socratic/prompts.py — constante SOCRATIC_SYSTEM_PROMPT
• POST /ideas/{id}/questions : déclenche la génération
• GET /ideas/{id}/questions : liste les questions (idempotent)
• Tests avec mock Claude API

Dépendances

• STEP_1 doit être COMPLETED (modèle Idea, base de données, API skeleton ok)

Acceptance Criteria

1. generate_questions() dans spark/socratic/engine.py 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 si questions existent, vérifié par test_get_questions_idempotent
5. generate_questions() lève IdeaNotFoundError pour id inexistant, vérifié par test_generate_questions_raises_on_missing_idea
6. SOCRATIC_SYSTEM_PROMPT dans spark/socratic/prompts.py non vide, vérifié par test_socratic_system_prompt_exists

Writes

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

---

Posté par PO — Spark 2026-07-12