omgkit 2.27.0 → 2.29.0

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
@@ -436,6 +437,14 @@ agents:
       - /design:enhance
       - /design:fast
       - /design:good
+      - /design:themes
+      - /design:theme
+      - /design:preview
+      - /design:add
+      - /design:from-screenshot
+      - /design:from-url
+      - /design:builder
+      - /design:reset
 
   api-designer:
     file: agents/api-designer.md
@@ -870,13 +879,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/design/schema/theme.schema.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OMGKIT Theme Schema",
+  "description": "Schema for OMGKIT design system themes (shadcn/ui compatible)",
+  "type": "object",
+  "required": ["name", "id", "category", "colors"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Display name of the theme"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "description": "Unique identifier (kebab-case)"
+    },
+    "category": {
+      "type": "string",
+      "enum": ["tech-ai", "minimal-clean", "corporate-enterprise", "creative-bold", "nature-organic"],
+      "description": "Theme category"
+    },
+    "description": {
+      "type": "string",
+      "description": "Brief description of the theme aesthetic"
+    },
+    "colors": {
+      "type": "object",
+      "required": ["light", "dark"],
+      "properties": {
+        "light": { "$ref": "#/definitions/colorPalette" },
+        "dark": { "$ref": "#/definitions/colorPalette" }
+      }
+    },
+    "radius": {
+      "type": "string",
+      "default": "0.5rem",
+      "description": "Border radius for components"
+    },
+    "fontFamily": {
+      "type": "object",
+      "properties": {
+        "sans": { "type": "string", "default": "Inter, system-ui, sans-serif" },
+        "mono": { "type": "string", "default": "JetBrains Mono, monospace" }
+      }
+    }
+  },
+  "definitions": {
+    "colorPalette": {
+      "type": "object",
+      "required": [
+        "background", "foreground",
+        "primary", "primary-foreground",
+        "secondary", "secondary-foreground",
+        "muted", "muted-foreground",
+        "accent", "accent-foreground",
+        "destructive", "destructive-foreground",
+        "border", "input", "ring",
+        "card", "card-foreground",
+        "popover", "popover-foreground"
+      ],
+      "properties": {
+        "background": { "$ref": "#/definitions/hslColor" },
+        "foreground": { "$ref": "#/definitions/hslColor" },
+        "primary": { "$ref": "#/definitions/hslColor" },
+        "primary-foreground": { "$ref": "#/definitions/hslColor" },
+        "secondary": { "$ref": "#/definitions/hslColor" },
+        "secondary-foreground": { "$ref": "#/definitions/hslColor" },
+        "muted": { "$ref": "#/definitions/hslColor" },
+        "muted-foreground": { "$ref": "#/definitions/hslColor" },
+        "accent": { "$ref": "#/definitions/hslColor" },
+        "accent-foreground": { "$ref": "#/definitions/hslColor" },
+        "destructive": { "$ref": "#/definitions/hslColor" },
+        "destructive-foreground": { "$ref": "#/definitions/hslColor" },
+        "border": { "$ref": "#/definitions/hslColor" },
+        "input": { "$ref": "#/definitions/hslColor" },
+        "ring": { "$ref": "#/definitions/hslColor" },
+        "card": { "$ref": "#/definitions/hslColor" },
+        "card-foreground": { "$ref": "#/definitions/hslColor" },
+        "popover": { "$ref": "#/definitions/hslColor" },
+        "popover-foreground": { "$ref": "#/definitions/hslColor" },
+        "chart-1": { "$ref": "#/definitions/hslColor" },
+        "chart-2": { "$ref": "#/definitions/hslColor" },
+        "chart-3": { "$ref": "#/definitions/hslColor" },
+        "chart-4": { "$ref": "#/definitions/hslColor" },
+        "chart-5": { "$ref": "#/definitions/hslColor" },
+        "sidebar-background": { "$ref": "#/definitions/hslColor" },
+        "sidebar-foreground": { "$ref": "#/definitions/hslColor" },
+        "sidebar-primary": { "$ref": "#/definitions/hslColor" },
+        "sidebar-primary-foreground": { "$ref": "#/definitions/hslColor" },
+        "sidebar-accent": { "$ref": "#/definitions/hslColor" },
+        "sidebar-accent-foreground": { "$ref": "#/definitions/hslColor" },
+        "sidebar-border": { "$ref": "#/definitions/hslColor" },
+        "sidebar-ring": { "$ref": "#/definitions/hslColor" }
+      }
+    },
+    "hslColor": {
+      "type": "string",
+      "pattern": "^\\d+(\\.\\d+)?\\s+\\d+(\\.\\d+)?%\\s+\\d+(\\.\\d+)?%$",
+      "description": "HSL color without hsl() wrapper, e.g., '220 14.3% 95.9%'"
+    }
+  }
+}

