opencodekit 0.9.2 → 0.11.0

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

@@ -6,31 +6,67 @@ agent: build
 
 # Create Task
 
-## Phase 1: Interview
+## Phase 1: Check for Similar Work
+
+Before creating, search for existing or past work:
+
+```typescript
+memory -
+  search({ query: "[keywords from title/problem]", type: "observations" });
+bd_ls({ status: "all", limit: 20 });
+```
+
+If similar task exists:
+
+- Link as dependency, or
+- Extend existing task, or
+- Confirm this is intentionally separate
+
+## Phase 2: Interview
 
 **If title provided:** Use `$ARGUMENTS` as starting point.
 
-**If no title:** Ask:
+**If no title:** Ask in one message:
 
 1. "What problem are we solving?"
 2. "Bug, feature, or task?"
 3. "What's the acceptance criteria?"
+4. "Any constraints or 'never do X' rules?"
+5. "Related existing code or past work?"
 
-Keep it brief. Get: clear goal, success criteria, scope.
+Keep it brief. Get: clear goal, success criteria, scope, constraints.
 
-## Phase 2: Classify
+## Phase 3: Classify & Estimate
 
 Based on interview:
 
+### Type & Priority
+
 - **Type**: bug | feature | task | chore
 - **Priority**: 0 (critical) to 4 (low), default 2
-- **Complexity**: quick | deep
 
-**Quick** (default): Simple bugs, small changes, clear scope. No research/plan needed.
+### Complexity & Estimation
+
+| Complexity | Tool Calls | Description                        | Workflow            |
+| ---------- | ---------- | ---------------------------------- | ------------------- |
+| **S**      | ~10        | Single file fix, obvious solution  | → /implement        |
+| **M**      | ~30        | Few files, clear scope             | → /implement        |
+| **L**      | ~100       | Multiple files, needs research     | → /research → /plan |
+| **XL**     | Decompose  | Too big - break into smaller tasks | → Create sub-beads  |
+
+**Default:** M (medium)
+
+## Phase 4: Create Bead
 
-**Deep**: Complex features, unknowns, architectural changes. Needs research and planning.
+Reserve the artifacts directory:
 
-## Phase 3: Create Bead
+```typescript
+bd_reserve({
+  paths: [".beads/artifacts/<bead-id>/spec.md"],
+  reason: "Creating new task",
+  ttl: 600,
+});
+```
 
 Propose:
 
@@ -39,8 +75,8 @@ Creating:
   Title: [title]
   Type: [type]
   Priority: [0-4]
-  Complexity: [quick/deep]
-  Role: [fe/be/mobile/devops/qa] (optional, for multi-agent)
+  Estimate: [S/M/L/XL] (~[N] tool calls)
+  Role: [fe/be/mobile/devops/qa] (optional)
 
 Approve? (yes/modify)
 ```
@@ -53,18 +89,30 @@ bd_add({
   type: "[type]",
   pri: [priority],
   desc: "[description]",
+  tags: ["[role]", "[estimate]"], // e.g., ["fe", "M"]
 });
 ```
 
-**If using Beads Village for multi-agent coordination:** Add role tags so tasks can be auto-assigned to the right agent:
+### Link Dependencies
+
+If this task depends on others:
 
 ```typescript
-bd_add({ title: "[title]", type: "[type]", pri: [priority], tags: ["[role]"] });
+bd_add({
+  title: "[title]",
+  type: "[type]",
+  pri: [priority],
+  deps: ["<blocking-bead-id>"], // Tasks that must complete first
+});
 ```
 
-This makes the task claimable by agents with matching roles.
+### Assign to Role (optional)
+
+```typescript
+bd_assign({ id: "<bead-id>", role: "[fe/be/mobile/devops/qa]", notify: true });
+```
 
-## Phase 4: Create Spec
+## Phase 5: Create Spec
 
 ```bash
 mkdir -p .beads/artifacts/<bead-id>
@@ -74,12 +122,15 @@ Use the PRD template from `.opencode/memory/_templates/prd.md` as the base struc
 
 Write `.beads/artifacts/<bead-id>/spec.md`:
 
+### Standard Spec (S/M complexity)
+
 ```markdown
 # [Title]
 
 **Bead:** <bead-id>
 **Created:** [date]
 **Status:** To Do
