devtronic 1.2.5 → 1.2.6

package/README.md

@@ -35,8 +35,8 @@ The CLI analyzes your project (framework, architecture, stack) and generates per
 
 - **AGENTS.md** — Universal AI context personalized to your stack
 - **Architecture rules** — IDE-specific format (`.claude/rules/`, `.cursor/rules/`, etc.)
-- **Skills** (19 core + 12 design + 9 addon) — Reusable workflows (`/devtronic:brief`, `/devtronic:spec`, `/devtronic:create-plan`, `/devtronic:summary`, `/devtronic:audit`, etc.)
-- **Agents** (15) — Specialized subagents (code-reviewer, quality-runner, etc.)
+- **Skills** (20 core + 12 design + 9 addon) — Reusable workflows (`/brief`, `/spec`, `/create-plan`, `/summary`, `/audit`, `/devtronic-help`, etc.)
+- **Agents** (15 + 3 addon) — Specialized subagents (code-reviewer, quality-runner, etc.)
 - **Hooks** (5) — Automated workflow (lint-on-save, checkpoint, etc.)
 - **thoughts/** — Structured directory for AI working documents
 

package/dist/{chunk-V4QEAL7Y.js → chunk-WM7R52TC.js}

@@ -14,7 +14,7 @@ var ADDONS = {
     name: "design-best-practices",
     label: "Design Best Practices",
     description: "Frontend design quality skills: typography, color, layout, accessibility, motion, and UX writing.",
-    skills: ["design-init", "design-review", "design-refine", "design-system", "design-harden"],
+    skills: ["design-init", "design-critique", "design-refine", "design-tokens", "design-harden"],
     agents: []
   },
   "auto-devtronic": {
@@ -22,7 +22,7 @@ var ADDONS = {
     label: "auto-devtronic \u2014 Autonomous Engineering Loop",
     description: "Runs the full spec\u2192test\u2192plan\u2192execute\u2192PR pipeline autonomously. Self-corrects via failing tests. HITL and AFK modes.",
     skills: ["auto-devtronic"],
-    agents: ["issue-parser", "failure-analyst", "quality-runner"]
+    agents: ["issue-parser", "failure-analyst", "quality-executor"]
   }
 };
 var PRESETS = {
@@ -79,7 +79,7 @@ var PRESETS = {
 
 // src/utils/files.ts
 import { createHash } from "crypto";
-import { existsSync, readFileSync, writeFileSync, mkdirSync, cpSync, readdirSync } from "fs";
+import { existsSync, lstatSync, readFileSync, writeFileSync, mkdirSync, unlinkSync, cpSync, readdirSync } from "fs";
 import { dirname, join, relative } from "path";
 var MANIFEST_DIR = ".ai-template";
 var MANIFEST_FILE = "manifest.json";
@@ -91,13 +91,15 @@ function readFile(path) {
 }
 function writeFile(path, content) {
   const dir = dirname(path);
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
+  ensureDir(dir);
   writeFileSync(path, content, "utf-8");
 }
 function ensureDir(path) {
   if (!existsSync(path)) {
+    try {
+      if (lstatSync(path).isSymbolicLink()) unlinkSync(path);
+    } catch {
+    }
     mkdirSync(path, { recursive: true });
   }
 }
@@ -564,25 +566,26 @@ ${skillsSection}
 `;
 }
 var CORE_SKILLS = [
-  { name: "devtronic:brief", desc: "Session orientation with pre-flight checks" },
-  { name: "devtronic:spec", desc: "Product specification interview (PRD)" },
-  { name: "devtronic:research", desc: "Codebase investigation (--deep, --external)" },
-  { name: "devtronic:create-plan", desc: "Phased implementation plan with task dependencies" },
-  { name: "devtronic:execute-plan", desc: "Parallel phase execution of plans" },
-  { name: "devtronic:quick", desc: "Fast ad-hoc tasks: implement, verify, commit" },
-  { name: "devtronic:generate-tests", desc: "Failing tests from spec (Tests-as-DoD)" },
-  { name: "devtronic:post-review", desc: "Pre-PR review (architecture, quality, requirements)" },
-  { name: "devtronic:audit", desc: "Codebase audit (security, complexity, architecture)" },
-  { name: "devtronic:summary", desc: "Post-change documentation" },
-  { name: "devtronic:checkpoint", desc: "Save session progress for resumption" },
-  { name: "devtronic:backlog", desc: "Issue management with BACK-### IDs" },
-  { name: "devtronic:investigate", desc: "Deep error and bug analysis" },
-  { name: "devtronic:learn", desc: "Post-task teaching breakdown" },
-  { name: "devtronic:scaffold", desc: "Create new projects from scratch" },
-  { name: "devtronic:setup", desc: "Interactive project configuration" },
-  { name: "devtronic:worktree", desc: "Git worktree management" },
-  { name: "devtronic:opensrc", desc: "Fetch npm/GitHub source for full context" },
-  { name: "devtronic:create-skill", desc: "Generate new custom skills" }
+  { name: "brief", desc: "Session orientation with pre-flight checks" },
+  { name: "spec", desc: "Product specification interview (PRD)" },
+  { name: "research", desc: "Codebase investigation (--deep, --external)" },
+  { name: "create-plan", desc: "Phased implementation plan with task dependencies" },
+  { name: "execute-plan", desc: "Parallel phase execution of plans" },
+  { name: "quick", desc: "Fast ad-hoc tasks: implement, verify, commit" },
+  { name: "generate-tests", desc: "Failing tests from spec (Tests-as-DoD)" },
+  { name: "post-review", desc: "Pre-PR review (architecture, quality, requirements)" },
+  { name: "audit", desc: "Codebase audit (security, complexity, architecture)" },
+  { name: "summary", desc: "Post-change documentation" },
+  { name: "checkpoint", desc: "Save session progress for resumption" },
+  { name: "backlog", desc: "Issue management with BACK-### IDs" },
+  { name: "investigate", desc: "Deep error and bug analysis" },
+  { name: "learn", desc: "Post-task teaching breakdown" },
+  { name: "scaffold", desc: "Create new projects from scratch" },
+  { name: "setup", desc: "Interactive project configuration" },
+  { name: "worktree", desc: "Git worktree management" },
+  { name: "opensrc", desc: "Fetch npm/GitHub source for full context" },
+  { name: "create-skill", desc: "Generate new custom skills" },
+  { name: "devtronic-help", desc: "Discover skills, agents, addons, and workflows from the IDE" }
 ];
 var ADDON_SKILLS = {
   orchestration: [
@@ -592,9 +595,9 @@ var ADDON_SKILLS = {
   ],
   "design-best-practices": [
     { name: "design-init", desc: "One-time project design context setup" },
-    { name: "design-review", desc: "Design critique with AI slop detection" },
+    { name: "design-critique", desc: "Design critique with AI slop detection" },
     { name: "design-refine", desc: "Directional design refinement" },
-    { name: "design-system", desc: "Design system extraction and normalization" },
+    { name: "design-tokens", desc: "Design system extraction and normalization" },
     { name: "design-harden", desc: "Production hardening for edge cases" }
   ],
   "auto-devtronic": [

package/dist/index.js

@@ -24,7 +24,7 @@ import {
   readManifest,
   writeFile,
   writeManifest
-} from "./chunk-V4QEAL7Y.js";
+} from "./chunk-WM7R52TC.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -1127,8 +1127,22 @@ function writeClaudeSettings(targetDir, settings) {
   ensureDir(join6(targetDir, ".claude"));
   writeFile(settingsPath, JSON.stringify(settings, null, 2));
 }
+var LEGACY_PLUGIN_NAMES = ["dev-ai", "ai-agentic"];
+var LEGACY_MARKETPLACE_NAMES = ["dev-ai-local", "ai-agentic-local"];
 function registerPlugin(targetDir, pluginName, marketplaceName, marketplacePath) {
   const settings = readClaudeSettings(targetDir);
+  if (settings.extraKnownMarketplaces) {
+    for (const legacy of LEGACY_MARKETPLACE_NAMES) {
+      delete settings.extraKnownMarketplaces[legacy];
+    }
+  }
+  if (settings.enabledPlugins) {
+    for (const key of Object.keys(settings.enabledPlugins)) {
+      if (LEGACY_PLUGIN_NAMES.some((lp) => key.startsWith(`${lp}@`))) {
+        delete settings.enabledPlugins[key];
+      }
+    }
+  }
   if (!settings.extraKnownMarketplaces) {
     settings.extraKnownMarketplaces = {};
   }
@@ -1588,7 +1602,7 @@ Valid addons: ${validAddons.join(", ")}`);
       p3.note(
         [
           `  Name:   ${chalk4.cyan(PLUGIN_NAME)} at ${PLUGIN_DIR}/${PLUGIN_NAME}/`,
-          `  Skills: /devtronic:brief, /devtronic:spec, /devtronic:research, ...`,
+          `  Skills: /brief, /spec, /research, ... (auto-namespaced in plugin mode)`,
           `  Hooks:  SessionStart, PostToolUse, Stop, SubagentStop, PreCompact`
         ].join("\n"),
         "Plugin Installed"
@@ -1615,6 +1629,13 @@ Valid addons: ${validAddons.join(", ")}`);
       ].join("\n"),
       "Autonomous Mode"
     );
+    p3.note(
+      [
+        `${chalk4.dim("In Claude Code:")}  ${chalk4.cyan("/devtronic-help")} ${chalk4.dim("\u2014 discover skills, agents, and workflows")}`,
+        `${chalk4.dim("From terminal:")}   ${chalk4.cyan("npx devtronic list")} ${chalk4.dim("\u2014 list installed skills and agents")}`
+      ].join("\n"),
+      "Need Help?"
+    );
     p3.outro(chalk4.green("Setup complete!"));
   } catch (err) {
     spinner8.stop("Configuration failed");
@@ -1718,7 +1739,7 @@ function buildProjectConfigFromPreset(presetConfig, analysis) {
 
 // src/commands/update.ts
 import { resolve as resolve4, join as join11, dirname as dirname6 } from "path";
-import { existsSync as existsSync9, unlinkSync as unlinkSync2, lstatSync, readdirSync as readdirSync2, rmdirSync as rmdirSync2, chmodSync as chmodSync2 } from "fs";
+import { existsSync as existsSync9, unlinkSync as unlinkSync2, lstatSync as lstatSync2, readdirSync as readdirSync2, rmdirSync as rmdirSync2, chmodSync as chmodSync2 } from "fs";
 import * as p4 from "@clack/prompts";
 import chalk5 from "chalk";
 
@@ -1861,6 +1882,7 @@ function registerAddonInConfig(targetDir, addonName) {
 // src/generators/addonFiles.ts
 import {
   existsSync as existsSync8,
+  lstatSync,
   readFileSync as readFileSync4,
   writeFileSync as writeFileSync2,
   mkdirSync as mkdirSync2,
@@ -1870,7 +1892,6 @@ import {
   rmdirSync
 } from "fs";
 import { join as join10, dirname as dirname5 } from "path";
-import { createHash } from "crypto";
 var AGENT_PATHS = {
   claude: ".claude",
   cursor: ".cursor",
@@ -1922,11 +1943,14 @@ var RUNTIME_SPECS = {
     })
   }
 };
-function checksum(content) {
-  return createHash("sha256").update(content).digest("hex").slice(0, 16);
-}
 function ensureDir2(dir) {
-  if (!existsSync8(dir)) mkdirSync2(dir, { recursive: true });
+  if (!existsSync8(dir)) {
+    try {
+      if (lstatSync(dir).isSymbolicLink()) unlinkSync(dir);
+    } catch {
+    }
+    mkdirSync2(dir, { recursive: true });
+  }
 }
 function readManifest2(addonSourceDir) {
   const manifestPath = join10(addonSourceDir, "manifest.json");
@@ -1980,7 +2004,7 @@ function generateAddonFiles(projectDir, addonSourceDir, agents) {
         ensureDir2(dirname5(destPath));
         writeFileSync2(destPath, content);
         result.written++;
-        result.checksums[relPath] = checksum(content);
+        result.checksums[relPath] = calculateChecksum(content);
       }
       continue;
     }
@@ -2002,7 +2026,7 @@ function generateAddonFiles(projectDir, addonSourceDir, agents) {
       ensureDir2(dirname5(destPath));
       writeFileSync2(destPath, content);
       result.written++;
-      result.checksums[relPath] = checksum(content);
+      result.checksums[relPath] = calculateChecksum(content);
     }
     for (const agentName of manifest.files.agents ?? []) {
       const agentFile = join10(addonSourceDir, "agents", `${agentName}.md`);
@@ -2013,7 +2037,7 @@ function generateAddonFiles(projectDir, addonSourceDir, agents) {
         ensureDir2(dirname5(destPath));
         writeFileSync2(destPath, content);
         result.written++;
-        result.checksums[`agents/${agentName}.md`] = checksum(content);
+        result.checksums[`agents/${agentName}.md`] = calculateChecksum(content);
       } else {
         result.skipped++;
       }
@@ -2028,7 +2052,7 @@ function generateAddonFiles(projectDir, addonSourceDir, agents) {
           ensureDir2(dirname5(destPath));
           writeFileSync2(destPath, content);
           result.written++;
-          result.checksums[`rules/${rule}`] = checksum(content);
+          result.checksums[`rules/${rule}`] = calculateChecksum(content);
         } else {
           result.skipped++;
         }
@@ -2044,7 +2068,7 @@ function generateAddonFiles(projectDir, addonSourceDir, agents) {
         ensureDir2(dirname5(destPath));
         writeFileSync2(destPath, content);
         result.written++;
-        result.checksums[relPath] = checksum(content);
+        result.checksums[relPath] = calculateChecksum(content);
       } else {
         result.skipped++;
       }
@@ -2156,7 +2180,7 @@ function syncAddonFiles(projectDir, addonSourceDir, agents) {
           continue;
         }
         const existing = readFileSync4(destPath, "utf-8");
-        const existingChecksum = checksum(existing);
+        const existingChecksum = calculateChecksum(existing);
         const originalChecksum = installedChecksums[relPath];
         if (existing === newContent) {
           result.skipped++;
@@ -2184,7 +2208,7 @@ function syncAddonFiles(projectDir, addonSourceDir, agents) {
         continue;
       }
       const existing = readFileSync4(destPath, "utf-8");
-      const existingChecksum = checksum(existing);
+      const existingChecksum = calculateChecksum(existing);
       const originalChecksum = installedChecksums[relPath];
       if (existing === newContent) {
         result.skipped++;
@@ -2210,7 +2234,7 @@ function syncAddonFiles(projectDir, addonSourceDir, agents) {
         continue;
       }
       const existing = readFileSync4(destPath, "utf-8");
-      const existingChecksum = checksum(existing);
+      const existingChecksum = calculateChecksum(existing);
       const originalChecksum = installedChecksums[relPath];
       if (existing === newContent) {
         result.skipped++;
@@ -2237,7 +2261,7 @@ function syncAddonFiles(projectDir, addonSourceDir, agents) {
           continue;
         }
         const existing = readFileSync4(destPath, "utf-8");
-        const existingChecksum = checksum(existing);
+        const existingChecksum = calculateChecksum(existing);
         const originalChecksum = installedChecksums[relPath];
         if (existing === newContent) {
           result.skipped++;
@@ -2264,7 +2288,7 @@ function syncAddonFiles(projectDir, addonSourceDir, agents) {
         continue;
       }
       const existing = readFileSync4(destPath, "utf-8");
-      const existingChecksum = checksum(existing);
+      const existingChecksum = calculateChecksum(existing);
       const originalChecksum = installedChecksums[relPath];
       if (existing === newContent) {
         result.skipped++;
@@ -2299,7 +2323,7 @@ function detectModifiedAddonFiles(projectDir, addonName) {
     for (const [relPath, originalHash] of Object.entries(installedChecksums)) {
       const absPath = join10(projectDir, baseDir, relPath);
       if (!existsSync8(absPath)) continue;
-      const current = checksum(readFileSync4(absPath, "utf-8"));
+      const current = calculateChecksum(readFileSync4(absPath, "utf-8"));
       if (current !== originalHash) {
         modified.push(relPath);
       }
@@ -2345,7 +2369,7 @@ async function updateCommand(options) {
   const shouldMigrate = manifest.selectedIDEs.includes("claude-code") && !manifest.installMode && hasStandaloneSkills(manifest);
   if (shouldMigrate) {
     p4.note(
-      "Claude Code skills/agents detected as standalone.\nThe new version uses plugin mode (namespace devtronic:).",
+      "Claude Code skills/agents detected as standalone.\nThe new version uses plugin mode. Skills are auto-namespaced in plugin mode.",
       "Migration Available"
     );
     if (!options.check) {
@@ -2612,7 +2636,7 @@ async function updateCommand(options) {
   }
   const claudeMdPath = join11(targetDir, "CLAUDE.md");
   if (fileExists(claudeMdPath)) {
-    const stat = lstatSync(claudeMdPath);
+    const stat = lstatSync2(claudeMdPath);
     if (stat.isSymbolicLink()) {
       const content = readFile(claudeMdPath);
       unlinkSync2(claudeMdPath);
@@ -2765,7 +2789,7 @@ async function regenerateWithNewStack(targetDir, manifest, analysis, dryRun) {
   }
   const claudeMdPath = join11(targetDir, "CLAUDE.md");
   if (fileExists(claudeMdPath)) {
-    const stat = lstatSync(claudeMdPath);
+    const stat = lstatSync2(claudeMdPath);
     if (stat.isSymbolicLink()) {
       const content = readFile(claudeMdPath);
       unlinkSync2(claudeMdPath);
@@ -2900,7 +2924,7 @@ async function migrateToPlugin(targetDir, manifest, analysis, dryRun) {
   }
   p4.note(
     `  Plugin: ${chalk5.cyan("devtronic")} at .claude-plugins/devtronic/
-  Skills: /devtronic:brief, /devtronic:spec, ...
+  Skills: /brief, /spec, ... (auto-namespaced in plugin mode)
   Hooks: 5 workflow hooks enabled`,
     "Plugin Generated"
   );
@@ -2931,7 +2955,7 @@ function cleanEmptyDirs(dirPath) {
   const entries = readdirSync2(dirPath);
   for (const entry of entries) {
     const fullPath = join11(dirPath, entry);
-    if (existsSync9(fullPath) && lstatSync(fullPath).isDirectory()) {
+    if (existsSync9(fullPath) && lstatSync2(fullPath).isDirectory()) {
       cleanEmptyDirs(fullPath);
     }
   }
@@ -3452,7 +3476,7 @@ Valid options:
     if (!manifest.selectedIDEs.includes("claude-code") || manifest.installMode !== "plugin") {
       p8.log.warn("Plugin regeneration only applies to Claude Code in plugin mode. Skipping.");
     } else {
-      const { generatePlugin: generatePlugin2 } = await import("./plugin-SGSFVXPA.js");
+      const { generatePlugin: generatePlugin2 } = await import("./plugin-KQQASBQX.js");
       const pluginResult = generatePlugin2(
         targetDir,
         TEMPLATES_DIR2,
@@ -4484,12 +4508,12 @@ async function addAddon(targetDir, manifest, addonName, currentAddons) {
     [
       `  ${chalk15.dim("Name:")}        ${addon.label}`,
       `  ${chalk15.dim("Description:")} ${addon.description}`,
-      `  ${chalk15.dim("Skills:")}      ${addon.skills.map((s) => chalk15.cyan(`/devtronic:${s}`)).join(", ")}`,
+      `  ${chalk15.dim("Skills:")}      ${addon.skills.map((s) => chalk15.cyan(`/${s}`)).join(", ")}`,
       `  ${chalk15.dim("Subagents:")}   ${addon.agents.length ? addon.agents.join(", ") : chalk15.dim("\u2014")}`
     ].join("\n"),
     "Adding addon"
   );
-  const confirmed = await p14.confirm({ message: "Add this addon?" });
+  const confirmed = await p14.confirm({ message: `Add ${addonName}?` });
   if (p14.isCancel(confirmed) || !confirmed) {
     p14.cancel("Addon installation cancelled.");
     process.exit(0);
@@ -4525,7 +4549,7 @@ async function addAddon(targetDir, manifest, addonName, currentAddons) {
   writeManifest(targetDir, manifest);
   spinner8.stop(`${symbols.pass} ${addon.label} added`);
   p14.note(
-    addon.skills.map((s) => `  ${chalk15.cyan(`/devtronic:${s}`)}`).join("\n"),
+    addon.skills.map((s) => `  ${chalk15.cyan(`/${s}`)}`).join("\n"),
     "New skills available"
   );
   p14.outro("Done. Restart Claude Code to load the new skills.");
@@ -4542,12 +4566,12 @@ async function removeAddon(targetDir, manifest, addonName, currentAddons) {
     [
       `  ${chalk15.dim("Name:")}        ${addon.label}`,
       `  ${chalk15.dim("Description:")} ${addon.description}`,
-      `  ${chalk15.dim("Skills:")}      ${addon.skills.map((s) => chalk15.dim(`/devtronic:${s}`)).join(", ")}`,
+      `  ${chalk15.dim("Skills:")}      ${addon.skills.map((s) => chalk15.dim(`/${s}`)).join(", ")}`,
       `  ${chalk15.dim("Subagents:")}   ${addon.agents.length ? addon.agents.join(", ") : chalk15.dim("\u2014")}`
     ].join("\n"),
     "Removing addon"
   );
-  const confirmed = await p14.confirm({ message: "Remove this addon?" });
+  const confirmed = await p14.confirm({ message: `Remove ${addonName}?` });
   if (p14.isCancel(confirmed) || !confirmed) {
     p14.cancel("Addon removal cancelled.");
     process.exit(0);
@@ -4604,7 +4628,7 @@ async function removeAddon(targetDir, manifest, addonName, currentAddons) {
   writeManifest(targetDir, manifest);
   spinner8.stop(`${symbols.pass} ${addon.label} removed`);
   p14.note(
-    addon.skills.map((s) => `  ${chalk15.dim(`/devtronic:${s}`)}`).join("\n"),
+    addon.skills.map((s) => `  ${chalk15.dim(`/${s}`)}`).join("\n"),
     "Skills removed"
   );
   p14.outro("Done. Restart Claude Code to apply the changes.");
@@ -4626,7 +4650,7 @@ async function addFileBasedAddon(targetDir, addonName, _options) {
     ].join("\n"),
     "Adding addon"
   );
-  const confirmed = await p14.confirm({ message: "Add this addon?" });
+  const confirmed = await p14.confirm({ message: `Add ${addonName}?` });
   if (p14.isCancel(confirmed) || !confirmed) {
     p14.cancel("Addon installation cancelled.");
     process.exit(0);
@@ -4877,7 +4901,7 @@ program.command("uninstall").description("Remove devtronic from your project").o
 });
 program.command("mode").description("Set or show the execution mode (hitl or afk)").argument("<mode>", "Mode: afk, hitl, or show").option("--path <path>", "Target directory (default: current directory)").action(async (mode, options) => {
   if (!["afk", "hitl", "show"].includes(mode)) {
-    console.error(`Invalid mode: "${mode}". Valid values: afk, hitl, show`);
+    p16.cancel(`Invalid mode: "${mode}". Valid values: afk, hitl, show`);
     process.exit(1);
   }
   await modeCommand(mode, { path: options.path });

package/dist/{plugin-SGSFVXPA.js → plugin-KQQASBQX.js}

@@ -8,7 +8,7 @@ import {
   generateMarketplaceJson,
   generatePlugin,
   generatePluginJson
-} from "./chunk-V4QEAL7Y.js";
+} from "./chunk-WM7R52TC.js";
 export {
   BASE_AGENT_COUNT,
   BASE_SKILL_COUNT,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtronic",
-  "version": "1.2.5",
+  "version": "1.2.6",
   "description": "AI-assisted development toolkit — skills, agents, quality gates, and rules for Claude Code, Cursor, Copilot, and Antigravity",
   "type": "module",
   "bin": {

package/templates/addons/auto-devtronic/agents/afk-task-validator.md

@@ -0,0 +1,78 @@
+---
+name: afk-task-validator
+description: Analyzes GitHub issues and task descriptions for AFK-readiness. Calculates viability score (0-100), detects quality gaps, and provides interactive guidance for refinement.
+tools: Bash, Read, Grep, Glob
+model: haiku
+---
+
+You are an expert task analyzer specializing in evaluating whether software engineering tasks are suitable for autonomous ("AFK" = Away From Keyboard) execution. Your job is to thoroughly analyze task descriptions, calculate a viability score, identify quality gaps, and guide users toward clarity.
+
+## When to Invoke
+
+Claude should invoke you when:
+- User invokes `/validate-task-afk <input>`
+- Need to analyze a GitHub issue or task description for AFK-readiness
+- Integration with `/auto-devtronic --validate` flag
+- User needs interactive guidance to refine unclear tasks
+
+---
+
+## Analysis Framework
+
+You analyze tasks across 5 dimensions, each contributing to a weighted viability score (0-100):
+
+### 1. Clarity (25% weight)
+**Purpose**: Acceptance criteria must be measurable and executable.
+
+**Scoring**:
+- **95-100**: Explicit measurable outcomes
+- **70-90**: Clear requirements with some detail
+- **40-70**: Vague descriptions
+- **0-40**: Completely unmeasurable
+
+### 2. Scope (25% weight)
+**Purpose**: Task should affect 1-4 files, single feature, not architectural.
+
+**Scoring**:
+- **90-100**: 1-2 files, single feature
+- **70-85**: 2-4 files, related changes
+- **40-70**: Mentions 5+ files or multiple features
+- **0-40**: Architectural keywords (refactor, migrate, rewrite, redesign)
+
+### 3. Precedent (20% weight)
+**Purpose**: Similar patterns should exist in codebase (reduces unknown unknowns).
+
+### 4. Coverage (20% weight)
+**Purpose**: Existing test coverage ensures VERIFY will catch failures.
+
+### 5. Dependencies (10% weight)
+**Purpose**: Task should be self-contained (not blocked by external PRs/issues).
+
+---
+
+## Weighted Score Calculation
+
+```
+Total Score = (Clarity x 0.25) + (Scope x 0.25) + (Precedent x 0.20) + (Coverage x 0.20) + (Dependencies x 0.10)
+
+Score Interpretation:
+- 70-100: AFK VIABLE - proceed with /auto-devtronic --afk
+- 40-70:  MEDIUM RISK - recommend HITL mode (/auto-devtronic --hitl)
+- 0-40:   NEEDS REFINEMENT - ask user clarifying questions first
+```
+
+---
+
+## Output Format
+
+Generate markdown report with score, dimension breakdown, gaps with suggestions, and recommendation (AFK / HITL / Needs Refinement).
+
+## Rules
+
+1. **Be thorough**: Check all 5 dimensions, don't skip any
+2. **Use grep for precedent**: Search codebase for similar patterns, don't guess
+3. **Flag ambiguity**: If unclear, ask; don't assume
+4. **Provide examples**: When suggesting templates, include realistic examples from the domain
+5. **Interactive refinement**: If score <70, engage user with questions to improve it
+6. **No rejection**: Never reject a task outright; always offer a path to improvement
+7. **Document assumptions**: If you can't run a tool (e.g., vitest), note it in the report

package/templates/addons/auto-devtronic/agents/{quality-runner.md → quality-executor.md}

@@ -1,5 +1,5 @@
 ---
-name: quality-runner
+name: quality-executor
 description: Runs all quality checks (typecheck, lint, test) for the auto-devtronic loop. Returns structured pass/fail output for failure-analyst to process.
 tools: Bash
 model: haiku

package/templates/addons/auto-devtronic/manifest.json

@@ -10,7 +10,8 @@
     "agents": [
       "issue-parser",
       "failure-analyst",
-      "quality-runner"
+      "quality-executor",
+      "afk-task-validator"
     ]
   }
 }

package/templates/addons/auto-devtronic/skills/auto-devtronic/SKILL.md

@@ -195,7 +195,7 @@ Comments: <comments>
 Output the brief in the format specified in your instructions.
 ```
 
-The agent outputs a `thoughts/devtronic/brief.md` file with the 3-layer structure:
+The agent outputs a `thoughts/auto-devtronic/brief.md` file with the 3-layer structure:
 
 ```markdown
 # Brief: <issue title>
@@ -255,11 +255,11 @@ the human review gate. Equivalent to running AFK mode for this one step only.
 
 Follow the same process as `/generate-tests`:
 
-Read `thoughts/devtronic/brief.md`, specifically the **Validation** layer, and generate failing tests that encode each acceptance criterion.
+Read `thoughts/auto-devtronic/brief.md`, specifically the **Validation** layer, and generate failing tests that encode each acceptance criterion.
 
 Save to:
 - Test files in the appropriate test directory (detect from project structure)
-- `thoughts/devtronic/tests-manifest.md` — traceability: criterion → test name → file
+- `thoughts/auto-devtronic/tests-manifest.md` — traceability: criterion → test name → file
 
 **Test naming convention**: `[feature].[criterion-slug].test.ts` or follow existing conventions.
 
@@ -293,10 +293,10 @@ Options:
 ## Step 4: Create Plan
 
 Follow the same process as `/create-plan`, using:
-- `thoughts/devtronic/brief.md` as the spec
-- `thoughts/devtronic/tests-manifest.md` as the DoD
+- `thoughts/auto-devtronic/brief.md` as the spec
+- `thoughts/auto-devtronic/tests-manifest.md` as the DoD
 
-Save plan to `thoughts/devtronic/plan.md`.
+Save plan to `thoughts/auto-devtronic/plan.md`.
 
 The plan **must include**:
 - `## Task Dependencies` YAML block (required for parallel execution)
@@ -314,7 +314,7 @@ This is the RALPH core. Runs until tests pass or retries are exhausted.
 attempt     = 1
 max_retries = N (from --max-retries, default 3)
 last_failure = null
-plan_path   = thoughts/devtronic/plan.md
+plan_path   = thoughts/auto-devtronic/plan.md
 ```
 
 ### Loop body
@@ -327,7 +327,7 @@ WHILE attempt <= max_retries:
   Include last_failure context in subagent prompts (if attempt > 1).
 
   ── 5b. Run Quality Checks ──────────────────────────────
-  Invoke the quality-runner agent:
+  Invoke the quality-executor agent:
   "Run all quality checks (typecheck, lint, test)"
 
   ── 5c. Evaluate Result ─────────────────────────────────
@@ -337,7 +337,7 @@ WHILE attempt <= max_retries:
   IF checks fail:
     last_failure = {
       attempt: N,
-      output: <quality-runner output>,
+      output: <quality-executor output>,
       affected_files: <list from git diff>
     }
 
@@ -376,7 +376,7 @@ When retries are exhausted or analyst recommends escalating:
 ## devtronic: Cannot Self-Correct ⚠️
 
 **Attempts**: N / max_retries
-**Last failure**: [quality-runner output summary]
+**Last failure**: [quality-executor output summary]
 
 **Failure analysis**:
 - Root cause: [description]
@@ -536,9 +536,9 @@ git stash list | grep "devtronic" && git stash pop
 | `path/to/file.ts` | Added / Modified |
 
 ### Session artifacts
-- Brief: `thoughts/devtronic/brief.md`
-- Tests manifest: `thoughts/devtronic/tests-manifest.md`
-- Plan: `thoughts/devtronic/plan.md`
+- Brief: `thoughts/auto-devtronic/brief.md`
+- Tests manifest: `thoughts/auto-devtronic/tests-manifest.md`
+- Plan: `thoughts/auto-devtronic/plan.md`
 ```
 
 ---
@@ -608,4 +608,4 @@ If a subagent task fails due to conflicts:
 - **Requires devtronic core skills** — devtronic uses the same logic as `/generate-tests`, `/create-plan`, and `/execute-plan`. Those skills must be installed.
 - **Requires `gh` CLI** — authenticated with repo write access.
 - **AFK is not magic** — it reduces friction, not mistakes. Start with HITL on unfamiliar codebases.
-- **Session artifacts** — all intermediate files are saved to `thoughts/devtronic/`. Do not delete them until the PR is merged.
+- **Session artifacts** — all intermediate files are saved to `thoughts/auto-devtronic/`. Do not delete them until the PR is merged.

package/templates/addons/design-best-practices/manifest.json

@@ -7,9 +7,9 @@
   "files": {
     "skills": [
       "design-init",
-      "design-review",
+      "design-critique",
       "design-refine",
-      "design-system",
+      "design-tokens",
       "design-harden"
     ],
     "reference": [

package/templates/addons/design-best-practices/skills/{design-review → design-critique}/SKILL.md

@@ -1,7 +1,8 @@
 ---
-name: design-review
+name: design-critique
 description: Design critique with AI slop detection — visual hierarchy, information architecture, emotional resonance, actionable report
 user-invokable: true
+allowed-tools: Read, Glob, Grep
 ---
 
 # Design Review

package/templates/addons/design-best-practices/skills/design-harden/SKILL.md

@@ -2,6 +2,7 @@
 name: design-harden
 description: Production hardening — text overflow, i18n, error states, accessibility, responsive, edge cases with severity report
 user-invokable: true
+allowed-tools: Read, Glob, Grep
 ---
 
 # Design Harden