package/templates/design/themes/corporate-enterprise/consulting.json

@@ -0,0 +1,81 @@
+{
+  "name": "Consulting",
+  "id": "consulting",
+  "category": "corporate-enterprise",
+  "description": "Management consulting aesthetic like McKinsey and BCG",
+  "colors": {
+    "light": {
+      "background": "0 0% 100%",
+      "foreground": "222 47% 11%",
+      "primary": "222 80% 28%",
+      "primary-foreground": "0 0% 100%",
+      "secondary": "220 20% 96%",
+      "secondary-foreground": "222 47% 15%",
+      "muted": "220 20% 96%",
+      "muted-foreground": "220 15% 45%",
+      "accent": "35 80% 45%",
+      "accent-foreground": "0 0% 100%",
+      "destructive": "0 84.2% 60.2%",
+      "destructive-foreground": "0 0% 98%",
+      "border": "220 15% 90%",
+      "input": "220 15% 90%",
+      "ring": "222 80% 28%",
+      "card": "0 0% 100%",
+      "card-foreground": "222 47% 11%",
+      "popover": "0 0% 100%",
+      "popover-foreground": "222 47% 11%",
+      "chart-1": "222 80% 28%",
+      "chart-2": "35 80% 45%",
+      "chart-3": "160 70% 40%",
+      "chart-4": "0 70% 55%",
+      "chart-5": "270 60% 55%",
+      "sidebar-background": "220 20% 98%",
+      "sidebar-foreground": "222 47% 15%",
+      "sidebar-primary": "222 80% 28%",
+      "sidebar-primary-foreground": "0 0% 100%",
+      "sidebar-accent": "220 20% 94%",
+      "sidebar-accent-foreground": "222 47% 15%",
+      "sidebar-border": "220 15% 90%",
+      "sidebar-ring": "222 80% 28%"
+    },
+    "dark": {
+      "background": "222 47% 6%",
+      "foreground": "220 20% 96%",
+      "primary": "222 60% 50%",
+      "primary-foreground": "0 0% 100%",
+      "secondary": "222 30% 15%",
+      "secondary-foreground": "220 20% 96%",
+      "muted": "222 30% 15%",
+      "muted-foreground": "220 15% 55%",
+      "accent": "35 80% 55%",
+      "accent-foreground": "222 47% 6%",
+      "destructive": "0 62.8% 30.6%",
+      "destructive-foreground": "0 0% 98%",
+      "border": "222 30% 18%",
+      "input": "222 30% 18%",
+      "ring": "222 60% 50%",
+      "card": "222 47% 8%",
+      "card-foreground": "220 20% 96%",
+      "popover": "222 47% 6%",
+      "popover-foreground": "220 20% 96%",
+      "chart-1": "222 60% 60%",
+      "chart-2": "35 80% 65%",
+      "chart-3": "160 70% 50%",
+      "chart-4": "0 70% 65%",
+      "chart-5": "270 60% 65%",
+      "sidebar-background": "222 47% 6%",
+      "sidebar-foreground": "220 20% 96%",
+      "sidebar-primary": "222 60% 50%",
+      "sidebar-primary-foreground": "0 0% 100%",
+      "sidebar-accent": "222 30% 15%",
+      "sidebar-accent-foreground": "220 20% 96%",
+      "sidebar-border": "222 30% 18%",
+      "sidebar-ring": "222 60% 50%"
+    }
+  },
+  "radius": "0.375rem",
+  "fontFamily": {
+    "sans": "Inter, system-ui, sans-serif",
+    "mono": "JetBrains Mono, monospace"
+  }
+}

