opencodekit 0.15.21 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/dist/index.js +5 -7
  2. package/dist/template/.opencode/AGENTS.md +21 -20
  3. package/dist/template/.opencode/agent/build.md +88 -7
  4. package/dist/template/.opencode/agent/explore.md +1 -1
  5. package/dist/template/.opencode/agent/general.md +54 -4
  6. package/dist/template/.opencode/agent/looker.md +1 -1
  7. package/dist/template/.opencode/agent/painter.md +1 -1
  8. package/dist/template/.opencode/agent/plan.md +52 -0
  9. package/dist/template/.opencode/agent/review.md +1 -1
  10. package/dist/template/.opencode/agent/scout.md +3 -3
  11. package/dist/template/.opencode/agent/vision.md +1 -1
  12. package/dist/template/.opencode/command/create.md +201 -95
  13. package/dist/template/.opencode/command/design.md +5 -7
  14. package/dist/template/.opencode/command/handoff.md +7 -0
  15. package/dist/template/.opencode/command/init.md +25 -47
  16. package/dist/template/.opencode/command/plan.md +35 -16
  17. package/dist/template/.opencode/command/resume.md +7 -18
  18. package/dist/template/.opencode/command/ship.md +156 -0
  19. package/dist/template/.opencode/command/start.md +315 -28
  20. package/dist/template/.opencode/command/ui-review.md +5 -7
  21. package/dist/template/.opencode/command/verify.md +279 -0
  22. package/dist/template/.opencode/memory/_templates/README.md +57 -19
  23. package/dist/template/.opencode/memory/_templates/prd.md +29 -0
  24. package/dist/template/.opencode/memory/_templates/project/tech-stack.md +50 -0
  25. package/dist/template/.opencode/memory/_templates/proposal.md +38 -0
  26. package/dist/template/.opencode/memory/_templates/spec.md +66 -0
  27. package/dist/template/.opencode/memory/_templates/tasks.md +198 -0
  28. package/dist/template/.opencode/memory/observations/2026-02-01-decision-add-skills-vs-commands-to-global-agents-.md +15 -0
  29. package/dist/template/.opencode/memory/observations/2026-02-01-decision-build-agent-auto-loads-skills-contextual.md +31 -0
  30. package/dist/template/.opencode/memory/observations/2026-02-01-decision-fixed-agent-configuration-for-opencodeki.md +25 -0
  31. package/dist/template/.opencode/memory/observations/2026-02-01-decision-focused-agents-md-upgrade-for-opencode-k.md +14 -0
  32. package/dist/template/.opencode/memory/observations/2026-02-01-decision-implement-tier-1-permission-upgrades.md +15 -0
  33. package/dist/template/.opencode/memory/observations/2026-02-01-decision-instructions-config-explicit-paths-not-w.md +40 -0
  34. package/dist/template/.opencode/memory/observations/2026-02-01-decision-merged-context-into-memory-project-singl.md +42 -0
  35. package/dist/template/.opencode/memory/observations/2026-02-01-decision-oracle-tool-should-use-review-agent-not-.md +14 -0
  36. package/dist/template/.opencode/memory/observations/2026-02-01-decision-plan-agent-auto-loads-skills-contextuall.md +31 -0
  37. package/dist/template/.opencode/memory/observations/2026-02-01-decision-plan-phased-oracle-command-merge-into-ne.md +14 -0
  38. package/dist/template/.opencode/memory/observations/2026-02-01-decision-prd-workflow-uses-prd-and-prd-task-skill.md +23 -0
  39. package/dist/template/.opencode/memory/observations/2026-02-01-decision-prefer-review-agent-via-opencode-cli-ove.md +14 -0
  40. package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-add-ship-command-with.md +14 -0
  41. package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-and-add-ship-command-.md +14 -0
  42. package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-and-add-ship-command.md +14 -0
  43. package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-skills-vs-commands-section-from-a.md +14 -0
  44. package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-oracle-tool-with-ship-command-fl.md +14 -0
  45. package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-oracle-with-ship-command-workflo.md +14 -0
  46. package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-proxypal-oracle-with-cli-review-.md +14 -0
  47. package/dist/template/.opencode/memory/observations/2026-02-01-decision-simplified-dist-template-only-tech-stack.md +50 -0
  48. package/dist/template/.opencode/memory/observations/2026-02-01-decision-simplified-templates-only-tech-stack-md.md +26 -0
  49. package/dist/template/.opencode/memory/observations/2026-02-01-decision-subagents-load-minimal-skills-stay-lean.md +29 -0
  50. package/dist/template/.opencode/memory/observations/2026-02-01-decision-user-approved-permission-upgrades-in-ope.md +15 -0
  51. package/dist/template/.opencode/memory/observations/2026-02-01-discovery-verify-command-already-implemented.md +28 -0
  52. package/dist/template/.opencode/memory/observations/2026-02-01-feature-openspec-phase-b-complete-template-upgra.md +43 -0
  53. package/dist/template/.opencode/memory/observations/2026-02-01-learning-build-agent-should-use-dynamic-lsp-not-f.md +14 -0
  54. package/dist/template/.opencode/memory/observations/2026-02-01-learning-kimi-k2-5-model-requires-temperature-1-0.md +22 -0
  55. package/dist/template/.opencode/memory/observations/2026-02-01-learning-opencode-context-injection-already-imple.md +27 -0
  56. package/dist/template/.opencode/memory/observations/2026-02-01-learning-opencode-context-injection-uses-instruct.md +35 -0
  57. package/dist/template/.opencode/memory/observations/2026-02-01-learning-update-build-agent-prompt-to-use-context.md +14 -0
  58. package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-using-opencode-expert-.md +14 -0
  59. package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-with-opencode-expert-g.md +14 -0
  60. package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-with-opencode-expert-r.md +14 -0
  61. package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-prefers-copilot-gpt-5-2-codex-mediu.md +14 -0
  62. package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-wants-general-agent-prompt-contextu.md +15 -0
  63. package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-wants-general-agent-prompt-reviewed.md +15 -0
  64. package/dist/template/.opencode/memory/project/command-rules.md +122 -0
  65. package/dist/template/.opencode/memory/project/tech-stack.md +50 -0
  66. package/dist/template/.opencode/memory/research/ccpm-analysis.md +334 -0
  67. package/dist/template/.opencode/memory/research/openspec-analysis.md +226 -0
  68. package/dist/template/.opencode/opencode.json +916 -803
  69. package/dist/template/.opencode/skill/tool-priority/SKILL.md +2 -2
  70. package/package.json +1 -1
  71. package/dist/template/.opencode/command/accessibility-check.md +0 -331
  72. package/dist/template/.opencode/command/agent-browser.md +0 -21
  73. package/dist/template/.opencode/command/analyze-mockup.md +0 -423
  74. package/dist/template/.opencode/command/analyze-project.md +0 -295
  75. package/dist/template/.opencode/command/brainstorm.md +0 -373
  76. package/dist/template/.opencode/command/cloudflare.md +0 -70
  77. package/dist/template/.opencode/command/commit.md +0 -245
  78. package/dist/template/.opencode/command/complete-next-task.md +0 -77
  79. package/dist/template/.opencode/command/design-audit.md +0 -480
  80. package/dist/template/.opencode/command/edit-image.md +0 -242
  81. package/dist/template/.opencode/command/finish.md +0 -255
  82. package/dist/template/.opencode/command/fix-ci.md +0 -109
  83. package/dist/template/.opencode/command/fix-types.md +0 -104
  84. package/dist/template/.opencode/command/fix-ui.md +0 -117
  85. package/dist/template/.opencode/command/fix.md +0 -168
  86. package/dist/template/.opencode/command/frontend-design.md +0 -21
  87. package/dist/template/.opencode/command/generate-diagram.md +0 -349
  88. package/dist/template/.opencode/command/generate-icon.md +0 -283
  89. package/dist/template/.opencode/command/generate-image.md +0 -246
  90. package/dist/template/.opencode/command/generate-pattern.md +0 -247
  91. package/dist/template/.opencode/command/generate-storyboard.md +0 -250
  92. package/dist/template/.opencode/command/implement.md +0 -609
  93. package/dist/template/.opencode/command/import-plan.md +0 -406
  94. package/dist/template/.opencode/command/index-knowledge.md +0 -25
  95. package/dist/template/.opencode/command/integration-test.md +0 -424
  96. package/dist/template/.opencode/command/issue.md +0 -102
  97. package/dist/template/.opencode/command/new-feature.md +0 -651
  98. package/dist/template/.opencode/command/opensrc.md +0 -58
  99. package/dist/template/.opencode/command/quick-build.md +0 -238
  100. package/dist/template/.opencode/command/ralph.md +0 -41
  101. package/dist/template/.opencode/command/research-and-implement.md +0 -148
  102. package/dist/template/.opencode/command/research-ui.md +0 -466
  103. package/dist/template/.opencode/command/restore-image.md +0 -424
  104. package/dist/template/.opencode/command/revert-feature.md +0 -386
  105. package/dist/template/.opencode/command/skill-create.md +0 -517
  106. package/dist/template/.opencode/command/skill-optimize.md +0 -556
  107. package/dist/template/.opencode/command/summarize.md +0 -412
  108. package/dist/template/.opencode/command/triage.md +0 -398
  109. package/dist/template/.opencode/memory/_templates/project/architecture.md +0 -60
  110. package/dist/template/.opencode/memory/_templates/project/commands.md +0 -72
  111. package/dist/template/.opencode/memory/_templates/project/conventions.md +0 -68
  112. package/dist/template/.opencode/memory/_templates/project/gotchas.md +0 -41
  113. package/dist/template/.opencode/skill/notebooklm/SKILL.md +0 -272
  114. package/dist/template/.opencode/skill/notebooklm/references/setup.md +0 -353
  115. package/dist/template/.opencode/tool/notebooklm.ts +0 -488
  116. package/dist/template/.opencode/tool/oracle.ts +0 -240
