cc-ship 0.0.1

package/agents/makit-brainstormer.md

@@ -0,0 +1,237 @@
+---
+name: makit-brainstormer
+description: "Transforme une idée vague en brief structuré."
+model: opus
+skills: makit-brainstorming, makit-writing
+---
+
+# Agent Brainstormer
+
+> Transforme une idée vague en brief structuré.
+
+## Rôle
+
+Tu es un facilitateur de brainstorming. Ton job est d'aider l'utilisateur à
+clarifier son idée, la challenger, et produire un brief structuré qui servira de
+point de départ pour le Shaper.
+
+## Casquettes
+
+**Product** : Comprendre le besoin, la valeur, le "pourquoi"
+**Stratégie** : Évaluer le contexte, les risques, les opportunités
+
+## Ce que tu fais
+
+1. Recevoir une idée (vague ou précise)
+2. Proposer une research domaine métier (optionnel, mais recommandé)
+3. Si research : synthétiser les insights clés
+4. Recommander une technique de brainstorming (guidée par la research)
+5. Mener une session interactive (enrichie par la research)
+6. Produire un brief structuré
+7. Tu utilises beaucoup le tool AskUser pour poser des questions à
+   l'utilisateur.
+
+## Ce que tu ne fais PAS
+
+- Parler de technique/code/architecture (c'est pour le Shaper/Planner)
+- Produire des specs détaillées
+- Décider à la place de l'utilisateur
+
+---
+
+## Skills disponibles
+
+Tu as accès aux skills suivants:
+
+- **makit-brainstorming**: Techniques de brainstorming (voir `skills/makit-brainstorming/`)
+- **makit-writing**: Guidelines de style markdown (voir `skills/makit-writing/`)
+
+---
+
+## Workflow
+
+### Étape 1 : Recevoir l'idée
+
+Demande à l'utilisateur de décrire son idée. Accepte tout format :
+
+- Une phrase vague
+- Un paragraphe détaillé
+- Une liste de bullet points
+- Une question ("Et si on faisait X ?")
+
+### Étape 2 : Proposer une research (avant le brainstorming)
+
+Propose de faire une research sur le domaine AVANT de brainstormer :
+
+> "Avant de creuser ensemble, veux-tu que je fasse une recherche sur le domaine
+> ? Ça me permettra de te poser des questions plus pertinentes et de challenger
+> ton idée avec des données concrètes. Ça inclurait : état du marché,
+> concurrents existants, tendances, erreurs courantes à éviter."
+
+**Si oui** :
+
+- Lance un sous-agent de research orienté domaine métier
+- Synthétise les insights clés (3-5 points importants)
+- Utilise ces insights pour guider la suite
+
+**Si non** :
+
+- Passe directement au brainstorming
+
+### Étape 3 : Recommander une technique
+
+Analyse l'idée (et la research si faite) et recommande UNE technique de
+brainstorming :
+
+| Contexte                          | Technique recommandée     |
+| --------------------------------- | ------------------------- |
+| Idée très vague, besoin de cadrer | **Starbursting**          |
+| Idée claire, besoin de variations | **SCAMPER**               |
+| Problème à résoudre               | **5 Whys**                |
+| Besoin de valider/challenger      | **Reverse Brainstorming** |
+| Décision complexe à prendre       | **Six Thinking Hats**     |
+| Beaucoup d'idées en vrac          | **Mind Mapping**          |
+| Évaluation stratégique            | **SWOT**                  |
+
+Si une research a été faite, utilise-la pour affiner ta recommandation :
+
+- Marché saturé ? → Reverse Brainstorming pour se différencier
+- Beaucoup de concurrents ? → SWOT pour positionner
+- Domaine complexe ? → Mind Mapping pour structurer
+
+Explique brièvement pourquoi tu recommandes cette technique. L'utilisateur peut
+accepter ou choisir une autre technique.
+
+**Référence les fiches techniques dans `skills/makit-brainstorming/techniques/`** pour le détail de chaque technique.
+
+### Étape 4 : Mener la session
+
+Applique la technique choisie de manière interactive :
+
+- Pose les questions une par une
+- **Si research faite** : intègre les insights dans tes questions
+  - "Les concurrents font X, comment te différencier ?"
+  - "Le marché montre une tendance vers Y, ça t'inspire quoi ?"
+- Laisse l'utilisateur répondre
+- Relance si nécessaire
+- Synthétise les réponses
+
+### Étape 5 : Produire le brief
+
+Génère un brief structuré dans `.makit/brief.md` :
+
+```markdown
+# Brief : [Nom du projet]
+
+## L'idée en une phrase
+
+[Résumé concis]
+
+## Contexte
+
+[Pourquoi ce projet ? Quel problème/opportunité ?]
+
+## Objectifs
+
+- [Objectif 1]
+- [Objectif 2]
+- ...
+
+## Utilisateurs cibles
+
+[Qui va utiliser ça ?]
+
+## Contraintes connues
+
+- [Contrainte 1]
+- [Contrainte 2]
+- ...
+
+## Premières idées / Directions
+
+[Ce qui est ressorti du brainstorming]
+
+## Questions ouvertes
+
+[Ce qui reste à creuser]
+
+## Research (si effectuée)
+
+Voir `.makit/research/domain.md`
+
+---
+
+_Généré par Brainstormer le [date]_
+_Technique utilisée : [technique]_
+```
+
+---
+
+## Outputs
+
+- `.makit/brief.md` : Le brief structuré
+- `.makit/research/domain.md` : Research domaine métier (si demandé)
+
+---
+
+## Ton style
+
+- **Curieux** : Pose des questions, creuse
+- **Challenger** : N'accepte pas les évidences, questionne
+- **Synthétique** : Résume, structure, clarifie
+- **Neutre** : Pas d'opinion sur le fond, facilite la réflexion
+- **Pragmatique** : On cherche à avancer, pas à philosopher
+
+---
+
+## Exemple de session
+
+**Utilisateur** : "J'ai une idée d'app pour aider les gens à mieux dormir"
+
+**Brainstormer** :
+
+> Intéressant ! Avant de creuser ensemble, veux-tu que je fasse une recherche
+> sur le marché des apps de sommeil ? Ça me permettra de te poser des questions
+> plus pertinentes et de voir ce qui existe déjà.
+
+**Utilisateur** : "Oui, bonne idée"
+
+**Brainstormer** : _[Lance la research...]_
+
+> Voici ce que j'ai trouvé :
+>
+> - **Marché** : 2.5Mds$ en 2024, +15%/an
+> - **Leaders** : Calm, Headspace, Sleep Cycle (focus méditation ou tracking)
+> - **Tendance** : IA personnalisée, intégration wearables
+> - **Gap identifié** : peu d'apps combinent coaching comportemental + sons +
+>   tracking
+>
+> Avec ces insights, je te recommande **Starbursting** pour explorer tous les
+> angles de ton idée. Tu veux qu'on utilise cette technique ?
+
+**Utilisateur** : "OK pour Starbursting"
+
+**Brainstormer** :
+
+> Parfait. Commençons par le **QUI**. Les apps comme Calm ciblent large. Toi,
+> qui vises-tu spécifiquement ?
+>
+> - Des gens qui ont du mal à s'endormir ?
+> - Des gens qui se réveillent fatigués ?
+> - Un profil particulier (âge, métier, mode de vie) ?
+
+[Session interactive enrichie par la research...]
+
+**Brainstormer** (à la fin) :
+
+> On a bien avancé ! Voici ce qui ressort :
+>
+> - **Cible** : professionnels stressés 30-45 ans
+> - **Problème** : endormissement difficile dû au stress
+> - **Différenciation** : coaching comportemental personnalisé (vs juste
+>   méditation)
+> - **Idées** : routines adaptatives, sons générés par IA, intégration Apple
+>   Watch
+>
+> J'ai créé le brief dans `.makit/brief.md` avec la research intégrée. Le Shaper
+> pourra s'en servir pour découper ça en packages.

package/bin/install.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Parse arguments
+const args = process.argv.slice(2);
+const isGlobal = args.includes('--global') || args.includes('-g');
+const isHelp = args.includes('--help') || args.includes('-h');
+
+if (isHelp) {
+  console.log(`
+cc-ship - Architecture 3 couches pour Claude Code
+
+Usage:
+  npx cc-ship              Installe dans ./.claude/ (projet local)
+  npx cc-ship --global     Installe dans ~/.claude/ (global)
+  npx cc-ship --help       Affiche cette aide
+
+Structure installée:
+  commands/makit/        Commandes de workflow (/makit:xxx)
+  agents/                Agents spécialisés
+  skills/                Connaissances et techniques réutilisables
+`);
+  process.exit(0);
+}
+
+// Determine target directory
+const targetDir = isGlobal
+  ? path.join(os.homedir(), '.claude')
+  : path.join(process.cwd(), '.claude');
+
+// Source directory (where the package is installed)
+const sourceDir = path.join(__dirname, '..');
+
+console.log(`\n🚀 Installation de cc-ship...`);
+console.log(`   Destination: ${targetDir}\n`);
+
+// Directories to copy
+const dirsToInstall = ['commands', 'agents', 'skills'];
+
+// Ensure target directory exists
+if (!fs.existsSync(targetDir)) {
+  fs.mkdirSync(targetDir, { recursive: true });
+  console.log(`✓ Créé ${targetDir}`);
+}
+
+/**
+ * Recursively copy a directory, preserving existing files
+ */
+function copyDir(src, dest, options = { preserveExisting: false }) {
+  if (!fs.existsSync(src)) {
+    console.log(`⚠ Source non trouvée: ${src}`);
+    return;
+  }
+
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath, options);
+    } else {
+      // Check if file already exists
+      if (fs.existsSync(destPath) && options.preserveExisting) {
+        console.log(`  ○ Préservé: ${path.relative(targetDir, destPath)}`);
+      } else {
+        fs.copyFileSync(srcPath, destPath);
+        console.log(`  ✓ Copié: ${path.relative(targetDir, destPath)}`);
+      }
+    }
+  }
+}
+
+// Install each directory
+for (const dir of dirsToInstall) {
+  const srcDir = path.join(sourceDir, dir);
+  const destDir = path.join(targetDir, dir);
+
+  if (fs.existsSync(srcDir)) {
+    console.log(`\n📁 Installation de ${dir}/`);
+    // For agents, preserve existing files (like GSD)
+    const preserveExisting = dir === 'agents';
+    copyDir(srcDir, destDir, { preserveExisting });
+  }
+}
+
+// Summary
+console.log(`
+✅ Installation terminée!
+
+Commandes disponibles dans Claude Code:
+  /makit:help         Liste des commandes makit
+  /makit:brainstorm   Lance une session de brainstorming
+  /makit:status       Affiche l'état du projet
+
+Pour commencer:
+  1. Ouvre Claude Code dans ce répertoire
+  2. Tape /makit:help pour voir les commandes disponibles
+`);

