ma-agents 3.4.7 → 3.4.9

package/.opencode/skills/.ma-agents.json

@@ -6,235 +6,235 @@
   ],
   "scope": "project",
   "skills": {
-    "ai-audit-trail": {
-      "version": "1.0.0",
-      "installedAt": "2026-04-01T10:30:58.027Z",
-      "updatedAt": "2026-04-01T10:30:58.027Z",
-      "installerVersion": "3.4.3",
+    "git-workflow-skill": {
+      "version": "2.1.0",
+      "installedAt": "2026-04-05T18:07:12.696Z",
+      "updatedAt": "2026-04-05T18:09:29.627Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "auto-bug-detection": {
+    "js-ts-dependency-mgmt": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:30:58.395Z",
-      "updatedAt": "2026-04-01T10:30:58.395Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:30.300Z",
+      "updatedAt": "2026-04-05T18:09:35.734Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cmake-best-practices": {
+    "js-ts-security-skill": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:30:58.887Z",
-      "updatedAt": "2026-04-01T10:30:58.887Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:31.521Z",
+      "updatedAt": "2026-04-05T18:09:37.126Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "code-documentation": {
+    "logging-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:30:59.856Z",
-      "updatedAt": "2026-04-01T10:30:59.856Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:34.518Z",
+      "updatedAt": "2026-04-05T18:09:48.622Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "code-review": {
+    "open-presentation": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:00.634Z",
-      "updatedAt": "2026-04-01T10:31:00.634Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:36.318Z",
+      "updatedAt": "2026-04-05T18:09:53.125Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "commit-message": {
+    "opentelemetry-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:01.128Z",
-      "updatedAt": "2026-04-01T10:31:01.128Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:39.513Z",
+      "updatedAt": "2026-04-05T18:07:39.513Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cpp-best-practices": {
+    "python-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:01.896Z",
-      "updatedAt": "2026-04-01T10:31:01.896Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:40.244Z",
+      "updatedAt": "2026-04-05T18:07:40.244Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cpp-concurrency-safety": {
+    "python-dependency-mgmt": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:02.715Z",
-      "updatedAt": "2026-04-01T10:31:02.715Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:41.778Z",
+      "updatedAt": "2026-04-05T18:07:41.778Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cpp-const-correctness": {
+    "python-security-skill": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:03.378Z",
-      "updatedAt": "2026-04-01T10:31:03.378Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:43.209Z",
+      "updatedAt": "2026-04-05T18:07:43.209Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cpp-memory-handling": {
+    "self-signed-cert": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:03.925Z",
-      "updatedAt": "2026-04-01T10:31:03.925Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:46.583Z",
+      "updatedAt": "2026-04-05T18:07:46.583Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cpp-modern-composition": {
+    "skill-creator": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:04.764Z",
-      "updatedAt": "2026-04-01T10:31:04.764Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:49.678Z",
+      "updatedAt": "2026-04-05T18:07:49.678Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cpp-robust-interfaces": {
+    "story-status-lookup": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:05.367Z",
-      "updatedAt": "2026-04-01T10:31:05.367Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:50.727Z",
+      "updatedAt": "2026-04-05T18:07:50.727Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "create-hardened-docker-skill": {
+    "test-accompanied-development": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:05.831Z",
-      "updatedAt": "2026-04-01T10:31:05.831Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:53.179Z",
+      "updatedAt": "2026-04-05T18:07:53.179Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "csharp-best-practices": {
+    "test-generator": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:06.541Z",
-      "updatedAt": "2026-04-01T10:31:06.541Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:54.383Z",
+      "updatedAt": "2026-04-05T18:07:54.383Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "docker-hardening-verification": {
+    "vercel-react-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:07.074Z",
-      "updatedAt": "2026-04-01T10:31:07.074Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:58.007Z",
+      "updatedAt": "2026-04-05T18:07:58.007Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "docker-image-signing": {
+    "verify-hardened-docker-skill": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:07.601Z",
-      "updatedAt": "2026-04-01T10:31:07.601Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:04.319Z",
+      "updatedAt": "2026-04-05T18:08:04.319Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "document-revision-history": {
+    "ai-audit-trail": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:08.024Z",
-      "updatedAt": "2026-04-01T10:31:08.024Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:39.503Z",
+      "updatedAt": "2026-04-05T18:08:39.503Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "git-workflow-skill": {
-      "version": "2.1.0",
-      "installedAt": "2026-04-01T10:31:08.790Z",
-      "updatedAt": "2026-04-01T10:31:08.790Z",
-      "installerVersion": "3.4.3",
+    "auto-bug-detection": {
+      "version": "1.0.0",
+      "installedAt": "2026-04-05T18:08:41.377Z",
+      "updatedAt": "2026-04-05T18:08:41.377Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "js-ts-dependency-mgmt": {
+    "cmake-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:09.438Z",
-      "updatedAt": "2026-04-01T10:31:09.438Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:43.339Z",
+      "updatedAt": "2026-04-05T18:08:43.339Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "js-ts-security-skill": {
+    "code-documentation": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:09.846Z",
-      "updatedAt": "2026-04-01T10:31:09.846Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:45.996Z",
+      "updatedAt": "2026-04-05T18:08:45.996Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "logging-best-practices": {
+    "code-review": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:10.688Z",
-      "updatedAt": "2026-04-01T10:31:10.688Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:47.752Z",
+      "updatedAt": "2026-04-05T18:08:47.752Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "open-presentation": {
+    "commit-message": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:11.332Z",
-      "updatedAt": "2026-04-01T10:31:11.332Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:50.322Z",
+      "updatedAt": "2026-04-05T18:08:50.322Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "opentelemetry-best-practices": {
+    "cpp-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:12.541Z",
-      "updatedAt": "2026-04-01T10:31:12.541Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:51.509Z",
+      "updatedAt": "2026-04-05T18:08:51.509Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "python-best-practices": {
+    "cpp-concurrency-safety": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:13.227Z",
-      "updatedAt": "2026-04-01T10:31:13.227Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:56.571Z",
+      "updatedAt": "2026-04-05T18:08:56.571Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "python-dependency-mgmt": {
+    "cpp-const-correctness": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:13.944Z",
-      "updatedAt": "2026-04-01T10:31:13.944Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:57.540Z",
+      "updatedAt": "2026-04-05T18:08:57.540Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "python-security-skill": {
+    "cpp-memory-handling": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:14.473Z",
-      "updatedAt": "2026-04-01T10:31:14.473Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:59.690Z",
+      "updatedAt": "2026-04-05T18:08:59.690Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "self-signed-cert": {
+    "cpp-modern-composition": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:14.915Z",
-      "updatedAt": "2026-04-01T10:31:14.915Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:03.289Z",
+      "updatedAt": "2026-04-05T18:09:03.289Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "skill-creator": {
+    "cpp-robust-interfaces": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:15.947Z",
-      "updatedAt": "2026-04-01T10:31:15.947Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:05.913Z",
+      "updatedAt": "2026-04-05T18:09:05.913Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "story-status-lookup": {
+    "create-hardened-docker-skill": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:16.515Z",
-      "updatedAt": "2026-04-01T10:31:16.515Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:07.044Z",
+      "updatedAt": "2026-04-05T18:09:07.044Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "test-accompanied-development": {
+    "csharp-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:16.837Z",
-      "updatedAt": "2026-04-01T10:31:16.837Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:09.984Z",
+      "updatedAt": "2026-04-05T18:09:09.984Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "test-generator": {
+    "docker-hardening-verification": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:17.620Z",
-      "updatedAt": "2026-04-01T10:31:17.620Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:13.601Z",
+      "updatedAt": "2026-04-05T18:09:13.601Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "vercel-react-best-practices": {
+    "docker-image-signing": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:18.135Z",
-      "updatedAt": "2026-04-01T10:31:18.135Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:21.890Z",
+      "updatedAt": "2026-04-05T18:09:21.890Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "verify-hardened-docker-skill": {
+    "document-revision-history": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:19.086Z",
-      "updatedAt": "2026-04-01T10:31:19.086Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:25.478Z",
+      "updatedAt": "2026-04-05T18:09:25.478Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     }
   }

package/.opencode/skills/add-sprint/SKILL.md

@@ -0,0 +1,207 @@
+---
+name: add-sprint
+description: Guided workflow to create a new sprint entity with capacity limits, optional ISO dates, and structured YAML schema for sprint planning
+type: skill
+triggers:
+  - "add sprint"
+  - "create sprint"
+---
+
+# Add Sprint Workflow
+
+Guided workflow to create a new sprint entity with capacity limits, optional ISO dates, and structured YAML schema.
+
+<workflow>
+
+<step n="1" goal="Gather and validate sprint number and name">
+  <action>Ask the user for the sprint number</action>
+  <ask>What is the sprint number? (positive integer, e.g., 1, 2, 3)</ask>
+  <action>Store input as {{sprint_number_input}}</action>
+  <action>Validate {{sprint_number_input}} matches `^[1-9]\d*$` (positive integer, no leading zeros, no non-numeric characters)</action>
+  <action>Validate {{sprint_number_input}} is <= 9999</action>
+  <check if="{{sprint_number_input}} fails validation (zero, negative, non-numeric, leading zeros like '03', or > 9999)">
+    <output>❌ Invalid sprint number: "{{sprint_number_input}}". Must be a positive integer (1-9999), no leading zeros.</output>
+    <goto step="1" />
+  </check>
+  <action>Store as {{sprint_number}} (integer)</action>
+  <action>Construct {{sprint_id}} = "sprint-{{sprint_number}}"</action>
+
+  <!-- Smart default name: detect naming patterns from existing sprints -->
+  <action>Glob `_bmad-output/implementation-artifacts/sprints/sprint-*.yaml` to discover existing sprint files</action>
+  <action>If existing sprints found, read the `name` field from the most recent one (highest sprint number)</action>
+  <action>Infer a smart default name:
+    - If previous name follows a sequential pattern with a numeric suffix (e.g., "app04"), suggest the next increment (e.g., "app05")
+    - If previous name follows a date pattern (e.g., "2026-W14"), suggest the next date interval
+    - If previous name is "Sprint {n}", suggest "Sprint {{sprint_number}}"
+    - If no pattern detected or no existing sprints, default to "Sprint {{sprint_number}}"
+  </action>
+  <ask>Sprint name? (press Enter for "{{default_name}}", or type a custom name):</ask>
+  <action>If user presses Enter or leaves blank, set {{sprint_name}} = "{{default_name}}"</action>
+  <action>If user provides input, store as {{sprint_name}}</action>
+</step>
+
+<step n="2" goal="Gather capacity as positive integer">
+  <action>Explain capacity: the maximum number of items (stories + bugs) that can be assigned to this sprint</action>
+  <ask>What is the sprint capacity? (Enter a positive integer — the maximum number of stories/bugs for this sprint)</ask>
+  <action>Store input as {{capacity_input}}</action>
+  <action>Validate {{capacity_input}} is a positive integer (greater than zero, no decimals, no non-numeric characters)</action>
+  <check if="{{capacity_input}} is NOT a positive integer">
+    <output>❌ Invalid capacity: "{{capacity_input}}". Capacity must be a positive integer (e.g., 5, 10, 20). Zero and negative values are not allowed.</output>
+    <goto step="2" />
+  </check>
+  <action>Store as {{capacity}} (integer)</action>
+</step>
+
+<step n="3a" goal="Gather optional start date (ISO format)">
+  <action>Explain: start and end dates are optional ISO dates (YYYY-MM-DD format). Press Enter to skip.</action>
+  <ask>Optional — Sprint start date (YYYY-MM-DD, press Enter to skip):</ask>
+  <action>Store input as {{start_input}}</action>
+  <check if="{{start_input}} is not empty">
+    <action>Validate {{start_input}} matches regex `^\d{4}-\d{2}-\d{2}$`</action>
+    <action>Verify {{start_input}} resolves to a real calendar date (reject impossible dates like 2026-02-30, 2026-13-45, etc.)</action>
+    <check if="{{start_input}} fails date validation">
+      <output>❌ Invalid date: "{{start_input}}". Must be a valid date in YYYY-MM-DD format (e.g., 2026-04-01).</output>
+      <goto step="3a" />
+    </check>
+  </check>
+  <action>Store as {{start_date}} (valid ISO date string, or empty string "" if skipped)</action>
+</step>
+
+<step n="3b" goal="Gather optional end date (ISO format)">
+  <ask>Optional — Sprint end date (YYYY-MM-DD, press Enter to skip):</ask>
+  <action>Store input as {{end_input}}</action>
+  <check if="{{end_input}} is not empty">
+    <action>Validate {{end_input}} matches regex `^\d{4}-\d{2}-\d{2}$`</action>
+    <action>Verify {{end_input}} resolves to a real calendar date</action>
+    <check if="{{end_input}} fails date validation">
+      <output>❌ Invalid date: "{{end_input}}". Must be a valid date in YYYY-MM-DD format (e.g., 2026-04-14).</output>
+      <goto step="3b" />
+    </check>
+  </check>
+  <action>Store as {{end_date}} (valid ISO date string, or empty string "" if skipped)</action>
+
+  <check if="both {{start_date}} and {{end_date}} are non-empty AND {{start_date}} > {{end_date}}">
+    <output>❌ Invalid date range: start date ({{start_date}}) is after end date ({{end_date}}). Start must be on or before end.</output>
+    <goto step="3a" />
+  </check>
+</step>
+
+<step n="4" goal="Confirm and validate all inputs">
+  <output>
+## Sprint Summary — Please Confirm
+
+- **Sprint ID:** {{sprint_id}}
+- **Sprint Name:** "{{sprint_name}}"
+- **Status:** planning
+- **Capacity (max items):** {{capacity}}
+- **Start Date:** {{start_date}} *(empty if skipped)*
+- **End Date:** {{end_date}} *(empty if skipped)*
+- **Items:** [] *(empty — items assigned via /add-to-sprint)*
+- **Output File:** `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`
+  </output>
+  <ask>Confirm creation? [y] Yes / [n] Cancel / [e] Edit a field:</ask>
+  <check if="user selects 'e'">
+    <ask>Which field to edit? (number / name / capacity / start / end)</ask>
+    <check if="field == 'number'">
+      <ask>New sprint number? (positive integer, 1-9999)</ask>
+      <action>Store input as {{sprint_number_input}}</action>
+      <action>Validate {{sprint_number_input}} matches `^[1-9]\d*$` and is <= 9999</action>
+      <check if="{{sprint_number_input}} fails validation">
+        <output>❌ Invalid sprint number: "{{sprint_number_input}}". Must be a positive integer (1-9999), no leading zeros.</output>
+        <goto step="4" />
+      </check>
+      <action>Store as {{sprint_number}} (integer)</action>
+      <action>Construct {{sprint_id}} = "sprint-{{sprint_number}}"</action>
+      <action>If sprint name was using previous default "Sprint {old_n}", update to "Sprint {{sprint_number}}"</action>
+      <action>Check if file exists at `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`</action>
+      <check if="file already exists at new path">
+        <output>⚠️ A sprint entity already exists at `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`. You will be prompted to overwrite at creation.</output>
+      </check>
+      <goto step="4" />
+    </check>
+    <check if="field == 'name'">
+      <ask>New sprint name (or press Enter to use "Sprint {{sprint_number}}"):</ask>
+      <action>If blank, set {{sprint_name}} = "Sprint {{sprint_number}}"; else store user input as {{sprint_name}}</action>
+      <goto step="4" />
+    </check>
+    <check if="field == 'capacity'"><goto step="2" /></check>
+    <check if="field == 'start'"><goto step="3a" /></check>
+    <check if="field == 'end'"><goto step="3b" /></check>
+    <check if="field is not recognized">
+      <output>❌ Unrecognized field: "{{field}}". Valid options: number, name, capacity, start, end.</output>
+      <goto step="4" />
+    </check>
+  </check>
+  <check if="user selects 'n'">
+    <output>❌ Sprint creation cancelled.</output>
+    <action>Exit workflow</action>
+  </check>
+  <check if="user input is not 'y', 'n', or 'e'">
+    <output>❌ Unrecognized option: "{{user_input}}". Please enter [y] Yes, [n] Cancel, or [e] Edit a field.</output>
+    <goto step="4" />
+  </check>
+</step>
+
+<step n="5" goal="Generate sprint entity YAML file">
+  <action>Determine output path: `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`</action>
+  <action>Ensure directory `_bmad-output/implementation-artifacts/sprints/` exists (create if needed)</action>
+
+  <!-- Overwrite protection for new path -->
+  <action>Check if file already exists at `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`</action>
+  <check if="file already exists at new path">
+    <anchor id="overwrite_prompt" />
+    <output>⚠️ A sprint entity already exists at `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`.</output>
+    <ask>Overwrite existing sprint? [y] Yes / [n] Cancel:</ask>
+    <check if="user selects 'n'">
+      <output>❌ Sprint creation cancelled to preserve existing sprint.</output>
+      <action>Exit workflow</action>
+    </check>
+    <check if="user input is not 'y' or 'n'">
+      <output>❌ Unrecognized option: "{{user_input}}". Please enter [y] Yes or [n] Cancel.</output>
+      <goto anchor="overwrite_prompt" />
+    </check>
+  </check>
+
+  <!-- Advisory check for old-format file -->
+  <action>Check if file exists at old path: `_bmad-output/implementation-artifacts/sprint-plan-{{sprint_number}}.yaml`</action>
+  <check if="old-format file exists">
+    <output>ℹ️ **Note:** An old-format sprint file exists at `_bmad-output/implementation-artifacts/sprint-plan-{{sprint_number}}.yaml`. The new sprint will be created at the new path. The old file is NOT auto-migrated — review or remove it manually if no longer needed.</output>
+  </check>
+
+  <action>Get current ISO timestamp for created_date and last_modified</action>
+  <action>Write sprint entity YAML to `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml` with this structure:
+
+```yaml
+id: {{sprint_id}}
+name: "{{sprint_name}}"
+status: planning
+capacity: {{capacity}}
+start: "{{start_date}}"
+end: "{{end_date}}"
+items: []
+created_date: "{{current_iso_timestamp}}"
+last_modified: "{{current_iso_timestamp}}"
+```
+
+  **YAML output rules:**
+  - Always quote the `name` field to handle special characters
+  - `start` and `end` are empty string `""` if skipped
+  - `items` is always empty array `[]` at creation
+  - `status` is always `planning` at creation (never `active` or `closed`)
+  </action>
+  <output>
+✅ **Sprint created successfully!**
+
+- **File:** `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`
+- **Sprint:** {{sprint_name}}
+- **Capacity:** {{capacity}} items
+- **Status:** planning
+
+**Next Steps:**
+- Use `/add-to-sprint` to assign backlog items to this sprint
+- Use `/modify-sprint` to update sprint details later
+- Use `/sprint-status-view` to view sprint progress
+  </output>
+</step>
+
+</workflow>

package/.opencode/skills/add-sprint/bmad-skill-manifest.yaml

@@ -0,0 +1,3 @@
+type: skill
+name: add-sprint
+module: ma-skills