# AI_CONTEXT.md — Handoff agent

> **Premier fichier à lire.** Ce fichier permet à n'importe quel agent IA de reprendre le projet sans briefing humain.

## Projet

| Champ | Valeur |
|---|---|
| **Nom** | cosma-log-analyzer |
| **Description** | Détecteur anomalies logs AUV COSMA (règles déterministes + NATS) |
| **Statut** | `wip` / `active` / `paused` / `archived` |
| **Owner humain** | Flag (`floppyrj45`) |
| **Agent principal** | `agent-surfer` |

## Ressources

| Ressource | URL / Chemin |
|---|---|
| **Gitea** | `http://192.168.0.82:3000/floppyrj45/cosma-log-analyzer` |
| **Nextcloud** | `/mnt/nas-nextcloud/cosma-log-analyzer/` (sur `.82`) |
| **Docs Sphinx** | `http://192.168.0.82/cosma-log-analyzer-docs/` |
| **Channel Discord** | `#PROJECT_CHANNEL` |

## Architecture courte

*À compléter — 5-10 lignes max. Stack, composants principaux, ports exposés.*

## État actuel

*Résumé de l'état du projet au moment de la dernière mise à jour de ce fichier.*

## Tâches ouvertes

- [ ] tâche 1
- [ ] tâche 2

## Décisions clés

*Décisions d'architecture ou de design importantes à connaître.*

## Comment démarrer (agent)

```bash
# 1. Configurer ton identité Git
git config user.name "agent-<ton-nom>"
git config user.email "agent-<ton-nom>@labo.local"

# 2. Lire les règles workflow
cat .gitea/WORKFLOW.md

# 3. Créer ta branche de travail
git checkout -b feat/agent-<ton-nom>/<description>

# 4. Push et ouvrir une PR vers develop
git push origin feat/agent-<ton-nom>/<description>
```

Token Gitea : voir `~/.agent-gitea-tokens` sur `.82` ou demander à Flag.