create-claudy 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gilles Bertrand
+
+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,79 @@
+# create-claudy
+
+Scaffolder qui crée un projet Claude Code préconfiguré pour utiliser le plugin [`claudy`](https://github.com/gilles-bertrand/claudy-plugin).
+
+## Usage
+
+```bash
+# Avec pnpm (recommandé)
+pnpm create claudy mon-projet
+
+# Avec npm
+npm create claudy@latest mon-projet
+
+# Avec npx
+npx create-claudy mon-projet
+```
+
+Si vous omettez le nom, il vous sera demandé.
+
+## Options
+
+| Flag | Effet |
+|------|-------|
+| `--no-git` | Ne pas initialiser de dépôt git |
+| `-h`, `--help` | Aide |
+
+## Ce qu'il génère
+
+```
+mon-projet/
+├── .claude/
+│   ├── settings.json       # pré-configuré pour activer le plugin claudy
+│   ├── CLAUDE.md           # mémoire projet (à personnaliser)
+│   ├── commands/           # vos commandes locales
+│   └── agents/             # vos agents locaux
+├── .env.example
+├── .gitignore
+├── .mcp.json               # Playwright préconfiguré
+├── ai_docs/                # doc API consultée par les agents
+├── docs/                   # documentation projet
+├── specs/
+│   ├── todo/               # plans en attente
+│   ├── done/               # plans terminés
+│   └── handoffs/           # états de session
+├── src/                    # code applicatif
+└── README.md
+```
+
+## Ce que fait le plugin claudy
+
+Une fois Claude Code lancé dans le nouveau projet, le plugin est activé automatiquement et fournit :
+
+- **Commandes** : `/TPK-plan`, `/TPK-build`, `/TPK-validate`, `/TPK-commit`, `/TPK-merge`, `/TPK-review`, `/TPK-prime`, `/TPK-handoff`, `/TPK-pickup`, `/TPK-create-command`, `/TPK-parallel-subagents`, `/TPK-visual-verify`, `/TPK-screenshot-compare`
+- **Agents** : `code-reviewer`, `test-runner`, `doc-generator`, `validated-builder`
+- **Skills** : `security-audit`, `skill-creator`
+- **Hooks de sécurité** actifs par défaut (bloquent `rm -rf`, force push, et protègent `.env`, `~/.ssh/`, `~/.aws/`…)
+
+Voir le [repo du plugin](https://github.com/gilles-bertrand/claudy-plugin) pour les détails.
+
+## Mise à jour du scaffolder
+
+```bash
+# Avec pnpm
+pnpm dlx create-claudy@latest ...
+
+# Avec npm
+npm create claudy@latest ...
+```
+
+Le scaffolder est un outil one-shot : il génère le projet puis disparaît. Les mises à jour du projet lui-même (commandes/agents/hooks) passent par le plugin `claudy` via `/plugin update`.
+
+## Prérequis
+
+- Node.js ≥ 18
+- [Claude Code](https://claude.com/claude-code) installé (pour utiliser les projets générés)
+
+## Licence
+
+MIT © Gilles Bertrand

package/index.mjs

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+/**
+ * create-claudy — scaffolder pour un projet Claude Code préconfiguré
+ * avec le plugin `claudy`.
+ *
+ * Usage :
+ *   pnpm create claudy [project-name]
+ *   npm create claudy@latest [project-name]
+ *   npx create-claudy [project-name]
+ */
+
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output, exit } from "node:process";
+import { execFileSync } from "node:child_process";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATE_DIR = join(__dirname, "template");
+
+// --- Terminal helpers ---------------------------------------------------
+const c = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  red: "\x1b[31m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  blue: "\x1b[34m",
+  cyan: "\x1b[36m",
+};
+
+const log = (msg) => console.log(msg);
+const info = (msg) => console.log(`${c.cyan}›${c.reset} ${msg}`);
+const success = (msg) => console.log(`${c.green}✓${c.reset} ${msg}`);
+const warn = (msg) => console.log(`${c.yellow}⚠${c.reset} ${msg}`);
+const error = (msg) => console.error(`${c.red}✗${c.reset} ${msg}`);
+
+// --- Args ---------------------------------------------------------------
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  let projectName = null;
+  let skipGit = false;
+  let help = false;
+
+  for (const arg of args) {
+    if (arg === "--help" || arg === "-h") help = true;
+    else if (arg === "--no-git") skipGit = true;
+    else if (!arg.startsWith("-") && !projectName) projectName = arg;
+  }
+
+  return { projectName, skipGit, help };
+}
+
+function printHelp() {
+  log(`
+${c.bold}create-claudy${c.reset} — scaffolder pour un projet Claude Code préconfiguré
+
+${c.bold}Usage${c.reset}
+  pnpm create claudy [project-name] [options]
+  npm create claudy@latest [project-name] [options]
+  npx create-claudy [project-name] [options]
+
+${c.bold}Options${c.reset}
+  --no-git       Ne pas initialiser de dépôt git
+  -h, --help     Affiche cette aide
+
+${c.bold}Example${c.reset}
+  pnpm create claudy mon-super-projet
+`);
+}
+
+// --- Validation ---------------------------------------------------------
+function isValidProjectName(name) {
+  return /^[a-z0-9][a-z0-9-_]*$/i.test(name);
+}
+
+async function promptProjectName() {
+  const rl = createInterface({ input, output });
+  try {
+    while (true) {
+      const answer = (await rl.question(`${c.cyan}?${c.reset} Nom du projet : `)).trim();
+      if (!answer) {
+        warn("Nom requis.");
+        continue;
+      }
+      if (!isValidProjectName(answer)) {
+        warn("Caractères autorisés : lettres, chiffres, tirets, underscores. Pas d'espaces.");
+        continue;
+      }
+      return answer;
+    }
+  } finally {
+    rl.close();
+  }
+}
+
+async function confirmOverwrite(targetDir) {
+  const rl = createInterface({ input, output });
+  try {
+    const answer = (await rl.question(
+      `${c.yellow}?${c.reset} Le dossier ${c.bold}${targetDir}${c.reset} existe déjà et n'est pas vide. Continuer quand même (fusion) ? [y/N] `
+    )).trim().toLowerCase();
+    return answer === "y" || answer === "yes" || answer === "o" || answer === "oui";
+  } finally {
+    rl.close();
+  }
+}
+
+// --- File helpers -------------------------------------------------------
+function isDirEmpty(dir) {
+  try {
+    return readdirSync(dir).length === 0;
+  } catch {
+    return true;
+  }
+}
+
+function substituteInFile(filePath, replacements) {
+  const content = readFileSync(filePath, "utf8");
+  let out = content;
+  for (const [key, value] of Object.entries(replacements)) {
+    out = out.replaceAll(`{{${key}}}`, value);
+  }
+  if (out !== content) writeFileSync(filePath, out, "utf8");
+}
+
+function walkFiles(dir, callback) {
+  for (const entry of readdirSync(dir)) {
+    const full = join(dir, entry);
+    const stat = statSync(full);
+    if (stat.isDirectory()) walkFiles(full, callback);
+    else callback(full);
+  }
+}
+
+// --- Steps --------------------------------------------------------------
+function copyTemplate(targetDir) {
+  cpSync(TEMPLATE_DIR, targetDir, { recursive: true });
+}
+
+function renameHiddenFiles(targetDir) {
+  // env-example.tmp → .env.example
+  // (contournement : les hooks de sécurité Claude Code empêchent de créer
+  // directement un fichier dont le chemin matche `.env.*` lors de la
+  // publication du template.)
+  const tmp = join(targetDir, "env-example.tmp");
+  const final = join(targetDir, ".env.example");
+  if (existsSync(tmp)) renameSync(tmp, final);
+}
+
+function applySubstitutions(targetDir, replacements) {
+  walkFiles(targetDir, (filePath) => {
+    if (/\.(md|json|txt|mjs|js|ts|yaml|yml|gitignore|example)$/i.test(filePath)) {
+      substituteInFile(filePath, replacements);
+    }
+  });
+}
+
+function runGit(targetDir, args) {
+  execFileSync("git", args, { cwd: targetDir, stdio: "ignore" });
+}
+
+function initGitRepo(targetDir) {
+  try {
+    runGit(targetDir, ["init", "-q", "-b", "main"]);
+    runGit(targetDir, ["add", "."]);
+    runGit(targetDir, [
+      "commit",
+      "-q",
+      "-m",
+      "chore: initial commit from create-claudy",
+    ]);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// --- Main ---------------------------------------------------------------
+async function main() {
+  const { projectName: argName, skipGit, help } = parseArgs(process.argv);
+
+  if (help) {
+    printHelp();
+    return;
+  }
+
+  log(`\n${c.bold}${c.cyan}claudy${c.reset} ${c.dim}— scaffolder Claude Code${c.reset}\n`);
+
+  let projectName = argName;
+  if (!projectName) {
+    projectName = await promptProjectName();
+  } else if (!isValidProjectName(projectName)) {
+    error(`Nom de projet invalide : ${projectName}`);
+    warn("Caractères autorisés : lettres, chiffres, tirets, underscores.");
+    exit(1);
+  }
+
+  const targetDir = resolve(process.cwd(), projectName);
+
+  if (existsSync(targetDir) && !isDirEmpty(targetDir)) {
+    const ok = await confirmOverwrite(targetDir);
+    if (!ok) {
+      warn("Abandon.");
+      exit(0);
+    }
+  }
+
+  info(`Création du projet dans ${c.bold}${targetDir}${c.reset}`);
+  mkdirSync(targetDir, { recursive: true });
+
+  info("Copie du template...");
+  copyTemplate(targetDir);
+
+  info("Renommage des fichiers spéciaux...");
+  renameHiddenFiles(targetDir);
+
+  info("Substitution des placeholders...");
+  applySubstitutions(targetDir, {
+    PROJECT_NAME: projectName,
+  });
+
+  if (!skipGit) {
+    info("Initialisation du dépôt git...");
+    const gitOk = initGitRepo(targetDir);
+    if (gitOk) success("Dépôt git initialisé avec un commit initial");
+    else warn("git n'a pas pu être initialisé (git installé ?)");
+  }
+
+  log(`\n${c.green}${c.bold}✨ Projet ${projectName} créé avec succès !${c.reset}\n`);
+  log(`${c.bold}Étapes suivantes :${c.reset}`);
+  log(`  ${c.cyan}cd${c.reset} ${projectName}`);
+  log(`  ${c.cyan}cp${c.reset} .env.example .env  ${c.dim}# puis remplissez vos clés${c.reset}`);
+  log(`  ${c.cyan}claude${c.reset}                 ${c.dim}# lance Claude Code${c.reset}`);
+  log(`\n${c.dim}Au premier lancement, Claude Code installera automatiquement le plugin${c.reset}`);
+  log(`${c.dim}claudy depuis gilles-bertrand/claudy-marketplace.${c.reset}\n`);
+}
+
+main().catch((err) => {
+  error(err?.message ?? String(err));
+  exit(1);
+});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "create-claudy",
+  "version": "0.1.0",
+  "description": "Scaffolder pour créer un projet préconfiguré avec le plugin Claude Code claudy",
+  "type": "module",
+  "bin": {
+    "create-claudy": "./index.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "template/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "claude-code",
+    "scaffolder",
+    "create",
+    "template",
+    "claudy"
+  ],
+  "author": {
+    "name": "Gilles Bertrand",
+    "url": "https://github.com/gilles-bertrand"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/gilles-bertrand/create-claudy",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gilles-bertrand/create-claudy.git"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/template/.claude/CLAUDE.md

@@ -0,0 +1,32 @@
+# {{PROJECT_NAME}}
+
+Description courte du projet.
+
+## Quick Reference
+
+- Code applicatif : `src/`
+- Plans : `specs/todo/` → `specs/done/`
+- Documentation : `docs/`
+- Doc API pour agents : `ai_docs/`
+
+## Commandes
+
+- Test : `npm test`
+- Build : `npm run build`
+- Dev : `npm run dev`
+
+## Plugin Claude Code
+
+Ce projet utilise le plugin [`claudy`](https://github.com/gilles-bertrand/claudy-plugin) qui fournit :
+
+- Commandes `/TPK-*` (plan, build, validate, commit, merge, review, etc.)
+- Sub-agents (`code-reviewer`, `test-runner`, `doc-generator`, `validated-builder`)
+- Skills (`security-audit`, `skill-creator`)
+- Hooks de sécurité actifs par défaut (damage-control)
+
+Les commandes locales au projet vont dans `.claude/commands/` et les agents locaux dans `.claude/agents/`.
+
+## Notes importantes
+
+- Garder ce fichier sous 500 tokens
+- Contexte spécifique à une feature : dans les prompts ou `specs/`

package/template/.claude/settings.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "marketplaces": {
+    "claudy-marketplace": {
+      "source": "github",
+      "repo": "gilles-bertrand/claudy-marketplace"
+    }
+  },
+  "plugins": {
+    "claudy@claudy-marketplace": {
+      "enabled": true
+    }
+  },
+  "permissions": {
+    "allow": [
+      "Read",
+      "Glob",
+      "Grep",
+      "Bash(git status)",
+      "Bash(git diff *)",
+      "Bash(git log *)",
+      "Bash(npm *)",
+      "Bash(npx *)",
+      "Bash(pnpm *)"
+    ],
+    "deny": [
+      "Bash(rm -rf *)",
+      "Bash(sudo *)",
+      "Bash(chmod 777 *)",
+      "Read(.env)"
+    ]
+  }
+}

package/template/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["@playwright/mcp@latest"]
+    }
+  }
+}

package/template/README.md

@@ -0,0 +1,65 @@
+# {{PROJECT_NAME}}
+
+Description de votre projet.
+
+## Prérequis
+
+- [Claude Code](https://claude.com/claude-code) installé
+- Node.js 18+
+
+## Démarrage
+
+```bash
+# Installer les dépendances
+npm install
+
+# Configurer l'environnement
+cp .env.example .env
+# Complétez .env avec vos clés
+
+# Lancer Claude Code
+claude
+```
+
+Au premier lancement, Claude Code détectera le plugin `claudy` référencé dans `.claude/settings.json` et vous proposera de l'installer. Acceptez pour récupérer toutes les commandes `/TPK-*`, agents et hooks de sécurité.
+
+## Structure
+
+```
+.
+├── .claude/              # Config Claude Code (settings + CLAUDE.md + extensions locales)
+├── src/                  # Code applicatif
+├── specs/
+│   ├── todo/             # Plans en attente
+│   ├── done/             # Plans terminés
+│   └── handoffs/         # États de session
+├── docs/                 # Documentation projet
+└── ai_docs/              # Doc API consultée par les agents
+```
+
+## Workflow avec Claude Code
+
+```
+PLANIFIER → CONSTRUIRE → VALIDER → VÉRIFIER → COMMITTER
+```
+
+1. `/TPK-plan "ce que je veux faire"` — crée une spec dans `specs/todo/`
+2. `/TPK-build specs/todo/ma-spec.md` — implémente
+3. `/TPK-validate` — lance les tests
+4. `/TPK-review` — compare à la spec
+5. `/TPK-commit` — crée le commit
+
+## Plugin utilisé
+
+Ce projet utilise [`claudy`](https://github.com/gilles-bertrand/claudy-plugin).
+
+Pour mettre à jour le plugin :
+
+```bash
+/plugin marketplace update claudy-marketplace
+/plugin update claudy@claudy-marketplace
+```
+
+## Licence
+
+À compléter.

package/template/env-example.tmp

@@ -0,0 +1,17 @@
+# ===========================================
+# Variables d'environnement du projet
+# ===========================================
+# Copiez ce fichier en .env et complétez.
+# Ne committez JAMAIS .env dans git.
+# ===========================================
+
+# --- IA ---
+# ANTHROPIC_API_KEY=
+# GOOGLE_API_KEY=
+# OPENAI_API_KEY=
+
+# --- GitHub ---
+# GITHUB_TOKEN=
+
+# --- Base de données ---
+# DATABASE_URL=