package/templates/design/themes/corporate-enterprise/corporate-indigo.json

@@ -0,0 +1,81 @@
+{
+  "name": "Corporate Indigo",
+  "id": "corporate-indigo",
+  "category": "corporate-enterprise",
+  "description": "Professional SaaS aesthetic like Stripe and Intercom",
+  "colors": {
+    "light": {
+      "background": "0 0% 100%",
+      "foreground": "224 71.4% 4.1%",
+      "primary": "238.7 83.5% 66.7%",
+      "primary-foreground": "0 0% 100%",
+      "secondary": "220 14.3% 95.9%",
+      "secondary-foreground": "220.9 39.3% 11%",
+      "muted": "220 14.3% 95.9%",
+      "muted-foreground": "220 8.9% 46.1%",
+      "accent": "220 14.3% 95.9%",
+      "accent-foreground": "220.9 39.3% 11%",
+      "destructive": "0 84.2% 60.2%",
+      "destructive-foreground": "0 0% 98%",
+      "border": "220 13% 91%",
+      "input": "220 13% 91%",
+      "ring": "238.7 83.5% 66.7%",
+      "card": "0 0% 100%",
+      "card-foreground": "224 71.4% 4.1%",
+      "popover": "0 0% 100%",
+      "popover-foreground": "224 71.4% 4.1%",
+      "chart-1": "238.7 83.5% 66.7%",
+      "chart-2": "173 58% 39%",
+      "chart-3": "197 37% 24%",
+      "chart-4": "43 74% 66%",
+      "chart-5": "27 87% 67%",
+      "sidebar-background": "0 0% 98%",
+      "sidebar-foreground": "240 5.3% 26.1%",
+      "sidebar-primary": "238.7 83.5% 66.7%",
+      "sidebar-primary-foreground": "0 0% 98%",
+      "sidebar-accent": "240 4.8% 95.9%",
+      "sidebar-accent-foreground": "240 5.9% 10%",
+      "sidebar-border": "220 13% 91%",
+      "sidebar-ring": "238.7 83.5% 66.7%"
+    },
+    "dark": {
+      "background": "224 71.4% 4.1%",
+      "foreground": "210 20% 98%",
+      "primary": "238.7 83.5% 66.7%",
+      "primary-foreground": "0 0% 100%",
+      "secondary": "215 27.9% 16.9%",
+      "secondary-foreground": "210 20% 98%",
+      "muted": "215 27.9% 16.9%",
+      "muted-foreground": "217.9 10.6% 64.9%",
+      "accent": "215 27.9% 16.9%",
+      "accent-foreground": "210 20% 98%",
+      "destructive": "0 62.8% 30.6%",
+      "destructive-foreground": "210 20% 98%",
+      "border": "215 27.9% 16.9%",
+      "input": "215 27.9% 16.9%",
+      "ring": "238.7 83.5% 66.7%",
+      "card": "224 71.4% 4.1%",
+      "card-foreground": "210 20% 98%",
+      "popover": "224 71.4% 4.1%",
+      "popover-foreground": "210 20% 98%",
+      "chart-1": "220 70% 50%",
+      "chart-2": "160 60% 45%",
+      "chart-3": "30 80% 55%",
+      "chart-4": "280 65% 60%",
+      "chart-5": "340 75% 55%",
+      "sidebar-background": "224 71.4% 4.1%",
+      "sidebar-foreground": "210 20% 98%",
+      "sidebar-primary": "238.7 83.5% 66.7%",
+      "sidebar-primary-foreground": "0 0% 100%",
+      "sidebar-accent": "215 27.9% 16.9%",
+      "sidebar-accent-foreground": "210 20% 98%",
+      "sidebar-border": "215 27.9% 16.9%",
+      "sidebar-ring": "238.7 83.5% 66.7%"
+    }
+  },
+  "radius": "0.5rem",
+  "fontFamily": {
+    "sans": "Inter, system-ui, sans-serif",
+    "mono": "JetBrains Mono, monospace"
+  }
+}