@pennyfarthing/core 10.0.0 → 10.0.2

package/pennyfarthing-dist/skills/sprint/scripts/sprint-status.sh

@@ -0,0 +1,147 @@
+#!/bin/bash
+# Display current sprint status
+# Usage: .pennyfarthing/scripts/sprint/sprint-status.sh [filter]
+#    or: Invoked with PROJECT_ROOT already set
+#
+# Filters:
+#   (none)       - Show all stories
+#   todo         - Show only backlog stories
+#   in-progress  - Show only in_progress stories
+#   done         - Show only done/cancelled stories
+
+set -euo pipefail
+
+# PROJECT_ROOT should be set by find-root.sh, but find it if not
+if [[ -z "${PROJECT_ROOT:-}" ]]; then
+  d="$PWD"
+  while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do
+    d="$(dirname "$d")"
+  done
+  PROJECT_ROOT="$d"
+fi
+
+# Parse filter argument
+FILTER="${1:-}"
+case "$FILTER" in
+  todo|backlog)
+    STATUS_FILTER="backlog"
+    FILTER_LABEL="Todo"
+    ;;
+  in-progress|wip)
+    STATUS_FILTER="in_progress"
+    FILTER_LABEL="In Progress"
+    ;;
+  done|completed)
+    STATUS_FILTER="done"
+    FILTER_LABEL="Done"
+    ;;
+  cancelled|canceled)
+    STATUS_FILTER="cancelled"
+    FILTER_LABEL="Cancelled"
+    ;;
+  "")
+    STATUS_FILTER=""
+    FILTER_LABEL=""
+    ;;
+  *)
+    echo "Error: Unknown filter '$FILTER'"
+    echo "Valid filters: todo, in-progress, done, cancelled"
+    exit 1
+    ;;
+esac
+
+SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
+
+if [[ ! -f "$SPRINT_FILE" ]]; then
+  echo "Error: Sprint file not found at $SPRINT_FILE"
+  exit 1
+fi
+
+if ! command -v yq &> /dev/null; then
+  echo "Error: yq is required but not installed"
+  echo "Install with: brew install yq"
+  exit 1
+fi
+
+# Extract sprint metadata
+SPRINT_NAME=$(yq eval '.sprint.name' "$SPRINT_FILE")
+SPRINT_GOAL=$(yq eval '.sprint.goal' "$SPRINT_FILE")
+START_DATE=$(yq eval '.sprint.start_date' "$SPRINT_FILE")
+END_DATE=$(yq eval '.sprint.end_date' "$SPRINT_FILE")
+STATUS=$(yq eval '.sprint.status' "$SPRINT_FILE")
+
+echo "# Sprint Status"
+echo ""
+echo "**Sprint:** $SPRINT_NAME"
+echo "**Goal:** $SPRINT_GOAL"
+echo "**Dates:** $START_DATE to $END_DATE"
+echo "**Status:** $STATUS"
+echo ""
+
+# Count stories by status
+TOTAL_STORIES=$(yq eval '[.epics[].stories[]] | length' "$SPRINT_FILE")
+BACKLOG=$(yq eval '[.epics[].stories[] | select(.status == "backlog")] | length' "$SPRINT_FILE")
+IN_PROGRESS=$(yq eval '[.epics[].stories[] | select(.status == "in_progress")] | length' "$SPRINT_FILE")
+
+# Sum points using paste+bc (yq add not available in all versions)
+sum_points() {
+  local result
+  result=$(echo "$1" | paste -sd+ - | bc 2>/dev/null)
+  echo "${result:-0}"
+}
+
+TOTAL_POINTS=$(sum_points "$(yq '.epics[].stories[].points' "$SPRINT_FILE")")
+BACKLOG_POINTS=$(sum_points "$(yq '.epics[].stories[] | select(.status == "backlog") | .points' "$SPRINT_FILE")")
+IN_PROGRESS_POINTS=$(sum_points "$(yq '.epics[].stories[] | select(.status == "in_progress") | .points' "$SPRINT_FILE")")
+
+echo "## Summary"
+echo ""
+echo "| Status | Stories | Points |"
+echo "|--------|---------|--------|"
+echo "| Backlog | $BACKLOG | $BACKLOG_POINTS |"
+echo "| In Progress | $IN_PROGRESS | $IN_PROGRESS_POINTS |"
+echo "| **Total Remaining** | **$TOTAL_STORIES** | **$TOTAL_POINTS** |"
+echo ""
+
+# List stories by epic (grouped - epic name appears once)
+if [[ -n "$FILTER_LABEL" ]]; then
+  echo "## Stories by Epic (${FILTER_LABEL} only)"
+else
+  echo "## Stories by Epic"
+fi
+echo ""
+
+# Process each epic, output header once then all its stories
+# Apply status filter if specified
+if [[ -n "$STATUS_FILTER" ]]; then
+  yq eval -o=json '.epics[]' "$SPRINT_FILE" 2>/dev/null | jq -r --arg status "$STATUS_FILTER" '
+    .title as $title |
+    [.stories[] | select(.status == $status)] |
+    if length > 0 then
+      "### " + $title + "\n" +
+      (map("- [" + .status + "] " + .id + ": " + .title + " (" + (.points | tostring) + " pts)") | join("\n")) + "\n"
+    else
+      empty
+    end
+  ' 2>/dev/null || echo "No stories found"
+else
+  yq eval -o=json '.epics[]' "$SPRINT_FILE" 2>/dev/null | jq -r '
+    "### " + .title + "\n" +
+    (.stories | map("- [" + .status + "] " + .id + ": " + .title + " (" + (.points | tostring) + " pts)") | join("\n")) + "\n"
+  ' 2>/dev/null || echo "No stories found"
+fi
+
+# Check archive for completed count
+SPRINT_NUM=$(echo "$SPRINT_NAME" | sed 's/TO Sprint //')
+ARCHIVE_FILE="$PROJECT_ROOT/sprint/archive/sprint-${SPRINT_NUM}-completed.yaml"
+
+if [[ -f "$ARCHIVE_FILE" ]]; then
+  COMPLETED_COUNT=$(yq '.completed | length' "$ARCHIVE_FILE" 2>/dev/null || echo "0")
+  COMPLETED_POINTS=$(sum_points "$(yq '.completed[].points' "$ARCHIVE_FILE" 2>/dev/null)")
+  echo ""
+  echo "## Completed This Sprint"
+  echo ""
+  echo "**Stories:** $COMPLETED_COUNT | **Points:** $COMPLETED_POINTS"
+  echo ""
+  echo "See: sprint/archive/sprint-${SPRINT_NUM}-completed.yaml"
+fi

