Claude Code Plugins

Community-maintained marketplace

Feedback

TaxasGE Go/No-Go Validator

@KouemouSah/taxasge
0
0

Orchestre agents TEST/DOC pour validation tâche, calcule score /100, génère 3 rapports, commit auto

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

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 :

  1. Commit 3 rapports générés
  2. Push branche distante
  3. ⚠️ 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:

  1. Charge .claude/.agent/Tasks/GONOGO_CHECKLIST.md
  2. Invoque TEST_AGENT
    • Exécute tests backend/frontend
    • Génère .claude/.agent/Reports/PHASE_2/TASK_P2_007_TESTS_REPORT.md
  3. Invoque DOC_AGENT
    • Vérifie documentation
    • Génère .claude/.agent/Reports/PHASE_2/TASK_P2_007_DOC_REPORT.md
  4. Calcule score : 87/100
  5. Décision : GO ✅
  6. Génère 3 rapports :
    • ias/04_VALIDATION/GONOGO_TASK_P2_007.md
    • .agent/Reports/PHASE_2/TASK_P2_007_REPORT.md
    • ias/03_PHASES/MODULE_02_CORE_BACKEND/RAPPORT_ORCHESTRATION_31_10_2025_TASK_P2_007.md
  7. Git commit + push automatique
  8. 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