learnship 2.1.1 → 2.2.0

package/learnship/workflows/secure-phase.md

@@ -75,30 +75,72 @@ Classify each threat:
 
 If all threats are CLOSED: skip to Step 6.
 
-If open threats exist, present them:
+If open threats exist, present them with a structured question:
 
+Display the threat table first, then:
+
+```
+AskUserQuestion([
+  {
+    header: "Open Threats",
+    question: "[N] open threat(s) found. How do you want to handle them?",
+    multiSelect: false,
+    options: [
+      { label: "Verify all", description: "Investigate and resolve each open threat against the codebase" },
+      { label: "Accept all", description: "Document all as accepted risks with rationale" },
+      { label: "Review individually", description: "Decide per threat: verify, accept, or skip" }
+    ]
+  }
+])
 ```
-Open Threats ([N]):
 
-| ID | Category | Component | Description |
-|----|----------|-----------|-------------|
-| T-03-01 | Info Disclosure | api/auth.ts | JWT secret in environment without validation |
+## Step 5: Resolve Open Threats
 
-Options:
-1. Verify all open threats — investigate and resolve
-2. Accept all open — document as accepted risks
-3. Review individually — decide per threat
-```
+Read `parallelization` from `.planning/config.json` (defaults to `false`).
 
-Wait for user response.
+**For "Verify all":**
 
-## Step 5: Resolve Open Threats
+**If `parallelization.enabled` is `true`:**
+```
+Task(
+  subagent_type="learnship-security-auditor",
+  prompt="
+    <objective>
+    Verify all open threats in the threat register for phase [N].
+    Check each threat against the actual codebase. Update status to
+    CLOSED if mitigation found, or document what's missing.
+    Follow the security auditor persona at @./agents/security-auditor.md.
+    </objective>
+
+    <files_to_read>
+    - [phase SECURITY.md or threat register]
+    - @./agents/security-auditor.md (persona)
+    </files_to_read>
+  "
+)
+```
+
+**If `parallelization.enabled` is `false`:**
+Using `@./agents/security-auditor.md`, check each open threat against the codebase. Update status based on findings.
 
-For option 1 (verify all): Using `@./agents/verifier.md`, check each open threat against the codebase. Update status based on findings.
+**For "Accept all":** Add each to the Accepted Risks Log with user's rationale.
 
-For option 2 (accept all): Add each to the Accepted Risks Log with user's rationale.
+**For "Review individually":** Present each threat one at a time:
 
-For option 3 (individual): Present each threat one at a time with options: Verify / Accept / Skip.
+```
+AskUserQuestion([
+  {
+    header: "Threat [ID]",
+    question: "[Category]: [Description] in [Component]",
+    multiSelect: false,
+    options: [
+      { label: "Verify", description: "Investigate this threat against the codebase" },
+      { label: "Accept", description: "Document as accepted risk" },
+      { label: "Skip", description: "Leave open for now" }
+    ]
+  }
+])
+```
 
 ## Step 6: Write SECURITY.md
 

package/learnship/workflows/settings.md

@@ -87,166 +87,166 @@ cat .planning/config.json
 
 Parse current values to use as defaults in the prompts.
 
-## Step 3: Present Settings Menu
+## Step 3: Present Settings
 
-Display current settings and ask what to change:
+Display the settings banner, then present settings using structured question rounds. Use your platform's interactive question tool, or numbered text lists if unavailable. Pre-select current values where the tool supports it.
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  learnship ► SETTINGS
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Current configuration:
-
-[1] Mode:              [current] (yolo | interactive)
-[2] Granularity:       [current] (coarse | standard | fine)
-[3] Model profile:     [current] (quality | balanced | budget)
-[4] Learning mode:     [current] (auto | manual)
-[5] Test-first (TDD):  [on/off]
-[6] Research agent:    [on/off]
-[7] Plan check agent:  [on/off]
-[8] Verifier agent:    [on/off]
-[9] Test validation:   [on/off]
-[10] Review workflow:   [on/off]
-[11] Solutions search:  [on/off]
-[12] Security enforcement: [on/off]
-[13] Auto-review after verify: [on/off]
-[14] Ship: auto-test:   [on/off]
-[15] Ship: conventional commits: [on/off]
-[16] Ship: PR template: [on/off]
-[17] Parallelization:   [on/off] (max agents: [N])
-[18] Git branching:     [current] (none | phase | milestone)
-[19] Commit docs:       [on/off]
-[20] Safety: confirm destructive: [on/off]
-[21] Context warnings:  [on/off]
-
-Enter a number to change a setting, or 'done' to save.
-```
-
-Wait for selection. Repeat until user types "done".
-
-## Step 4: Change Selected Setting
-
-For each selected setting, explain the options and ask for the new value:
-
-**[1] Mode:**
-```
-Mode controls how much Cascade auto-approves vs. asks you:
-- yolo: auto-approves decisions, fastest flow
-- interactive: confirms at each step, more control
-
-Current: [current]. New value?
-```
-
-**[2] Granularity:**
-```
-Granularity controls phase size:
-- coarse: 3-5 phases (broad strokes)
-- standard: 5-8 phases (default)
-- fine: 8-12 phases (more granular, better for complex projects)
-
-Current: [current]. New value?
-```
-
-**[3] Model profile:**
-```
-Model profile controls which model tier each agent uses:
-- quality: large-tier for all decision-making agents (highest cost, best results)
-- balanced: large for planning, medium for execution (default — good balance)
-- budget: medium for writing code, small for research/verification (lowest cost)
-
-Current: [current]. New value?
-```
-
-**[4] Learning mode:**
-```
-Learning mode controls when learning actions are offered:
-- auto: offered automatically at workflow checkpoints (default)
-- manual: only when you explicitly invoke @agentic-learning
-
-Current: [current]. New value?
-```
-
-**[5] Test-first (TDD):**
-```
-Test-first mode enforces red-green-refactor during execute-phase:
-- on: write failing test → verify red → implement → verify green
-- off: write tests alongside implementation (default)
-
-Current: [current]. New value? (on/off)
-```
-
-**[6-8] Agent toggles (research / plan_check / verifier):**
-```
-[Research / Plan check / Verifier] agent:
-- on: agent runs (recommended for production work)
-- off: skip this agent (faster, for familiar domains or prototyping)
-
-Current: [current]. New value? (on/off)
 ```
 