package/pennyfarthing-dist/skills/sprint/scripts/sync-epic-jira.sh

@@ -0,0 +1,93 @@
+#!/bin/bash
+# Sync an epic and its stories to Jira
+# Usage: .pennyfarthing/scripts/sprint/sync-epic-jira.sh <epic-id> [--dry-run] [--transition] [--points] [--all]
+#
+# Example: .pennyfarthing/scripts/sprint/sync-epic-jira.sh MSSCI-11952
+# Example: .pennyfarthing/scripts/sprint/sync-epic-jira.sh MSSCI-11952 --all
+#
+# This script syncs status and story points from sprint YAML to Jira.
+# Thin wrapper that delegates to Python CLI.
+
+set -euo pipefail
+
+# Find package root (where pennyfarthing_scripts lives) from script location
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+PACKAGE_ROOT="$(cd "$SCRIPT_DIR/../../../.." && pwd -P)"
+
+# Set PYTHONPATH so Python can find pennyfarthing_scripts
+export PYTHONPATH="${PACKAGE_ROOT}:${PYTHONPATH:-}"
+
+EPIC_ID="${1:-}"
+
+if [[ -z "$EPIC_ID" ]]; then
+  echo "Usage: sync-epic-jira.sh <epic-id> [options]"
+  echo ""
+  echo "Syncs an epic and its stories from sprint YAML to Jira."
+  echo ""
+  echo "Options:"
+  echo "  --dry-run      Show what would be done without making changes"
+  echo "  --transition   Transition Jira issues to match sprint YAML status"
+  echo "  --points       Sync story points from sprint YAML to Jira"
+  echo "  --all          Equivalent to --transition --points"
+  echo ""
+  echo "Examples:"
+  echo "  sync-epic-jira.sh MSSCI-11952              # Show sync status"
+  echo "  sync-epic-jira.sh MSSCI-11952 --dry-run    # Preview changes"
+  echo "  sync-epic-jira.sh MSSCI-11952 --all        # Sync status and points"
+  exit 1
+fi
+
+# PROJECT_ROOT should be set by find-root.sh, but find it if not
+if [[ -z "${PROJECT_ROOT:-}" ]]; then
+  d="$PWD"
+  while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do
+    d="$(dirname "$d")"
+  done
+  PROJECT_ROOT="$d"
+fi
+
+SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
+
+if [[ ! -f "$SPRINT_FILE" ]]; then
+  echo "Error: Sprint file not found at $SPRINT_FILE"
+  exit 1
+fi
+
+if ! command -v yq &> /dev/null; then
+  echo "Error: yq is required but not installed"
+  echo "Install with: brew install yq"
+  exit 1
+fi
+
+# Check if epic exists in sprint YAML
+EPIC_EXISTS=$(yq ".epics[] | select(.id == \"$EPIC_ID\") | .id" "$SPRINT_FILE" 2>/dev/null || echo "")
+
+if [[ -z "$EPIC_EXISTS" ]]; then
+  echo "Error: Epic $EPIC_ID not found in $SPRINT_FILE"
+  echo ""
+  echo "Available epics:"
+  yq '.epics[].id' "$SPRINT_FILE" 2>/dev/null || echo "  None found"
+  exit 1
+fi
+
+# Build arguments for Python CLI
+shift  # Remove epic-id from arguments
+SYNC_ARGS=("$EPIC_ID")
+
+# Handle --all flag
+for arg in "$@"; do
+  case "$arg" in
+    --all)
+      SYNC_ARGS+=("--transition" "--points")
+      ;;
+    *)
+      SYNC_ARGS+=("$arg")
+      ;;
+  esac
+done
+
+echo "Syncing epic $EPIC_ID to Jira..."
+echo ""
+
+# Delegate to Python CLI
+exec python3 -m pennyfarthing_scripts.jira sync "${SYNC_ARGS[@]}"