@@ -1,406 +0,0 @@
1
- ---
2
- description: Import external plan into Beads - create epics and issues with dependencies
3
- argument-hint: "<plan-file.md> [--prefix=<epic-prefix>] [--dry-run] [--force]"
4
- agent: build
5
- ---
6
-
7
- # Import Plan
8
-
9
- **Load skills:**
10
-
11
- ```typescript
12
- skill({ name: "beads" }); // For hierarchy and dependencies
13
- skill({ name: "executing-plans" }); // For plan execution
14
- ```
15
-
16
- Import a markdown plan into Beads epics and issues. Follows Steve Yegge's "plan outside, import inside" pattern.
17
-
18
- ## Parse Arguments
19
-
20
- | Argument | Default | Description |
21
- | ----------- | -------- | ---------------------------------- |
22
- | Plan file | required | Path to markdown plan |
23
- | `--prefix` | none | Prefix for epic titles |
24
- | `--dry-run` | false | Preview without creating beads |
25
- | `--force` | false | Import even if duplicates detected |
26
-
27
- ---
28
-
29
- ## Phase 1: Load Plan
30
-
31
- Read the plan file:
32
-
33
- ```typescript
34
- read({ filePath: "$ARGUMENTS" });
35
- ```
36
-
37
- If file not found: "Plan file not found. Provide path to markdown plan."
38
-
39
- ---
40
-
41
- ## Phase 2: Duplicate Detection
42
-
43
- Before importing, check for existing beads with similar titles:
44
-
45
- !`bd list --status all --limit 50`
46
-
47
- Compare plan titles against existing beads:
48
-
49
- ````
50
- Duplicate Check:
51
- ━━━━━━━━━━━━━━━━
52
-
53
- ⚠ Potential duplicates found:
54
- - "User Authentication" similar to existing bd-abc123: "Auth System"
55
- - "Create login form" similar to existing bd-def456: "Login Form Component"
56
-
57
- Options:
58
- 1. Skip duplicates (import only new items)
59
- 2. Force import (create duplicates)
60
- 3. Cancel import
61
-
62
- ```typescript
63
- question({
64
- questions: [{
65
- header: "Duplicates",
66
- question: "Potential duplicates found. What should I do?",
67
- options: [
68
- { label: "Skip duplicates (Recommended)", description: "Import only new items" },
69
- { label: "Force import", description: "Create duplicate beads anyway" },
70
- { label: "Cancel import", description: "Stop and review plan" }
71
- ]
72
- }]
73
- });
74
- ````
75
-
76
- If `--force` flag set, skip this check and import everything.
77
-
78
- ---
79
-
80
- ## Phase 3: Analyze Structure
81
-
82
- Parse the plan for:
83
-
84
- - **Epics**: Top-level sections (## headers)
85
- - **Issues**: Sub-sections or task lists (### headers, - [ ] items)
86
- - **Dependencies**: References between sections, "after X", "requires Y"
87
- - **Estimates**: Size markers (S, M, L, XL, or time estimates)
88
- - **Tags**: Hashtags or category markers (#frontend, #backend, etc.)
89
-
90
- Report:
91
-
92
- ````
93
- Plan Analysis: [filename]
94
- ━━━━━━━━━━━━━━━━━━━━━━━━
95
-
96
- Epics found: [count]
97
- Issues found: [count]
98
- Dependencies: [count]
99
- Estimated effort: [total hours/points]
100
-
101
- Structure:
102
- ├── [Epic 1 title] ([issue count] issues, [estimate])
103
- │ ├── [Issue 1] [S] #frontend
104
- │ └── [Issue 2] [M] #backend → depends on Issue 1
105
- ├── [Epic 2 title] ([issue count] issues, [estimate])
106
- │ └── [Issue 1] [L] → depends on [Epic 1/Issue 2]
107
- └── ...
108
-
109
- ```typescript
110
- question({
111
- questions: [{
112
- header: "Import",
113
- question: "Plan analyzed. Should I proceed with import?",
114
- options: [
115
- { label: "Proceed with import (Recommended)", description: "Create epics and issues" },
116
- { label: "Modify plan", description: "Need changes before importing" },
117
- { label: "Cancel", description: "Stop and review plan" }
118
- ]
119
- }]
120
- });
121
- ````
122
-
123
- **STOP and wait for user approval** (unless `--dry-run`, then just show preview).
124
-
125
- ---
126
-
127
- ## Phase 4: Create Epics
128
-
129
- For each epic (top-level section):
130
-
131
- ```bash
132
- bd create "[prefix][Epic title]" -t epic -p 2
133
- ```
134
-
135
- Store epic IDs for dependency linking.
136
-
137
- **Progress feedback:**
138
-
139
- ```
140
- Creating epics... [1/3] ████░░░░░░ User Authentication
141
- Creating epics... [2/3] ██████░░░░ Dashboard
142
- Creating epics... [3/3] ██████████ Settings ✓
143
- ```
144
-
145
- ---
146
-
147
- ## Phase 5: Create Issues
148
-
149
- For each issue under an epic:
150
-
151
- ```bash
152
- bd create "[Issue title]" -t <inferred-type> -p <inferred-priority>
153
- # Then: bd dep add <issue-id> <epic-id>
154
- ```
155
-
156
- ### Type Inference
157
-
158
- | Content Pattern | Type |
159
- | --------------------------------- | ------- |
160
- | "fix", "bug", "error", "broken" | bug |
161
- | "test", "spec", "coverage" | task |
162
- | "refactor", "cleanup", "optimize" | task |
163
- | "docs", "document", "readme" | docs |
164
- | Default | feature |
165
-
166
- ### Priority Inference
167
-
168
- | Marker | Priority |
169
- | ------------------------------------- | -------- |
170
- | "critical", "urgent", "blocker", "P0" | 0 |
171
- | "important", "high", "P1" | 1 |
172
- | Default | 2 |
173
- | "low", "nice to have", "P3" | 3 |
174
- | "backlog", "someday", "P4" | 4 |
175
-
176
- ### Estimation Inference
177
-
178
- | Marker | Meaning | Suggested Hours |
179
- | ------------------- | -------------- | --------------- |
180
- | XS, "trivial" | Extra small | 1-2 hours |
181
- | S, "small" | Small | 2-4 hours |
182
- | M, "medium" | Medium | 4-8 hours |
183
- | L, "large" | Large | 1-2 days |
184
- | XL, "extra large" | Extra large | 3-5 days |
185
- | "[N]h", "[N] hours" | Explicit hours | N hours |
186
- | "[N]d", "[N] days" | Explicit days | N \* 8 hours |
187
-
188
- ### Tag Inference
189
-
190
- Detect from content and extract:
191
-
192
- - `#frontend`, `#backend`, `#devops`, `#design`
193
- - `@assignee` patterns
194
- - `[component-name]` references
195
-
196
- ---
197
-
198
- ## Phase 6: Link Dependencies
199
-
200
- For issues with dependencies, use the `deps` parameter:
201
-
202
- ```bash
203
- bd create "[title]" -t task -p 2
204
- bd dep add <issue-id> <blocking-issue-id>
205
- ```
206
-
207
- ### Dependency Patterns
208
-
209
- | Pattern | Interpretation |
210
- | --------------------------- | ---------------------- |
211
- | "after [X]" | X blocks this |
212
- | "requires [Y]" | Y blocks this |
213
- | "depends on [Z]" | Z blocks this |
214
- | "before [W]" | This blocks W |
215
- | "blocked by [V]" | V blocks this |
216
- | Numbered steps (1, 2, 3...) | Sequential blocking |
217
- | Indented sub-items | Parent blocks children |
218
-
219
- ---
220
-
221
- ## Phase 7: Rollback on Failure
222
-
223
- If any creation fails, offer rollback:
224
-
225
- ```
226
- ❌ Error creating issue "Setup database"
227
- Reason: [error message]
228
-
229
- Created so far:
230
- - bd-abc123: Epic: User Auth
231
- - bd-def456: Issue: Login form
232
-
233
- Options:
234
- 1. Rollback (delete created beads)
235
- 2. Continue (skip failed, proceed with rest)
236
- 3. Abort (keep created, stop here)
237
-
238
- Select option (1/2/3):
239
- ```
240
-
241
- Rollback implementation:
242
-
243
- ```bash
244
- # Delete in reverse order
245
- bd update bd-def456 --status cancelled
246
- bd update bd-abc123 --status cancelled
247
- ```
248
-
249
- ---
250
-
251
- ## Phase 8: Review Pass
252
-
253
- After import, review for quality:
254
-
255
- ```
256
- Import complete. Running review pass...
257
- ```
258
-
259
- For each epic, verify:
260
-
261
- - Title is clear and actionable
262
- - Description captures intent
263
- - Issues are properly scoped
264
- - Dependencies make sense
265
- - Estimates are reasonable
266
-
267
- Suggest improvements:
268
-
269
- ```
270
- Review Suggestions:
271
- ━━━━━━━━━━━━━━━━━━
272
-
273
- - bd-abc123: Title vague → "Implement Auth" → "Implement JWT Authentication"
274
- - bd-def456: Missing estimate → Suggest: M (4-8 hours)
275
- - bd-ghi789: Circular dependency detected with bd-jkl012
276
-
277
- Apply suggestions? (yes/no/select)
278
- ```
279
-
280
- ---
281
-
282
- ## Phase 9: Polish (Optional)
283
-
284
- If user approves suggestions, update the beads:
285
-
286
- ```bash
287
- bd update bd-abc123 --title "Implement JWT Authentication"
288
- ```
289
-
290
- Iterate up to 5 times if user requests more refinement.
291
-
292
- ---
293
-
294
- ## Output
295
-
296
- ```
297
- Plan Imported: [filename]
298
- ━━━━━━━━━━━━━━━━━━━━━━━
299
-
300
- Summary:
301
- ├── Epics: [count]
302
- ├── Issues: [count]
303
- ├── Dependencies: [count]
304
- ├── Estimated effort: [total]
305
- └── Duplicates skipped: [count]
306
-
307
- Created:
308
- ├── bd-epic-001: User Authentication
309
- │ ├── bd-task-001: Create login form [S] #frontend
310
- │ └── bd-task-002: Implement JWT tokens [M] #backend → blocked by bd-task-001
311
- ├── bd-epic-002: Dashboard
312
- │ └── bd-task-003: Dashboard layout [M] #frontend
313
- └── ...
314
-
315
- Next Steps:
316
- ├── View ready tasks: bd list --status ready
317
- ├── Start first task: /implement bd-task-001
318
- └── View dependencies: bd dep tree <id>
319
- ```
320
-
321
- ---
322
-
323
- ## Dry Run Mode
324
-
325
- With `--dry-run`, show what WOULD be created without creating anything:
326
-
327
- ```bash
328
- /import-plan docs/feature-plan.md --dry-run
329
- ```
330
-
331
- Output:
332
-
333
- ```
334
- DRY RUN - No beads will be created
335
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
336
-
337
- Would create:
338
- ├── [EPIC] User Authentication (pri: 2)
339
- │ ├── [feature] Create login form (pri: 2, est: S) #frontend
340
- │ └── [feature] Implement JWT tokens (pri: 2, est: M) #backend
341
- │ └── depends on: Create login form
342
- ├── [EPIC] Dashboard (pri: 2)
343
- │ └── [feature] Dashboard layout (pri: 2, est: M) #frontend
344
- └── ...
345
-
346
- Total: 2 epics, 3 issues, 1 dependency
347
-
348
- Run without --dry-run to create beads.
349
- ```
350
-
351
- ---
352
-
353
- ## Example Plan Format
354
-
355
- The command accepts plans in this format:
356
-
357
- ```markdown
358
- # Project: [Name]
359
-
360
- ## Epic: User Authentication
361
-
362
- Implement secure user authentication system.
363
-
364
- ### Issue: Create login form [S] #frontend
365
-
366
- - Build login form component
367
- - Add validation
368
- - Connect to auth API
369
-
370
- ### Issue: Implement JWT tokens [M] #backend
371
-
372
- After: Create login form
373
- Priority: high
374
-
375
- - Generate tokens on login
376
- - Validate tokens on requests
377
- - Handle token refresh
378
-
379
- ## Epic: Dashboard
380
-
381
- ### Issue: Dashboard layout [M] #frontend
382
-
383
- - Create responsive grid
384
- - Add navigation sidebar
385
- ```
386
-
387
- ---
388
-
389
- ## Supported Plan Formats
390
-
391
- | Format | Detection | Notes |
392
- | ------------------- | --------------- | ----------------------- |
393
- | Markdown (## / ###) | `.md` extension | Primary format |
394
- | Task lists (- [ ]) | Checkbox syntax | Converted to issues |
395
- | Numbered lists | 1. 2. 3. | Sequential dependencies |
396
-
397
- ---
398
-
399
- ## Related Commands
400
-
401
- | Need | Command |
402
- | ------------------------ | ---------------------- |
403
- | Create plan from scratch | `/plan` |
404
- | Execute imported plan | `/implement <bead-id>` |
405
- | View plan status | `/status` |
406
- | Create single bead | `bd create` |
@@ -1,25 +0,0 @@
1
- ---
2
- description: Generate hierarchical AGENTS.md knowledge base
3
- argument-hint: "[optional focus or notes]"
4
- agent: plan
5
- ---
6
-
7
- # Index Knowledge: $ARGUMENTS
8
-
9
- Generate or refresh hierarchical `AGENTS.md` files for this codebase.
10
-
11
- ## Load Skill
12
-
13
- ```typescript
14
- skill({ name: "index-knowledge" });
15
- ```
16
-
17
- Then follow the skill workflow to:
18
-
19
- - Analyze the repo structure
20
- - Identify subsystem boundaries
21
- - Generate/refresh `AGENTS.md` files (root + nested where appropriate)
22
-
23
- <user-request>
24
- $ARGUMENTS
25
- </user-request>