learnship 1.9.7 → 1.9.9

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.7",
+  "version": "1.9.9",
   "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.7",
+  "version": "1.9.9",
   "logo": "assets/logo.png",
   "author": {
     "name": "Favio Vazquez",

package/bin/install.js

@@ -497,6 +497,7 @@ function copyDir(srcDir, destDir, pathPrefix, platform) {
     } else if (entry.name.endsWith('.md')) {
       let c = fs.readFileSync(src, 'utf8');
       c = replacePaths(c, pathPrefix, platform);
+      if (entry.name === 'new-project.md') c = rewriteNewProject(c, platform);
       if (platform === 'opencode') c = convertToOpencode(c);
       // gemini agents converted separately; body ${VAR} escaping done there
       fs.writeFileSync(dest, c);
@@ -525,6 +526,38 @@ function replacePaths(content, pathPrefix, platform) {
   return c;
 }
 
+/** Rewrite new-project.md markers with exact platform-specific content at install time */
+function rewriteNewProject(content, platform) {
+  const dirName = getDirName(platform);
+  const label   = getPlatformLabel(platform);
+
+  // Platform label block
+  const platformLabel = `You are running on **${label}**. Platform config directory: \`${dirName}/\``;
+  content = content.replace('<!-- LEARNSHIP_PLATFORM_LABEL -->', platformLabel);
+
+  // Gitignore command — exact single line, no conditionals
+  const gitignoreCmd = `grep -q '${dirName}/' .gitignore 2>/dev/null || echo '${dirName}/' >> .gitignore`;
+  content = content.replace('<!-- LEARNSHIP_GITIGNORE_CMD -->', gitignoreCmd);
+
+  // Platforms that support real parallel subagents (verified against official docs)
+  // Windsurf: no subagents at all
+  // Gemini CLI: subagents exist but parallel execution is not yet shipped (GitHub issues #14963/#17749)
+  const supportsParallel = platform === 'claude' || platform === 'opencode' || platform === 'codex';
+
+  // Parallel execution block
+  let parallelBlock;
+  if (supportsParallel) {
+    parallelBlock = `**Group D — Parallel execution:**\n\n${label} supports real parallel subagents. Ask:\n\n"Do you want to enable parallel subagent execution?"\n- **No** (recommended default) — Plans execute sequentially, one at a time. Safer, easier to follow.\n- **Yes** — Each independent plan in a wave gets its own dedicated subagent with a fresh context budget. Faster, but uses more tokens.`;
+  } else if (platform === 'gemini') {
+    parallelBlock = `**Group D — Parallel execution:**\n\nGemini CLI supports subagents but only runs them sequentially — parallel execution is not yet available. Parallelization is automatically set to \`false\`.`;
+  } else {
+    parallelBlock = `**Group D — Parallel execution:**\n\n${label} does not support real subagents. Parallelization is automatically set to \`false\`.`;
+  }
+  content = content.replace('<!-- LEARNSHIP_PARALLEL_BLOCK -->', parallelBlock);
+
+  return content;
+}
+
 /** Install Claude Code / Windsurf commands (commands/learnship/ → target/commands/learnship/) */
 function installClaudeCommands(srcDir, targetDir, pathPrefix) {
   const destDir = path.join(targetDir, 'commands', 'learnship');
@@ -1235,6 +1268,7 @@ if (process.env.LEARNSHIP_TEST_MODE) {
     installCodexAgents,
     parseJsonc,
     replacePaths,
+    rewriteNewProject,
     toHomePrefix,
     LEARNSHIP_CODEX_MARKER,
     CODEX_AGENT_SANDBOX,

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "learnship",
-  "version": "1.9.7",
+  "version": "1.9.9",
   "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/workflows/new-project.md

@@ -8,27 +8,7 @@ Initialize a new project with full context gathering, optional research, require
 
 ## Step 1: Setup
 
-**Detect the current platform** by inspecting the path of the file you are currently reading (this file). The install path uniquely identifies the platform:
-
-| If this file's path contains | Platform |
-|---|---|
-| `/.claude/` | Claude Code |
-| `/.codeium/` | Windsurf |
-| `/.config/opencode/` or `/.opencode/` | OpenCode |
-| `/.gemini/` | Gemini CLI |
-| `/.codex/` | Codex CLI |
-
-Set `PLATFORM` accordingly. If you cannot determine the path, ask: "Which platform are you running? (Windsurf / Claude Code / OpenCode / Gemini CLI / Codex CLI)"
-
-Platform determines:
-- Which directory to add to `.gitignore` (so AI config files aren't tracked)
-- Whether to ask the parallelization question (Group D below)
-- The gitignore directory by platform:
-  - **Claude Code** → `.claude/`
-  - **Windsurf** → `.windsurf/`
-  - **OpenCode** → `.opencode/`
-  - **Gemini CLI** → `.gemini/`
-  - **Codex CLI** → `.codex/`
+<!-- LEARNSHIP_PLATFORM_LABEL -->
 
 Check if `.planning/PROJECT.md` already exists:
 
@@ -49,22 +29,11 @@ test -d .git && echo "HAS_GIT" || echo "NO_GIT"
 git init
 ```
 
-Add the platform config directory to `.gitignore` so AI platform files are not tracked in the project repo. Use the platform-specific directory detected above:
+Add the platform config directory to `.gitignore` so AI platform files are not tracked in the project repo:
 ```bash
-# For Claude Code:
-grep -q '.claude/' .gitignore 2>/dev/null || echo '.claude/' >> .gitignore
-# For Windsurf:
-# grep -q '.windsurf/' .gitignore 2>/dev/null || echo '.windsurf/' >> .gitignore
-# For OpenCode:
-# grep -q '.opencode/' .gitignore 2>/dev/null || echo '.opencode/' >> .gitignore
-# For Gemini CLI:
-# grep -q '.gemini/' .gitignore 2>/dev/null || echo '.gemini/' >> .gitignore
-# For Codex CLI:
-# grep -q '.codex/' .gitignore 2>/dev/null || echo '.codex/' >> .gitignore
+<!-- LEARNSHIP_GITIGNORE_CMD -->
 ```
 
-Run only the line matching the detected platform.
-
 Create the planning directory:
 ```bash
 mkdir -p .planning/research
@@ -98,15 +67,7 @@ Ask: "Which workflow agents should be enabled?"
 - **Plan Check** (recommended) — Verify plans achieve their goals before execution
 - **Verifier** (recommended) — Confirm deliverables match phase goals after execution
 
-**Group D — Parallel execution:**
-
-**If PLATFORM is `WINDSURF`:** Skip this question entirely. Set `parallelization: false` automatically. Windsurf does not support real subagents.
-
-**If PLATFORM is `CLAUDE`, `OPENCODE`, `GEMINI`, or `CODEX`:** Ask this question — these platforms support real subagents:
-
-Ask: "Do you want to enable parallel subagent execution?"
-- **No** (recommended default) — Plans execute sequentially, one at a time. Safer, easier to follow.
-- **Yes** — Each independent plan in a wave gets its own dedicated subagent with a fresh context budget. Faster, but uses more tokens.
+<!-- LEARNSHIP_PARALLEL_BLOCK -->
 
 Ask: "Commit planning docs to git?"
 - **Yes** (recommended) — Planning docs tracked in version control

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "learnship",
-  "version": "1.9.7",
+  "version": "1.9.9",
   "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",