@netanelyasi/agent-ready 0.2.1 → 0.2.2

package/README.md

@@ -14,7 +14,7 @@
 
 <p align="center">
   <img alt="Status" src="https://img.shields.io/badge/status-experimental-f59e0b?style=flat-square" />
-  <img alt="Version" src="https://img.shields.io/badge/version-0.2.0-111827?style=flat-square" />
+  <img alt="Version" src="https://img.shields.io/badge/version-0.2.2-111827?style=flat-square" />
   <img alt="License" src="https://img.shields.io/badge/license-MIT-0f766e?style=flat-square" />
   <img alt="Runtime" src="https://img.shields.io/badge/runtime-Node.js-3c873a?style=flat-square" />
   <img alt="Built by BrainboxAI" src="https://img.shields.io/badge/by-BrainboxAI-111827?style=flat-square" />

package/dist/generators/generate.js

@@ -4,7 +4,7 @@ export function generateFiles(scan, score, force) {
     add("CLAUDE.md", generateClaudeMd(scan));
     add("CODEMAP.md", generateCodemap(scan));
     add(".aiignore", generateAiIgnore(scan));
-    add(".claude/settings.json", generateClaudeSettings(scan));
+    add(".claude/settings.json", generateClaudeSettings());
     add(".claude/hooks/prevent-destructive.mjs", generatePreventDestructiveHook());
     add(".claude/hooks/protect-generated.mjs", generateProtectGeneratedHook());
     add(".claude/hooks/suggest-validation.mjs", generateSuggestValidationHook(scan));
@@ -132,6 +132,20 @@ function commandLines(scan) {
         lines.push("- No standard validation commands were detected. Add project-specific commands here.");
     return lines;
 }
+// Flat one-command-per-rule list for the validation skill, e.g. "test: `npm run test`".
+// Unlike commandLines (which nests for CLAUDE.md), this stays flat so it renders
+// correctly as a SKILL.md bullet list.
+function validationSkillRules(scan) {
+    const order = ["dev", "build", "test", "lint", "typecheck", "format"];
+    const rules = [];
+    for (const name of order) {
+        for (const command of (scan.commands[name] ?? []).slice(0, 8))
+            rules.push(`${name}: \`${command}\``);
+    }
+    if (!rules.length)
+        rules.push("No standard validation commands were detected. Add project-specific commands here.");
+    return rules;
+}
 function generateCodemap(scan) {
     return [
         `# ${scan.name} — CODEMAP`,
@@ -228,7 +242,7 @@ function generateAiIgnore(scan) {
         add(`${noisy}/`);
     return `${base.join("\n")}\n`;
 }
-function generateClaudeSettings(scan) {
+function generateClaudeSettings() {
     const deniedPathPatterns = [
         "node_modules/**",
         ".next/**",
@@ -467,7 +481,7 @@ function hookRecommendations(scan) {
 function generateSkills(scan) {
     const skills = [
         { slug: "codebase-navigation", content: skill("codebase-navigation", "Use when starting work in this repository or when a task spans unfamiliar directories.", ["Read CODEMAP.md first.", "Use narrow searches from the relevant directory before global search.", "Prefer symbol/reference search when LSP is available.", "Do not inspect ignored/generated directories unless explicitly needed."]) },
-        { slug: "validation", content: skill("validation", "Use after code edits or before declaring a task complete.", [...commandLines(scan).map((line) => line.replace(/^[- ]+/, "")), "Run the narrowest relevant command first.", "If validation cannot be run, report the exact reason."]) },
+        { slug: "validation", content: skill("validation", "Use after code edits or before declaring a task complete.", [...validationSkillRules(scan), "Run the narrowest relevant command first.", "If validation cannot be run, report the exact reason."]) },
     ];
     if (scan.frameworks.includes("Next.js"))
         skills.push({ slug: "nextjs-hydration", content: skill("nextjs-hydration", "Use when editing Next.js/React components, routes, or client/server boundaries.", ["Do not read localStorage/sessionStorage/window/document during server render or initial state.", "Use useEffect or guarded client-only code for browser APIs.", "Avoid Math.random() or new Date() in render paths that must hydrate identically.", "Keep server/client boundaries explicit."]) });
@@ -480,7 +494,28 @@ function generateSkills(scan) {
     return skills;
 }
 function skill(name, description, rules) {
-    return [`# ${name}`, "", `Description: ${description}`, "", "## Rules", ...rules.map((rule) => `- ${rule}`), ""].join("\n");
+    return [
+        "---",
+        `name: ${name}`,
+        `description: ${yamlScalar(description)}`,
+        "---",
+        "",
+        `# ${name}`,
+        "",
+        description,
+        "",
+        "## Rules",
+        ...rules.map((rule) => `- ${rule}`),
+        "",
+    ].join("\n");
+}
+// Claude Code parses SKILL.md frontmatter as YAML. Quote scalars that contain
+// characters YAML would otherwise treat as structure (`:`, leading `#`, etc.).
+function yamlScalar(value) {
+    if (/^[^\s].*[:#]|^[#&*!|>%@`"']|:\s|\s#/.test(value)) {
+        return `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
+    }
+    return value;
 }
 function list(items) {
     return items.length ? items.join(", ") : "none detected";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@netanelyasi/agent-ready",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Generate an AI-agent harness for any codebase: CLAUDE.md, CODEMAP.md, skills, ignore rules, and readiness reports.",
   "type": "module",
   "bin": {