learnship 1.9.0

package/commands/learnship/pause-work.md

@@ -0,0 +1,21 @@
+---
+name: learnship:pause-work
+description: Save a handoff file when stopping mid-phase so you can resume seamlessly later
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+---
+
+<execution_context>
+@~/.claude/workflows/pause-work.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship pause-work workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/plan-milestone-gaps.md

@@ -0,0 +1,22 @@
+---
+name: learnship:plan-milestone-gaps
+description: Create fix phases for all gaps found by audit-milestone
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - Task
+---
+
+<execution_context>
+@~/.claude/workflows/plan-milestone-gaps.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship plan-milestone-gaps workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/plan-phase.md

@@ -0,0 +1,24 @@
+---
+name: learnship:plan-phase
+description: Research + create + verify plans for a phase — spawns specialist subagents where supported
+argument-hint: "[N]"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - Task
+  - AskUserQuestion
+---
+
+<execution_context>
+@~/.claude/workflows/plan-phase.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship plan-phase workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/progress.md

@@ -0,0 +1,20 @@
+---
+name: learnship:progress
+description: Show project progress, current position, and what to do next
+allowed-tools:
+  - Read
+  - Bash
+---
+
+<execution_context>
+@~/.claude/workflows/progress.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship progress workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/quick.md

@@ -0,0 +1,27 @@
+---
+name: learnship:quick
+description: Execute an ad-hoc task with full agentic guarantees — atomic commits, state tracking, no full planning ceremony
+argument-hint: ""<task description>""
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+---
+
+<execution_context>
+@~/.claude/workflows/quick.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship quick workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/reapply-patches.md

@@ -0,0 +1,21 @@
+---
+name: learnship:reapply-patches
+description: Restore local workflow customizations after updating the platform
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+---
+
+<execution_context>
+@~/.claude/workflows/reapply-patches.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship reapply-patches workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/release.md

@@ -0,0 +1,21 @@
+---
+name: learnship:release
+description: Cut a new learnship release — bump version, update changelog, push to public-main, tag, create GitHub release
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+---
+
+<execution_context>
+@~/.claude/workflows/release.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship release workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/remove-phase.md

@@ -0,0 +1,23 @@
+---
+name: learnship:remove-phase
+description: Remove a planned (not yet executed) phase and renumber subsequent phases
+argument-hint: "[N]"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - AskUserQuestion
+---
+
+<execution_context>
+@~/.claude/workflows/remove-phase.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship remove-phase workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/research-phase.md

@@ -0,0 +1,23 @@
+---
+name: learnship:research-phase
+description: Deep-dive domain research for a phase without immediately creating plans
+argument-hint: "[N]"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - Task
+---
+
+<execution_context>
+@~/.claude/workflows/research-phase.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship research-phase workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/resume-work.md

@@ -0,0 +1,21 @@
+---
+name: learnship:resume-work
+description: Restore full project context and continue from where you left off
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+---
+
+<execution_context>
+@~/.claude/workflows/resume-work.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship resume-work workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/set-profile.md

@@ -0,0 +1,21 @@
+---
+name: learnship:set-profile
+description: Quick model profile switch without opening full settings
+argument-hint: "[quality|balanced|budget]"
+allowed-tools:
+  - Read
+  - Write
+---
+
+<execution_context>
+@~/.claude/workflows/set-profile.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship set-profile workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/settings.md

@@ -0,0 +1,21 @@
+---
+name: learnship:settings
+description: Interactive settings editor for .planning/config.json
+allowed-tools:
+  - Read
+  - Write
+  - AskUserQuestion
+---
+
+<execution_context>
+@~/.claude/workflows/settings.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship settings workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/transition.md

@@ -0,0 +1,21 @@
+---
+name: learnship:transition
+description: Hand off a project context to a new session or collaborator — writes a HANDOFF.md with full state snapshot
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+---
+
+<execution_context>
+@~/.claude/workflows/transition.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship transition workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/update.md

@@ -0,0 +1,21 @@
+---
+name: learnship:update
+description: Update the learnship platform itself to the latest version
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+---
+
+<execution_context>
+@~/.claude/workflows/update.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship update workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/validate-phase.md

@@ -0,0 +1,22 @@
+---
+name: learnship:validate-phase
+description: Retroactive test coverage audit for a completed phase — fill validation gaps without modifying implementation
+argument-hint: "[N]"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+---
+
+<execution_context>
+@~/.claude/workflows/validate-phase.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship validate-phase workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/commands/learnship/verify-work.md

@@ -0,0 +1,23 @@
+---
+name: learnship:verify-work
+description: Manual user acceptance testing — walk through what was built, log issues, create fix plans
+argument-hint: "[N]"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - AskUserQuestion
+---
+
+<execution_context>
+@~/.claude/workflows/verify-work.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS
+</context>
+
+<process>
+Execute the learnship verify-work workflow end-to-end.
+Preserve all workflow gates, validations, checkpoints, and routing.
+</process>

