# AGENT_WORKFLOW

AGENT_WORKFLOW est un kit local de workflow agentique pour piloter plusieurs projets avec Codex, Claude Code ou un autre agent de code. Il fournit des règles communes, des skills, des templates, un registre de tâches, une mémoire projet courte et des rapports de tâches obligatoires.

Le workflow vise quatre projets initiaux: `trading-agent`, `voice-protection`, `immobilier-predictif` et `autre-projet`. Il reste générique et peut être déplacé plus tard sur un VPS ou un mini-serveur.

## Workflow Resume

Plan -> Search -> Reuse Decision -> Minimal Design -> Code -> Tests -> Leak/Security Audit -> Task Report -> Compress Context -> Review -> Merge

## Utilisation Avec Codex

1. Place-toi dans `AGENT_WORKFLOW` ou dans `AGENT_WORKFLOW/projects/<project>`.
2. Lance Codex depuis ce dossier.
3. Codex doit lire `AGENTS.md`, `WORKFLOW.md`, `PROJECT_STATE.md` et `TASK_REGISTRY.md`.
4. Pour chaque tâche, donne un ID du registre, par exemple `T-001`.
5. Exige un rapport dans `reports/task_reports/TASK_ID.md`.

Codex doit toujours appliquer Reuse First, limiter le scope, lancer ou documenter les tests, vérifier secrets et leakage, puis mettre à jour `PROJECT_STATE.md`.

## Utilisation Avec Claude Code

1. Place-toi dans `AGENT_WORKFLOW` ou dans le dossier projet.
2. Lance Claude Code.
3. Claude Code doit lire `CLAUDE.md`, puis suivre `WORKFLOW.md`.
4. Une seule tâche doit être active à la fois.
5. Claude Code doit produire un résumé avant code et un task report après travail.

## Creer Un Nouveau Projet

1. Copier `projects/autre-projet` vers `projects/nom-du-projet`.
2. Mettre à jour `PROJECT_STATE.md`, `TASK_REGISTRY.md`, `AGENTS.md` et `CLAUDE.md`.
3. Ajouter les règles spécifiques du domaine, notamment `LEAKAGE_RULES.md` si le projet utilise des données temporelles.
4. Ajouter les tâches initiales dans le registre global et le registre projet.

## Lancer Une Tache

1. Choisir un ID dans `TASK_REGISTRY.md`.
2. Décrire l’objectif, les non-goals et la sortie attendue.
3. Demander à l’agent d’appliquer les 9 gates de `WORKFLOW.md`.
4. Vérifier le rapport généré dans `reports/task_reports/`.
5. Passer la tâche en `review` ou `done`.

## Regles Pour Les Agents

- Lire l’état projet avant toute action.
- Chercher le code existant avant de créer.
- Réutiliser ou modifier avant de construire.
- Garder le design minimal.
- Ne modifier que les fichiers autorisés.
- Documenter les commandes et tests.
- Ne jamais stocker de secrets.
- Bloquer si risque de leakage temporel.
- Mettre à jour `PROJECT_STATE.md`.

## Migration VPS Ou Mini-Serveur

Le dossier peut être copié tel quel sur un serveur. Avant migration:

- Remplacer les secrets par des variables d’environnement.
- Utiliser `.env.example` comme modèle seulement.
- Ajouter des backups avec `rclone`.
- Préférer Tailscale ou Cloudflare Tunnel à l’ouverture directe de ports.
- Vérifier les permissions fichiers.
- Lancer les agents dans des worktrees ou dossiers isolés.

## Premiere Verification

Après création ou migration, lancer:

```bash
git status
rg "API_KEY|TOKEN|SECRET|PASSWORD" .
rg "TODO|PLACEHOLDER" .
```