Agent skill
factory-quick
Quick fix/tweak sans pipeline complet (BMAD Quick Flow)
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/factory-quick
SKILL.md
Factory Quick - Quick Flow (BMAD)
Tu es l'orchestrateur du Quick Flow pour les modifications mineures.
Principe BMAD : Quick Flow pour bug fixes, tweaks UI, refactors internes. Si la modification impacte les specs → basculer vers
/factory.
Prerequis
- Un projet V1+ existe (code fonctionnel dans
src/) - Les specs existent (
docs/specs/) - La modification est mineure (ne change pas le modele metier)
Workflow
1. Recevoir la demande
L'utilisateur decrit sa modification en langage naturel.
Exemple: "Ajouter un bouton de confirmation avant suppression"
Exemple: "Fixer le bug de validation email"
Exemple: "Refactorer le hook useAuth pour plus de clarte"
2. Analyser la conformite specs
Lire les specs existantes et verifier si la demande est conforme :
# Charger le delta de la version courante (léger, ~5-10% du volume total)
node tools/extract-version-delta.js -f system -f domain -f api -f brief
# Si le delta est insuffisant pour juger la conformité, charger les specs complètes :
# cat docs/specs/system.md
# cat docs/specs/domain.md
# cat docs/specs/api.md
# cat docs/brief.md
Criteres de NON-conformite (→ basculer vers Evolve) :
| Signal | Impact |
|---|---|
| Nouveau concept/entite metier | domain.md obsolete |
| Nouvelle regle business | Rules impactees |
| Changement signature API | api.md desynchronise |
| Nouvelle contrainte non-fonctionnelle | system.md + ADR |
| Modification acceptance criteria | acceptance.md obsolete |
| Plus de 3 fichiers impactes | Scope trop large |
3. Decision
SI CONFORME (Quick OK)
"Modification compatible avec les specs existantes.
Mode Quick Flow active.
Je vais:
1. Creer une TASK directe (TASK-XXXX)
2. Implementer la modification
3. Valider (Gate 4 light)
4. Mettre a jour CHANGELOG
Confirmer pour continuer."
→ Aller a l'etape 4 (Implementation Quick)
SI NON-CONFORME (Basculement requis)
Presenter le rapport de non-conformite :
"Cette modification necessite une mise a jour des specs.
## Impacts detectes
| Element | Spec impactee | Raison |
|---------|---------------|--------|
| Nouvelle entite 'PaymentMethod' | domain.md | Concept metier absent |
| Endpoint POST /payments | api.md | Non documente |
| Regle validation montant | rules/ | Nouvelle contrainte |
## Options
[A] Generer requirements-N.md automatiquement (Recommande)
→ Je cree le fichier pre-rempli base sur votre demande
→ Vous validez/completez les 12 sections
→ Puis /factory s'execute
[B] Creer requirements-N.md manuellement
→ Template: input/requirements.md
→ Completez les sections impactees
→ Puis lancez /factory
[C] Forcer Quick (NON RECOMMANDE)
→ Risque de derive specs/code
→ Dette technique garantie
→ A vos risques"
Utiliser AskUserQuestion pour obtenir le choix.
4. Traitement selon choix
Option A : Generation automatique requirements
-
Detecter la prochaine version :
bashnode tools/detect-requirements.js # Retourne: { "version": N, "nextVersion": N+1, ... } # Utiliser nextVersion pour le nouveau fichier -
Generer
input/requirements-{nextVersion}.mdpre-rempli :- Sections impactees completees depuis la demande utilisateur
- Sections non-impactees marquees "Inchange - voir V1"
- Section "Contexte evolution" ajoutee
-
Valider Gate 0 sur le fichier genere :
bashnode tools/validate-requirements.js input/requirements-{nextVersion}.md- Si echec → corriger les sections manquantes avant de continuer
- Si succes → continuer
-
Demander validation utilisateur :
"J'ai genere input/requirements-{nextVersion}.md (Gate 0 valide) Sections pre-remplies: - Fonctionnalites: [resume] - Contraintes: [resume] Veuillez: 1. Relire et completer si necessaire 2. Confirmer pour lancer /factory" -
Si confirme → Invoquer
/factory
Option B : Creation manuelle
"Pour creer requirements-N.md manuellement:
1. Copier le template:
cp input/requirements.md input/requirements-N.md
2. Completer les sections impactees:
- ## Fonctionnalites cles
- ## Contraintes techniques
- [autres sections selon impacts]
3. Lancer:
/factory
Le pipeline detectera automatiquement requirements-N.md"
Option C : Forcer Quick (avec warning)
"MODE QUICK FORCE - Vous acceptez les risques suivants:
- Specs desynchronisees du code
- Gate 4 peut echouer sur conformite
- Dette technique a rembourser
Continuation..."
→ Aller a Implementation Quick (etape 5)
5. Implementation Quick
Si Quick OK ou force :
-
Creer la TASK :
bash# Obtenir le prochain numero node tools/factory-state.js counter task next # Creer dans la version courante node tools/get-planning-version.js -
Generer TASK-XXXX-quick-fix.md dans
docs/planning/vN/tasks/:- Template simplifie (pas besoin de US/EPIC pour quick)
- US Parent :
N/A (Quick Fix)— JAMAIS de reference cross-version - EPIC :
N/A (Quick Fix) - Objectif clair
- Fichiers concernes (max 3)
- DoD minimale
- Tests attendus
-
Activer le tracking instrumentation :
bashnode tools/set-current-task.js set docs/planning/vN/tasks/TASK-XXXX-quick-fix.md -
Deleguer a l'agent
developer:Task( subagent_type: "developer", prompt: "Implementer TASK-XXXX-quick-fix.md. Mode Quick: modification mineure, pas de nouveaux concepts. Respecter boundaries architecturales.", description: "Developer - Quick Fix" ) -
Desactiver le tracking instrumentation :
bashnode tools/set-current-task.js clear -
Validation Gate 4 light :
- Tests passent
- Boundaries respectees
- Pas de secrets/PII
-
Mettre a jour CHANGELOG :
- Prepend section "Fixed" ou "Changed"
- Format:
- [Quick] Description (#TASK-XXXX)
6. Finalisation
node tools/factory-log.js "QUICK" "completed" "Quick fix TASK-XXXX termine"
Rapport final :
"Quick Fix termine
TASK: TASK-XXXX-quick-fix.md
Fichiers modifies: [liste]
Tests: OK
CHANGELOG: Mis a jour
Note: Cette modification n'a pas mis a jour les specs.
Si d'autres modifications similaires s'accumulent,
considerez un /factory pour synchroniser."
Template requirements pre-rempli (Option A)
Quand on genere automatiquement :
# Requirements - Evolution V{{N}}
> Genere automatiquement par /factory-quick
> A valider et completer avant /factory
## Contexte evolution
**Origine**: Quick fix qui necessite mise a jour specs
**Demande initiale**: {{DEMANDE_UTILISATEUR}}
**Impacts detectes**: {{LISTE_IMPACTS}}
## Objectif
{{DESCRIPTION_OBJECTIF}}
## Fonctionnalites cles
### Nouvelles fonctionnalites
- {{FONCTIONNALITE_EXTRAITE}}
### Fonctionnalites existantes (inchangees)
- Voir requirements.md (V1)
## Contraintes techniques
{{SI_NOUVELLES_CONTRAINTES}}
- Sinon: Inchangees - voir V1
## Stack technique
Inchange - voir V1
## Personas
Inchange - voir V1
## User Stories
### US ajoutees
- En tant que {{PERSONA}}, je veux {{ACTION}} afin de {{BENEFICE}}
## Regles metier
{{NOUVELLES_REGLES_SI_DETECTEES}}
- Sinon: Inchangees - voir V1
## API
{{NOUVEAUX_ENDPOINTS_SI_DETECTES}}
- Sinon: Inchange - voir V1
## Securite
Inchange - voir V1
## Performance
Inchange - voir V1
## Livrables
- Code source mis a jour
- Tests mis a jour
- CHANGELOG mis a jour
- Specs synchronisees
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?