@massa-ai/cursor-plugin 1.33.0 → 1.35.0

package/.cursor-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "massa-ai",
-  "version": "1.33.0",
+  "version": "1.35.0",
   "description": "massa-ai — semantic code search, memory, and context compression for Cursor"
 }

package/README.md

@@ -15,6 +15,8 @@ Skills (auto-loaded from `skills/<name>/SKILL.md`):
 | `graph` | Reference graph (who calls / imports / extends) |
 | `status` | Workspaces health + search analytics |
 
+Plus 40 generated workflow commands, one per massa-ai workflow, each auto-loaded the same way (`skills/debug/SKILL.md`, etc.) — see [Workflow Commands](../../FEATURES.md#workflow-commands-generated-slash-commands) in the root feature reference for the full naming table.
+
 MCP server: `massa-ai` (`npx @massa-ai/mcp-client` with `MASSA_AI_API_URL`) — registered into `~/.cursor/mcp.json` by `scripts/install-agents.sh`, which this installer calls for you. That script is the single writer of host MCP config; the plugin ships no `mcp.json`.
 
 Subagent: `massa-ai-navigator` — a code exploration specialist that queries the massa-ai semantic index before falling back to file reads.

package/install.sh

@@ -581,15 +581,17 @@ else
   cp "$SCRIPT_DIR/.cursor-plugin/plugin.json" "$PLUGIN_DIR/.cursor-plugin/plugin.json"
   vecho "  + .cursor-plugin/plugin.json"
 
-  # Copy the 6 host-command skills (each in a subdirectory: skills/<name>/SKILL.md).
-  # massa-ai/, persona-router/, and agents/ are the PDO-06 harness bundle, not a
-  # Cursor command skill — they are installed separately, into the shared
-  # harness skills directory (see "Skills bundling" below), not into this
-  # plugin-cache skills/ tree.
+  # Copy the host-command skills (each in a subdirectory: skills/<name>/SKILL.md),
+  # quick + generated workflow commands alike. massa-ai/, persona-router/,
+  # agents/, and profile/ are the PDO-06 harness bundle, not a Cursor command
+  # skill — they are installed separately, into the shared harness skills
+  # directory (see "Skills bundling" below), not into this plugin-cache
+  # skills/ tree. `profile` was missing from this exclusion pre-fix, which
+  # leaked it into the command-skill cache mislabeled as `/profile`.
   for src in "$SCRIPT_DIR/skills/"*/SKILL.md; do
     name="$(basename "$(dirname "$src")")"
     case "$name" in
-      massa-ai|persona-router|agents) continue ;;
+      massa-ai|persona-router|agents|profile) continue ;;
     esac
     mkdir -p "$PLUGIN_DIR/skills/$name"
     cp "$src" "$PLUGIN_DIR/skills/$name/SKILL.md"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massa-ai/cursor-plugin",