+**Estimate:** [S/M] (~[N] tool calls)
 
 ## Goal
 
@@ -87,50 +138,80 @@ Write `.beads/artifacts/<bead-id>/spec.md`:
 
 ## Scope
 
-### In-Scope:
+**In-Scope:**
 
 - [What we ARE doing]
 
-### Out-of-Scope:
+**Out-of-Scope:**
 
 - [What we are NOT doing]
 
-## User Flow
+## Success Criteria
 
-1. [Step 1: What user sees/does]
-2. [Step 2]
-3. [Step 3]
+- [ ] [Criterion 1]
+  - Verify: `[actual command to test this]`
+- [ ] [Criterion 2]
+  - Verify: `[actual command to test this]`
 
-## Success Criteria
+## Constraints
 
-- [ ] [Specific, measurable criterion 1]
-- [ ] [Specific, measurable criterion 2]
-- [ ] [Specific, measurable criterion 3]
+**Must:**
 
-## Dependencies
+- [Required constraint]
+
+**Never:**
 
-- [List any prerequisites or blocking tasks]
+- [Anti-pattern or forbidden action]
 
 ## Notes
 
-[Additional context or constraints]
+[Additional context]
 ```
 
-For **Quick** mode, simplify: Goal, Success Criteria, Notes only.
+### Deep Spec (L/XL complexity)
 
-For **Deep** mode, add:
+Add these sections:
 
 ```markdown
+## User Flow
+
+1. [Step 1: What user sees/does]
+2. [Step 2]
+3. [Step 3]
+
+## Dependencies
+
+- `<bead-id>` - [what it provides]
+- [External dependency]
+
+## Edge Cases
+
+- [Edge case 1] → [expected behavior]
+- [Edge case 2] → [expected behavior]
+
 ## Open Questions
 
 - [Question for research phase]
+- [Uncertainty to resolve]
 
 ## Technical Approach
 
 [To be filled during /research phase]
 ```
 
-## Phase 5: Review Spec
+## Phase 6: Spec Quality Check
+
+Before presenting, verify:
+
+- [ ] **Testable criteria?** Each success criterion has a verification command
+- [ ] **Constraints explicit?** "Must" and "Never" rules documented
+- [ ] **Edge cases identified?** (for L/XL complexity)
+- [ ] **Scope clear?** In/Out boundaries defined
+- [ ] **Estimate realistic?** Based on similar past work
+
+Fix any gaps before proceeding.
+
+## Phase 7: Review Spec
 
 Present the spec for approval:
 
@@ -141,15 +222,26 @@ Spec Preview:
 [Show full spec.md content]
 
 ━━━━━━━━━━━━━
+Quality check:
+✓ Testable criteria
+✓ Constraints explicit
+✓ Scope clear
+[✓/⚠] Edge cases (if L/XL)
+
 Approve spec? (yes/modify)
 ```
 
 **STOP and wait for human response.**
 
 If "modify": Iterate on spec based on feedback until approved.
-If "yes": Proceed to report.
+If "yes": Proceed to sync and report.
+
+## Phase 8: Sync & Report
 
-## Phase 6: Report
+```typescript
+bd_release({ _: true });
+bd_sync({ reason: "Created task $ARGUMENTS" });
+```
 
 ```
 Created: <bead-id>
@@ -157,19 +249,30 @@ Created: <bead-id>
 
 Title: [title]
 Type: [type]
-Mode: [Quick/Deep]
+Estimate: [S/M/L/XL] (~[N] tool calls)
 
 Spec: .beads/artifacts/<bead-id>/spec.md
 ```
 
-**Quick mode next step:**
+### Next Steps by Complexity
+
+**S/M complexity:**
 
 ```
 Next: /implement <bead-id>
 ```
 
-**Deep mode next step:**
+**L complexity:**
 
 ```
 Next: /research <bead-id>
 ```
+
+**XL complexity:**
+
+```
+This task is too large. Break it down:
+  /create "[subtask 1]"  # Then link as dependency
+  /create "[subtask 2]"
+  /create "[subtask 3]"
+```