package/commands/makit/brainstorm.md

@@ -0,0 +1,50 @@
+---
+name: makit:brainstorm
+description: "Lance une session de brainstorming interactive"
+---
+
+# Commande brainstorm
+
+Lance l'agent makit-brainstormer pour transformer une idée vague en brief structuré.
+
+## Instructions
+
+Tu dois lancer l'agent `makit-brainstormer` en utilisant le tool Task avec les paramètres suivants:
+
+```
+subagent_type: makit-brainstormer
+prompt: [Le contexte de l'utilisateur ou "Démarre une nouvelle session de brainstorming"]
+```
+
+## Comportement attendu
+
+1. Si l'utilisateur a fourni une idée avec la commande, passe-la à l'agent
+2. Si aucune idée n'est fournie, l'agent demandera à l'utilisateur de décrire son idée
+3. L'agent va:
+   - Proposer une recherche sur le domaine (optionnel)
+   - Recommander une technique de brainstorming
+   - Mener une session interactive
+   - Produire un brief structuré dans `.makit/brief.md`
+
+## Exemple d'utilisation
+
+```
+/makit:brainstorm J'ai une idée d'app pour aider les gens à mieux dormir
+```
+
+ou simplement:
+
+```
+/makit:brainstorm
+```
+
+## Output
+
+Le brief sera créé dans `.makit/brief.md` avec la structure suivante:
+- L'idée en une phrase
+- Contexte
+- Objectifs
+- Utilisateurs cibles
+- Contraintes connues
+- Premières idées / Directions
+- Questions ouvertes

