malikkaraoui/atelier-setup

Atelier Setup

Tu guides l'utilisateur dans la configuration complète de son atelier. Checklist interactive — chaque point est vérifié puis coché.

Checklist

Vérifie chaque point dans l'ordre. Pour chaque point :

• Si OK → affiche [✅] et passe au suivant
• Si KO → affiche [❌] avec les instructions pour corriger, attends que l'utilisateur confirme avant de continuer

1. Fichiers de base

[?] .claude/CLAUDE.md installé et ≤ 150 lignes
[?] .claude/settings.json avec permissions Bash(*) + deny list
[?] .claudeignore à la racine
[?] .gitignore à la racine
[?] scripts/pre-push-gate.sh installé et exécutable

Si un fichier manque → proposer npx claude-atelier init ou node bin/cli.js init si dans le repo source.

2. Contexte projet (§0)

Lire .claude/CLAUDE.md et vérifier que §0 est rempli :

[?] Projet courant ≠ "—"
[?] Stack définie
[?] Repo défini

Si §0 est partiellement ou totalement vide → auto-découvrir :

Nom du projet :

cat package.json 2>/dev/null | python3 -c "import sys,json; print(json.load(sys.stdin).get('name',''))" 2>/dev/null || basename "$(git rev-parse --show-toplevel 2>/dev/null || pwd)"

Stack (en parallèle) — détecte la présence de :

• go.mod → Go
• package.json → Node.js / JavaScript
• Cargo.toml → Rust
• pyproject.toml ou requirements.txt → Python
• *.swift → iOS
• pom.xml ou build.gradle → Java

detect_stack() {
  for f in go.mod package.json Cargo.toml pyproject.toml requirements.txt pom.xml build.gradle; do
    [ -f "$f" ] && case "$f" in
      go.mod) echo "Go"; return;;
      package.json) echo "Node.js"; return;;
      Cargo.toml) echo "Rust"; return;;
      pyproject.toml|requirements.txt) echo "Python"; return;;
      pom.xml|build.gradle) echo "Java"; return;;
    esac
  done
  compgen -G "*.swift" > /dev/null 2>&1 && echo "iOS" && return
  echo ""
}
detect_stack

Repo GitHub :

git remote get-url origin 2>/dev/null

QMD enrichment (optionnel) — si .qmd/ existe ou qmd status fonctionne :

qmd query --searches '[{"type":"lex","query":"project stack technology"}]' 2>/dev/null || true

Affichage et validation :

Afficher les résultats avec [AUTO] :

[AUTO] Projet : {nom}
[AUTO] Stack : {stack}
[AUTO] Repo : {url}

Demander : "Valide ou corrige les découvertes avant que je les écrive dans §0. Tape [OK] pour valider, ou corrige et tape [OK]."

Attendre réponse, puis éditer §0 avec les valeurs validées.

Champs manquants : Seulement si un champ reste vide après tout ça → demander ce seul champ : "Le champ {nom} reste vide. Donne-moi la valeur :"

3. Pouls Peter — agent mainteneur vault

[?] vault/.peter/state.json présent (Peter actif)

Vérifier :

[ -f vault/.peter/state.json ] && echo "ACTIF" || echo "ABSENT"

Si absent → proposer : "Lance claude-atelier vault update pour initialiser Peter. Il tiendra le vault à jour en autonomie via son pouls (CronCreate)."

Le Night Watchdog manuel (Claude desktop → tâche planifiée) est remplacé par le Pouls Peter — cycle autonome géré par CronCreate, session-independent.

4. Séréna — Design Senior + MCP magic (optionnel)

[ ] Skill design-senior installé
[ ] MCP magic (21st.dev) configuré

Vérifier :

ls .claude/skills/design-senior/ 2>/dev/null && echo "OK" || echo "MISSING"
grep -q "magic" ~/.claude.json 2>/dev/null || grep -q "magic" .mcp.json 2>/dev/null && echo "OK" || echo "MISSING"

Si skill absent → il sera copié au prochain npx claude-atelier init.

Si MCP magic absent → proposer :

"Séréna est la chef designer senior de l'atelier. Elle s'active automatiquement quand tu parles design, UI/UX, charte.

Pour les composants UI premium, elle utilise le MCP magic (21st.dev). L'installation est gratuite, l'utilisation nécessite une clé API (free tier = 100 uses).

Installation rapide (scope user, tous les projets) :

claude mcp add magic --scope user --env API_KEY=\"ta-clé\" -- npx -y @21st-dev/magic@latest

1. Créer un compte : https://21st.dev
2. Générer une clé : https://21st.dev/agents/api-keys
3. Lancer la commande ci-dessus avec ta clé

[OUI] Installer magic | [SKIP] Continuer sans"

5. BMAD-METHOD (optionnel)

[ ] BMAD-METHOD pour les gros projets

"Ce projet est-il un gros projet nécessitant un cycle complet analyse → plan → architecture → implémentation ?

BMAD-METHOD fournit 6 agents spécialisés (analyste, PM, architecte, dev, UX, tech writer) et un workflow structuré en 4 phases.

⚠️ C'est une méthodologie conséquente. Pour un petit projet ou un script, ce n'est pas nécessaire.

[OUI] Installer BMAD | [NON] Continuer sans"

Si oui → npx bmad-method install dans le projet.

6. QMD (optionnel, conditionnel)

Compter les fichiers .md dans le projet : find . -name '*.md' -not -path './.git/*' -not -path './node_modules/*' | wc -l

Si < 5 → ne pas proposer, passer. Si ≥ 5 → proposer :

"Tu as [N] fichiers markdown dans ce projet. QMD peut les indexer pour retrouver du contexte rapidement (plans, bugs, reviews).

[OUI] Installer QMD | [NON] Pas maintenant"

Si oui → guider l'installation de QMD (voir src/fr/ecosystem/qmd-integration.md).

7. Résumé

Afficher le résumé final :

╔══════════════════════════════════════════════════╗
║  🔧 Atelier configuré !                          ║
╠══════════════════════════════════════════════════╣
║  [✅] Config de base (5/5)                       ║
║  [✅] Contexte projet §0 rempli                  ║
║  [✅] Pouls Peter actif (vault autonome)         ║
║  [✅] Séréna + MCP magic configurés             ║
║  [—]  BMAD : non installé (petit projet)        ║
║  [—]  QMD : non installé (< 5 fichiers .md)     ║
╠══════════════════════════════════════════════════╣
║  Tape /atelier-help pour voir les commandes.    ║
╚══════════════════════════════════════════════════╝

Règles

• Toujours vérifier avant de corriger
• Ne jamais forcer une installation (proposer, pas imposer)
• BMAD et QMD sont optionnels — ne pas insister
• Respecter les choix de l'utilisateur (SKIP est valide)