@meltstudio/meltctl 4.10.0 → 4.12.0

package/README.md

@@ -43,7 +43,7 @@ meltctl version --check
 
 ## Requirements
 
-- Node.js 22+
+- Node.js 20+
 - `@meltstudio.co` Google Workspace account
 
 ## License

package/dist/commands/init.js

@@ -7,43 +7,83 @@ import { fetchTemplates } from '../utils/templates.js';
 const SKILL_FRONTMATTER = {
     setup: `---
 user-invocable: true
-description: Analyze the project and customize AGENTS.md for this codebase
+description: >-
+  Analyze the project and customize AGENTS.md for this codebase.
+  Use when setting up a new project, after running meltctl init,
+  or when AGENTS.md has placeholder markers. Detects tech stack,
+  fills in project-specific sections, and merges existing standards.
 ---
 
 `,
     plan: `---
 user-invocable: true
-description: Design an implementation approach before writing code
+description: >-
+  Design an implementation approach before writing code. Use when
+  starting a feature, tackling a complex task, or when the developer
+  says "plan this" or "how should we approach this". Gathers requirements,
+  explores codebase, and presents a step-by-step plan for approval.
 ---
 
 `,
     review: `---
 user-invocable: true
-description: Review changes against project standards
+description: >-
+  Review code changes against project standards and address PR feedback.
+  Use when the developer asks to review changes, check code quality,
+  or respond to PR reviewer comments. Categorizes findings as must-fix,
+  should-fix, or suggestions.
 ---
 
 `,
     pr: `---
 user-invocable: true
-description: Create a well-structured pull request
+description: >-
+  Create a well-structured pull request from current changes. Use when
+  the developer is ready to submit work, says "create a PR", or "open
+  a pull request". Analyzes changes, runs pre-flight checks, drafts
+  description, and creates the PR via gh CLI.
 ---
 
 `,
     debug: `---
 user-invocable: true
-description: Systematically investigate and fix bugs
+description: >-
+  Systematically investigate and fix bugs. Use when the developer
+  reports a bug, encounters an error, or says "debug this" or "why
+  is this failing". Reproduces the issue, isolates root cause, writes
+  regression test, and implements minimal fix.
 ---
 
 `,
     audit: `---
 user-invocable: true
-description: Run a project compliance audit against team standards
+description: >-
+  Run a comprehensive project compliance audit against team standards.
+  Use when the developer wants to assess project health, check compliance,
+  or says "audit this project". Checks 15 categories including documentation,
+  testing, CI/CD, security, and AI tool setup. Produces a structured
+  report with scores and actionable fixes.
+---
+
+`,
+    validate: `---
+user-invocable: true
+description: >-
+  Run the validation plan from the plan document after implementation.
+  Use when the developer says "validate this", "test the feature", or
+  after finishing implementation. Validates end-to-end using browser,
+  API, or CLI testing, suggests test coverage improvements, then prompts
+  the developer for mandatory manual sign-off.
 ---
 
 `,
     update: `---
 user-invocable: true
-description: Update Melt skills and standards to the latest version
+description: >-
+  Update Melt skills and standards to the latest version. Use when the
+  developer wants the latest skill templates, says "update melt", or
+  after a new meltctl version is released. Fetches latest templates,
+  preserves project customizations in AGENTS.md, and merges changes.
 ---
 
 `,
@@ -146,7 +186,7 @@ export async function initCommand(options) {
     console.log(chalk.bold('Initializing Melt development tools...'));
     console.log();
     const createdFiles = [];
-    const workflows = ['setup', 'plan', 'review', 'pr', 'debug', 'audit', 'update'];
+    const workflows = ['setup', 'plan', 'validate', 'review', 'pr', 'debug', 'audit', 'update'];
     // Shared files (skip on re-init)
     if (!isReInit) {
         const agentsMd = templates['agents-md.md'];
@@ -178,7 +218,7 @@ export async function initCommand(options) {
                 await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillContent, 'utf-8');
             }
         }
-        createdFiles.push('.claude/skills/melt-{setup,plan,review,pr,debug,audit,update}/SKILL.md');
+        createdFiles.push('.claude/skills/melt-{setup,plan,validate,review,pr,debug,audit,update}/SKILL.md');
     }
     // Cursor files
     if (tools.cursor) {
@@ -189,7 +229,7 @@ export async function initCommand(options) {
                 await fs.writeFile(path.join(cwd, `.cursor/commands/melt-${name}.md`), workflowContent, 'utf-8');
             }
         }
-        createdFiles.push('.cursor/commands/melt-{setup,plan,review,pr,debug,audit,update}.md');
+        createdFiles.push('.cursor/commands/melt-{setup,plan,validate,review,pr,debug,audit,update}.md');
     }
     // Print summary
     console.log(chalk.green('Created files:'));
@@ -202,11 +242,11 @@ export async function initCommand(options) {
         console.log();
     }
     if (tools.claude) {
-        const skills = '/melt-setup, /melt-plan, /melt-review, /melt-pr, /melt-debug, /melt-audit, /melt-update';
+        const skills = '/melt-setup, /melt-plan, /melt-validate, /melt-review, /melt-pr, /melt-debug, /melt-audit, /melt-update';
         console.log(chalk.dim(`Available skills: ${skills}`));
     }
     if (tools.cursor) {
-        console.log(chalk.dim('Available commands: melt-setup, melt-plan, melt-review, melt-pr, melt-debug, melt-audit, melt-update'));
+        console.log(chalk.dim('Available commands: melt-setup, melt-plan, melt-validate, melt-review, melt-pr, melt-debug, melt-audit, melt-update'));
     }
     if (tools.claude || tools.cursor) {
         console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meltstudio/meltctl",
-  "version": "4.10.0",
+  "version": "4.12.0",
   "description": "AI-first development tools for teams - set up AGENTS.md, Claude Code, Cursor, and Copilot standards",
   "main": "dist/index.js",
   "type": "module",