-**[9] Test validation:**
-```
-Test validation maps automated test coverage to requirements during plan-phase.
-- on: plans include automated verify commands per task (recommended)
-- off: skip validation research (good for rapid prototyping)
-
-Current: [current]. New value? (on/off)
-```
-
-**[10] Review workflow:**
-```
-Multi-persona code review after verification:
-- on: /review is available and can be auto-triggered (recommended)
-- off: skip review workflow
-
-Current: [current]. New value? (on/off)
-```
+**Round 1 — Core settings (4 questions):**
 
-**[11] Solutions search:**
 ```
-Search .planning/solutions/ for prior art during plan-phase:
-- on: reuse patterns from solved problems (recommended)
-- off: skip solutions search
-
-Current: [current]. New value? (on/off)
-```
-
-**[12] Auto-review after verify:**
-```
-Automatically trigger /review after verify-work passes:
-- on: review starts immediately after successful verification
-- off: run /review manually when ready (default)
-
-Current: [current]. New value? (on/off)
+AskUserQuestion([
+  {
+    header: "Model Profile",
+    question: "Which model quality tier for agents?",
+    multiSelect: false,
+    options: [
+      { label: "Balanced (Recommended)", description: "Large for planning, medium for execution" },
+      { label: "Quality", description: "Large-tier for all agents (highest cost)" },
+      { label: "Budget", description: "Medium for code, small for research (lowest cost)" },
+      { label: "Inherit", description: "Use current session model for all agents" }
+    ]
+  },
+  {
+    header: "Mode",
+    question: "Working style?",
+    multiSelect: false,
+    options: [
+      { label: "YOLO", description: "Auto-approve steps, just execute" },
+      { label: "Interactive", description: "Confirm at each step, more control" }
+    ]
+  },
+  {
+    header: "Granularity",
+    question: "Phase size?",
+    multiSelect: false,
+    options: [
+      { label: "Coarse", description: "3-5 phases, broad strokes" },
+      { label: "Standard", description: "5-8 phases, balanced (default)" },
+      { label: "Fine", description: "8-12 phases, granular for complex projects" }
+    ]
+  },
+  {
+    header: "Learning",
+    question: "When should learning partner activate?",
+    multiSelect: false,
+    options: [
+      { label: "Auto", description: "Offer at natural checkpoints (default)" },
+      { label: "Manual", description: "Only when you invoke @agentic-learning" }
+    ]
+  }
+])
 ```
 
