[agent:surfer] ajout standard AI-ready : AI_CONTEXT, CLAUDE, .gitea workflow

This commit is contained in:
2026-04-21 00:18:32 +00:00
parent 26f9609b53
commit d927320358
6 changed files with 220 additions and 0 deletions

24
.gitea/AGENTS.md Normal file
View File

@@ -0,0 +1,24 @@
# AGENTS — Identités et permissions
## Comptes Gitea actifs
| Username | Rôle | Périmètre |
|---|---|---|
| `floppyrj45` | Admin / Owner | Tous les repos, valide les PR sur `main` |
| `agent-surfer` | Agent principal OpenClaw | Tous les repos du Labo |
| `agent-watcher` | Gitea watcher / CI | Lecture + commentaires issues |
| `agent-claude-cli` | Claude Code CLI local | Repos assignés par Flag |
| `agent-codex` | Codex / OpenCode | Repos assignés par Flag |
## Créer un nouveau compte agent
```bash
./scripts/gitea-agent-setup.sh <nom-agent>
```
Le script crée le compte Gitea, génère un token, et l'ajoute à `~/.agent-gitea-tokens`.
## Règle de moindre privilège
Un agent ne touche qu'aux repos explicitement listés dans `AI_CONTEXT.md` de chaque projet.
Il ne lit pas, ne fork pas, ne clone pas les repos hors de son périmètre.

54
.gitea/WORKFLOW.md Normal file
View File

@@ -0,0 +1,54 @@
# 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`.

View File

@@ -0,0 +1,25 @@
## Résumé
<!-- Une phrase sur ce que cette PR fait -->
## Type de changement
- [ ] `feat` — nouvelle fonctionnalité
- [ ] `fix` — correction de bug
- [ ] `chore` — maintenance / docs / config
- [ ] `refactor` — refactoring sans changement de comportement
## Agent / Auteur
`agent:` <!-- ex: surfer, claude-cli, flag -->
## Checklist
- [ ] Code testé localement
- [ ] Docs mises à jour si besoin (`docs/`)
- [ ] Pas de secret en clair dans le diff
- [ ] Commit messages au format `[agent:<nom>] verbe description`
## Contexte
<!-- Lien vers l'issue, la tâche, ou le livrable concerné -->