opencodekit 0.15.20 → 0.16.0

package/dist/template/.opencode/command/ship.md

@@ -0,0 +1,156 @@
+---
+description: Ship a bead - implement, verify, review, close
+argument-hint: "<bead-id> [--parallel] [--swarm]"
+agent: build
+---
+
+# Ship: $ARGUMENTS
+
+This command combines implementation and finish gates. It implements, verifies, runs review, then closes.
+
+## Load Skills
+
+```typescript
+skill({ name: "beads" });
+skill({ name: "test-driven-development" });
+skill({ name: "verification-before-completion" });
+skill({ name: "finishing-a-development-branch" });
+skill({ name: "receiving-code-review" });
+skill({ name: "swarm-coordination" });
+skill({ name: "beads-bridge" });
+```
+
+## Skill Routing
+
+- Use **systematic-debugging** when a gate fails and root cause is unclear.
+- Use **receiving-code-review** to triage review feedback after the review agent runs.
+
+## Verify Task & Claim
+
+```bash
+bd show $ARGUMENTS
+bd update $ARGUMENTS --status in_progress
+```
+
+## Pre-Flight Verification
+
+Run `/verify $ARGUMENTS --quick` to check:
+
+- All spec requirements addressed
+- All gates passing
+- No obvious contradictions
+
+If verification fails, fix issues before proceeding.
+
+## Implement (Keep It Focused)
+
+- Read before edit
+- Delegate research if unclear (Task → explore/scout)
+- Keep scope ≤ 3 files or create subtasks
+
+If the task is large (3+ independent subtasks), use swarm mode.
+
+## Run Verification Gates
+
+Detect project type:
+
+```bash
+ls package.json Cargo.toml pyproject.toml go.mod Makefile 2>/dev/null
+```
+
+**Node/TypeScript:**
+
+```bash
+npm run build 2>/dev/null || true
+npm test
+npm run lint 2>/dev/null || true
+npm run typecheck 2>/dev/null || true
+```
+
+**Rust:**
+
+```bash
+cargo build
+cargo test
+cargo clippy -- -D warnings
+```
+
+**Python:**
+
+```bash
+pytest
+ruff check .
+mypy . 2>/dev/null || true
+```
+
+**Go:**
+
+```bash
+go build ./...
+go test ./...
+golangci-lint run
+```
+
+If ANY gate fails, stop and fix before proceeding.
+
+## Stage Changes For Review
+
+```bash
+git add -A
+git status
+git diff --cached --stat
+```
+
+## Spawn Review Agent (After Tests)
+
+```typescript
+Task({
+  subagent_type: "review",
+  description: "Review changes for $ARGUMENTS",
+  prompt: `Review the staged changes for bead $ARGUMENTS.
+
+Context:
+- Use git status and git diff --cached to see changes
+- Focus on correctness, edge cases, and risks
+- Report issues with file:line references
+
+Return:
+- Summary of findings
+- Critical/High/Medium issues (if any)
+`,
+});
+```
+
+If review finds issues, fix them, re-run verification gates, then re-run review.
+
+## Verify Success Criteria
+
+```bash
+cat .beads/artifacts/$ARGUMENTS/spec.md
+```
+
+Ensure all criteria are met before closing.
+
+## Close Bead (Ask First)
+
+```typescript
+question({
+  questions: [
+    {
+      header: "Close",
+      question: "Ship complete. Close bead $ARGUMENTS?",
+      options: [
+        { label: "Yes, close it (Recommended)", description: "All gates passed" },
+        { label: "No, keep open", description: "Need more work" },
+      ],
+    },
+  ],
+});
+```
+
+If confirmed:
+
+```bash
+bd close $ARGUMENTS --reason "Shipped: verification + review passed"
+bd sync
+```