@codigodoleo/wp-kit 3.0.1 → 3.1.0

package/lib/commands/init.js

@@ -9,6 +9,7 @@ import { Generator } from '../core/generator.js';
 import { log, color } from '../utils/logger.js';
 import { inferCiCapabilities } from '../core/infer-ci-capabilities.js';
 import { validateVersionCompatibility } from '../config/versions.js';
+import { installSuperpowersSage } from '../utils/git.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -150,5 +151,11 @@ export const initCommand = new Command('init')
     log(color.blue, '🔗 Executing post-setup hooks...');
     generator.hooks.doAction('after_setup_complete', context, generator);
 
+    // Gera CLAUDE.md com overview do projeto e referência ao AI Co-Pilot
+    await generator.generateFile('CLAUDE.md', context);
+
+    // Instala superpowers-sage em .claude/ do projeto gerado
+    await installSuperpowersSage(target);
+
     log(color.green, '✅ Project initialized with templates.');
   });

package/lib/utils/git.js

@@ -1,4 +1,10 @@
-import { execSync } from 'child_process';
+import { execSync, spawnSync } from 'child_process';
+import os from 'os';
+import path from 'path';
+
+import fs from 'fs-extra';
+
+import { log, color } from './logger.js';
 
 export function getGitUserDefaults() {
   const exec = (cmd) => {
@@ -15,3 +21,39 @@ export function getGitUserDefaults() {
     gitRepository: exec('git config --get remote.origin.url') || '',
   };
 }
+
+/**
+ * Clona codigodoleo/superpowers-sage e copia seu conteúdo para <targetDir>/.claude
+ * Requer git instalado no host.
+ * @param {string} targetDir - Caminho absoluto do projeto gerado
+ */
+export async function installSuperpowersSage(targetDir) {
+  const repo = 'https://github.com/codigodoleo/superpowers-sage.git';
+  const tmpDir = path.join(os.tmpdir(), `superpowers-sage-${Date.now()}`);
+  const claudeDir = path.join(targetDir, '.claude');
+
+  log(color.blue, '🔌 Installing superpowers-sage...');
+
+  const result = spawnSync('git', ['clone', '--depth=1', repo, tmpDir], {
+    stdio: 'inherit',
+  });
+
+  if (result.status !== 0) {
+    log(
+      color.orange,
+      '⚠️  Could not clone superpowers-sage (no network or git unavailable). Skipping.'
+    );
+    return;
+  }
+
+  // Copia o conteúdo completo do clone (exceto .git) para .claude do projeto
+  await fs.ensureDir(claudeDir);
+  await fs.copy(tmpDir, claudeDir, {
+    overwrite: true,
+    filter: (src) => !src.includes(`${path.sep}.git`),
+  });
+
+  await fs.remove(tmpDir);
+
+  log(color.green, '✅ superpowers-sage installed at .claude/');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codigodoleo/wp-kit",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "Kit opinativo para padronizar projetos WordPress com CI/CD dinâmico.",
   "main": "bin/index.js",
   "bin": {

package/templates/CLAUDE.md.hbs

@@ -0,0 +1,28 @@
+#
+{{projectName}}
+
+> WordPress project scaffolded by [wp-kit](https://github.com/codigodoleo/wp-kit), using the
+[Roots](https://roots.io/) ecosystem: Bedrock, Sage, Acorn, and Lando. ## Stack - PHP
+{{phpVersion}}
+- Node.js
+{{nodeVersion}}
+- WordPress
+{{wpCoreVersion}}
+{{#if useSage}}- Sage
+  {{sageVersion}}
+  + Acorn
+{{/if}}- Lando (local development) ## Local Development ```bash lando start lando vite # HMR dev
+server lando vite-build # Production build ``` ## AI Co-Pilot This project includes
+[superpowers-sage](https://github.com/codigodoleo/superpowers-sage) skills in `.claude/`. Start a
+session with: ``` /sage-onboard ``` Available commands: | Command | Purpose | |---|---| |
+`/sage-onboard` | Project analysis and overview | | `/sage-plan` | Architecture decision for a new
+feature | | `/sage-scaffold` | Run generators and create stubs | | `/sage-review` | Review code
+against conventions | | `/sage-debug` | Guided troubleshooting | ## Theme
+
+{{#if useSage}}
+  Theme located at `content/themes/{{themeName}}/`. ```bash lando theme-composer require
+  vendor/package lando theme-yarn add package-name lando acorn make:component ComponentName lando
+  acorn acf:block BlockName ```
+{{else}}
+  No Sage theme configured.
+{{/if}}