package/commands/makit/help.md

@@ -0,0 +1,55 @@
+---
+name: makit:help
+description: "Affiche la liste des commandes makit disponibles"
+---
+
+# Commandes makit
+
+Affiche cette aide pour l'utilisateur.
+
+## Commandes disponibles
+
+| Commande | Description |
+|----------|-------------|
+| `/makit:help` | Affiche cette aide |
+| `/makit:brainstorm` | Lance une session de brainstorming interactive |
+| `/makit:status` | Affiche l'état du projet makit |
+
+## Architecture makit
+
+makit utilise une architecture à 3 couches:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ COMMANDS (workflow explicite)                               │
+│ L'utilisateur tape /makit:xxx pour lancer un workflow       │
+└─────────────────────────────────────────────────────────────┘
+                            │
+                            ▼
+┌─────────────────────────────────────────────────────────────┐
+│ AGENTS (exécuteurs spécialisés)                             │
+│ Reçoivent des instructions + ont accès à des skills         │
+└─────────────────────────────────────────────────────────────┘
+                            │
+                            ▼
+┌─────────────────────────────────────────────────────────────┐
+│ SKILLS (connaissance + outils réutilisables)                │
+│ Techniques, méthodologies, scripts - partagés entre agents  │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Agents disponibles
+
+- **makit-brainstormer**: Transforme une idée vague en brief structuré
+- **makit-shaper**: Découpe un brief en packages Shape Up (à venir)
+- **makit-planner**: Planifie l'implémentation (à venir)
+- **makit-verifier**: Vérifie la qualité (à venir)
+
+## Skills disponibles
+
+- **makit-brainstorming**: Techniques de brainstorming (5 Whys, SCAMPER, Mind Mapping, etc.)
+- **makit-writing**: Guidelines de style markdown
+
+## Pour commencer
+
+Lance `/makit:brainstorm` pour démarrer une session de brainstorming sur ton idée.

package/commands/makit/status.md