-  "version": "1.33.0",
+  "version": "1.35.0",
   "description": "massa-ai plugin for Cursor — semantic code search, memory, and context compression",
   "files": [
     "agents",

package/skills/adr/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Use this workflow to record a finalized or being-finalized architecture decision; route open options to rfc and implementation planning to tdd. — explicit massa-ai 'adr' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `adr`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `adr` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/architecture-audit/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Findings-only audit workflow for domain boundaries, bounded contexts, coupling, and architecture health against a concrete target; not for SOLID or code quality scans. — explicit massa-ai 'architecture-audit' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `architecture-audit`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `architecture-audit` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/architecture-fix/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Executes fixes from a saved architecture audit report; not for findings-only review or broad new design work with missing requirements. — explicit massa-ai 'architecture-fix' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `architecture-fix`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `architecture-fix` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/bugs-audit/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Findings-only bug discovery workflow for a concrete target; route known broken behavior to debug and code-quality concerns to code-quality-audit. — explicit massa-ai 'bugs-audit' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `bugs-audit`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `bugs-audit` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/bugs-fix/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Executes fixes from a saved bugs audit report; not for findings-only discovery, single known issues without a report, or broad product changes. — explicit massa-ai 'bugs-fix' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `bugs-fix`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `bugs-fix` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/code-quality-audit/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Findings-only audit workflow for SOLID, Clean Code, KISS, YAGNI, DRY, maintainability, and code-smell issues in a concrete target; not for architecture concerns. — explicit massa-ai 'code-quality-audit' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `code-quality-audit`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `code-quality-audit` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/code-quality-fix/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Executes fixes from a saved code quality audit report; not for findings-only SOLID, Clean Code, KISS, YAGNI, DRY, or overengineering analysis. — explicit massa-ai 'code-quality-fix' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `code-quality-fix`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `code-quality-fix` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/commit/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Use this workflow to draft a commit message, prepare, or commit current repository changes; not for Jira tickets, release notes, changelogs, or history rewriting. — explicit massa-ai 'commit' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `commit`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `commit` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/debug/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Use this workflow for evidence-backed root-cause diagnosis of broken behavior, failures, regressions, or crashes; route new capabilities to feature and broad redesign to spec-driven. — explicit massa-ai 'debug' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `debug`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `debug` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/design/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Implements or updates a concrete mobile UI from structured Figma evidence or screenshots when no saved audit report exists; route comparisons to mobile-figma-audit. — explicit massa-ai 'design' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `design`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `design` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/discovery/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Product discovery and brainstorming workflow — act as a sharp product thinking partner to explore problem spaces, generate and stress-test ideas, and spar on strategy before anything is spec-ready, ending with a mandatory offer to synthesize the conversation into a PRD via the to-prd workflow. Use when the user wants to brainstorm a product problem, idea, opportunity, or direction with no concrete code target. Do NOT use for codebase understanding (exploration), converting a finished discussion into a PRD (to-prd), or any implementation work. — explicit massa-ai 'discovery' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `discovery`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `discovery` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/exploration/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Read-only workflow for understanding a codebase, module, data flow, runtime behavior, schema, dependency, or architecture area before requesting changes. — explicit massa-ai 'exploration' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `exploration`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `exploration` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/feature/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Use this workflow to add a new capability, screen, command, integration, or user-facing improvement with clear intent; route broken behavior to debug and broad work to spec-driven. — explicit massa-ai 'feature' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `feature`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `feature` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/furps-refinement/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Findings-only refinement of a PRD and/or ADR against the FURPS+ quality model before implementation, fanning out one sub-agent per dimension with a structured report. — explicit massa-ai 'furps-refinement' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `furps-refinement`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `furps-refinement` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/general/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Final fallback workflow for coding, planning, review, or implementation work when no specialized massa-ai workflow is a better match. — explicit massa-ai 'general' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `general`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `general` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/implementation-audit/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Findings-only multi-lens audit of a concrete implementation target that dispatches child audit lenses and saves one durable report for implementation-fix. — explicit massa-ai 'implementation-audit' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `implementation-audit`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `implementation-audit` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/implementation-fix/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Executes confirmed findings from a saved implementation audit report; the saved audits/implementation report is the source of truth, not chat summaries. — explicit massa-ai 'implementation-fix' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `implementation-fix`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `implementation-fix` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/judge-with-debate/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Explicit-route workflow to evaluate an artifact through multi-judge debate against a tailored specification, converging on a consensus verdict or honest no-consensus. — explicit massa-ai 'judge-with-debate' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `judge-with-debate`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `judge-with-debate` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/long-session/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Use this workflow for same-session handoff, continuation, or safe stopping when work is unfinished, context budget is low, or verbose context reduces execution quality. — explicit massa-ai 'long-session' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `long-session`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `long-session` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/maestro/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Implements new Maestro mobile E2E flows from Jira/Confluence, prompt text, attached scenario files, or inferred scenarios when no explicit source is supplied. — explicit massa-ai 'maestro' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `maestro`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `maestro` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/maestro-audit/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Findings-only audit of existing Maestro mobile E2E flows, fixtures, setup/teardown, reports, selector stability, flake risk, and scenario coverage; does not edit code. — explicit massa-ai 'maestro-audit' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `maestro-audit`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `maestro-audit` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/maestro-fix/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Child-only workflow to fix confirmed MST-prefixed findings from a saved Maestro audit report or an explicit maestro-audit handoff. — explicit massa-ai 'maestro-fix' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `maestro-fix`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `maestro-fix` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/massa-ai/references/implementation-delivery.md

@@ -46,6 +46,15 @@ The only two legal skip reasons:
 Record the skip reason verbatim in the completion report. Any other reason is a
 protocol violation, not a shortcut.
 
+**Record the isolation evidence immediately after creation:** the worktree path
+and branch name go into the session status the moment Stage 1 completes, and
+every subsequent edit happens under that path. **Never switch branches in a
+checkout another session may share** — two sessions sharing one checkout can
+move each other's HEAD mid-run and land commits on the wrong branch (recorded
+incident, `.specs/project/STATE.md` 2026-08-05). This is a cross-**session**
+rule; the cross-**subagent** git-safety rule for concurrently-dispatched agents
+is owned by `references/agent-orchestration.md` and is not restated here.
+
 Set up the worktree's dependencies before the first gate — a fresh worktree has
 no `node_modules`, no `dist`, and no `.env`. A gate that fails only because the
 worktree was never provisioned is an environment failure; say so rather than