package/cursor-rules/learnship.mdc

@@ -0,0 +1,60 @@
+---
+name: learnship
+description: Activate learnship agentic engineering workflows — structured phases, persistent memory, learning partner, and impeccable UI design. Use whenever a user is working on a software project or asks about project planning, phases, workflows, or how to build something.
+---
+
+You are working inside a project that uses **learnship** — a multi-platform agentic engineering system for building real products with spec-driven workflows, integrated learning, and impeccable design.
+
+## Core Workflows
+
+Suggest the appropriate workflow slash command when relevant:
+
+| Workflow | When to suggest |
+|----------|----------------|
+| `/new-project` | User wants to start a new project from scratch |
+| `/discuss-phase [N]` | Before planning a phase — capture user's implementation vision |
+| `/plan-phase [N]` | After discussing a phase — create executable plans |
+| `/execute-phase [N]` | Plans exist and are ready to run |
+| `/verify-work [N]` | Phase execution complete — user acceptance testing |
+| `/ls` | User asks "where are we?", "what's next?", or starts a new session |
+| `/next` | User wants to keep moving without deciding what to do |
+| `/quick [task]` | Small ad-hoc task that doesn't need full phase ceremony |
+| `/progress` | Status overview and routing |
+| `/pause-work` | User is stopping mid-phase |
+| `/resume-work` | User is returning to an in-progress project |
+| `/complete-milestone` | All phases in the current milestone are done |
+
+## Planning Artifacts
+
+All project state lives in `.planning/`. Key files:
+
+- `.planning/config.json` — Settings including `learning_mode` ("auto" or "manual")
+- `.planning/PROJECT.md` — Vision, requirements, key decisions
+- `.planning/ROADMAP.md` — Phase-by-phase delivery plan
+- `.planning/STATE.md` — Current position, decisions, blockers
+- `.planning/phases/[N]-[slug]/` — Per-phase artifacts
+
+Always read `STATE.md` and `ROADMAP.md` before any planning or execution operation.
+
+## Key Behaviors
+
+- **Context efficiency**: Reference file paths rather than inlining file contents.
+- **Atomic commits**: Every task gets its own commit. Never batch unrelated changes.
+- **No scope creep**: Execute exactly what plans say. Document deviations in SUMMARY.md.
+- **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.
+
+## Learning Mode
+
+Read `learning_mode` from `.planning/config.json` (default: "auto"):
+
+- **`auto`** — Proactively offer learning actions at natural workflow checkpoints
+- **`manual`** — Only activate learning when the user explicitly asks
+
+## Design Quality
+
+The `impeccable` skill is available for UI work. Key commands:
+- `@impeccable audit` — full quality audit
+- `@impeccable polish` — final pass before shipping
+- `@impeccable frontend-design` — apply design foundation principles
+- `@impeccable critique` — UX effectiveness review

package/gemini-extension.json

@@ -0,0 +1,10 @@
+{
+  "name": "learnship",
+  "version": "1.9.0",
+  "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/",
+  "repository": "https://github.com/FavioVazquez/learnship",
+  "license": "MIT",
+  "installDir": ".gemini"
+}

package/hooks/hooks-claude.json

@@ -0,0 +1,15 @@
+{
+  "description": "learnship session context injection",
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/session-start\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/hooks-cursor.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "hooks": {
+    "sessionStart": [
+      {
+        "command": "\"${CURSOR_PLUGIN_ROOT}/hooks/session-start\""
+      }
+    ]
+  }
+}

package/hooks/session-start

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# SessionStart hook for learnship plugin
+# Injects learnship SKILL.md context at every session start so the agent
+# always knows the workflows, planning artifacts, and learning system.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+SKILL_FILE="${PLUGIN_ROOT}/SKILL.md"
+
+if [ ! -f "$SKILL_FILE" ]; then
+  exit 0
+fi
+
+skill_content=$(cat "$SKILL_FILE" 2>/dev/null || echo "")
+
+escape_for_json() {
+  local s="$1"
+  s="${s//\\/\\\\}"
+  s="${s//\"/\\\"}"
+  s="${s//$'\n'/\\n}"
+  s="${s//$'\r'/\\r}"
+  s="${s//$'\t'/\\t}"
+  printf '%s' "$s"
+}
+
+skill_escaped=$(escape_for_json "$skill_content")
+
+session_context="<learnship>\nYou are working in a project that uses learnship — an agentic engineering system.\n\n${skill_escaped}\n</learnship>"
+
+# Cursor sets CURSOR_PLUGIN_ROOT; Claude Code sets CLAUDE_PLUGIN_ROOT.
+# Emit the field each platform expects to avoid double-injection.
+if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
+  printf '{\n  "additional_context": "%s"\n}\n' "$session_context"
+elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ]; then
+  printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context"
+else
+  printf '{\n  "additional_context": "%s"\n}\n' "$session_context"
+fi
+
+exit 0