# WORKFLOW — Règles Git multi-agent

## Branches

| Branche | Usage | Qui push |
|---|---|---|
| `main` | Production stable | Flag uniquement (via PR) |
| `develop` | Intégration continue | Agents via PR |
| `feat/<agent>/<desc>` | Nouvelle fonctionnalité | Agent concerné |
| `fix/<agent>/<desc>` | Correction de bug | Agent concerné |
| `chore/<agent>/<desc>` | Maintenance, docs, config | Agent concerné |

**Jamais de push direct sur `main` ou `develop`.** Toujours via Pull Request.

## Format de commit

```
[agent:<nom>] <verbe> <description courte>
```

Exemples :
- `[agent:surfer] ajout endpoint /mission pour dashboard`
- `[agent:claude-cli] fix calcul distance waypoints`
- `[flag] merge feat/surfer/telemetry-endpoint`

Le nom d'agent doit correspondre à un compte Gitea listé dans `AGENTS.md`.

## Pull Requests

- Titre : `[agent:<nom>] <description>`
- Body : utiliser le template `.gitea/pull_request_template.md`
- Reviewer : `floppyrj45` (Flag) pour toute PR vers `main`
- PR vers `develop` : peut être mergée par un autre agent si les checks passent

## Issues

- Ouvrir une issue avant tout travail non trivial
- Assigner l'agent qui prend en charge
- Labels : `bug`, `feat`, `chore`, `blocked`, `agent:<nom>`

## Protection de branche

- `main` : PR obligatoire, 1 approbation humaine minimum
- `develop` : PR obligatoire, checks CI requis

## Identité Git locale (agents)

Chaque agent configure :
```bash
git config user.name "agent-<nom>"
git config user.email "agent-<nom>@labo.local"
```

Token d'authentification : voir `~/.agent-gitea-tokens` sur `.82`, ou demander via `gitea-agent-setup.sh`.