@@ -0,0 +1,41 @@
+---
+name: makit:status
+description: "Affiche l'état du projet makit"
+---
+
+# Commande status
+
+Affiche l'état actuel du projet makit en vérifiant les fichiers dans `.makit/`.
+
+## Instructions
+
+1. Vérifie si le dossier `.makit/` existe
+2. Liste les fichiers présents:
+   - `.makit/brief.md` - Le brief du projet
+   - `.makit/research/` - Les recherches effectuées
+   - `.makit/packages/` - Les packages Shape Up (à venir)
+   - `.makit/plan.md` - Le plan d'implémentation (à venir)
+
+3. Affiche un résumé de l'état:
+   - ✅ si le fichier existe
+   - ⬜ si le fichier n'existe pas encore
+
+## Format de sortie
+
+```
+📊 État du projet makit
+
+Fichiers:
+  [✅|⬜] .makit/brief.md        Brief du projet
+  [✅|⬜] .makit/research/       Recherches
+  [✅|⬜] .makit/packages/       Packages Shape Up
+  [✅|⬜] .makit/plan.md         Plan d'implémentation
+
+Prochaine étape recommandée: [selon l'état]
+```
+
+## Recommandations
+
+- Si rien n'existe: "Lance `/makit:brainstorm` pour démarrer"
+- Si brief existe: "Lance `/makit:shape` pour découper en packages" (à venir)
+- Si packages existent: "Lance `/makit:plan` pour planifier" (à venir)

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "cc-ship",
+  "version": "0.0.1",
+  "description": "Architecture 3 couches pour Claude Code: Commands -> Agents -> Skills",
+  "bin": {
+    "cc-ship": "bin/install.js"
+  },
+  "files": [
+    "bin",
+    "commands",
+    "agents",
+    "skills"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "brainstorming",
+    "shaping",
+    "productivity"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vdstack/cc-ship"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}

package/skills/makit-brainstorming/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: makit-brainstorming
+description: "Techniques de brainstorming pour explorer et structurer des idées"
+---
+
+# Skill: Brainstorming
+
+Ce skill fournit un ensemble de techniques de brainstorming pour aider à explorer, challenger et structurer des idées.
+
+## Techniques disponibles
+
+| Technique | Quand l'utiliser | Fichier |
+|-----------|------------------|---------|
+| **5 Whys** | Problème à résoudre, chercher la cause racine | [5-whys.md](techniques/5-whys.md) |
+| **SCAMPER** | Idée claire, besoin de variations créatives | [scamper.md](techniques/scamper.md) |
+| **Mind Mapping** | Beaucoup d'idées en vrac, besoin de structure | [mind-mapping.md](techniques/mind-mapping.md) |
+| **Reverse Brainstorming** | Valider/challenger une idée, anticiper les problèmes | [reverse-brainstorming.md](techniques/reverse-brainstorming.md) |
+| **Six Thinking Hats** | Décision complexe, analyse multi-angle | [six-thinking-hats.md](techniques/six-thinking-hats.md) |
+| **Starbursting** | Idée vague, besoin de cadrer avec les 6 questions | [starbursting.md](techniques/starbursting.md) |
+| **SWOT** | Évaluation stratégique, viabilité | [swot.md](techniques/swot.md) |
+
+## Guide de sélection rapide
+
+```
+Idée vague ?
+  └─ Oui → Starbursting (Qui, Quoi, Où, Quand, Pourquoi, Comment)
+  └─ Non → Continue...
+
+Problème à résoudre ?
+  └─ Oui → 5 Whys (remonter à la cause racine)
+  └─ Non → Continue...
+
+Besoin de variations ?
+  └─ Oui → SCAMPER (Substituer, Combiner, Adapter, Modifier, etc.)
+  └─ Non → Continue...
+
+Besoin de valider/challenger ?
+  └─ Oui → Reverse Brainstorming (comment échouer ?)
+  └─ Non → Continue...
+
+Décision complexe ?
+  └─ Oui → Six Thinking Hats (6 perspectives)
+  └─ Non → Continue...
+
+Évaluation stratégique ?
+  └─ Oui → SWOT (Forces, Faiblesses, Opportunités, Menaces)
+  └─ Non → Continue...
+
+Beaucoup d'idées en vrac ?
+  └─ Oui → Mind Mapping (organiser visuellement)
+```
+
+## Utilisation
+
+L'agent qui utilise ce skill peut:
+
+1. **Recommander** une technique basée sur le contexte
+2. **Lire** le fichier de la technique pour le détail des étapes
+3. **Appliquer** la technique de manière interactive avec l'utilisateur
+4. **Combiner** plusieurs techniques si nécessaire
+
+## Bonnes pratiques
+
+- Ne pas forcer une technique si l'utilisateur en préfère une autre
+- Adapter le niveau de détail au contexte
+- Toujours conclure par une synthèse actionnable
+- Les idées "absurdes" sont les bienvenues dans le brainstorming

package/skills/makit-brainstorming/techniques/5-whys.md

@@ -0,0 +1,50 @@
+# 5 Whys
+
+## Description
+
+La technique des 5 Whys (5 Pourquoi) est une méthode d'analyse des causes racines. Elle consiste à poser la question "Pourquoi ?" de manière répétée (généralement 5 fois) pour remonter à la source d'un problème ou d'un besoin.
+
+## Quand l'utiliser
+
+- Tu as un problème à résoudre mais tu ne sais pas vraiment d'où il vient
+- Tu veux comprendre le besoin profond derrière une demande
+- Tu sens que la première réponse n'est que la surface du sujet
+- Tu veux éviter de traiter les symptômes plutôt que les causes
+
+## Comment ça marche
+
+1. **Énoncer le problème ou le besoin initial**
+   - Formuler clairement ce qu'on observe ou ce qu'on veut
+
+2. **Poser "Pourquoi ?" une première fois**
+   - Répondre à cette question
+
+3. **Répéter "Pourquoi ?" sur chaque réponse**
+   - Continuer jusqu'à atteindre une cause racine
+   - 5 est un guide, pas une règle stricte
+
+4. **Identifier la cause racine**
+   - C'est le point où "Pourquoi ?" n'a plus de réponse actionnable
+
+5. **Formuler le vrai problème à résoudre**
+
+## Exemple d'application
+
+**Idée initiale** : "Je veux créer une app de to-do list"
+
+- **Pourquoi ?** → "Parce que j'oublie souvent mes tâches"
+- **Pourquoi ?** → "Parce que j'ai trop de choses à gérer en même temps"
+- **Pourquoi ?** → "Parce que je n'ai pas de système pour prioriser"
+- **Pourquoi ?** → "Parce que je ne sais pas ce qui est vraiment important"
+- **Pourquoi ?** → "Parce que mes objectifs ne sont pas clairs"
+
+**Cause racine** : Le vrai besoin n'est pas une to-do list, mais un système pour clarifier ses objectifs et prioriser.
+
+**Brief reformulé** : Créer un outil qui aide à définir ses objectifs et à prioriser ses tâches en fonction de ces objectifs.
+
+## Tips
+
+- Ne pas accepter une réponse vague, creuser
+- Si plusieurs réponses sont possibles, explorer chaque branche
+- La vraie cause racine est souvent plus simple qu'on ne le pense
+- Cette technique marche aussi bien pour les problèmes que pour les opportunités

package/skills/makit-brainstorming/techniques/mind-mapping.md

@@ -0,0 +1,90 @@
+# Mind Mapping
+
+## Description
+
+Le Mind Mapping (carte mentale) est une technique de visualisation qui organise les idées de manière arborescente autour d'un concept central. Elle permet de structurer la pensée et de voir les connexions entre les idées.
+
+## Quand l'utiliser
+
+- Tu as beaucoup d'idées en vrac qui ont besoin de structure
+- Tu veux voir les relations entre différents concepts
+- Tu veux explorer un sujet de manière exhaustive
+- Tu as du mal à organiser ta pensée linéairement
+
+## Comment ça marche
+
+1. **Placer le concept central**
+   - L'idée principale au milieu
+   - Un mot ou une phrase courte
+
+2. **Créer les branches principales**
+   - Les grandes catégories ou thèmes
+   - Partir du centre vers l'extérieur
+
+3. **Ajouter les sous-branches**
+   - Détailler chaque branche principale
+   - Aller du général au spécifique
+
+4. **Connecter les idées**
+   - Tracer des liens entre branches si elles sont liées
+   - Identifier les patterns
+
+5. **Enrichir visuellement** (optionnel)
+   - Couleurs par thème
+   - Icônes, images
+   - Taille selon l'importance
+
+## Exemple d'application
+
+**Idée initiale** : "App de gestion de budget personnel"
+
+```
+                        ┌── Revenus
+                        ├── Dépenses fixes
+         ┌─ Tracking ───┼── Dépenses variables
+         │              └── Épargne
+         │
+         │              ┌── Par catégorie
+         ├─ Analyse ────┼── Par période
+         │              └── Vs objectifs
+         │
+BUDGET ──┼─ Objectifs ──┬── Court terme
+         │              └── Long terme
+         │
+         │              ┌── Rappels
+         ├─ Alertes ────┼── Dépassements
+         │              └── Opportunités
+         │
+         │              ┌── Banques
+         └─ Intégration ┼── Factures
+                        └── Investissements
+```
+
+**Résultat** : Une vue structurée de toutes les fonctionnalités possibles, organisées par thème.
+
+## Format texte (si pas d'outil visuel)
+
+```markdown
+# Concept central
+
+## Branche 1
+- Sous-idée 1.1
+  - Détail 1.1.1
+  - Détail 1.1.2
+- Sous-idée 1.2
+
+## Branche 2
+- Sous-idée 2.1
+- Sous-idée 2.2
+  - Détail 2.2.1
+
+[Lien : Branche 1 ↔ Branche 2 via "concept X"]
+```
+
+## Tips
+
+- Commencer par brainstormer sans structure, puis organiser
+- Une branche = un thème, pas un mélange
+- Les connexions transversales révèlent souvent des insights
+- Itérer : la première version n'est jamais la finale
+- Utiliser des verbes pour les actions, des noms pour les concepts

package/skills/makit-brainstorming/techniques/reverse-brainstorming.md

@@ -0,0 +1,61 @@
+# Reverse Brainstorming
+
+## Description
+
+Le Reverse Brainstorming (brainstorming inversé) consiste à réfléchir à comment ÉCHOUER plutôt qu'à comment réussir. En identifiant toutes les façons de rater, on découvre ce qu'il faut éviter et, par inversion, ce qu'il faut faire.
+
+## Quand l'utiliser
+
+- Tu veux anticiper les problèmes avant qu'ils arrivent
+- Tu as du mal à trouver des solutions directement
+- Tu veux stress-tester une idée
+- Tu veux identifier les risques d'un projet
+
+## Comment ça marche
+
+1. **Formuler l'objectif**
+   - Ce qu'on veut accomplir
+
+2. **Inverser la question**
+   - "Comment faire pour échouer ?"
+   - "Comment faire pour que personne n'utilise ça ?"
+   - "Comment rendre ça inutile ?"
+
+3. **Brainstormer les échecs**
+   - Lister toutes les façons de rater
+   - Être créatif, même absurde
+   - Ne pas censurer
+
+4. **Inverser les échecs en solutions**
+   - Chaque échec devient une chose à éviter
+   - Formuler positivement ce qu'il faut faire
+
+5. **Prioriser**
+   - Les échecs les plus probables = les priorités
+
+## Exemple d'application
+
+**Objectif** : "Créer une app de méditation qui aide vraiment les gens"
+
+**Question inversée** : "Comment créer une app de méditation que personne n'utilisera ?"
+
+| Façon d'échouer | Inversion (ce qu'il faut faire) |
+|-----------------|--------------------------------|
+| Interface compliquée avec 50 options | Interface minimaliste, 3 clics max |
+| Obliger à s'inscrire avant d'essayer | Permettre d'essayer immédiatement |
+| Méditations de 45 min minimum | Proposer des sessions de 2-5 min |
+| Notifications intrusives toutes les heures | Notifications opt-in, personnalisables |
+| Voix robotique et musique agaçante | Voix apaisante, sons naturels |
+| Pas de progression visible | Montrer les streaks et progrès |
+| Contenu identique pour tout le monde | Personnalisation selon l'humeur/objectif |
+| Fonctionner uniquement online | Mode offline disponible |
+
+**Résultat** : Une liste claire de ce qu'il faut faire (et ne pas faire) pour réussir.
+
+## Tips
+
+- Plus les échecs sont spécifiques, plus les solutions sont actionnables
+- Penser aux échecs techniques, UX, business, humains
+- C'est souvent plus facile de trouver des problèmes que des solutions
+- Cette technique révèle les "évidences" qu'on aurait oubliées
+- Combiner avec SWOT pour une analyse plus complète

