simonlesaumon/agent-workflow

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:

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