-**[13-15] Ship pipeline (auto_test / conventional_commits / pr_template):**
-```
-[Auto-test / Conventional commits / PR template]:
-- on: enabled (recommended)
-- off: disabled
+**Round 2 — Workflow agents (6 questions):**
 
-Current: [current]. New value? (on/off)
 ```
-
-**[16] Git branching:**
+AskUserQuestion([
+  {
+    header: "Research",
+    question: "Spawn researcher agent before planning?",
+    multiSelect: false,
+    options: [
+      { label: "Yes (Recommended)", description: "Research domain before planning each phase" },
+      { label: "No", description: "Skip research, plan directly" }
+    ]
+  },
+  {
+    header: "Plan Check",
+    question: "Verify plans before execution?",
+    multiSelect: false,
+    options: [
+      { label: "Yes (Recommended)", description: "Catch gaps before execution starts" },
+      { label: "No", description: "Execute without plan verification" }
+    ]
+  },
+  {
+    header: "Verifier",
+    question: "Verify phase completion?",
+    multiSelect: false,
+    options: [
+      { label: "Yes (Recommended)", description: "Confirm deliverables after execution" },
+      { label: "No", description: "Skip post-execution verification" }
+    ]
+  },
+  {
+    header: "Review",
+    question: "Multi-persona code review?",
+    multiSelect: false,
+    options: [
+      { label: "Yes (Recommended)", description: "Correctness, security, performance review" },
+      { label: "No", description: "Skip review" }
+    ]
+  },
+  {
+    header: "Solutions",
+    question: "Search prior solutions during planning?",
+    multiSelect: false,
+    options: [
+      { label: "Yes (Recommended)", description: "Check .planning/solutions/ for reusable patterns" },
+      { label: "No", description: "Plan without searching prior solutions" }
+    ]
+  },
+  {
+    header: "TDD",
+    question: "Test-first mode?",
+    multiSelect: false,
+    options: [
+      { label: "No (Recommended)", description: "Write tests alongside implementation" },
+      { label: "Yes", description: "Red-green-refactor: failing test first, then implement" }
+    ]
+  }
+])
 ```
-Branching strategy:
-- none: no automatic branches (good for solo work)
-- phase: create a branch at each execute-phase (good for code review per phase)
-- milestone: one branch for all phases in a milestone (good for release branches)
 
-Current: [current]. New value?
-```
+**Round 3 — Pipeline & git (4 questions):**
 
-**[17] Commit docs:**
 ```
-Whether .planning/ files are committed to git:
-- on: planning artifacts tracked in git (default)
-- off: keep .planning/ local only (add to .gitignore for privacy)
-
-Current: [current]. New value? (on/off)
+AskUserQuestion([
+  {
+    header: "Ship Pipeline",
+    question: "Ship pipeline preferences?",
+    multiSelect: true,
+    options: [
+      { label: "Auto-test before shipping (Recommended)", description: "Run tests before every ship" },
+      { label: "Conventional commits (Recommended)", description: "Use feat:, fix:, docs: prefixes" },
+      { label: "Auto-generate PR description (Recommended)", description: "Create PR body from commits" }
+    ]
+  },
+  {
+    header: "Git Tracking",
+    question: "Commit planning docs to git?",
+    multiSelect: false,
+    options: [
+      { label: "Yes (Recommended)", description: "Planning docs tracked in version control" },
+      { label: "No", description: "Keep .planning/ local-only" }
+    ]
+  },
+  {
+    header: "Branching",
+    question: "Git branching strategy?",
+    multiSelect: false,
+    options: [
+      { label: "None (Recommended)", description: "Commit directly to current branch" },
+      { label: "Per Phase", description: "Create branch for each phase" },
+      { label: "Per Milestone", description: "One branch for entire milestone" }
+    ]
+  },
+  {
+    header: "Context Warnings",
+    question: "Context window warnings?",
+    multiSelect: false,
+    options: [
+      { label: "Yes (Recommended)", description: "Warn when context usage is high" },
+      { label: "No", description: "Disable warnings, allow natural auto-compact" }
+    ]
+  }
+])
 ```
 
 ## Step 5: Save Config

