learnship 1.9.17 → 1.9.18

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "learnship",
   "description": "Agentic engineering done right — 42 structured workflows, persistent memory across sessions, integrated learning partner, and impeccable UI design system. Works with Claude Code, Windsurf, Cursor, Gemini CLI, OpenCode, and Codex.",
-  "version": "1.9.17",
+  "version": "1.9.18",
   "author": {
     "name": "Favio Vazquez",
     "email": "favio.vazquezp@gmail.com"

package/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "learnship",
   "displayName": "learnship",
   "description": "Agentic engineering done right — 42 structured workflows, persistent memory across sessions, integrated learning partner, and impeccable UI design system.",
-  "version": "1.9.17",
+  "version": "1.9.18",
   "logo": "assets/logo.png",
   "author": {
     "name": "Favio Vazquez",

package/bin/install.js

@@ -501,6 +501,7 @@ function copyDir(srcDir, destDir, pathPrefix, platform) {
       let c = fs.readFileSync(src, 'utf8');
       c = replacePaths(c, pathPrefix, platform);
       if (entry.name === 'new-project.md') c = rewriteNewProject(c, platform);
+      if (entry.name === 'agents.md') c = rewriteAgentsMd(c, platform, pathPrefix);
       if (platform === 'opencode') c = convertToOpencode(c);
       // gemini agents converted separately; body ${VAR} escaping done there
       fs.writeFileSync(dest, c);
@@ -529,6 +530,62 @@ function replacePaths(content, pathPrefix, platform) {
   return c;
 }
 
+/**
+ * Rewrite AGENTS.md markers with platform-specific skill invocation instructions.
+ * On Windsurf, @agentic-learning and @impeccable are native @skill invocations.
+ * On all other platforms there is no @mention dispatch — the AI must be told
+ * explicitly where the skill files live and what to do when the user types @skill-name.
+ */
+function rewriteAgentsMd(content, platform, pathPrefix) {
+  if (!content.includes('<!-- LEARNSHIP_SKILLS_BLOCK -->')) return content;
+
+  let block;
+  if (platform === 'windsurf') {
+    block = `### Learning Partner — \`@agentic-learning\`
+
+Windsurf loads \`@agentic-learning\` natively as a skill. When the user (or a workflow) invokes \`@agentic-learning <action>\`, Windsurf automatically routes it to the installed skill.
+
+Available actions: \`learn\`, \`quiz\`, \`reflect\`, \`space\`, \`brainstorm\`, \`explain-first\`, \`struggle\`, \`either-or\`, \`interleave\`, \`cognitive-load\`
+
+### Design System — \`@impeccable\`
+
+Windsurf loads \`@impeccable\` natively as a skill. When the user (or a workflow) invokes \`@impeccable <action>\`, Windsurf automatically routes it to the installed skill.
+
+Available actions: \`adapt\`, \`animate\`, \`arrange\`, \`audit\`, \`bolder\`, \`clarify\`, \`colorize\`, \`critique\`, \`delight\`, \`distill\`, \`extract\`, \`frontend-design\`, \`harden\`, \`normalize\`, \`onboard\`, \`optimize\`, \`overdrive\`, \`polish\`, \`quieter\`, \`teach-impeccable\`, \`typeset\``;
+  } else {
+    // For all non-Windsurf platforms: @mention is not a native dispatch mechanism.
+    // The AI must read the skill file directly and execute the instructions inside it.
+    // pathPrefix ends with learnship/ — skills are at learnship/skills/
+    const skillsPath = pathPrefix + 'skills';
+
+    block = `### Learning Partner — \`@agentic-learning\`
+
+**There is no native @mention skill dispatch on this platform.** When a workflow checkpoint or the user mentions \`@agentic-learning <action>\`, you must:
+
+1. Read \`${skillsPath}/agentic-learning/SKILL.md\`
+2. Find the section for the requested action (e.g. \`either-or\`, \`brainstorm\`, \`reflect\`, \`quiz\`, etc.)
+3. Execute those instructions directly in this conversation
+
+Available actions: \`learn\`, \`quiz\`, \`reflect\`, \`space\`, \`brainstorm\`, \`explain-first\`, \`struggle\`, \`either-or\`, \`interleave\`, \`cognitive-load\`
+
+**Do NOT say "@agentic-learning isn't installed" — it is installed. Read the SKILL.md and run the action.**
+
+### Design System — \`@impeccable\`
+
+**There is no native @mention skill dispatch on this platform.** When a workflow checkpoint or the user mentions \`@impeccable <action>\`, you must:
+
+1. Read \`${skillsPath}/impeccable/SKILL.md\`
+2. Find the section for the requested action (e.g. \`audit\`, \`critique\`, \`polish\`, etc.)
+3. Execute those instructions directly in this conversation
+
+Available actions: \`adapt\`, \`animate\`, \`arrange\`, \`audit\`, \`bolder\`, \`clarify\`, \`colorize\`, \`critique\`, \`delight\`, \`distill\`, \`extract\`, \`frontend-design\`, \`harden\`, \`normalize\`, \`onboard\`, \`optimize\`, \`overdrive\`, \`polish\`, \`quieter\`, \`teach-impeccable\`, \`typeset\`
+
+**Do NOT say "@impeccable isn't installed" — it is installed. Read the SKILL.md and run the action.**`;
+  }
+
+  return content.replace('<!-- LEARNSHIP_SKILLS_BLOCK -->', block);
+}
+
 /** Rewrite new-project.md markers with exact platform-specific content at install time */
 function rewriteNewProject(content, platform) {
   const dirName = getDirName(platform);
@@ -1339,6 +1396,7 @@ if (process.env.LEARNSHIP_TEST_MODE) {
     parseJsonc,
     replacePaths,
     rewriteNewProject,
+    rewriteAgentsMd,
     installClaudePlugins,
     toHomePrefix,
     LEARNSHIP_CODEX_MARKER,

package/cursor-rules/learnship.mdc

@@ -44,6 +44,32 @@ Always read `STATE.md` and `ROADMAP.md` before any planning or execution operati
 - **Goal-backward verification**: Check that `must_haves` are met, not just that tasks ran.
 - **Deferred ideas**: Note things outside current phase scope in the roadmap backlog.
 
+## Skills — @agentic-learning and @impeccable
+
+**There is no native @mention skill dispatch in Cursor.** When a workflow checkpoint or the user mentions `@agentic-learning <action>` or `@impeccable <action>`, you must read the skill file and execute its instructions directly.
+
+### Learning Partner — `@agentic-learning`
+
+When `@agentic-learning <action>` is mentioned:
+1. Read `node_modules/learnship/skills/agentic-learning/SKILL.md` (or `learnship/skills/agentic-learning/SKILL.md` if installed locally)
+2. Find the section for the requested action
+3. Execute those instructions in this conversation
+
+Available actions: `learn`, `quiz`, `reflect`, `space`, `brainstorm`, `explain-first`, `struggle`, `either-or`, `interleave`, `cognitive-load`
+
+**Do NOT say "@agentic-learning isn't installed" — it is installed. Read the SKILL.md and run the action.**
+
+### Design System — `@impeccable`
+
+When `@impeccable <action>` is mentioned:
+1. Read `node_modules/learnship/skills/impeccable/SKILL.md` (or `learnship/skills/impeccable/SKILL.md` if installed locally)
+2. Find the section for the requested action
+3. Execute those instructions in this conversation
+
+Available actions: `adapt`, `animate`, `arrange`, `audit`, `bolder`, `clarify`, `colorize`, `critique`, `delight`, `distill`, `extract`, `frontend-design`, `harden`, `normalize`, `onboard`, `optimize`, `overdrive`, `polish`, `quieter`, `teach-impeccable`, `typeset`
+
+**Do NOT say "@impeccable isn't installed" — it is installed. Read the SKILL.md and run the action.**
+
 ## Parallel Execution
 
 Cursor supports real parallel subagents. During `/new-project` setup (Group D), ask:

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "learnship",
-  "version": "1.9.17",
+  "version": "1.9.18",
   "description": "Agentic engineering done right — 42 structured workflows, persistent memory across sessions, integrated learning partner, and impeccable UI design system.",
   "author": "Favio Vazquez",
   "homepage": "https://faviovazquez.github.io/learnship/",

package/learnship/templates/agents.md

@@ -181,6 +181,8 @@ This project uses **learnship**. Key facts:
 
 ## Skills — Operational Knowledge
 
+<!-- LEARNSHIP_SKILLS_BLOCK -->
+
 ### CHANGELOG Discipline
 
 Every significant change gets a dated entry in `CHANGELOG.md` with:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "learnship",
-  "version": "1.9.17",
+  "version": "1.9.18",
   "description": "Learn as you build. Build with intent. — A multi-platform agentic engineering system for Windsurf, Claude Code, Cursor, OpenCode, Gemini CLI, and Codex: spec-driven workflows, integrated learning, and production-grade design.",
   "keywords": [
     "agentic",