| name | TaxasGE Go/No-Go Validator |
| description | Orchestre agents TEST/DOC pour validation tâche, calcule score /100, génère 3 rapports, commit auto |
| version | 2.0.0 |
TaxasGE Go/No-Go Validator Skill
Overview
Ce skill orchestre les agents pour valider une tâche complétée. Il ne fait aucune exécution directe mais délègue aux agents spécialisés (TEST_AGENT, DOC_AGENT), agrège leurs résultats, calcule un score /100, et génère 3 rapports dans différentes destinations.
Principe fondamental : Zéro redondance - Le skill référence, n'exécute pas.
When to Use This Skill
Claude invoquera automatiquement ce skill quand vous dites :
- "Valide TASK-P2-{XXX}"
- "Go/No-Go TASK-P2-{XXX}"
- "Check qualité TASK-P2-{XXX}"
- "Termine TASK-P2-{XXX}"
Core Responsibilities
1. Orchestration Agents
Agents invoqués :
- TEST_AGENT : Tests backend/frontend, lint, coverage
- DOC_AGENT : Vérification documentation, README, Swagger
Référence workflows :
.claude/.agent/SOP/TEST_WORKFLOW.md.claude/.agent/SOP/DOC_WORKFLOW.md
2. Agrégation Résultats
Sources :
.claude/.agent/Reports/PHASE_X/TASK_PX_XXX_TESTS_REPORT.md.claude/.agent/Reports/PHASE_X/TASK_PX_XXX_DOC_REPORT.md
Calcul score : Selon .claude/.agent/Tasks/GONOGO_CHECKLIST.md
3. Génération 3 Rapports
Rapport 1 - Validation :
- Destination :
.github/docs-internal/ias/04_VALIDATION/GONOGO_TASK_PX_XXX.md - Template :
.claude/skills/taxasge-gonogo-validator/templates/GONOGO_REPORT.md
Rapport 2 - Agent :
- Destination :
.claude/.agent/Reports/PHASE_X/TASK_PX_XXX_REPORT.md - Template :
.claude/.agent/Reports/TASK_REPORT_TEMPLATE.md
Rapport 3 - Orchestration :
- Destination :
.github/docs-internal/ias/03_PHASES/MODULE_XX_NOM/RAPPORT_ORCHESTRATION_{DD_MM_YYYY}_TASK_PX_XXX.md - Template :
.claude/skills/taxasge-gonogo-validator/templates/ORCHESTRATION_TASK_REPORT.md
4. Git Automatique
Actions :
- Commit 3 rapports générés
- Push branche distante
- ⚠️ PAUSE : Attente validation utilisateur
Workflow Complet (6 Étapes)
Étape 1 : Charger Critères Validation
Fichier : .claude/.agent/Tasks/GONOGO_CHECKLIST.md
Action :
Lire checklist complète :
- Backend : 40 points (endpoints 224, tests 10, qualité 10)
- Frontend : 30 points (pages 15, tests 10, qualité 5)
- Integration : 15 points (API 10, staging 5)
- Accessibilité : 10 points (lighthouse 5, ARIA 5)
- Documentation : 5 points (README 2, doc backend 2, rapport 1)
TOTAL : /100 points
Référence : Ne PAS dupliquer les critères, juste les charger.
Étape 2 : Invoquer Agent Test
Agent : .claude/.agent/Tasks/TEST_AGENT.md
Workflow : .claude/.agent/SOP/TEST_WORKFLOW.md
Commande d'invocation :
> Agent Test, exécute validation complète TASK-P2-{XXX} :
>
> **Backend** :
> - Tests unitaires (pytest)
> - Coverage report (>85% requis)
> - Lint (flake8)
> - Type check (mypy)
>
> **Frontend** (si applicable) :
> - Tests unitaires (jest)
> - Coverage report (>75% requis)
> - Lint (eslint)
> - Type check (tsc)
> - Build (npm run build)
>
> **Génère rapport** :
> `.claude/.agent/Reports/PHASE_2/TASK_P2_{XXX}_TESTS_REPORT.md`
>
> **Format rapport** :
> - Tests passés : X/Y
> - Coverage backend : Z%
> - Coverage frontend : W%
> - Erreurs lint : N
> - Erreurs type : M
> - Build : ✅ SUCCESS / ❌ FAILED
Récupération résultats :
Lire rapport généré :
- `tests_passed` : Booléen
- `coverage_backend` : Pourcentage
- `coverage_frontend` : Pourcentage
- `lint_errors` : Nombre
- `type_errors` : Nombre
- `build_success` : Booléen
Étape 3 : Invoquer Agent Doc
Agent : .claude/.agent/Tasks/DOC_AGENT.md
Workflow : .claude/.agent/SOP/DOC_WORKFLOW.md
Commande d'invocation :
> Agent Doc, vérifie documentation TASK-P2-{XXX} :
>
> **Vérifications** :
> - README module existe et complet
> - Documentation backend dans `.github/docs-internal/Documentations/Backend/` à jour
> - Swagger endpoints documentés
> - Docstrings fonctions publiques
>
> **Génère rapport** :
> `.claude/.agent/Reports/PHASE_2/TASK_P2_{XXX}_DOC_REPORT.md`
>
> **Format rapport** :
> - README : ✅ / ❌
> - Documentation backend : ✅ / ⚠️ / ❌
> - Swagger : ✅ / ❌
> - Docstrings : X% complètes
Récupération résultats :
Lire rapport généré :
- `readme_exists` : Booléen
- `backend_doc_complete` : Booléen
- `swagger_complete` : Booléen
- `docstrings_coverage` : Pourcentage
Étape 4 : Calculer Score /100
Référence : .claude/.agent/Tasks/GONOGO_CHECKLIST.md
Formule agrégation :
## Backend (40 points)
### Endpoints (20 points)
- Si tous implémentés : 20 pts
- Sinon : (endpoints_réalisés / endpoints_planifiés) * 20
### Tests Backend (10 points)
- Coverage ≥90% : 10 pts
- Coverage 85-90% : 9 pts
- Coverage 80-85% : 8 pts
- Coverage <80% : 0 pts (blocage)
### Qualité Backend (10 points)
- Lint errors = 0 : 4 pts
- Type errors = 0 : 3 pts
- Docstrings ≥90% : 2 pts
- Code dupliqué <10 lignes : 1 pt
## Frontend (30 points)
[Même logique si applicable]
## Integration (15 points)
- API calls OK : 10 pts
- Staging déployé : 5 pts
## Accessibilité (10 points)
- Lighthouse Accessibility >85 : 5 pts
- ARIA labels complets : 5 pts
## Documentation (5 points)
- README : 2 pts
- Documentation backend complète : 2 pts
- Rapport tâche : 1 pt
TOTAL = backend_score + frontend_score + integration_score + accessibility_score + doc_score
Décision automatique :
if total_score >= 80:
decision = "GO ✅"
elif total_score >= 70:
decision = "GO CONDITIONNEL ⚠️"
else:
decision = "NO-GO ❌"
Étape 5 : Générer 3 Rapports
Rapport 1 : Go/No-Go (Validation)
Template : .claude/skills/taxasge-gonogo-validator/templates/GONOGO_REPORT.md
Destination : .github/docs-internal/ias/04_VALIDATION/GONOGO_TASK_P2_{XXX}.md
Contenu :
# GO/NO-GO TASK-P2-{XXX} - {DESCRIPTION}
**Date** : {DD/MM/YYYY}
**Score** : {X}/100 ({Y%})
**Décision** : {GO ✅ / GO CONDITIONNEL ⚠️ / NO-GO ❌}
## Détails Évaluation
### Backend ({X}/40)
- Endpoints : {score}/20
- Tests : {score}/10
- Qualité : {score}/10
### Frontend ({X}/30)
[Si applicable]
### Integration ({X}/15)
- API : {score}/10
- Staging : {score}/5
### Accessibilité ({X}/10)
- Lighthouse : {score}/5
- ARIA : {score}/5
### Documentation ({X}/5)
- README : {score}/2
- Backend doc : {score}/2
- Rapport : {score}/1
## Bugs Critiques
- [ ] Aucun ✅ / Liste bugs P0
## Métriques Finales
- Coverage Backend : {X%}
- Coverage Frontend : {Y%}
- Lint Errors : {N}
- Type Errors : {M}
## Prochaines Étapes
[Si GO] TASK-P2-{XXX+1} peut démarrer après validation utilisateur
[Si NO-GO] Corrections requises : [Liste]
Rapport 2 : Agent (Traçabilité)
Template : .claude/.agent/Reports/TASK_REPORT_TEMPLATE.md
Destination : .claude/.agent/Reports/PHASE_2/TASK_P2_{XXX}_REPORT.md
Contenu :
# RAPPORT TÂCHE P2-{XXX} - {DESCRIPTION}
**Agent** : DEV_AGENT
**Date** : {DD/MM/YYYY}
**Durée** : {X} jours
**Statut** : ✅ COMPLÉTÉ
## Implémentation
### Fichiers Créés
- `app/api/v1/{module}.py` : {X} lignes
- `app/services/{module}_service.py` : {Y} lignes
- `app/database/repositories/{module}_repository.py` : {Z} lignes
### Fichiers Modifiés
- `{fichier}` : +{X}/-{Y} lignes
## Tests
### Tests Écrits
- `tests/use_cases/test_uc_{module}.py` : {N} tests
- Coverage : {X%}
## Sources Vérifiées (Règle 0)
1. `database/schema.sql` ligne {X} : Vérification types
2. `.env` ligne {Y} : Configuration
3. `.github/docs-internal/Documentations/Backend/{module}.md` : Référence
## Difficultés Rencontrées
- Aucune ✅ / Liste difficultés
## Prochaines Étapes
Validation Go/No-Go
Rapport 3 : Orchestration Tâche
Template : .claude/skills/taxasge-gonogo-validator/templates/ORCHESTRATION_TASK_REPORT.md
Destination : .github/docs-internal/ias/03_PHASES/MODULE_02_CORE_BACKEND/RAPPORT_ORCHESTRATION_{DD_MM_YYYY}_TASK_P2_{XXX}.md
Contenu :
# RAPPORT ORCHESTRATION - TASK-P2-{XXX}
**Date validation** : {DD/MM/YYYY HH:MM}
**Durée totale** : {X} jours
**Statut** : {GO ✅ / GO CONDITIONNEL ⚠️ / NO-GO ❌}
## Workflow Exécuté
### 1. Développement
**Agent** : DEV_AGENT
**Workflow** : DEV_WORKFLOW.md
**Durée** : {X} jours
**Résultat** : ✅ Implémentation complète
### 2. Tests
**Agent** : TEST_AGENT
**Workflow** : TEST_WORKFLOW.md
**Durée** : {Y} heures
**Résultat** :
- Tests passés : {X}/{Y}
- Coverage : {Z%}
### 3. Documentation
**Agent** : DOC_AGENT
**Workflow** : DOC_WORKFLOW.md
**Durée** : {W} heures
**Résultat** : ✅ Documentation complète
### 4. Validation Go/No-Go
**Score** : {X}/100
**Décision** : {GO/NO-GO}
## Métriques Agrégées
| Métrique | Planifié | Réalisé | Écart |
|----------|----------|---------|-------|
| Durée | {X}j | {Y}j | {+/-}Z% |
| Endpoints | {A} | {B} | {+/-}C |
| Tests | {D} | {E} | {+/-}F |
| Coverage | {G%} | {H%} | {+/-}I% |
## Décisions Techniques
### Décision 1 : {Titre}
**Contexte** : {Description}
**Choix** : {Option retenue}
**Justification** : {Raison}
**Référence** : `.github/docs-internal/ias/01_DECISIONS/DECISION_{NNN}.md`
## Blockers Rencontrés
- Aucun ✅ / Liste blockers résolus
## Leçons Apprises
**Positives** :
- {Leçon 1}
**Améliorations** :
- {Amélioration 1}
## Prochaine Tâche
**TASK-P2-{XXX+1}** : {Description}
**Assigné à** : {Agent}
**Début prévu** : {Date} (après validation utilisateur)
Étape 6 : Git Commit + Push Automatique
Script : .claude/skills/taxasge-gonogo-validator/scripts/invoke_validation.sh
Actions automatiques :
#!/bin/bash
# Invoqué automatiquement après génération rapports
TASK_ID=$1
PHASE=$2
MODULE=$3
DATE=$(date +%d_%m_%Y)
# 1. Commit rapport Go/No-Go
git add .github/docs-internal/ias/04_VALIDATION/GONOGO_${TASK_ID}.md
git commit -m "docs(validation): Add Go/No-Go ${TASK_ID} - Score: {X}/100 - Decision: {GO/NO-GO}"
# 2. Commit rapport agent
git add .claude/.agent/Reports/${PHASE}/${TASK_ID}_REPORT.md
git add .claude/.agent/Reports/${PHASE}/${TASK_ID}_TESTS_REPORT.md
git add .claude/.agent/Reports/${PHASE}/${TASK_ID}_DOC_REPORT.md
git commit -m "docs(agent): Add ${TASK_ID} reports (dev + tests + doc)"
# 3. Commit rapport orchestration
git add .github/docs-internal/ias/03_PHASES/${MODULE}/RAPPORT_ORCHESTRATION_${DATE}_${TASK_ID}.md
git commit -m "docs(orchestration): Add ${TASK_ID} orchestration report"
# 4. Push branche distante
CURRENT_BRANCH=$(git branch --show-current)
git push origin ${CURRENT_BRANCH}
echo "✅ Git commit + push automatique réussi"
echo "📊 Rapports générés :"
echo " - .github/docs-internal/ias/04_VALIDATION/GONOGO_${TASK_ID}.md"
echo " - .claude/.agent/Reports/${PHASE}/${TASK_ID}_*.md"
echo " - .github/docs-internal/ias/03_PHASES/${MODULE}/RAPPORT_ORCHESTRATION_${DATE}_${TASK_ID}.md"
echo ""
echo "⚠️ ATTENTE VALIDATION UTILISATEUR"
echo "Commandes disponibles :"
echo " - 'GO TASK suivante' : Continue workflow"
echo " - 'NO-GO corrections' : Liste corrections à faire"
⚠️ PAUSE WORKFLOW :
Après push automatique, le workflow s'arrête et affiche :
┌─────────────────────────────────────────────────────────┐
│ ✅ TASK-P2-{XXX} VALIDÉE │
│ │
│ Score : {X}/100 ({Y%}) │
│ Décision : {GO ✅ / GO CONDITIONNEL ⚠️ / NO-GO ❌} │
│ │
│ Rapports générés : │
│ - Go/No-Go : ias/04_VALIDATION/GONOGO_TASK_P2_{XXX}.md │
│ - Agent : .agent/Reports/PHASE_2/TASK_P2_{XXX}_*.md │
│ - Orchestration : ias/03_PHASES/MODULE_02/RAPPORT_... │
│ │
│ ⚠️ VALIDATION REQUISE POUR CONTINUER │
│ │
│ Que voulez-vous faire ? │
│ 1. GO → Continue avec TASK-P2-{XXX+1} │
│ 2. NO-GO → Liste corrections à faire │
│ 3. Voir rapports détaillés │
└─────────────────────────────────────────────────────────┘
References
Agents
.claude/.agent/Tasks/TEST_AGENT.md- Agent tests.claude/.agent/Tasks/DOC_AGENT.md- Agent documentation
Workflows
.claude/.agent/SOP/TEST_WORKFLOW.md- Processus tests.claude/.agent/SOP/DOC_WORKFLOW.md- Processus documentation
Critères Validation
.claude/.agent/Tasks/GONOGO_CHECKLIST.md- Checklist complète avec scoring
Templates Rapports
.claude/skills/taxasge-gonogo-validator/templates/GONOGO_REPORT.md.claude/skills/taxasge-gonogo-validator/templates/ORCHESTRATION_TASK_REPORT.md.claude/.agent/Reports/TASK_REPORT_TEMPLATE.md
Scripts
.claude/skills/taxasge-gonogo-validator/scripts/invoke_validation.sh
Success Criteria
Une validation Go/No-Go est réussie si :
- ✅ TEST_AGENT invoqué (pas exécution directe)
- ✅ DOC_AGENT invoqué (pas exécution directe)
- ✅ Score calculé depuis rapports agents
- ✅ 3 rapports générés (validation, agent, orchestration)
- ✅ Rapports dans bonnes destinations
- ✅ Git commit + push automatique réussi
- ✅ Workflow pause pour validation utilisateur
Example Usage
User says: "Valide TASK-P2-007"
Skill actions:
- Charge
.claude/.agent/Tasks/GONOGO_CHECKLIST.md - Invoque TEST_AGENT
- Exécute tests backend/frontend
- Génère
.claude/.agent/Reports/PHASE_2/TASK_P2_007_TESTS_REPORT.md
- Invoque DOC_AGENT
- Vérifie documentation
- Génère
.claude/.agent/Reports/PHASE_2/TASK_P2_007_DOC_REPORT.md
- Calcule score : 87/100
- Décision : GO ✅
- Génère 3 rapports :
ias/04_VALIDATION/GONOGO_TASK_P2_007.md.agent/Reports/PHASE_2/TASK_P2_007_REPORT.mdias/03_PHASES/MODULE_02_CORE_BACKEND/RAPPORT_ORCHESTRATION_31_10_2025_TASK_P2_007.md
- Git commit + push automatique
- Affiche message validation et PAUSE
User says: "GO TASK suivante"
Skill actions: 9. Démarre TASK-P2-008
Skill created by: TaxasGE Backend Team
Date: 2025-10-31
Version: 2.0.0
Status: ✅ READY FOR USE