Qwen Superpowers

Transformez Qwen Code en ingénieur logiciel discipliné. Plugin de skills et workflow structuré pour le développement IA autonome et fiable.

🚀 Qu'est-ce que c'est ?

Qwen Superpowers est un plugin pour Qwen Code qui injecte un ensemble de compétences ("skills") et un workflow en 7 étapes rigoureux. Inspiré du projet Superpowers, il transforme un agent IA qui code de manière ad-hoc en un ingénieur logiciel autonome et discipliné.

Philosophie

• TDD non-négociable — tests avant code, toujours
• Processus systématique — pas de devinettes, que de la méthode
• Simplicité première — réduire la complexité est la priorité n°1
• Preuves > Affirmations — les tests sont la seule preuve acceptable

📋 Workflow en 7 Étapes

Chaque tâche de développement suit un pipeline obligatoire :

| Étape | Nom | Description | |-------|-----|-------------| | 1 | Brainstorming | Questions socratiques → Design doc validé | | 2 | Git Worktrees | Workspace isolé → Setup → Tests de base propres | | 3 | Writing Plans | Découpage en tâches de 2-5 min avec chemins et vérifications | | 4 | Subagent-Driven Dev | Dispatch par sous-agent → Revue 2 étapes → Continue | | 5 | Test-Driven Dev | RED → GREEN → REFACTOR → Commit si tests verts | | 6 | Code Review | Comparaison au plan → Blocage si critiques → Rapport | | 7 | Branch Finalization | Tests finaux → Options merge/PR → Cleanup |

🧠 Skills Disponibles

| Skill | Description | Catégorie | |-------|-------------|-----------| | test-driven-development | TDD strict : RED → GREEN → REFACTOR | Testing | | systematic-debugging | Debugging méthodique en 4 phases | Debugging | | verification-before-completion | Vérification systématique avant "terminé" | Qualité | | brainstorming | Questionnement socratique → Design doc | Collaboration | | writing-plans | Plans détaillés avec tâches atomiques | Collaboration | | executing-plans | Exécution étape par étape d'un plan | Collaboration | | code-review | Revue en 2 passes : conformité + qualité | Collaboration | | git-worktrees | Isolation par worktrees Git | Collaboration | | subagent-driven-development | Dispatch à sous-agents avec revue | Collaboration | | writing-skills | Comment créer de nouveaux skills | Méta |

📦 Installation

Prérequis

• Node.js >= 18.0.0
• Qwen Code installé et configuré
• Git (pour les worktrees)

Via npm (recommandé)

npm install -g qwen-superpowers

Depuis les sources

git clone https://github.com/votre-org/qwen-superpowers
cd qwen-superpowers
npm link

Initialisation dans un projet

# Se déplacer dans le projet cible
cd mon-projet

# Initialiser le plugin
qwen-powers init

Cela créera :

• .qwen-powers.json — Configuration locale
• .qwen-skills/ — Copie des skills

🔧 Utilisation

CLI

# Lister les skills
qwen-powers list

# Voir les détails d'un skill
qwen-powers show test-driven-development

# Activer un skill
qwen-powers enable test-driven-development

# Désactiver un skill
qwen-powers disable brainstorming

# Afficher le workflow
qwen-powers workflow

# Créer un nouveau skill
qwen-powers create mon-skill

# Aide
qwen-powers help

Intégration avec Qwen Code

1. Placer le fichier AGENTS.md à la racine de votre projet
2. Ou copier son contenu dans votre fichier QWEN.md
3. L'agent détectera automatiquement les skills et le workflow

Configuration

Fichier .qwen-powers.json :

{
  "version": "1.0.0",
  "enabledSkills": [
    "test-driven-development",
    "code-review",
    "brainstorming"
  ],
  "workflow": {
    "enforceStages": true,
    "stages": [
      "brainstorming",
      "git-worktrees",
      "writing-plans",
      "subagent-driven-development",
      "test-driven-development",
      "code-review",
      "finishing-branch"
    ]
  },
  "settings": {
    "tddEnforced": true,
    "codeReviewRequired": true,
    "autoRunTests": true,
    "autoLint": true
  }
}

🏗️ Architecture

qwen-superpowers/
├── AGENTS.md                      # Instructions pour Qwen Code
├── .qwen-powers.example.json      # Config exemple
├── package.json                   # Metadata du plugin
│
├── cli/
│   └── index.js                   # CLI principal (qwen-powers)
│
├── skills/                        # Librairie de skills
│   ├── test-driven-development/
│   │   └── SKILL.md
│   ├── systematic-debugging/
│   │   └── SKILL.md
│   ├── brainstorming/
│   │   └── SKILL.md
│   ├── writing-plans/
│   │   └── SKILL.md
│   ├── executing-plans/
│   │   └── SKILL.md
│   ├── code-review/
│   │   └── SKILL.md
│   ├── git-worktrees/
│   │   └── SKILL.md
│   ├── subagent-driven-development/
│   │   └── SKILL.md
│   ├── verification-before-completion/
│   │   └── SKILL.md
│   └── writing-skills/
│       └── SKILL.md
│
├── hooks/
│   ├── pre-execute.js             # Hook avant exécution
│   └── post-execute.js            # Hook après exécution
│
├── docs/                          # Documentation additionnelle
├── scripts/                       # Scripts d'automatisation
└── README.md                      # Ce fichier

📖 Comment ça marche

1. Injection de Contexte

Le fichier AGENTS.md (ou son contenu dans QWEN.md) sert de system prompt pour Qwen Code. Il définit les règles, le workflow et les skills disponibles.

2. Détection Automatique

L'agent détecte automatiquement le contexte et active le skill approprié :

• "Je pense à faire X" → brainstorming
• "Commence à travailler" → git-worktrees → writing-plans
• Code à écrire → test-driven-development
• Bug signalé → systematic-debugging

3. Workflow Obligatoire

Les 7 étapes doivent être suivies dans l'ordre. L'agent ne peut pas sauter d'étape sans justification.

4. Hooks

Les hooks pre-execute et post-execute valident l'environnement avant et après chaque action.

🤝 Contribution

Les contributions sont les bienvenues ! Voici comment participer :

1. Forker le dépôt
2. Créer une branche : git checkout -b feature/mon-skill
3. Créer un skill : qwen-powers create mon-skill
4. Tester avec Qwen Code
5. Soumettre une PR

Guidelines

• Un skill = une responsabilité unique
• Triggers explicites et détectables
• Instructions actionnables, pas théoriques
• Sortie vérifiable définie
• Respecter le TDD pour tout code du plugin

📄 Licence

MIT — Voir le fichier LICENSE pour les détails.

🙏 Remerciements

• Inspiration principale : obra/superpowers — Le projet original qui a tout commencé
• Qwen Code — L'agent IA qui rend ce plugin possible

"Un ingénieur discipliné vaut mieux qu'un codeur brillant mais chaotique."