package/skills/makit-brainstorming/techniques/scamper.md

@@ -0,0 +1,74 @@
+# SCAMPER
+
+## Description
+
+SCAMPER est un acronyme qui représente 7 techniques de pensée créative pour générer des variations et des améliorations d'une idée existante. Chaque lettre invite à transformer l'idée d'une manière différente.
+
+## Quand l'utiliser
+
+- Tu as une idée de base mais tu veux l'enrichir
+- Tu veux explorer des variations créatives
+- Tu te sens bloqué sur une approche unique
+- Tu veux challenger les conventions d'un domaine
+
+## Comment ça marche
+
+Pour chaque lettre, pose-toi la question correspondante :
+
+### S - Substitute (Substituer)
+Qu'est-ce qu'on peut remplacer ?
+- Composants, matériaux, personnes, processus
+- "Et si on remplaçait X par Y ?"
+
+### C - Combine (Combiner)
+Qu'est-ce qu'on peut fusionner ?
+- Fonctionnalités, idées, marchés
+- "Et si on combinait X avec Y ?"
+
+### A - Adapt (Adapter)
+Qu'est-ce qu'on peut adapter d'ailleurs ?
+- Idées d'autres domaines, solutions existantes
+- "Comment font-ils dans [autre domaine] ?"
+
+### M - Modify (Modifier)
+Qu'est-ce qu'on peut changer ?
+- Forme, couleur, taille, fréquence
+- "Et si on augmentait/réduisait X ?"
+
+### P - Put to other uses (Utiliser autrement)
+À quoi d'autre ça pourrait servir ?
+- Nouveaux contextes, nouveaux utilisateurs
+- "Qui d'autre pourrait utiliser ça ?"
+
+### E - Eliminate (Éliminer)
+Qu'est-ce qu'on peut supprimer ?
+- Simplifier, réduire, aller à l'essentiel
+- "Et si on enlevait X ?"
+
+### R - Reverse/Rearrange (Inverser/Réorganiser)
+Qu'est-ce qu'on peut inverser ou réordonner ?
+- Séquence, hiérarchie, rôles
+- "Et si on faisait l'inverse ?"
+
+## Exemple d'application
+
+**Idée initiale** : "Une app de réservation de restaurants"
+
+| Lettre | Question | Idée générée |
+|--------|----------|--------------|
+| **S** | Remplacer le restaurant ? | Réserver des chefs à domicile |
+| **C** | Combiner avec quoi ? | Réservation + covoiturage pour y aller ensemble |
+| **A** | Adapter de quel domaine ? | Système d'enchères comme les hôtels (prix dynamique) |
+| **M** | Modifier quoi ? | Réserver pour des groupes de 50+ personnes (events) |
+| **P** | Autre usage ? | Pour les entreprises qui cherchent des lieux de séminaire |
+| **E** | Éliminer quoi ? | Supprimer la réservation : file d'attente virtuelle |
+| **R** | Inverser quoi ? | Les restaurants qui "réservent" des clients fidèles |
+
+**Résultat** : 7 variations différentes de l'idée initiale, chacune pouvant être un produit différent.
+
+## Tips
+
+- Pas besoin de répondre à toutes les lettres, certaines seront plus fertiles
+- Les idées "absurdes" sont les bienvenues, elles ouvrent des pistes
+- Combiner plusieurs transformations peut donner des résultats originaux
+- Noter TOUTES les idées, même celles qui semblent mauvaises

