aissia/CLAUDE.md

AISSIA - Assistant Personnel Intelligent

Description

Assistant personnel qui aide à gérer le temps, l'hyperfocus et l'apprentissage de langues. Interventions proactives avec l'IA pour forcer les transitions et planifier intelligemment.

Fonctionnalités MVP

1. SchedulerModule : Planning de tâches, détection hyperfocus (max 2h), rappels de pauses
2. AIAssistantModule : Interventions contextuelles via Claude, dialogue naturel
3. LanguageLearningModule : Conversation dans langue cible, corrections intelligentes
4. NotificationModule : Alertes système Windows, TTS, support multilingue
5. DataModule : SQLite local, historique, métriques

Architecture Technique

Principe : Architecture Modulaire WarFactory

Hot-reload 0.4ms, modules 200-300 lignes, build autonome par module.

MainServer Process
├── CoordinationModule → Charge appconfig.json
├── DebugEngine → SequentialModuleSystem
└── Modules (.dll)
    ├── scheduler.dll
    ├── ai-assistant.dll
    ├── language.dll
    ├── notification.dll
    └── data.dll

5 Interfaces Fondamentales

ICoordinationModule → Orchestrateur global
IEngine            → DebugEngine → HighPerfEngine
IModuleSystem      → Sequential → Threaded → Cluster
IModule            → Logique métier pure (200 lignes max)
IIO                → IntraIO → LocalIO → NetworkIO

Contraintes Critiques

Modules :

• 200-300 lignes maximum
• Logique métier pure (pas de threading, network)
• Communication JSON uniquement
• Build autonome : cmake . depuis module

NEVER :

• ❌ cmake .. ou #include "../"
• ❌ Modules > 300 lignes
• ❌ Dépendances entre modules

ALWAYS :

• ✅ Build autonome
• ✅ JSON communication
• ✅ Hot-reload ready
• ✅ Task-centric design

Workflow Développement

cd modules/scheduler/
cmake .                  # NEVER cmake ..
make
./scheduler-test

# Edit SchedulerModule.cpp → Save → Hot-reload 0.4ms

Communication Inter-Modules (JSON)

{"event": "hyperfocus", "duration_minutes": 120}
  → AIAssistantModule
{"type": "break_suggestion", "message": "Pause ?"}
  → NotificationModule
{"notification": "system_toast", "tts": true}

Structure Projet

Aissia/
├── CLAUDE.md
├── docs/                        # Documentation détaillée
├── modules/                     # À créer
│   ├── scheduler/
│   ├── ai-assistant/
│   ├── language-learning/
│   ├── notification/
│   └── data/
└── src/                        # Infrastructure

Priorités

1. Infrastructure (IModule, IEngine, hot-reload)
2. SchedulerModule
3. NotificationModule
4. AIAssistantModule
5. LanguageLearningModule
6. DataModule

Références

• docs/README.md : Vue d'ensemble
• docs/architecture/architecture-technique.md : Architecture complète
• CDCDraft.md : Cahier des charges
• GroveEngine : Architecture source WarFactory (accès via .claude/settings.json)