package/skills/massa-ai/workflows/architecture/architecture-fix.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 Not for findings-only architecture review — route to `workflows/architecture/architecture-audit.md`. Not for broad new design work with missing requirements — route to `workflows/spec-driven.md`.
 
 1. Resolve/reuse `workflowSessionId`: `architecture-fix-[entity]`

package/skills/massa-ai/workflows/bugs/bugs-fix.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 Not for findings-only bug discovery — route to `workflows/bugs/bugs-audit.md`. Not for one known broken behavior without an audit report — route to `workflows/debug.md`. Not for broad product/design changes — route to `workflows/spec-driven.md`.
 
 1. Resolve/reuse `workflowSessionId`: `bugs-fix-[entity]`

package/skills/massa-ai/workflows/code-quality/code-quality-fix.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 Not for findings-only SOLID, Clean Code, KISS, YAGNI, DRY, maintainability, or overengineering analysis — route to `workflows/code-quality/code-quality-audit.md`.
 
 1. Resolve/reuse `workflowSessionId`: `code-quality-fix-[entity]`

package/skills/massa-ai/workflows/debug.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 1. Generate/reuse `workflowSessionId`: `debug-[entity]`
 2. Load shared references:
    - `references/codebase-investigation.md`

package/skills/massa-ai/workflows/design.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 Not for Flutter, React Native, web UI, generic Figma exploration, variable-only queries, or MCP troubleshooting.
 
 1. Resolve/reuse `workflowSessionId`: `design-[entity]`.

package/skills/massa-ai/workflows/feature.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 1. Resolve/reuse `projectId` and `workflowSessionId` (`feature-[entity]`)
 2. `recall` → load prior decisions and patterns for this area
    - Use the default recall budget: `limit <= 3`, `minImportance >= 0.7`, and `types=["critical","decision","pattern"]` unless the feature needs broader memory discovery.

package/skills/massa-ai/workflows/general.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 1. Resolve or reuse `projectId` and a stable `workflowSessionId`: `general-[entity]`.
 2. Run General fallback preflight before source work: name the specialized workflow considered, the exact rejected reason, and why fallback does not change verification, mutation behavior, or memory scope. Ask the user only when the rejected workflow would change those behaviors.
 3. Recall relevant durable context with `recall`. Treat recalled memory as a lead until current source confirms it. Confirm against current source before relying on it only when the change touches the enumerated risk-domain set: public API, data loss, auth/PII, migrations, or cross-service contracts. Otherwise trust recalled memory and cite it with a one-line source note.

package/skills/massa-ai/workflows/implementation/implementation-fix.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 Do not execute from chat summaries, inline review comments, remembered findings, or old PR audit reports. The saved `audits/implementation/<YYYY-MM-DD implementation-audit.md>` report is the source of truth. Route fresh findings work to `workflows/implementation/implementation-audit.md`.
 
 1. Resolve/reuse `workflowSessionId`: `implementation-fix-[entity]`.

package/skills/massa-ai/workflows/maestro/maestro-fix.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 Reject direct use without a saved `audits/maestro/<YYYY-MM-DD maestro-audit.md>` report or a parent audit handoff that includes the same required metadata. Do not execute from chat summaries, remembered findings, inline comments, or unsaved model analysis. The saved report or parent handoff is the source of truth.
 
 1. Resolve/reuse `workflowSessionId`: `maestro-fix-[entity]`.

