@the-bearded-bear/claude-craft 4.4.0 → 5.0.0-next.fa2403f
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/Dev/i18n/de/Common/commands/ralph-sprint.md +159 -0
- package/Dev/i18n/en/Common/commands/ralph-sprint.md +293 -0
- package/Dev/i18n/es/Common/commands/ralph-sprint.md +159 -0
- package/Dev/i18n/fr/Common/commands/ralph-sprint.md +281 -0
- package/Dev/i18n/pt/Common/commands/ralph-sprint.md +159 -0
- package/Dev/scripts/install-angular-rules.sh +1 -1
- package/Dev/scripts/install-common-rules.sh +1 -1
- package/Dev/scripts/install-csharp-rules.sh +1 -1
- package/Dev/scripts/install-flutter-rules.sh +1 -1
- package/Dev/scripts/install-laravel-rules.sh +1 -1
- package/Dev/scripts/install-php-rules.sh +1 -1
- package/Dev/scripts/install-python-rules.sh +1 -1
- package/Dev/scripts/install-react-rules.sh +1 -1
- package/Dev/scripts/install-reactnative-rules.sh +1 -1
- package/Dev/scripts/install-symfony-rules.sh +1 -1
- package/Dev/scripts/install-vuejs-rules.sh +1 -1
- package/README.md +23 -0
- package/Tools/Ralph/README.md +72 -11
- package/Tools/Ralph/config/ralph-autonomous.yml +139 -0
- package/Tools/Ralph/docs/PARALLEL.md +458 -0
- package/Tools/Ralph/docs/RECOVERY.md +371 -0
- package/Tools/Ralph/lib/circuit-breaker.sh +184 -1
- package/Tools/Ralph/lib/escalation-service.sh +611 -0
- package/Tools/Ralph/lib/parallel-manager.sh +602 -0
- package/Tools/Ralph/lib/recovery-engine.sh +606 -0
- package/Tools/Ralph/lib/sprint-conductor.sh +1000 -0
- package/Tools/Ralph/ralph.sh +106 -2
- package/package.json +1 -1
|
@@ -0,0 +1,281 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Lancer le conducteur de sprint autonome pour une execution overnight/sans surveillance
|
|
3
|
+
argument-hint: <nom-sprint> [--overnight|--parallel N|--supervised|--max-stories N]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Ralph Sprint - Conducteur de Sprint Autonome (ASC)
|
|
7
|
+
|
|
8
|
+
Execute un sprint entier de maniere autonome avec un minimum d'interventions humaines. Le Conducteur de Sprint Autonome (ASC) gere la reclamation des stories, l'execution, les transitions, la recuperation d'erreurs et l'escalade des problemes bloquants.
|
|
9
|
+
|
|
10
|
+
## Arguments
|
|
11
|
+
|
|
12
|
+
**$ARGUMENTS**
|
|
13
|
+
|
|
14
|
+
- `<nom-sprint>`: Nom ou ID du sprint a traiter
|
|
15
|
+
- `--overnight`: Mode overnight (limite, arret a 6h)
|
|
16
|
+
- `--parallel N`: Traiter jusqu'a N stories en parallele (defaut: 1)
|
|
17
|
+
- `--supervised`: Pause avant chaque story pour confirmation
|
|
18
|
+
- `--max-stories N`: Nombre maximum de stories (defaut: 10)
|
|
19
|
+
- `--timeout H`: Duree maximale en heures (defaut: 12)
|
|
20
|
+
|
|
21
|
+
## Fonctionnalites Cles
|
|
22
|
+
|
|
23
|
+
| Fonctionnalite | Description |
|
|
24
|
+
|----------------|-------------|
|
|
25
|
+
| **Auto-Claim** | Reclame automatiquement la prochaine story prete |
|
|
26
|
+
| **Auto-Transition** | Transite les stories selon l'etat de completion |
|
|
27
|
+
| **Moteur de Recuperation** | Auto-recuperation des erreurs transitoires/recuperables |
|
|
28
|
+
| **Service d'Escalade** | File d'attente des problemes bloquants pour resolution humaine |
|
|
29
|
+
| **Traitement Parallele** | Traite plusieurs stories independantes simultanement |
|
|
30
|
+
| **Execution Limitee** | Fenetres de temps, limites de stories, seuils d'echecs |
|
|
31
|
+
|
|
32
|
+
## Processus
|
|
33
|
+
|
|
34
|
+
### 1. Initialisation du Sprint
|
|
35
|
+
|
|
36
|
+
1. **Charger la configuration du sprint**:
|
|
37
|
+
- Lire les metadonnees depuis `.bmad/sprint-status.yaml`
|
|
38
|
+
- Charger la config autonome depuis `ralph-autonomous.yml`
|
|
39
|
+
- Initialiser le moteur de recuperation et le service d'escalade
|
|
40
|
+
|
|
41
|
+
2. **Activer le mode autonome**:
|
|
42
|
+
- Configurer le circuit breaker en profil autonome
|
|
43
|
+
- Activer la recuperation avant declenchement
|
|
44
|
+
- Initialiser le gestionnaire parallele si active
|
|
45
|
+
|
|
46
|
+
### 2. Boucle Principale du Conducteur
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
50
|
+
│ CONDUCTEUR DE SPRINT AUTONOME (ASC) │
|
|
51
|
+
└───────────────────────────────┬─────────────────────────────────┘
|
|
52
|
+
│
|
|
53
|
+
┌───────────────────────────┼───────────────────────────────┐
|
|
54
|
+
▼ ▼ ▼
|
|
55
|
+
┌─────────┐ ┌─────────────┐ ┌─────────────┐
|
|
56
|
+
│Prochaine│──────────────│ Reclamer │───────────────│Executer avec│
|
|
57
|
+
│ Story │ │ Story │ │ Ralph │
|
|
58
|
+
└────┬────┘ └─────────────┘ └──────┬──────┘
|
|
59
|
+
│ │
|
|
60
|
+
│ Aucune story ────────────────────┐ ┌──────────────┘
|
|
61
|
+
▼ ▼ ▼
|
|
62
|
+
┌─────────┐ ┌─────────┐ ┌─────────┐
|
|
63
|
+
│Verifier │ │Finaliser│ │Transiter│
|
|
64
|
+
│Escalades│ │ Sprint │ │ Story │
|
|
65
|
+
└─────────┘ └─────────┘ └─────────┘
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### 3. Recuperation d'Erreurs
|
|
69
|
+
|
|
70
|
+
Le Moteur de Recuperation classifie les erreurs en 4 niveaux:
|
|
71
|
+
|
|
72
|
+
| Niveau | Type | Action | Exemples |
|
|
73
|
+
|--------|------|--------|----------|
|
|
74
|
+
| 0 | **Transitoire** | Auto-retry avec backoff | Timeout, rate limit, reseau |
|
|
75
|
+
| 1 | **Recuperable** | Auto-fix + retry | Lint, tests, deps, syntaxe |
|
|
76
|
+
| 2 | **Degrade** | Continuer avec warning | Docs, gates optionnels, coverage |
|
|
77
|
+
| 3 | **Bloque** | Escalader a humain | Securite, architecture, auth |
|
|
78
|
+
|
|
79
|
+
### 4. Gestion des Escalades
|
|
80
|
+
|
|
81
|
+
Les problemes bloquants sont mis en file d'attente:
|
|
82
|
+
|
|
83
|
+
```yaml
|
|
84
|
+
# .ralph/escalations/queue/ESC-xxx.yaml
|
|
85
|
+
id: "ESC-1704067200-123"
|
|
86
|
+
level: "blocked"
|
|
87
|
+
error_type: "security"
|
|
88
|
+
priority: "critical"
|
|
89
|
+
timeout_at: "2024-01-02T10:00:00Z"
|
|
90
|
+
default_action: "pause"
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
**Options de resolution**:
|
|
94
|
+
- `proceed` - Continuer avec la tache
|
|
95
|
+
- `skip` - Ignorer cette story et continuer
|
|
96
|
+
- `retry` - Reessayer l'operation echouee
|
|
97
|
+
- `abort` - Arreter le sprint
|
|
98
|
+
|
|
99
|
+
### 5. Conditions d'Arret
|
|
100
|
+
|
|
101
|
+
Le conducteur s'arrete quand une condition est atteinte:
|
|
102
|
+
|
|
103
|
+
| Condition | Defaut | Description |
|
|
104
|
+
|-----------|--------|-------------|
|
|
105
|
+
| Max stories | 10 | Nombre maximum de stories |
|
|
106
|
+
| Max echecs | 3 | Seuil d'echecs consecutifs |
|
|
107
|
+
| Max runtime | 12h | Duree maximale totale |
|
|
108
|
+
| Fenetre d'arret | 06:00 | Arret base sur l'heure (overnight) |
|
|
109
|
+
| Escalade critique | - | Pause sur problemes critiques |
|
|
110
|
+
|
|
111
|
+
## Traitement Parallele
|
|
112
|
+
|
|
113
|
+
Quand `--parallel N` est specifie, l'ASC traite les stories en vagues paralleles:
|
|
114
|
+
|
|
115
|
+
### Fonctionnement
|
|
116
|
+
|
|
117
|
+
1. **Graphe de Dependances**: L'ASC construit un graphe depuis les relations `blocked_by`
|
|
118
|
+
2. **Traitement par Vagues**: Les stories sont traitees par vagues selon les dependances satisfaites
|
|
119
|
+
3. **Gestion des Slots**: Jusqu'a N sessions concurrentes, limitees par CPU/memoire
|
|
120
|
+
4. **Merge Sequentiel**: Les branches Git sont mergees sequentiellement pour eviter les conflits
|
|
121
|
+
|
|
122
|
+
```
|
|
123
|
+
Vague 1: [US-001, US-002, US-003] ← Stories independantes (pas de bloqueurs)
|
|
124
|
+
↓ ↓ ↓
|
|
125
|
+
Session Session Session
|
|
126
|
+
↓ ↓ ↓
|
|
127
|
+
Termine Termine Termine
|
|
128
|
+
|
|
129
|
+
Vague 2: [US-004, US-005] ← Dependent de US-001/US-002 (maintenant terminees)
|
|
130
|
+
↓ ↓
|
|
131
|
+
Session Session
|
|
132
|
+
↓ ↓
|
|
133
|
+
Termine Termine
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
### Gestion des Dependances
|
|
137
|
+
|
|
138
|
+
Les stories ne sont planifiees que quand leurs dependances sont satisfaites:
|
|
139
|
+
|
|
140
|
+
```yaml
|
|
141
|
+
# sprint-status.yaml
|
|
142
|
+
stories:
|
|
143
|
+
US-001:
|
|
144
|
+
status: ready-for-dev
|
|
145
|
+
blocked_by: [] # ✓ Peut demarrer immediatement
|
|
146
|
+
US-002:
|
|
147
|
+
status: ready-for-dev
|
|
148
|
+
blocked_by: [] # ✓ Peut demarrer immediatement
|
|
149
|
+
US-003:
|
|
150
|
+
status: ready-for-dev
|
|
151
|
+
blocked_by: [US-001] # ✗ Attend la completion de US-001
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
### Limites de Ressources
|
|
155
|
+
|
|
156
|
+
```yaml
|
|
157
|
+
# ralph-autonomous.yml
|
|
158
|
+
parallel:
|
|
159
|
+
enabled: true
|
|
160
|
+
max_concurrent: 3
|
|
161
|
+
resource_limits:
|
|
162
|
+
cpu_percent: 80 # Ne pas spawner si CPU > 80%
|
|
163
|
+
mem_percent: 80 # Ne pas spawner si memoire > 80%
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
## Exemples Rapides
|
|
167
|
+
|
|
168
|
+
```bash
|
|
169
|
+
# Sprint overnight
|
|
170
|
+
/common:ralph-sprint "Sprint 3" --overnight
|
|
171
|
+
|
|
172
|
+
# Traitement parallele avec 3 sessions
|
|
173
|
+
/common:ralph-sprint "Sprint 3" --parallel 3
|
|
174
|
+
|
|
175
|
+
# Combine: parallele overnight
|
|
176
|
+
/common:ralph-sprint "Sprint 3" --parallel 3 --overnight
|
|
177
|
+
|
|
178
|
+
# Mode supervise (confirmer chaque story)
|
|
179
|
+
/common:ralph-sprint "Sprint 3" --supervised
|
|
180
|
+
|
|
181
|
+
# Execution limitee (5 stories, 4 heures)
|
|
182
|
+
/common:ralph-sprint "Sprint 3" --max-stories 5 --timeout 4
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
## Configuration
|
|
186
|
+
|
|
187
|
+
L'ASC utilise `Tools/Ralph/config/ralph-autonomous.yml`:
|
|
188
|
+
|
|
189
|
+
```yaml
|
|
190
|
+
autonomous:
|
|
191
|
+
enabled: true
|
|
192
|
+
mode: "bounded"
|
|
193
|
+
schedule:
|
|
194
|
+
stop_window: "06:00"
|
|
195
|
+
max_runtime_hours: 12
|
|
196
|
+
limits:
|
|
197
|
+
max_stories_per_session: 10
|
|
198
|
+
max_consecutive_failures: 3
|
|
199
|
+
parallel:
|
|
200
|
+
enabled: false
|
|
201
|
+
max_concurrent: 3
|
|
202
|
+
|
|
203
|
+
recovery:
|
|
204
|
+
enabled: true
|
|
205
|
+
max_attempts: 3
|
|
206
|
+
auto_retry_transient: true
|
|
207
|
+
auto_fix_lint: true
|
|
208
|
+
auto_fix_tests: "retry_tdd"
|
|
209
|
+
|
|
210
|
+
escalation:
|
|
211
|
+
enabled: true
|
|
212
|
+
timeout_hours: 4
|
|
213
|
+
default_action: "skip"
|
|
214
|
+
critical_action: "pause"
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
## Sortie
|
|
218
|
+
|
|
219
|
+
```
|
|
220
|
+
╔════════════════════════════════════════════════════════════╗
|
|
221
|
+
║ Conducteur de Sprint Autonome (ASC) ║
|
|
222
|
+
║ Sprint 3 ║
|
|
223
|
+
╚════════════════════════════════════════════════════════════╝
|
|
224
|
+
|
|
225
|
+
ℹ [ASC] Conducteur initialise
|
|
226
|
+
ℹ [ASC] Session: ASC-20240101-120000-12345
|
|
227
|
+
ℹ [ASC] Mode: bounded
|
|
228
|
+
ℹ [ASC] Max stories: 10
|
|
229
|
+
|
|
230
|
+
ℹ [ASC] Traitement story: US-001
|
|
231
|
+
✓ [ASC] Story terminee: US-001
|
|
232
|
+
ℹ [ASC] US-001 transite vers review
|
|
233
|
+
|
|
234
|
+
ℹ [ASC] Traitement story: US-002
|
|
235
|
+
⚠ Erreur classifiee Niveau 1 (recuperable): test_fail
|
|
236
|
+
ℹ Tentative auto-fix pour: test_fail
|
|
237
|
+
✓ [ASC] Story terminee: US-002
|
|
238
|
+
|
|
239
|
+
════════════════════════════════════════
|
|
240
|
+
Resume du Conducteur de Sprint
|
|
241
|
+
════════════════════════════════════════
|
|
242
|
+
|
|
243
|
+
Session: ASC-20240101-120000-12345
|
|
244
|
+
Duree: 4h 23m
|
|
245
|
+
|
|
246
|
+
Stories:
|
|
247
|
+
Terminees: 7
|
|
248
|
+
Echouees: 1
|
|
249
|
+
Ignorees: 2
|
|
250
|
+
|
|
251
|
+
Escalades:
|
|
252
|
+
creees: 3
|
|
253
|
+
resolues: 2
|
|
254
|
+
|
|
255
|
+
Tentatives de recuperation: 8
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
## Metriques de Succes
|
|
259
|
+
|
|
260
|
+
| Metrique | Actuel | Cible |
|
|
261
|
+
|----------|--------|-------|
|
|
262
|
+
| Interventions humaines/sprint | ~15 | <5 |
|
|
263
|
+
| Stories completees overnight | 0 | 3-5 |
|
|
264
|
+
| Taux auto-recuperation | N/A | >70% |
|
|
265
|
+
| Temps avant escalade | N/A | <15 min |
|
|
266
|
+
| Efficacite parallelisation | N/A | >60% |
|
|
267
|
+
|
|
268
|
+
## Bonnes Pratiques
|
|
269
|
+
|
|
270
|
+
1. **Commencer en supervise**: Utilisez `--supervised` d'abord
|
|
271
|
+
2. **Limites realistes**: Ne pas mettre max-stories trop haut initialement
|
|
272
|
+
3. **Surveiller escalades**: Verifier `.ralph/escalations/queue/` regulierement
|
|
273
|
+
4. **Analyser metriques**: Examiner `metrics-*.json` apres chaque run
|
|
274
|
+
5. **Configurer webhooks**: Notifications Slack/Teams pour problemes critiques
|
|
275
|
+
|
|
276
|
+
## Voir Aussi
|
|
277
|
+
|
|
278
|
+
- `/common:ralph-run` - Boucle continue pour une tache
|
|
279
|
+
- `/project:run-sprint` - Execution standard de sprint
|
|
280
|
+
- `/sprint:next-story` - Obtenir prochaine story prete
|
|
281
|
+
- `@ralph-conductor` - Agent d'orchestration Ralph
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Executar o condutor de sprint autonomo para execucao overnight/sem supervisao
|
|
3
|
+
argument-hint: <nome-sprint> [--overnight|--parallel N|--supervised|--max-stories N]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Ralph Sprint - Condutor de Sprint Autonomo (ASC)
|
|
7
|
+
|
|
8
|
+
Executa um sprint inteiro de forma autonoma com minima intervencao humana. O Condutor de Sprint Autonomo (ASC) gerencia a reivindicacao de historias, execucao, transicoes, recuperacao de erros e escalamento de problemas bloqueantes.
|
|
9
|
+
|
|
10
|
+
## Argumentos
|
|
11
|
+
|
|
12
|
+
**$ARGUMENTS**
|
|
13
|
+
|
|
14
|
+
- `<nome-sprint>`: Nome ou ID do sprint a processar
|
|
15
|
+
- `--overnight`: Modo noturno (limitado, para as 6h)
|
|
16
|
+
- `--parallel N`: Processar ate N historias em paralelo (padrao: 1)
|
|
17
|
+
- `--supervised`: Pausar antes de cada historia para confirmacao
|
|
18
|
+
- `--max-stories N`: Maximo de historias a processar (padrao: 10)
|
|
19
|
+
- `--timeout H`: Tempo maximo de execucao em horas (padrao: 12)
|
|
20
|
+
|
|
21
|
+
## Funcionalidades Principais
|
|
22
|
+
|
|
23
|
+
| Funcionalidade | Descricao |
|
|
24
|
+
|----------------|-----------|
|
|
25
|
+
| **Auto-Claim** | Reivindica automaticamente a proxima historia pronta |
|
|
26
|
+
| **Auto-Transicao** | Transiciona historias conforme estado de conclusao |
|
|
27
|
+
| **Motor de Recuperacao** | Auto-recuperacao de erros transitorios/recuperaveis |
|
|
28
|
+
| **Servico de Escalamento** | Fila de problemas bloqueantes para resolucao humana |
|
|
29
|
+
| **Processamento Paralelo** | Processa multiplas historias independentes simultaneamente |
|
|
30
|
+
| **Execucao Limitada** | Janelas de tempo, limites de historias, limiares de falhas |
|
|
31
|
+
|
|
32
|
+
## Processo
|
|
33
|
+
|
|
34
|
+
### 1. Inicializacao do Sprint
|
|
35
|
+
|
|
36
|
+
1. **Carregar configuracao do sprint**:
|
|
37
|
+
- Ler metadados de `.bmad/sprint-status.yaml`
|
|
38
|
+
- Carregar config autonoma de `ralph-autonomous.yml`
|
|
39
|
+
- Inicializar motor de recuperacao e servico de escalamento
|
|
40
|
+
|
|
41
|
+
2. **Ativar modo autonomo**:
|
|
42
|
+
- Configurar circuit breaker em perfil autonomo
|
|
43
|
+
- Ativar recuperacao antes do disparo
|
|
44
|
+
- Inicializar gerenciador paralelo se ativado
|
|
45
|
+
|
|
46
|
+
### 2. Loop Principal do Condutor
|
|
47
|
+
|
|
48
|
+
O ASC executa um loop continuo:
|
|
49
|
+
|
|
50
|
+
1. Verificar condicoes de parada
|
|
51
|
+
2. Obter proxima historia pronta
|
|
52
|
+
3. Reivindicar a historia
|
|
53
|
+
4. Executar com Ralph
|
|
54
|
+
5. Processar resultado (sucesso/falha/escalado)
|
|
55
|
+
6. Transicionar historia
|
|
56
|
+
7. Criar checkpoint
|
|
57
|
+
|
|
58
|
+
### 3. Recuperacao de Erros
|
|
59
|
+
|
|
60
|
+
O Motor de Recuperacao classifica erros em 4 niveis:
|
|
61
|
+
|
|
62
|
+
| Nivel | Tipo | Acao | Exemplos |
|
|
63
|
+
|-------|------|------|----------|
|
|
64
|
+
| 0 | **Transitorio** | Auto-retry com backoff | Timeout, rate limit, rede |
|
|
65
|
+
| 1 | **Recuperavel** | Auto-fix + retry | Lint, tests, deps, sintaxe |
|
|
66
|
+
| 2 | **Degradado** | Continuar com warning | Docs, gates opcionais |
|
|
67
|
+
| 3 | **Bloqueado** | Escalar para humano | Seguranca, arquitetura |
|
|
68
|
+
|
|
69
|
+
### 4. Gerenciamento de Escalamentos
|
|
70
|
+
|
|
71
|
+
Problemas bloqueantes sao colocados em fila para resolucao humana.
|
|
72
|
+
|
|
73
|
+
**Opcoes de resolucao**:
|
|
74
|
+
- `proceed` - Continuar com a tarefa
|
|
75
|
+
- `skip` - Pular esta historia e continuar
|
|
76
|
+
- `retry` - Tentar novamente a operacao falha
|
|
77
|
+
- `abort` - Parar o sprint
|
|
78
|
+
|
|
79
|
+
### 5. Condicoes de Parada
|
|
80
|
+
|
|
81
|
+
| Condicao | Padrao | Descricao |
|
|
82
|
+
|----------|--------|-----------|
|
|
83
|
+
| Max historias | 10 | Maximo de historias processadas |
|
|
84
|
+
| Max falhas | 3 | Limiar de falhas consecutivas |
|
|
85
|
+
| Max runtime | 12h | Tempo maximo total |
|
|
86
|
+
| Janela parada | 06:00 | Parada por horario (overnight) |
|
|
87
|
+
| Escalamento critico | - | Pausa em problemas criticos |
|
|
88
|
+
|
|
89
|
+
## Exemplos Rapidos
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
# Sprint noturno
|
|
93
|
+
/common:ralph-sprint "Sprint 3" --overnight
|
|
94
|
+
|
|
95
|
+
# Processamento paralelo com 3 sessoes
|
|
96
|
+
/common:ralph-sprint "Sprint 3" --parallel 3
|
|
97
|
+
|
|
98
|
+
# Modo supervisionado
|
|
99
|
+
/common:ralph-sprint "Sprint 3" --supervised
|
|
100
|
+
|
|
101
|
+
# Execucao limitada
|
|
102
|
+
/common:ralph-sprint "Sprint 3" --max-stories 5 --timeout 4
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
## Configuracao
|
|
106
|
+
|
|
107
|
+
O ASC usa `Tools/Ralph/config/ralph-autonomous.yml`:
|
|
108
|
+
|
|
109
|
+
```yaml
|
|
110
|
+
autonomous:
|
|
111
|
+
enabled: true
|
|
112
|
+
mode: "bounded"
|
|
113
|
+
schedule:
|
|
114
|
+
stop_window: "06:00"
|
|
115
|
+
max_runtime_hours: 12
|
|
116
|
+
limits:
|
|
117
|
+
max_stories_per_session: 10
|
|
118
|
+
max_consecutive_failures: 3
|
|
119
|
+
parallel:
|
|
120
|
+
enabled: false
|
|
121
|
+
max_concurrent: 3
|
|
122
|
+
|
|
123
|
+
recovery:
|
|
124
|
+
enabled: true
|
|
125
|
+
max_attempts: 3
|
|
126
|
+
auto_fix_lint: true
|
|
127
|
+
auto_fix_tests: "retry_tdd"
|
|
128
|
+
|
|
129
|
+
escalation:
|
|
130
|
+
enabled: true
|
|
131
|
+
timeout_hours: 4
|
|
132
|
+
default_action: "skip"
|
|
133
|
+
critical_action: "pause"
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
## Metricas de Sucesso
|
|
137
|
+
|
|
138
|
+
| Metrica | Atual | Meta |
|
|
139
|
+
|---------|-------|------|
|
|
140
|
+
| Intervencoes humanas/sprint | ~15 | <5 |
|
|
141
|
+
| Historias completadas overnight | 0 | 3-5 |
|
|
142
|
+
| Taxa auto-recuperacao | N/A | >70% |
|
|
143
|
+
| Tempo ate escalamento | N/A | <15 min |
|
|
144
|
+
| Eficiencia paralelizacao | N/A | >60% |
|
|
145
|
+
|
|
146
|
+
## Boas Praticas
|
|
147
|
+
|
|
148
|
+
1. **Comecar supervisionado**: Usar `--supervised` primeiro
|
|
149
|
+
2. **Limites realistas**: Nao colocar max-stories muito alto inicialmente
|
|
150
|
+
3. **Monitorar escalamentos**: Verificar `.ralph/escalations/queue/` regularmente
|
|
151
|
+
4. **Analisar metricas**: Examinar `metrics-*.json` apos cada execucao
|
|
152
|
+
5. **Configurar webhooks**: Notificacoes Slack/Teams para problemas criticos
|
|
153
|
+
|
|
154
|
+
## Relacionado
|
|
155
|
+
|
|
156
|
+
- `/common:ralph-run` - Loop continuo para uma tarefa
|
|
157
|
+
- `/project:run-sprint` - Execucao padrao de sprint
|
|
158
|
+
- `/sprint:next-story` - Obter proxima historia pronta
|
|
159
|
+
- `@ralph-conductor` - Agente de orquestracao Ralph
|
|
@@ -37,7 +37,7 @@ set -euo pipefail
|
|
|
37
37
|
#-------------------------------------------------------------------------------
|
|
38
38
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
39
39
|
SCRIPT_NAME="$(basename "$0")"
|
|
40
|
-
VERSION="
|
|
40
|
+
VERSION="5.0.0"
|
|
41
41
|
I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
|
|
42
42
|
|
|
43
43
|
# Couleurs
|
package/README.md
CHANGED
|
@@ -2,6 +2,29 @@
|
|
|
2
2
|
|
|
3
3
|
A comprehensive framework for AI-assisted development with [Claude Code](https://claude.ai/code). Install standardized rules, agents, and commands for your projects across multiple technology stacks.
|
|
4
4
|
|
|
5
|
+
**Autonomous Sprint Ready**: Run entire sprints overnight with `/common:ralph-sprint` - auto-claim, error recovery, parallel processing.
|
|
6
|
+
|
|
7
|
+
## What's New in v5.0 - Autonomous Sprint Conductor (ASC)
|
|
8
|
+
|
|
9
|
+
- **Overnight Sprint Execution**: Run sprints unattended with bounded execution
|
|
10
|
+
- `/common:ralph-sprint "Sprint 3" --overnight` - Stops at 6am
|
|
11
|
+
- `/common:ralph-sprint "Sprint 3" --parallel 3` - Process 3 stories concurrently
|
|
12
|
+
- `/common:ralph-sprint "Sprint 3" --supervised` - Confirm each story
|
|
13
|
+
- **Recovery Engine**: 4-level error classification with auto-fix
|
|
14
|
+
- Level 0 (Transient): Auto-retry with backoff (timeout, rate limit)
|
|
15
|
+
- Level 1 (Recoverable): Auto-fix then retry (lint, tests, deps)
|
|
16
|
+
- Level 2 (Degraded): Continue with warning (docs, optional gates)
|
|
17
|
+
- Level 3 (Blocked): Escalate to human (security, architecture)
|
|
18
|
+
- **Escalation Service**: Queue blocking issues with webhook notifications
|
|
19
|
+
- Slack, Teams, Discord integration
|
|
20
|
+
- Configurable timeout with default actions
|
|
21
|
+
- Audit trail for compliance
|
|
22
|
+
- **Parallel Processing**: Dependency-aware concurrent execution
|
|
23
|
+
- Resource monitoring (CPU/memory limits)
|
|
24
|
+
- Automatic session isolation
|
|
25
|
+
- **Enhanced Circuit Breaker**: New `autonomous` profile with recovery integration
|
|
26
|
+
- See [Autonomous Sprint Documentation](docs/AUTONOMOUS-SPRINT.md)
|
|
27
|
+
|
|
5
28
|
## What's New in v4.4
|
|
6
29
|
|
|
7
30
|
- **Comprehensive Documentation for Juniors**: 32 new documentation files
|