package/pennyfarthing-dist/skills/sprint/skill.md

@@ -0,0 +1,465 @@
+---
+name: sprint
+description: |
+  Sprint status, backlog, and story management for Pennyfarthing. Use when checking current
+  sprint status, finding available stories, reviewing backlog, or understanding story context
+  and history.
+  IMPORTANT: Always use the provided scripts - never manually edit sprint YAML.
+args: "[status|backlog|work|archive|new|promote]"
+---
+
+# /sprint - Sprint Management
+
+<critical>
+Never manually edit `sprint/current-sprint.yaml`. Use the scripts below for deterministic, correct YAML formatting.
+</critical>
+
+## Commands
+
+### `/sprint` or `/sprint status [filter]`
+
+Show current sprint status with story counts and points.
+
+<run>
+.pennyfarthing/scripts/sprint/sprint-status.sh [filter]
+</run>
+
+<args>
+| Arg | Required | Description |
+|-----|----------|-------------|
+| `filter` | No | Filter stories: `todo`, `in-progress`, `done`, `cancelled` |
+</args>
+
+<example>
+.pennyfarthing/scripts/sprint/sprint-status.sh           # All stories
+.pennyfarthing/scripts/sprint/sprint-status.sh todo      # Backlog only
+.pennyfarthing/scripts/sprint/sprint-status.sh in-progress  # WIP only
+.pennyfarthing/scripts/sprint/sprint-status.sh done      # Completed only
+</example>
+
+<output>
+Sprint metadata, stories by status (grouped under epic headers), points breakdown, completed count from archive.
+When filtered, only shows epics with matching stories.
+</output>
+
+---
+
+### `/sprint backlog`
+
+Show available stories grouped by epic with Jira context.
+
+<run>
+.pennyfarthing/scripts/sprint/available-stories.sh
+</run>
+
+<output>
+Backlog stories with epic descriptions, points, priority, and workflow tags.
+</output>
+
+---
+
+### `/sprint work [story-id|epic-id|next]`
+
+Start work on a story. This is the primary entry point for development work.
+
+<when>
+- Starting new development work
+- `/new-work` is an alias for this command
+</when>
+
+#### Without argument: Interactive selection
+
+Shows backlog, user selects story, then proceeds to setup.
+
+<output>
+1. Load SM persona
+2. Check for in-progress work
+3. Show available stories
+4. User selects story
+5. Setup and handoff to TEA/Dev
+</output>
+
+#### With story ID: Direct start
+
+<run>
+.pennyfarthing/scripts/sprint/check-story.sh <story-id>
+</run>
+
+<args>
+| Arg | Required | Description |
+|-----|----------|-------------|
+| `story-id` | Yes | Jira key (e.g., `MSSCI-12038`) |
+</args>
+
+<output>
+- `available: true` - Skip backlog, proceed to setup
+- `available: false` - Report why (assigned, in progress, etc.)
+</output>
+
+<example>
+.pennyfarthing/scripts/sprint/check-story.sh MSSCI-12038
+# Returns: {"type": "story", "available": true, "title": "...", ...}
+</example>
+
+#### With epic ID: Start first available story in epic
+
+<run>
+.pennyfarthing/scripts/sprint/check-story.sh <epic-id>
+</run>
+
+<output>
+Epic info with `first_story` (highest priority available story).
+Action: Automatically start work on `first_story` if available.
+</output>
+
+<example>
+.pennyfarthing/scripts/sprint/check-story.sh MSSCI-11952
+# Returns: {"type": "epic", "first_story": {"id": "MSSCI-11954", ...}, ...}
+</example>
+
+#### With `next`: Auto-select highest priority story
+
+<run>
+.pennyfarthing/scripts/sprint/check-story.sh next
+</run>
+
+<output>
+Highest-priority available story across all epics.
+Action: Automatically start work on returned story.
+</output>
+
+<example>
+.pennyfarthing/scripts/sprint/check-story.sh next
+# Returns: {"type": "next", "story": {"id": "MSSCI-11950", "priority": "P1", ...}}
+</example>
+
+---
+
+### `/sprint archive <story-id> [pr-number] [--apply]`
+
+Archive a completed story to the sprint archive file.
+
+<run>
+.pennyfarthing/scripts/sprint/archive-story.sh <story-id> [pr-number] [--apply]
+</run>
+
+<args>
+| Arg | Required | Description |
+|-----|----------|-------------|
+| `story-id` | Yes | Story ID (e.g., `35-2`) |
+| `pr-number` | No | PR number if merged via PR |
+| `--apply` | No | Also remove story from current-sprint.yaml |
+</args>
+
+<example>
+# Archive only (manual removal needed)
+.pennyfarthing/scripts/sprint/archive-story.sh 35-2 368
+
+# Archive and remove atomically (recommended)
+.pennyfarthing/scripts/sprint/archive-story.sh 35-2 368 --apply
+</example>
+
+<output>
+1. Extracts story from `current-sprint.yaml`
+2. Appends to `sprint/archive/sprint-{YYWW}-completed.yaml`
+3. With `--apply`: Also removes from current sprint
+4. Without `--apply`: Outputs command to complete removal
+</output>
+
+---
+
+### `/sprint new <yyww> <jira-id> <start> <end> "<goal>"`
+
+Initialize a new sprint from template.
+
+<run>
+.pennyfarthing/scripts/sprint/new-sprint.sh <yyww> <jira-id> <start> <end> "<goal>"
+</run>
+
+<args>
+| Arg | Required | Description |
+|-----|----------|-------------|
+| `yyww` | Yes | Sprint identifier (e.g., `2605` for 2026 week 5) |
+| `jira-id` | Yes | Jira sprint ID number (e.g., `277`) |
+| `start` | Yes | Start date `YYYY-MM-DD` |
+| `end` | Yes | End date `YYYY-MM-DD` |
+| `goal` | Yes | Sprint goal (quoted string) |
+</args>
+
+<example>
+.pennyfarthing/scripts/sprint/new-sprint.sh 2605 277 2026-02-03 2026-02-16 "Polish and stabilization"
+</example>
+
+<output>
+Creates:
+- `sprint/current-sprint.yaml` - New sprint file
+- `sprint/archive/sprint-{YYWW}-completed.yaml` - Empty archive
+
+Warning: Prompts for confirmation if current sprint is still active.
+</output>
+
+---
+
+### `/sprint future [--epic EPIC_ID]`
+
+Show future work initiatives and epics available for promotion.
+
+<run>
+.pennyfarthing/scripts/sprint/list-future.sh [--epic EPIC_ID]
+</run>
+
+<args>
+| Arg | Required | Description |
+|-----|----------|-------------|
+| `--epic` | No | Show detailed stories for a specific epic |
+</args>
+
+<output>
+Without `--epic`:
+- Initiatives grouped by status (READY, BLOCKED, planning)
+- Epics with points, priority, and status
+- Summary of total epics and points
+- Promotion instructions
+
+With `--epic`:
+- Full epic details including description
+- All stories with points and status
+- Promotion command for that epic
+</output>
+
+<example>
+# Show all future work
+.pennyfarthing/scripts/sprint/list-future.sh
+
+# Show details for specific epic
+.pennyfarthing/scripts/sprint/list-future.sh --epic epic-55
+</example>
+
+---
+
+### `/sprint promote <epic-id>`
+
+Move an epic from `future.yaml` to `current-sprint.yaml`.
+
+<run>
+.pennyfarthing/scripts/sprint/promote-epic.sh <epic-id>
+</run>
+
+<args>
+| Arg | Required | Description |
+|-----|----------|-------------|
+| `epic-id` | Yes | Local epic ID (e.g., `epic-41`) |
+</args>
+
+<example>
+.pennyfarthing/scripts/sprint/promote-epic.sh epic-41
+</example>
+
+<output>
+1. Finds epic in `sprint/planning.yaml`
+2. Extracts epic metadata and all stories
+3. Appends to `sprint/current-sprint.yaml` epics section
+4. Outputs yq command to remove from planning.yaml
+</output>
+
+<when>
+Next steps after promote:
+- Review appended YAML in current-sprint.yaml
+- Create Jira epic: `/jira create epic <epic-id>`
+- Remove from planning.yaml if desired
+</when>
+
+---
+
+## Read Operations
+
+These scripts read sprint YAML without modifying it. Use these instead of direct `yq` queries.
+
+### Get Story Field
+
+<run>
+.pennyfarthing/scripts/sprint/get-story-field.sh <story-id> <field>
+</run>
+
+<args>
+| Arg | Required | Description |
+|-----|----------|-------------|
+| `story-id` | Yes | Story ID (e.g., `35-2`) |
+| `field` | Yes | Field name to extract |
+</args>
+
+<example>
+.pennyfarthing/scripts/sprint/get-story-field.sh 35-2 workflow   # Returns: tdd
+.pennyfarthing/scripts/sprint/get-story-field.sh 35-2 jira       # Returns: MSSCI-12345
+.pennyfarthing/scripts/sprint/get-story-field.sh 35-2 status     # Returns: in_progress
+</example>
+
+<output>
+Field value or "null" if not found. Common fields: `workflow`, `status`, `jira`, `points`, `title`, `repos`, `priority`.
+</output>
+
+---
+
+### Get Epic Field
+
+<run>
+.pennyfarthing/scripts/sprint/get-epic-field.sh <epic-id> <field>
+</run>
+
+<args>
+| Arg | Required | Description |
+|-----|----------|-------------|
+| `epic-id` | Yes | Epic ID (e.g., `epic-35` or just `35`) |
+| `field` | Yes | Field name to extract |
+</args>
+
+<example>
+.pennyfarthing/scripts/sprint/get-epic-field.sh epic-35 jira    # Returns: MSSCI-11234
+.pennyfarthing/scripts/sprint/get-epic-field.sh 35 title        # Returns: Epic title
+</example>
+
+<output>
+Field value or "null" if not found. Common fields: `jira`, `title`, `description`, `status`.
+</output>
+
+---
+
+## Jira Operations
+
+For Jira-specific operations, use the `/jira` skill:
+
+| Task | Command |
+|------|---------|
+| Create epic in Jira | `/jira create epic <epic-id>` |
+| Sync epic to Jira | `/jira sync <epic-id>` |
+| Reconcile YAML vs Jira | `/jira reconcile` |
+| Claim a story | `/jira claim <issue-key>` |
+| View issue details | `/jira view <issue-key>` |
+
+---
+
+## Work Flow Details
+
+<when>
+When `/sprint work` (or `/new-work`) starts a story:
+</when>
+
+<agent-activation>
+Load SM persona first:
+```bash
+d="$PWD"; while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done; "$d/.pennyfarthing/scripts/core/agent-session.sh" start "sm"
+```
+</agent-activation>
+
+### Story Setup Steps
+
+<output>
+1. **Check story** via `check-story.sh` (if ID provided)
+2. **Write context** to `.session/context-story-{id}.md`
+3. **Setup story** via `sm-setup` subagent (claims Jira, creates branch)
+4. **Handoff** to next agent based on workflow:
+
+| Workflow | Route |
+|----------|-------|
+| `trivial` | SM → Dev |
+| `tdd` | SM → TEA → Dev → Reviewer |
+| `agent-docs` | SM → Orchestrator |
+</output>
+
+### Gates Before Handoff
+
+<critical>
+All gates must pass before handoff:
+- [ ] Session file exists at `.session/{story-id}-session.md`
+- [ ] Story context written with ACs
+- [ ] Jira claimed (assigned, In Progress)
+- [ ] Branch created
+</critical>
+
+---
+
+## File Locations
+
+| File | Purpose |
+|------|---------|
+| `sprint/current-sprint.yaml` | Active/backlog work only |
+| `sprint/archive/sprint-{YYWW}-completed.yaml` | Completed stories for sprint |
+| `sprint/sprint-template.yaml` | Format reference |
+
+## YAML Constraints
+
+| Field | Valid Values |
+|-------|-------------|
+| Sprint name | `"TO Sprint YYWW"` (e.g., "TO Sprint 2604") |
+| Story IDs | Jira keys `MSSCI-XXXXX` |
+| Status | `backlog`, `ready`, `in_progress`, `done` |
+| Workflow | `tdd`, `trivial`, `agent-docs`, `bdd` |
+| Priority | `P0`, `P1`, `P2`, `P3` |
+| in_sprint | `true`, `false` - Jira sprint membership |
+
+## Sprint Schema
+
+### Sprint-level fields
+
+| Field | Description |
+|-------|-------------|
+| `name` | Sprint name in "TO Sprint YYWW" format |
+| `jira_sprint_id` | Numeric Jira sprint ID (e.g., 276) |
+| `jira_sprint_name` | Jira sprint name (should match name) |
+| `goal` | Sprint goal/objective |
+| `start_date` | YYYY-MM-DD |
+| `end_date` | YYYY-MM-DD |
+| `status` | `active` or `closed` |
+
+### Story-level fields
+
+| Field | Description |
+|-------|-------------|
+| `in_sprint` | `true/false` - whether story is in Jira sprint (synced bidirectionally) |
+
+<output>
+The `in_sprint` field tracks Jira sprint membership:
+- `in_sprint: true` - Story is in the Jira sprint
+- `in_sprint: false` - Story is not in Jira sprint (backlog)
+- Field omitted - Sprint membership not explicitly tracked
+</output>
+
+## Dependencies
+
+<run>
+brew install yq
+</run>
+
+<when>
+For Jira integration, see `/jira` skill prerequisites.
+</when>
+
+## Quick Reference
+
+| Command | Script/Action |
+|---------|---------------|
+| `/sprint` | `sprint-status.sh` |
+| `/sprint status` | `sprint-status.sh` |
+| `/sprint status todo` | `sprint-status.sh todo` |
+| `/sprint status in-progress` | `sprint-status.sh in-progress` |
+| `/sprint status done` | `sprint-status.sh done` |
+| `/sprint backlog` | `available-stories.sh` |
+| `/sprint work` | Interactive story selection → SM flow |
+| `/sprint work MSSCI-XXX` | `check-story.sh` → direct start |
+| `/sprint work EPIC-ID` | `check-story.sh` → start first story |
+| `/sprint work next` | `check-story.sh next` → start highest priority |
+| `/sprint archive MSSCI-XXX` | `archive-story.sh MSSCI-XXX` |
+| `/sprint new 2605 277 ...` | `new-sprint.sh 2605 277 ...` |
+| `/sprint future` | `list-future.sh` |
+| `/sprint future --epic X` | `list-future.sh --epic X` |
+| `/sprint promote epic-41` | `promote-epic.sh epic-41` |
+| `/new-work` | Alias for `/sprint work` |
+| `/new-work MSSCI-XXX` | Alias for `/sprint work MSSCI-XXX` |
+| `/new-work next` | Alias for `/sprint work next` |
+
+## Related Skills
+
+| Skill | Purpose |
+|-------|---------|
+| `/jira` | Jira operations (create, sync, reconcile, claim) |
+| `/story` | Story creation, sizing, finish workflow |