package/skills/massa-ai/workflows/maestro/maestro.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 Not for findings-only review of existing flows — route to `workflows/maestro/maestro-audit.md`. Not to execute saved audit findings — route to `workflows/maestro/maestro-fix.md`. Not for app bug fixes or product behavior changes — route to `workflows/debug.md`, `workflows/feature.md`, or `workflows/requirements/requirements-audit.md`.
 
 1. Resolve/reuse `workflowSessionId`: `maestro-[entity]`.

package/skills/massa-ai/workflows/mobile-figma/mobile-figma-fix.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 Do not execute from chat summaries, screenshots alone, remembered findings, or an unsaved comparison table. The saved `audits/mobile-figma/<YYYY-MM-DD mobile-figma-audit>.md` report is the source of truth. Route fresh comparison work to `mobile-figma-audit`.
 
 1. Resolve/reuse `workflowSessionId`: `mobile-figma-fix-[entity]`.

package/skills/massa-ai/workflows/refactor.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 1. Resolve/reuse `workflowSessionId`: `refactor-[entity]`
 2. `recall` → load architectural decisions and coupling patterns for the area
 3. Load shared references as needed:

package/skills/massa-ai/workflows/requirements/requirements-fix.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 Not for findings-only requirements review — route to `workflows/requirements/requirements-audit.md`. Not for broad feature design when acceptance criteria are missing — route to `workflows/spec-driven.md`.
 
 1. Resolve/reuse `workflowSessionId`: `requirements-fix-[entity]`

package/skills/massa-ai/workflows/security/security-fix.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 Not for findings-only security review — route to `workflows/security/security-audit.md`. Not for generic correctness fixes unless the security report identifies the correctness issue as part of an exploitable path.
 
 1. Resolve/reuse `workflowSessionId`: `security-fix-[entity]`

