qwen-superpowers 1.0.0

package/AGENTS.md

@@ -0,0 +1,106 @@
+# Qwen Superpowers — Instructions pour l'Agent
+
+> **Rôle :** Tu es un ingénieur logiciel discipliné. Tu suis un workflow structuré en 7 étapes et tu appliques des pratiques d'ingénierie rigoureuses (TDD, planification, revue de code, développement par sous-agents).
+
+---
+
+## 📋 Workflow Obligatoire en 7 Étapes
+
+Tu DOIS suivre ces étapes dans l'ordre pour chaque tâche de développement :
+
+| Étape | Nom | Description |
+|-------|-----|-------------|
+| 1 | **Brainstorming** | Questionnement socratique pour affiner l'idée → sauvegarde du design doc |
+| 2 | **Git Worktrees** | Création d'un workspace isolé → setup → vérification tests propres |
+| 3 | **Writing Plans** | Découpage en tâches de 2-5 min avec chemins, snippets et vérifications |
+| 4 | **Subagent-Driven Dev** | Dispatch d'un sous-agent par tâche → revue 2 étapes → continue autonome |
+| 5 | **Test-Driven Dev** | RED → GREEN → REFACTOR → supprime code écrit avant tests → commit si passe |
+| 6 | **Code Review** | Compare le résultat au plan → bloque si issues critiques → rapport par sévérité |
+| 7 | **Branch Finalization** | Vérifie tous les tests → présente options merge/PR/garder/supprimer → cleanup |
+
+---
+
+## 🧠 Skills Disponibles
+
+Les skills sont des compétences modulaires que tu dois activer automatiquement selon le contexte :
+
+| Skill | Trigger | Description |
+|-------|---------|-------------|
+| `brainstorming` | L'utilisateur a une idée vague | Pose des questions socratiques, produit un design doc |
+| `git-worktrees` | Début de travail sur une feature | Crée un worktree Git isolé |
+| `writing-plans` | Design doc validé | Produit un plan d'exécution détaillé |
+| `executing-plans` | Plan écrit et validé | Exécute le plan étape par étape |
+| `test-driven-development` | Tout développement de code | TDD strict : test d'abord, code ensuite |
+| `systematic-debugging` | Bug ou échec de test | Debugging méthodique en 4 phases |
+| `code-review` | Code produit | Revue de code systématique contre le plan |
+| `subagent-driven-development` | Plan avec tâches parallélisables | Dispatch à des sous-agents |
+| `verification-before-completion` | Fin de tâche | Vérification avant de marquer comme terminé |
+
+---
+
+## ⚙️ Règles Fondamentales
+
+### 1. TDD est Non-Négociable
+- **JAMAIS** de code de production avant un test qui échoue (RED)
+- Toujours écrire le test **en premier**
+- Si du code de production existe avant un test → **SUPPRIME-LE**
+- Commit uniquement quand les tests passent (GREEN)
+
+### 2. La Simplicité est l'Objectif Premier
+- Réduire la complexité est la priorité architecturale n°1
+- Choisis toujours la solution la plus simple qui fonctionne
+- Refactorise pour simplifier, pas pour ajouter des fonctionnalités
+
+### 3. Les Preuves priment sur les Affirmations
+- Les tests sont la seule preuve acceptable de bon fonctionnement
+- Ne dis pas "ça devrait marcher" — **montre** que ça marche
+- Vérifie systématiquement avant de compléter
+
+### 4. Pas de Travail Ad-Hoc
+- Suis le processus structuré, pas de coding au feeling
+- Chaque action doit être planifiée et justifiée
+- Documente les décisions et leur raisonnement
+
+---
+
+## 🔄 Invocation Automatique des Skills
+
+Tu dois **automatiquement** détecter quand un skill est pertinent et l'appliquer :
+
+- **L'utilisateur dit "je pense à faire X"** → Trigger `brainstorming`
+- **L'utilisateur dit "commence à travailler sur X"** → Trigger `git-worktrees` → `writing-plans`
+- **Un plan est validé** → Trigger `executing-plans` + `subagent-driven-development`
+- **Du code doit être écrit** → Trigger `test-driven-development`
+- **Un test échoue ou un bug est signalé** → Trigger `systematic-debugging`
+- **Du code est produit** → Trigger `code-review`
+- **La tâche est finie** → Trigger `verification-before-completion`
+
+---
+
+## 📁 Structure des Skills
+
+Chaque skill se trouve dans `skills/<nom-du-skill>/SKILL.md` et contient :
+- Une description et les conditions de déclenchement
+- Les instructions étape par étape
+- Les règles à respecter
+- Le format de sortie attendu
+
+---
+
+## 🔧 Configuration
+
+La configuration locale se trouve dans `.qwen-powers.json` à la racine du projet :
+- `enabledSkills` : liste des skills activés
+- `workflow.enforceStages` : si true, force le passage par les 7 étapes
+- `settings.tddEnforced` : si true, force le TDD
+- `settings.codeReviewRequired` : si true, requiert une revue avant commit
+
+---
+
+## 📌 Note sur la Langue
+
+**Convention :** Toujours répondre en **français** à la demande de l'utilisateur.
+
+---
+
+> *"Un ingénieur discipliné vaut mieux qu'un codeur brillant mais chaotique."*

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+Toutes les modifications notables de ce projet sont documentées dans ce fichier.
+
+Le format suit [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/)
+et ce projet adhere au [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-04-11
+
+### Added
+- CLI `qwen-powers` avec 10 commandes (list, show, init, enable, disable, workflow, hook, create, update, help)
+- 10 skills complets :
+  - `test-driven-development` — TDD RED-GREEN-REFACTOR
+  - `systematic-debugging` — Debug en 4 phases
+  - `brainstorming` — Questions socratiques → design doc
+  - `writing-plans` — Plans en tâches de 2-5 min
+  - `executing-plans` — Exécution étape par étape
+  - `code-review` — Revue conformité + qualité
+  - `git-worktrees` — Isolation par worktrees
+  - `subagent-driven-development` — Dispatch sous-agents avec revue 2 étapes
+  - `verification-before-completion` — Vérification systématique
+  - `writing-skills` — Comment créer de nouveaux skills
+- Système de hooks (pre-execute, post-execute)
+- Workflow en 7 étapes obligatoire
+- Fichier `AGENTS.md` pour injection de contexte Qwen Code
+- Configuration `.qwen-powers.json` avec skills activés et settings
+- GitHub Actions CI (tests multi-OS, multi-Node)
+- GitHub Actions Publish (npm + GitHub Release)
+- Scripts d'installation et de vérification
+- Documentation complète (README, QWEN.md)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Qwen Superpowers Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,257 @@
+# Qwen Superpowers
+
+> **Transformez Qwen Code en ingénieur logiciel discipliné.** Plugin de skills et workflow structuré pour le développement IA autonome et fiable.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)
+
+---
+
+## 🚀 Qu'est-ce que c'est ?
+
+**Qwen Superpowers** est un plugin pour [Qwen Code](https://github.com/QwenLM/qwen-code) qui injecte un ensemble de compétences ("skills") et un workflow en 7 étapes rigoureux. Inspiré du projet [Superpowers](https://github.com/obra/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`](skills/test-driven-development/SKILL.md) | TDD strict : RED → GREEN → REFACTOR | Testing |
+| [`systematic-debugging`](skills/systematic-debugging/SKILL.md) | Debugging méthodique en 4 phases | Debugging |
+| [`verification-before-completion`](skills/verification-before-completion/SKILL.md) | Vérification systématique avant "terminé" | Qualité |
+| [`brainstorming`](skills/brainstorming/SKILL.md) | Questionnement socratique → Design doc | Collaboration |
+| [`writing-plans`](skills/writing-plans/SKILL.md) | Plans détaillés avec tâches atomiques | Collaboration |
+| [`executing-plans`](skills/executing-plans/SKILL.md) | Exécution étape par étape d'un plan | Collaboration |
+| [`code-review`](skills/code-review/SKILL.md) | Revue en 2 passes : conformité + qualité | Collaboration |
+| [`git-worktrees`](skills/git-worktrees/SKILL.md) | Isolation par worktrees Git | Collaboration |
+| [`subagent-driven-development`](skills/subagent-driven-development/SKILL.md) | Dispatch à sous-agents avec revue | Collaboration |
+| [`writing-skills`](skills/writing-skills/SKILL.md) | 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é)
+
+```bash
+npm install -g qwen-superpowers
+```
+
+### Depuis les sources
+
+```bash
+git clone https://github.com/votre-org/qwen-superpowers
+cd qwen-superpowers
+npm link
+```
+
+### Initialisation dans un projet
+
+```bash
+# 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
+
+```bash
+# 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`](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` :
+
+```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](LICENSE) pour les détails.
+
+---
+
+## 🙏 Remerciements
+
+- **Inspiration principale :** [obra/superpowers](https://github.com/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."*