omgkit 2.27.0 → 2.28.0

package/README.md

@@ -37,7 +37,7 @@ All coordinated through **Omega-level thinking** - a framework for finding break
 | Component | Count | Description |
 |-----------|-------|-------------|
 | **Agents** | 41 | Specialized AI team members with distinct roles |
-| **Commands** | 160 | Slash commands for every development task |
+| **Commands** | 161 | Slash commands for every development task |
 | **Workflows** | 69 | Complete development processes from idea to deploy |
 | **Skills** | 161 | Domain expertise modules across 24 categories |
 | **Modes** | 10 | Behavioral configurations for different contexts |
@@ -373,6 +373,7 @@ Commands are slash-prefixed actions organized by namespace.
 /sprint:sprint-start    # Start current sprint
 /sprint:sprint-current  # Show sprint progress
 /sprint:sprint-end      # End sprint + retrospective
+/sprint:ship            # Complete sprint + commit + push + PR
 /sprint:backlog-add     # Add task to backlog
 /sprint:backlog-show    # Display backlog
 /sprint:team-run        # Run AI team
@@ -386,6 +387,14 @@ Commands are slash-prefixed actions organized by namespace.
 /sprint:backlog-add "Login" --ref=artifacts/prd.md   # Task with ref context
 ```
 
+**Sprint Ship** (complete sprint + deploy):
+```bash
+/sprint:ship "Sprint 1 - MVP"     # Ship with message
+/sprint:ship --skip-tests         # Skip tests (not recommended)
+/sprint:ship --no-pr              # Push directly without PR
+/sprint:ship --force              # Ship with incomplete tasks
+```
+
 ### Autonomous Development (`/auto:*`)
 
 ```bash

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "omgkit",
-  "version": "2.27.0",
-  "description": "Omega-Level Development Kit - AI Team System for Claude Code. 41 agents, 160 commands, 161 skills, 69 workflows.",
+  "version": "2.28.0",
+  "description": "Omega-Level Development Kit - AI Team System for Claude Code. 41 agents, 161 commands, 161 skills, 69 workflows.",
   "keywords": [
     "claude-code",
     "ai",

package/plugin/agents/sprint-master.md

@@ -15,6 +15,7 @@ commands:
   - /sprint:sprint-start
   - /sprint:sprint-current
   - /sprint:sprint-end
+  - /sprint:ship
   - /sprint:backlog-add
   - /sprint:backlog-show
   - /sprint:backlog-prioritize

package/plugin/commands/sprint/ship.md

@@ -0,0 +1,264 @@
+---
+description: Complete sprint and ship to production
+allowed-tools: Task, Read, Write, Bash, Grep, Glob
+argument-hint: "[message] [--skip-tests] [--no-pr] [--force]"
+ship:
+  auto_test: true
+  auto_pr: true
+  commit_prefix: "feat(sprint)"
+related_skills:
+  - autonomous/project-orchestration
+  - omega/omega-sprint
+  - devops/workflow-config
+related_commands:
+  - /sprint:sprint-end
+  - /git:ship
+  - /git:commit
+  - /git:pr
+---
+
+# Sprint Ship: $ARGUMENTS
+
+Complete the current sprint and ship all changes to production in a single workflow.
+
+## Overview
+
+This command combines sprint completion with git operations to streamline the release process:
+
+1. **Validate** - Check sprint status and task completion
+2. **Test** - Run tests to ensure quality
+3. **End Sprint** - Generate retrospective and archive
+4. **Commit** - Stage and commit all changes
+5. **Push** - Push to remote repository
+6. **PR/Deploy** - Create PR or trigger CI/CD
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `message` | Commit message (uses sprint name if not provided) | Sprint name |
+| `--skip-tests` | Skip running tests before ship | `false` |
+| `--no-pr` | Push directly without creating PR | `false` |
+| `--force` | Force ship even with incomplete tasks | `false` |
+
+## Workflow Diagram
+
+```
+/sprint:ship "Sprint 1 - Auth"
+              │
+              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  PHASE 1: VALIDATION                                         │
+├─────────────────────────────────────────────────────────────┤
+│  ✓ Check current sprint exists                               │
+│  ✓ Verify sprint is active/in_progress                       │
+│  ✓ Check task completion (warn if incomplete)                │
+│  ✓ Check for uncommitted changes                             │
+└─────────────────────────────────────────────────────────────┘
+              │
+              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  PHASE 2: TESTING (unless --skip-tests)                      │
+├─────────────────────────────────────────────────────────────┤
+│  ► Run: npm test (or configured test command)                │
+│  ► Check coverage gates from workflow.yaml                   │
+│  ► FAIL if tests don't pass                                  │
+└─────────────────────────────────────────────────────────────┘
+              │
+              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  PHASE 3: SPRINT END                                         │
+├─────────────────────────────────────────────────────────────┤
+│  ► Set status: completed                                     │
+│  ► Calculate metrics (completed tasks, velocity)             │
+│  ► Generate retrospective                                    │
+│  ► Archive to .omgkit/sprints/archive/                       │
+└─────────────────────────────────────────────────────────────┘
+              │
+              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  PHASE 4: GIT OPERATIONS                                     │
+├─────────────────────────────────────────────────────────────┤
+│  ► git add .                                                 │
+│  ► git commit -m "feat(sprint): [message]"                   │
+│     └── Include retrospective summary in body                │
+│  ► git push origin [branch]                                  │
+└─────────────────────────────────────────────────────────────┘
+              │
+              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  PHASE 5: PR/CI (unless --no-pr)                             │
+├─────────────────────────────────────────────────────────────┤
+│  ► Create PR with sprint summary                             │
+│  ► Add labels: sprint-complete                               │
+│  ► Link CI/CD status                                         │
+└─────────────────────────────────────────────────────────────┘
+              │
+              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  PHASE 6: REPORT                                             │
+├─────────────────────────────────────────────────────────────┤
+│  📊 Sprint Summary                                           │
+│  📝 Commit: abc1234                                          │
+│  🔗 PR: https://github.com/org/repo/pull/123                 │
+│  🚀 CI/CD: Running...                                        │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Configuration
+
+Configure ship behavior in `.omgkit/workflow.yaml`:
+
+```yaml
+ship:
+  # Run tests before shipping
+  auto_test: true
+
+  # Test command to run
+  test_command: "npm test"
+
+  # Create PR instead of direct push
+  create_pr: true
+
+  # PR settings
+  pr:
+    draft: false
+    reviewers: []
+    labels: ["sprint-complete"]
+
+  # Commit message format
+  commit:
+    prefix: "feat(sprint)"
+    include_retrospective: true
+    include_metrics: true
+
+  # Force ship even with incomplete tasks
+  allow_incomplete: false
+
+  # Archive sprint after ship
+  archive_sprint: true
+```
+
+## Examples
+
+### Basic Usage
+
+```bash
+# Ship with auto-generated message from sprint name
+/sprint:ship
+
+# Ship with custom message
+/sprint:ship "Sprint 1 - User Authentication Complete"
+```
+
+### With Options
+
+```bash
+# Skip tests (use with caution)
+/sprint:ship "Hotfix Sprint" --skip-tests
+
+# Push directly without PR (for trunk-based development)
+/sprint:ship "Sprint 1" --no-pr
+
+# Force ship even with incomplete tasks
+/sprint:ship "MVP Sprint" --force
+
+# Combine options
+/sprint:ship "Quick Fix" --skip-tests --no-pr
+```
+
+### Full Workflow Example
+
+```bash
+# 1. Start sprint
+/sprint:sprint-new "Auth Feature" --ref=.omgkit/artifacts/prd-auth.md
+
+# 2. Work on sprint
+/sprint:team-run
+/dev:feature "implement login"
+/dev:feature "implement signup"
+
+# 3. Ship when done
+/sprint:ship "Sprint 1 - Auth Feature Complete"
+```
+
+## Output
+
+### Sprint Summary
+
+```markdown
+## Sprint Shipped: Auth Feature
+
+### Metrics
+- Completed: 8/10 tasks (80%)
+- Velocity: 2.5 tasks/day
+- Duration: 4 days
+
+### Retrospective
+**What Went Well:**
+- Fast iteration on login flow
+- Good test coverage achieved
+
+**What Could Improve:**
+- Better estimation for OAuth integration
+
+### Git
+- Commit: `abc1234`
+- Branch: `main`
+- PR: #123
+
+### CI/CD
+- Status: Running
+- URL: https://github.com/org/repo/actions/runs/123
+```
+
+## Error Handling
+
+### No Active Sprint
+
+```
+❌ Error: No active sprint found
+   Run /sprint:sprint-new to create a sprint first
+```
+
+### Tests Failed
+
+```
+❌ Error: Tests failed (12 failing)
+   Fix tests before shipping or use --skip-tests (not recommended)
+```
+
+### Incomplete Tasks
+
+```
+⚠️ Warning: 2 tasks incomplete
+   - [ ] Implement password reset
+   - [ ] Add email verification
+
+   Use --force to ship anyway, or complete tasks first
+```
+
+## Best Practices
+
+1. **Always run tests** - Don't use `--skip-tests` in production
+2. **Complete tasks** - Ship complete sprints, not partial work
+3. **Use meaningful messages** - Commit messages should describe the sprint's value
+4. **Review before ship** - Run `/dev:review` before `/sprint:ship`
+5. **Configure workflow.yaml** - Set team preferences for ship behavior
+
+## Comparison with Other Commands
+
+| Command | Purpose | When to Use |
+|---------|---------|-------------|
+| `/sprint:sprint-end` | End sprint only | When not ready to commit |
+| `/git:ship` | Commit and PR | For non-sprint commits |
+| `/git:commit` | Commit only | For WIP commits |
+| `/sprint:ship` | Full workflow | Sprint completion |
+
+## Related Commands
+
+- `/sprint:sprint-new` - Create new sprint
+- `/sprint:sprint-end` - End sprint (without shipping)
+- `/sprint:team-run` - Execute sprint tasks
+- `/git:ship` - Ship code (standalone)
+- `/git:pr` - Create pull request

package/plugin/registry.yaml

@@ -3,7 +3,7 @@
 # Version: 2.26.1
 # Updated: 2026-01-06
 
-version: "2.26.1"
+version: "2.28.0"
 
 # =============================================================================
 # OPTIMIZED ALIGNMENT PRINCIPLE (OAP)
@@ -409,6 +409,7 @@ agents:
       - /sprint:sprint-start
       - /sprint:sprint-current
       - /sprint:sprint-end
+      - /sprint:ship
       - /sprint:backlog-add
       - /sprint:backlog-show
       - /sprint:backlog-prioritize
@@ -870,13 +871,13 @@ workflows:
     skills:
       - omega/omega-sprint
       - methodology/executing-plans
-    commands: [/sprint:sprint-current, /sprint:team-run, /sprint:team-status, /dev:fix, /sprint:sprint-end]
+    commands: [/sprint:sprint-current, /sprint:team-run, /sprint:team-status, /dev:fix, /sprint:sprint-end, /sprint:ship]
 
   sprint/sprint-retrospective:
     agents: [sprint-master, project-manager, journal-writer]
     skills:
       - omega/omega-sprint
-    commands: [/sprint:sprint-end, /planning:doc]
+    commands: [/sprint:sprint-end, /sprint:ship, /planning:doc]
 
   # Fullstack workflows
   fullstack/full-feature:

package/plugin/workflows/sprint/sprint-execution.md

@@ -19,6 +19,7 @@ commands:
   - /sprint:team-status
   - /dev:fix
   - /sprint:sprint-end
+  - /sprint:ship
 prerequisites:
   - Sprint created and started
   - Tasks assigned
@@ -109,6 +110,19 @@ Complete sprint:
 
 **Output:** Sprint completed
 
+### Step 6: Ship (Optional)
+**Agent:** sprint-master
+**Command:** `/sprint:ship`
+**Duration:** 5-15 minutes
+
+Ship sprint to production:
+- Run tests
+- Commit all changes
+- Push to remote
+- Create PR or deploy
+
+**Output:** Sprint shipped
+
 ## Quality Gates
 
 - [ ] All high-priority tasks complete

package/plugin/workflows/sprint/sprint-retrospective.md

@@ -12,6 +12,7 @@ skills:
   - omega/omega-sprint
 commands:
   - /sprint:sprint-end
+  - /sprint:ship
   - /planning:doc
 prerequisites:
   - Sprint completed

package/templates/omgkit/workflow.yaml

@@ -219,3 +219,49 @@ references:
 
     # Maximum file age in days before warning
     max_age_days: 30
+
+# =============================================================================
+# SPRINT SHIP CONFIGURATION
+# =============================================================================
+ship:
+  # Run tests before shipping
+  auto_test: true
+
+  # Test command to run (uses package.json test script by default)
+  test_command: "npm test"
+
+  # Create PR instead of direct push
+  create_pr: true
+
+  # PR settings (when create_pr: true)
+  pr:
+    # Create as draft
+    draft: false
+
+    # Auto-assign reviewers
+    reviewers: []
+
+    # Auto-add labels
+    labels: ["sprint-complete"]
+
+  # Commit message settings
+  commit:
+    # Commit message prefix
+    prefix: "feat(sprint)"
+
+    # Include retrospective in commit body
+    include_retrospective: true
+
+    # Include metrics in commit body
+    include_metrics: true
+
+  # Ship behavior
+  behavior:
+    # Allow shipping with incomplete tasks (requires --force)
+    allow_incomplete: false
+
+    # Archive sprint after successful ship
+    archive_sprint: true
+
+    # Run lint/format before commit
+    pre_commit_checks: true