package/learnship/workflows/validate-phase.md

@@ -80,24 +80,51 @@ If no gaps (all COVERED): proceed directly to step 8 with `compliant: true`.
 
 ## Step 7: Present Gap Plan and Fill
 
-Show gap table:
+Show the gap table, then present a structured question:
+
+```
+AskUserQuestion([
+  {
+    header: "Validation Gaps",
+    question: "[N] gap(s) found. How do you want to handle them?",
+    multiSelect: false,
+    options: [
+      { label: "Fill all gaps", description: "I'll write the missing tests automatically" },
+      { label: "Manual-only", description: "Skip automation, verify these manually" },
+      { label: "Cancel", description: "Stop validation — no changes" }
+    ]
+  }
+])
 ```
-Phase [N] Validation Gaps
 
-| Requirement | Status | Suggested test |
-|-------------|--------|----------------|
-| REQ-AUTH-01 | MISSING | src/__tests__/auth.test.ts |
-| REQ-DASH-02 | PARTIAL | src/__tests__/dashboard.test.ts |
+**If "Fill all gaps":**
 
-Options:
-1. Fill all gaps — I'll write the missing tests
-2. Mark as manual-only — skip automation, verify manually
-3. Cancel
+Read `parallelization` from `.planning/config.json` (defaults to `false`).
+
+**If `parallelization.enabled` is `true` (subagent mode):**
+```
+Task(
+  subagent_type="learnship-verifier",
+  prompt="
+    <objective>
+    Write missing test files for phase [N] validation gaps.
+    Read VALIDATION.md gaps and write tests that cover each MISSING or PARTIAL requirement.
+    Follow the verifier persona at @./agents/verifier.md.
+    Never modify implementation files — only write test files.
+    Run tests to verify they pass. Up to 3 debug attempts if tests fail.
+    </objective>
+
+    <files_to_read>
+    - [VALIDATION.md path]
+    - @./agents/verifier.md (persona)
+    </files_to_read>
+  "
+)
 ```
 
-Wait for choice.
+**If `parallelization.enabled` is `false` (sequential mode):**
 
-**If "Fill all gaps":** Write the missing test files. Rules:
+Write the missing test files. Rules:
 - Never touch implementation files
 - Match the existing test framework and style
 - Write tests that actually run (import real modules, not mocks of the implementation)

package/learnship/workflows/verify-work.md

@@ -245,6 +245,33 @@ All tests passed. ✓
 [N] issues found. Diagnosing root causes...
 ```
 
+Read `parallelization` from `.planning/config.json` (defaults to `false`).
+
+**If `parallelization.enabled` is `true` (subagent mode — Claude Code, OpenCode, Codex):**
+
+Spawn a dedicated debugger agent for diagnosis:
+```
+Task(
+  subagent_type="learnship-debugger",
+  prompt="
+    <objective>
+    Diagnose all issues found in UAT for phase [N].
+    Read the UAT.md file with gaps, trace each issue to its root cause.
+    Do NOT fix anything — just diagnose and document root causes.
+    Follow the debugger persona at @./agents/debugger.md.
+    Write root_cause and affected_files for each gap back to UAT.md.
+    </objective>
+
+    <files_to_read>
+    - [UAT.md path]
+    - @./agents/debugger.md (persona)
+    </files_to_read>
+  "
+)
+```
+
+**If `parallelization.enabled` is `false` (sequential mode):**
+
 For each issue in the Gaps section, investigate using `@./agents/debugger.md` as your debug persona:
 - Read the relevant source files
 - Trace the issue to its root cause

package/package.json

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

package/templates/config.json

@@ -1,6 +1,7 @@
 {
   "mode": "interactive",
   "granularity": "standard",
+  "context": "dev",
   "model_profile": "balanced",
   "learning_mode": "auto",
   "test_first": false,