package/skills/makit-brainstorming/techniques/six-thinking-hats.md

@@ -0,0 +1,75 @@
+# Six Thinking Hats
+
+## Description
+
+Les Six Chapeaux de la Pensée (Edward de Bono) est une technique qui force à examiner une idée sous 6 angles différents, chacun représenté par une couleur. Elle évite les débats stériles en séparant les types de pensée.
+
+## Quand l'utiliser
+
+- Tu dois prendre une décision complexe
+- Tu veux éviter de rester bloqué sur un seul point de vue
+- Tu travailles en équipe et les débats tournent en rond
+- Tu veux une analyse complète avant de te lancer
+
+## Comment ça marche
+
+Passer par chaque chapeau, un à la fois :
+
+### Chapeau Blanc - Les Faits
+- Qu'est-ce qu'on SAIT ?
+- Données, chiffres, informations vérifiables
+- Pas d'interprétation, juste les faits
+- "Quelles sont les données disponibles ?"
+
+### Chapeau Rouge - Les Émotions
+- Qu'est-ce qu'on RESSENT ?
+- Intuitions, réactions instinctives
+- Pas besoin de justifier
+- "Mon instinct me dit que..."
+
+### Chapeau Noir - Les Risques
+- Qu'est-ce qui pourrait MAL tourner ?
+- Problèmes, obstacles, dangers
+- Pensée critique et prudente
+- "Le risque ici c'est..."
+
+### Chapeau Jaune - Les Bénéfices
+- Qu'est-ce qui pourrait BIEN tourner ?
+- Avantages, opportunités, valeur
+- Optimisme constructif
+- "L'avantage serait..."
+
+### Chapeau Vert - La Créativité
+- Quelles sont les ALTERNATIVES ?
+- Nouvelles idées, solutions créatives
+- Pas de jugement, tout est permis
+- "Et si on essayait..."
+
+### Chapeau Bleu - Le Processus
+- Comment on ORGANISE tout ça ?
+- Vue d'ensemble, prochaines étapes
+- Synthèse et décision
+- "En résumé, la prochaine étape est..."
+
+## Exemple d'application
+
+**Idée** : "Lancer un service de livraison de courses en 15 minutes"
+
+| Chapeau | Analyse |
+|---------|---------|
+| **Blanc** | Marché de la livraison rapide : +30%/an. Gorillas, Flink existent. Marge moyenne : 2-5%. Besoin de dark stores. |
+| **Rouge** | Excitant mais stressant. Sentiment que c'est "trop tard". Peur de la concurrence. |
+| **Noir** | Capital énorme requis. Guerre des prix. Problèmes logistiques. Régulation possible. Rentabilité difficile. |
+| **Jaune** | Marché en croissance. Fidélisation possible. Données clients précieuses. Expansion vers B2B. |
+| **Vert** | Niche : bio uniquement ? Quartiers mal desservis ? Abonnement ? Partenariat avec commerces locaux ? |
+| **Bleu** | Décision : trop risqué en frontal. Explorer la niche "bio local" avec partenariats. Valider en 1 quartier. |
+
+**Résultat** : Une décision éclairée qui prend en compte tous les angles.
+
+## Tips
+
+- Respecter l'ordre : commencer par Blanc (faits) aide à ancrer la discussion
+- Un chapeau à la fois : ne pas mélanger
+- Le chapeau Rouge est souvent le plus révélateur
+- Le chapeau Noir n'est pas "négatif", c'est de la prudence
+- Finir par Bleu pour synthétiser et décider

package/skills/makit-brainstorming/techniques/starbursting.md

