ai-novel-engine/docs/AGENTS_2026-03-21.md

Agents et sous-agents - 21 mars 2026

Carte operative mise a jour pour la refonte ANE.

Carte d'ensemble

flowchart TD
    C["Agent 0 - Coordination"] --> R["Agent 1 - Runtime layer"]
    C --> P["Agent 2 - Pipeline narratif"]
    C --> N["Agent 3 - next_lots / control plane"]
    C --> O["Agent 4 - Ops / logs / retention"]
    C --> D["Agent 5 - Docs / sync"]
    C --> V["Agent 6 - Veille OSS"]
    C --> A["Agent 7 - App SwiftUI"]
    C --> T["Agent 8 - Tests / qualite code"]
    R --> N
    R --> A
    V --> P
    T --> R
    T --> N

Agent 0 - Coordination

• mission: tenir le point de reprise officiel, arbitrer les lots, garder le repo coherent
• livrables: TODO_ACTIVE.md, plans dates, memoires, arbitrages de purge

Agent 1 - Runtime layer

• mission: rendre le runtime explicite et testable
• zones: core/runtime/*, core/generation/provider.py
• actif:
  • extraire profil + client + health
  • ajouter profils runtime nommes
  • ajouter capacites explicites pour response_format et switch manuel
  • extraire remote_hosts.py et orchestration.py

Agent 2 - Pipeline narratif

• mission: garder ANE strictement auteurial
• zones: core/generation/pipeline.py, prompts/*
• actif:
  • ne pas laisser les contraintes runtime reinfiltrer le pipeline
  • reprendre rewrite_v1 / repair_v1 pour qwen2.5:7b
  • comprendre mistral-nemo

Agent 3 - next_lots / control plane

• mission: decouper orchestration, preflight runtime et checkpoint manuel
• zones: core/next_lots.py, automation/next_lots.toml, scripts de reprise
• actif:
  • sortir les checkpoints runtime du monolithe
  • brancher les profils runtime
  • sortir le plan runtime et les signaux checkpoint hors du runner
  • proteger les reports references des purges

Agent 4 - Ops / logs / retention

• mission: garder des TUIs et logs lisibles, puis purger sans perdre de references
• zones: scripts/ops_tui.py, scripts/reports_ops.py, automation/reports/
• actif:
  • analyser les top erreurs stderr
  • converger le TUI remote Mascarade sur la couche runtime partagee
  • durcir la retention des reports documentes

Agent 5 - Docs / sync

• mission: resynchroniser l'histoire du repo avec l'etat reel
• zones: docs racine + docs app
• actif:
  • ouvrir un nouveau point de reprise au 21 mars
  • realigner toutes les references stale du 16 mars qui sont devenues fausses

Agent 6 - Veille OSS

• mission: reperer les briques reutilisables sans transformer ANE en framework generique
• actif:
  • sourcer llama.cpp, lm-format-enforcer, Outlines, DeepEval, LiteLLM, Open WebUI, WritingBench
  • traduire la veille en decisions d'implementation concretes

Agent 7 - App SwiftUI

• mission: aligner l'app avec l'architecture ANE + Mascarade
• zones: app_AI-novel-engine/Sources/AINovelEngineStudio/*
• actif:
  • backend selector OpenAI / Mascarade
  • test connection
  • lancement pipeline ANE
  • resynchroniser plans/TODOs/docs de l'app

Agent 8 - Tests / qualite code

• mission: garder chaque lot couvert et relancable
• actif:
  • valider 152 tests Python verts apres extraction runtime
  • ajouter tests dedies a la logique de profils runtime, TUI remote et execution runtime
  • clarifier la strategie de tests Swift de l'app