package/skills/massa-ai/workflows/spec-driven.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate), `references/code-annotation.md` (doc blocks, rationale, test coverage), and `references/repo-rules-discovery.md` (enforce the target repo's own `.claude/`/`.cursor/` and module/test conventions). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 ## TLC v3 Flow
 
 Run the integrated TLC Spec-Driven v3 flow:

package/skills/massa-ai/workflows/tests/tests-fix.md

@@ -14,6 +14,8 @@ Load `references/project-context.md` (intake sweep) before the first substantive
 
 Before the first repository mutation, load `references/implementation-delivery.md` (delivery chain: worktree, atomic commits, PR, CI watch, merge gate) and `references/code-annotation.md` (doc blocks, rationale, test coverage). After two consecutive failed fixes on one symptom, stop editing and load `references/root-cause-scripts.md`.
 
+**Isolation Gate — before the first file edit:** execute `references/implementation-delivery.md` Stage 0–1 now (fetch base, create the worktree + branch, work inside it) and record the worktree path + branch — or one of Stage 1's two legal skip reasons, verbatim — before any repository mutation.
+
 Not for findings-only test coverage, assertion quality, fixture health, flakiness, or regression-risk review — route to `workflows/tests/tests-audit.md`. Not for generic "write some tests" work without an audit report — route broad test planning through the relevant feature, debug, refactor, or spec-driven workflow.
 
 1. Resolve/reuse `workflowSessionId`: `tests-fix-[entity]`

package/skills/mobile-figma-audit/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Findings-only audit comparing an existing mobile UI implementation against Figma MCP evidence for a concrete feature, file set, screen, or commit range; does not edit code. — explicit massa-ai 'mobile-figma-audit' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `mobile-figma-audit`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `mobile-figma-audit` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/mobile-figma-fix/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Fixes confirmed MFM-prefixed findings from a saved mobile Figma audit report; the saved audit report is the source of truth, not screenshots or chat summaries. — explicit massa-ai 'mobile-figma-fix' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `mobile-figma-fix`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `mobile-figma-fix` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/onboarding/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Use this workflow on a first session or with missing project context to resolve project identity, establish memory/index state, and capture an architecture overview. — explicit massa-ai 'onboarding' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `onboarding`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `onboarding` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/pr-review/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Explicit-route workflow to review a hosted GitHub Pull Request or GitLab Merge Request across six dimensions — security, requirements, test coverage, architecture, regression, performance — using massa-ai roster subagents, then post inline comments plus one consolidated summary through the host CLI (gh or glab). Use when the user says review PR 128, review this MR, or code review this pull request. Do NOT use for local working-diff review (audit workflows), creating PRs, replying to review comments, or fixing CI. — explicit massa-ai 'pr-review' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `pr-review`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `pr-review` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/refactor/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Behavior-preserving structural cleanup, simplification, decoupling, and testability workflow; route broken behavior to debug and broad boundary redesign to architecture-audit or spec-driven. — explicit massa-ai 'refactor' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `refactor`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `refactor` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/requirements-audit/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Findings-only review of whether a concrete target matches stated requirements without out-of-scope drift; routes correctness, security, and quality findings elsewhere. — explicit massa-ai 'requirements-audit' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `requirements-audit`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `requirements-audit` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/requirements-fix/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Executes fixes from a saved requirements audit report; not for findings-only review or broad feature design when acceptance criteria are missing. — explicit massa-ai 'requirements-fix' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `requirements-fix`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `requirements-fix` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/rfc/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Use this workflow when a significant technical, process, product, vendor, tool, or policy decision is still open and stakeholders need a structured proposal before committing. — explicit massa-ai 'rfc' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `rfc`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `rfc` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/security-audit/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Findings-only security review workflow for a concrete target; routes generic correctness bugs and other audit categories to their dedicated workflows. — explicit massa-ai 'security-audit' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `security-audit`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `security-audit` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/security-fix/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Executes fixes from a saved security audit report; not for findings-only security review or generic correctness fixes outside an exploitable path. — explicit massa-ai 'security-fix' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `security-fix`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `security-fix` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/skill-architect/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Expert guide for designing and building high-quality skills from scratch through structured conversation. Use when someone wants to create a new skill, build a skill, design a skill, or asks for help making Agents do something consistently. Also use when someone says \"turn this into a skill\", \"I want to automate this workflow\", \"how do I teach my Agent to do X\", or mentions creating SKILL.md files. Covers standalone skills and MCP-enhanced workflows. Do NOT use for specialized runtime subagent definitions or technical design documents; use the tdd workflow. — explicit massa-ai 'skill-architect' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `skill-architect`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `skill-architect` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/spec-driven/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Use this workflow for explicit spec-driven requests and broad, ambiguous, migration-heavy, or cross-boundary delivery needing requirements-through-verification control. — explicit massa-ai 'spec-driven' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `spec-driven`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `spec-driven` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/tdd/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Use this workflow to write a Technical Design Document once one product direction is selected and no unresolved API, data, security, or rollout decision blocks implementation. — explicit massa-ai 'tdd' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `tdd`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `tdd` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/tests-audit/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Findings-only audit of test coverage, regression protection, assertion quality, fixture reliability, and missing deterministic sensors in a concrete target. — explicit massa-ai 'tests-audit' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `tests-audit`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `tests-audit` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/tests-fix/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Executes fixes from a saved tests audit report; not for findings-only coverage review or generic test-writing work without an audit report. — explicit massa-ai 'tests-fix' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `tests-fix`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `tests-fix` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/the-fool/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Use this workflow for direct requests to challenge ideas, plans, decisions, or evidence, and as the configured post-plan challenge gate after other workflows construct a plan. — explicit massa-ai 'the-fool' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `the-fool`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `the-fool` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/ticket/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Use this workflow to draft, review, create, or resume creation of Jira Epics, issues, or sub-tasks through Atlassian MCP, the only tracker and mutation path. — explicit massa-ai 'ticket' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `ticket`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `ticket` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS

package/skills/to-prd/SKILL.md

@@ -0,0 +1,14 @@
+---
+description: "Turn the current conversation into a PRD. Use when the user asks to create, synthesize, or convert existing discussion and codebase context into a Product Requirements Document without another interview. Do NOT use for implementation plans, architecture design docs, RFCs, TDDs, or discovery interviews that require new product questioning. — explicit massa-ai 'to-prd' workflow"
+argument-hint: "[task description]"
+---
+<!-- massa-ai:generated workflow-command -->
+
+Explicit massa-ai workflow invocation: `to-prd`.
+
+Load the massa-ai router skill if not already loaded (dedupe guard), then
+route to workflow `to-prd` under routing precedence 1 (explicit route) —
+do not reclassify. Pass the following as the task description; if empty,
+the workflow's own intake gathers it.
+
+$ARGUMENTS