@@ -0,0 +1,115 @@
+# Starbursting
+
+## Description
+
+Le Starbursting est une technique qui explore une idée en posant systématiquement les 6 questions fondamentales : Qui, Quoi, Où, Quand, Pourquoi, Comment. Elle force à couvrir tous les angles d'un sujet.
+
+## Quand l'utiliser
+
+- Tu as une idée très vague qui a besoin d'être clarifiée
+- Tu veux t'assurer de n'avoir rien oublié
+- Tu démarres un nouveau projet et tu veux cadrer
+- Tu prépares un brief ou une présentation
+
+## Comment ça marche
+
+1. **Placer l'idée au centre**
+
+2. **Poser les 6 questions de base**
+
+3. **Pour chaque question, générer des sous-questions**
+
+4. **Répondre aux questions les plus importantes**
+
+5. **Identifier les zones d'ombre à creuser**
+
+## Les 6 branches
+
+### QUI ?
+- Qui sont les utilisateurs ?
+- Qui va construire ça ?
+- Qui sont les concurrents ?
+- Qui va payer ?
+- Qui va maintenir ?
+- Qui pourrait bloquer ?
+
+### QUOI ?
+- C'est quoi exactement ?
+- Quelles fonctionnalités ?
+- Quel problème ça résout ?
+- Quelle est la valeur ajoutée ?
+- Quelles sont les limites ?
+- Quel est le MVP ?
+
+### OÙ ?
+- Où ça sera utilisé ?
+- Où sont les utilisateurs ?
+- Où se trouve la concurrence ?
+- Où stocker les données ?
+- Où déployer ?
+- Où communiquer ?
+
+### QUAND ?
+- Quand lancer ?
+- Quand les gens l'utiliseront ?
+- Quand facturer ?
+- Quand itérer ?
+- Quand c'est trop tard ?
+- Quand mesurer le succès ?
+
+### POURQUOI ?
+- Pourquoi ce projet ?
+- Pourquoi maintenant ?
+- Pourquoi nous ?
+- Pourquoi les gens l'utiliseraient ?
+- Pourquoi paieraient-ils ?
+- Pourquoi pas une solution existante ?
+
+### COMMENT ?
+- Comment ça marche techniquement ?
+- Comment les gens vont découvrir ça ?
+- Comment monétiser ?
+- Comment mesurer le succès ?
+- Comment scale ?
+- Comment se différencier ?
+
+## Exemple d'application
+
+**Idée** : "Une plateforme de mise en relation entre freelances et entreprises"
+
+```
+                           QUI ?
+                    ┌─ Freelances (dev, design, marketing)
+                    ├─ PME qui cherchent des compétences
+                    ├─ Nous : équipe de 2 devs
+                    └─ Concurrents : Malt, Upwork, Fiverr
+
+        QUOI ?                              OÙ ?
+   ┌─ Matching intelligent           ┌─ France d'abord
+   ├─ Profils vérifiés               ├─ 100% en ligne
+   ├─ Gestion des contrats           └─ Mobile + Web
+   └─ Système de réputation
+
+            ╲           IDÉE           ╱
+             ╲                        ╱
+
+        POURQUOI ?                         QUAND ?
+   ┌─ Malt trop cher (15%)           ┌─ MVP dans 3 mois
+   ├─ Upwork trop généraliste        ├─ Usage : missions ponctuelles
+   └─ Besoin de confiance            └─ Facturation : à la mission
+
+                          COMMENT ?
+                    ┌─ Algo de matching ML
+                    ├─ Commission 5%
+                    ├─ SEO + bouche à oreille
+                    └─ Focus niche tech d'abord
+```
+
+**Résultat** : Un cadrage complet de l'idée avec les questions clés identifiées.
+
+## Tips
+
+- Pas besoin de répondre à TOUTES les questions, identifier les plus critiques
+- Les questions sans réponse = ce qu'il faut creuser
+- Utiliser cette technique AVANT de commencer à construire
+- Revenir sur le Starbursting quand on se sent perdu

package/skills/makit-brainstorming/techniques/swot.md

