dauphincraft/.gitea/WORKFLOW.md

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 :

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.