mirror of
https://github.com/CyberMind-FR/secubox-deb.git
synced 2026-07-29 09:14:00 +00:00
docs: add multi-agent worktree workflow doctrine to CLAUDE.md (ref #83)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
4ff4830df4
commit
320215392e
46
CLAUDE.md
46
CLAUDE.md
|
|
@ -268,6 +268,52 @@ Après chaque module complété :
|
|||
|
||||
---
|
||||
|
||||
## 🌿 Multi-Agent Worktree Workflow — Obligatoire
|
||||
|
||||
Chaque travail non-trivial doit s'exécuter dans un worktree dédié, créé via
|
||||
`scripts/agent-worktree.sh start --issue <#>`. Le checkout principal
|
||||
(`~/CyberMindStudio/secubox-deb/secubox-deb/`) est réservé au `master`
|
||||
housekeeping et au travail humain — pas aux agents.
|
||||
|
||||
### Quand créer un worktree
|
||||
|
||||
- Toute issue GitHub avec label `bug`, `enhancement`, `documentation`,
|
||||
`eye-remote`, ou tout label métier (migration, hardware, api, frontend,
|
||||
security, infra)
|
||||
- Toute tâche estimée > 30 min ou touchant ≥ 3 fichiers
|
||||
- Toute feature/fix qui finira en PR
|
||||
|
||||
### Quand NE PAS en créer
|
||||
|
||||
- Édition triviale d'un seul fichier de suivi (`HISTORY.md`, `WIP.md`,
|
||||
`TODO.md`)
|
||||
- Exploration read-only, réponse à une question
|
||||
- Commits administratifs sur master (tags, bumps de version)
|
||||
|
||||
### Cycle obligatoire
|
||||
|
||||
```text
|
||||
gh issue create
|
||||
→ scripts/agent-worktree.sh start --issue <#>
|
||||
→ cd ~/CyberMindStudio/secubox-deb-worktrees/<#>-<slug>
|
||||
→ code + commits (chaque message: "(ref #<#>)")
|
||||
→ scripts/agent-worktree.sh finish # push + PR avec "Closes #<#>"
|
||||
→ [user valide et merge la PR]
|
||||
→ scripts/agent-worktree.sh clean <#> # supprime worktree + branche
|
||||
```
|
||||
|
||||
### Parallélisme
|
||||
|
||||
`start` refuse de créer un second worktree pour la même issue. Deux sessions
|
||||
Claude (deux terminaux) peuvent travailler simultanément sur deux issues
|
||||
distinctes sans collision.
|
||||
|
||||
### Source de vérité opérationnelle
|
||||
|
||||
`scripts/agent-worktree.sh --help`
|
||||
|
||||
---
|
||||
|
||||
## 🔒 Security Policies — Héritées de secubox-openwrt, adaptées Debian
|
||||
|
||||
### WAF Bypass — Interdiction absolue
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user