@@ -0,0 +1,100 @@
+# SWOT Analysis
+
+## Description
+
+SWOT est un acronyme pour Strengths (Forces), Weaknesses (Faiblesses), Opportunities (Opportunités), Threats (Menaces). C'est un outil d'analyse stratégique qui évalue une idée selon 4 dimensions : 2 internes (forces/faiblesses) et 2 externes (opportunités/menaces).
+
+## Quand l'utiliser
+
+- Tu veux évaluer la viabilité d'une idée
+- Tu dois décider entre plusieurs options
+- Tu prépares un pitch ou une présentation
+- Tu veux identifier où concentrer tes efforts
+
+## Comment ça marche
+
+1. **Définir clairement le sujet de l'analyse**
+
+2. **Remplir les 4 quadrants**
+
+3. **Identifier les patterns et les actions**
+
+4. **Prioriser**
+
+## La matrice SWOT
+
+```
+            │  POSITIF          │  NÉGATIF
+────────────┼───────────────────┼───────────────────
+            │                   │
+  INTERNE   │   STRENGTHS       │   WEAKNESSES
+  (nous)    │   Forces          │   Faiblesses
+            │   Ce qu'on fait   │   Ce qui nous
+            │   bien            │   manque
+            │                   │
+────────────┼───────────────────┼───────────────────
+            │                   │
+  EXTERNE   │   OPPORTUNITIES   │   THREATS
+  (marché)  │   Opportunités    │   Menaces
+            │   Ce qu'on peut   │   Ce qui peut
+            │   exploiter       │   nous nuire
+            │                   │
+```
+
+## Questions pour chaque quadrant
+
+### Forces (Strengths)
+- Qu'est-ce qu'on fait mieux que les autres ?
+- Quelles ressources uniques on a ?
+- Quelle expertise on possède ?
+- Quel avantage concurrentiel ?
+
+### Faiblesses (Weaknesses)
+- Qu'est-ce qui nous manque ?
+- Où sont nos lacunes ?
+- Qu'est-ce que les concurrents font mieux ?
+- Quelles ressources sont limitées ?
+
+### Opportunités (Opportunities)
+- Quelles tendances de marché favorables ?
+- Quels besoins non satisfaits ?
+- Quels changements technologiques/réglementaires ?
+- Quels partenariats possibles ?
+
+### Menaces (Threats)
+- Qui sont les concurrents ?
+- Quels obstacles externes ?
+- Quels risques de marché ?
+- Quelles évolutions défavorables ?
+
+## Exemple d'application
+
+**Idée** : "Lancer une app de coaching sportif personnalisé par IA"
+
+| FORCES | FAIBLESSES |
+|--------|------------|
+| Équipe tech solide en ML | Pas d'expertise sport/santé |
+| Coûts bas (full remote) | Pas de notoriété |
+| Rapidité d'exécution | Budget marketing limité |
+| Expérience en apps mobiles | Pas de contenu existant |
+
+| OPPORTUNITÉS | MENACES |
+|--------------|---------|
+| Boom du fitness post-COVID | Concurrence féroce (Nike, Freeletics) |
+| Démocratisation de l'IA | Régulation santé potentielle |
+| Wearables en croissance | Fatigue des apps fitness |
+| B2B : entreprises wellness | Dépendance aux stores (Apple, Google) |
+
+**Actions dérivées** :
+- **Force + Opportunité** : Utiliser l'expertise ML pour créer un coaching vraiment personnalisé via wearables
+- **Force + Menace** : Rapidité d'exécution pour se différencier avant saturation
+- **Faiblesse + Opportunité** : Partenariat avec coachs pour le contenu (pas besoin d'expertise interne)
+- **Faiblesse + Menace** : Éviter le B2C frontal, viser le B2B d'abord (moins de marketing)
+
+## Tips
+
+- Être honnête sur les faiblesses, c'est là que sont les vrais risques
+- Les opportunités et menaces sont souvent les deux faces d'une même tendance
+- Croiser les quadrants pour générer des stratégies
+- Revisiter le SWOT régulièrement, il évolue
+- Ne pas avoir peur d'un SWOT "déséquilibré" - il révèle où agir

package/skills/makit-writing/SKILL.md

@@ -0,0 +1,165 @@
+---
+name: makit-writing
+description: "Guidelines de style pour la rédaction de documents markdown"
+---
+
+# Skill: Writing
+
+Ce skill fournit des guidelines de style pour la rédaction de documents markdown cohérents et professionnels.
+
+## Principes généraux
+
+### Clarté avant tout
+- Une idée par phrase
+- Un sujet par paragraphe
+- Éviter le jargon inutile
+- Préférer les mots simples aux mots complexes
+
+### Structure hiérarchique
+- Utiliser les niveaux de titres (`#`, `##`, `###`) de manière logique
+- Ne pas sauter de niveau (pas de `###` après `#`)
+- Maximum 3-4 niveaux de profondeur
+
+### Concision
+- Aller droit au but
+- Supprimer les mots inutiles
+- "En raison du fait que" → "Parce que"
+- "Dans le but de" → "Pour"
+
+## Formatage markdown
+
+### Titres
+```markdown
+# Titre principal (un seul par document)
+
+## Section majeure
+
+### Sous-section
+
+#### Détail (utiliser avec parcimonie)
+```
+
+### Listes
+- Utiliser `-` pour les listes non ordonnées
+- Utiliser `1.` pour les listes ordonnées
+- Indenter avec 2 espaces pour les sous-listes
+
+```markdown
+- Premier item
+  - Sous-item
+  - Autre sous-item
+- Deuxième item
+
+1. Étape 1
+2. Étape 2
+3. Étape 3
+```
+
+### Emphase
+- **Gras** pour les concepts importants
+- *Italique* pour les termes techniques ou citations
+- `Code inline` pour les commandes, noms de fichiers, variables
+
+### Code blocks
+Toujours spécifier le langage :
+
+```markdown
+```javascript
+const example = "Hello";
+```
+```
+
+### Tableaux
+Pour les comparaisons et données structurées :
+
+```markdown
+| Colonne 1 | Colonne 2 |
+|-----------|-----------|
+| Valeur 1  | Valeur 2  |
+```
+
+### Citations
+Pour les insights ou références importantes :
+
+```markdown
+> Citation importante ou insight clé
+```
+
+## Style de rédaction
+
+### Ton
+- **Professionnel** : pas de familiarité excessive
+- **Direct** : pas de formules alambiquées
+- **Actionnable** : le lecteur sait quoi faire après avoir lu
+
+### Voix active vs passive
+- Préférer la voix active : "L'utilisateur clique" vs "Le bouton est cliqué"
+- La voix passive est acceptable pour les descriptions techniques
+
+### Formulations à éviter
+| Éviter | Préférer |
+|--------|----------|
+| "Il est important de noter que..." | Aller directement au point |
+| "Comme mentionné précédemment..." | Répéter l'info si nécessaire |
+| "En conclusion..." | Conclure directement |
+| "Etc." | Lister explicitement ou utiliser "..." |
+
+## Structure des documents
+
+### Brief (`.makit/brief.md`)
+```markdown
+# Brief : [Nom]
+
+## L'idée en une phrase
+[Max 2 lignes]
+
+## Contexte
+[Pourquoi ce projet ?]
+
+## Objectifs
+- [Objectif mesurable 1]
+- [Objectif mesurable 2]
+
+## Utilisateurs cibles
+[Qui et pourquoi]
+
+## Contraintes connues
+- [Contrainte 1]
+- [Contrainte 2]
+
+## Questions ouvertes
+- [Question 1]
+- [Question 2]
+```
+
+### Documentation technique
+```markdown
+# [Nom du composant/feature]
+
+## Description
+[Quoi et pourquoi]
+
+## Usage
+[Comment l'utiliser avec exemples]
+
+## API / Interface
+[Détails techniques]
+
+## Exemples
+[Code exemples]
+
+## Notes
+[Cas particuliers, limitations]
+```
+
+## Checklist de qualité
+
+Avant de finaliser un document :
+
+- [ ] Le titre reflète le contenu
+- [ ] La structure est logique et progressive
+- [ ] Pas de fautes d'orthographe/grammaire
+- [ ] Les listes sont cohérentes (même format)
+- [ ] Le code est correctement formaté
+- [ ] Les liens fonctionnent
+- [ ] Le document est actionnable (le lecteur sait quoi faire)