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,238 +0,0 @@
1
- ---
2
- description: Quick build for trivial tasks with fast verification
3
- argument-hint: "<task-description> [--no-test] [--no-commit]"
4
- agent: build
5
- ---
6
-
7
- # Quick Build: $ARGUMENTS
8
-
9
- Fast path for trivial tasks. Skip ceremony, keep safety.
10
-
11
- ## Parse Arguments
12
-
13
- | Argument | Default | Description |
14
- | ---------------- | -------- | ----------------------------- |
15
- | Task description | required | What to fix/change |
16
- | `--no-test` | false | Skip test run (use sparingly) |
17
- | `--no-commit` | false | Make changes but don't commit |
18
-
19
- ---
20
-
21
- ## Qualification Check
22
-
23
- **This task qualifies for quick-build if ALL are true:**
24
-
25
- | Criterion | Check | If False |
26
- | ------------------------ | ------------------------------------ | ----------------- |
27
- | Single file change | 1 file modified | Use `/create` |
28
- | No new dependencies | No package.json/requirements changes | Use `/create` |
29
- | No database changes | No migrations, schema changes | Use `/create` |
30
- | No security implications | No auth, secrets, permissions | Use `/create` |
31
- | Under 30 minutes | Estimate < 30 min | Use `/create` |
32
- | Clear scope | Know exactly what to change | Use `/brainstorm` |
33
- | Low risk | Won't break critical paths | Use `/create` |
34
-
35
- **Examples that qualify:**
36
-
37
- - Fix typo in UI text
38
- - Update a constant value
39
- - Fix off-by-one error
40
- - Add missing null check
41
- - Update documentation
42
- - Rename a variable
43
- - Fix CSS styling issue
44
-
45
- **Examples that DON'T qualify:**
46
-
47
- - Add new API endpoint (multiple files)
48
- - Change authentication logic (security)
49
- - Update database schema (DB changes)
50
- - Add new npm package (dependencies)
51
- - Refactor a module (scope unclear)
52
-
53
- ---
54
-
55
- ## Workflow
56
-
57
- ### Step 1: Verify Scope (30 seconds)
58
-
59
- !`grep -r "[search-term]" src/ --include="*.{ts,tsx}" -l | head -5`
60
-
61
- If more than 1 file: **STOP** → Use `/create $ARGUMENTS` instead.
62
-
63
- ### Step 2: Backup Current State
64
-
65
- ```bash
66
- # Stash any existing changes
67
- git stash push -m "pre-quickbuild-$(date +%s)" 2>/dev/null || true
68
- ```
69
-
70
- !`git rev-parse HEAD`
71
-
72
- ### Step 3: Make the Change
73
-
74
- ```bash
75
- # Read the file
76
- read [file-path]
77
-
78
- # Make minimal, focused edit
79
- edit [file-path] [oldString] [newString]
80
- ```
81
-
82
- **Edit guidelines:**
83
-
84
- - Change only what's necessary
85
- - Add comment if non-obvious
86
- - Don't refactor adjacent code
87
- - Don't fix unrelated issues
88
-
89
- ### Step 4: Verify (unless --no-test)
90
-
91
- ```bash
92
- # Type check
93
- npm run type-check || tsc --noEmit
94
-
95
- # Run relevant tests
96
- npm test -- --testPathPattern="[related-test]" --passWithNoTests
97
-
98
- # Lint check
99
- npm run lint -- [file-path]
100
- ```
101
-
102
- **All checks must pass before committing.**
103
-
104
- ### Step 5: Commit (unless --no-commit)
105
-
106
- ```bash
107
- git add [file-path]
108
- git commit -m "fix: [concise description]
109
-
110
- Quick-build: [task description]"
111
- ```
112
-
113
- **Commit message format:**
114
-
115
- - `fix:` for bug fixes
116
- - `chore:` for maintenance
117
- - `docs:` for documentation
118
- - `style:` for formatting
119
-
120
- ---
121
-
122
- ## Escape Hatch
123
-
124
- If during work you realize it's more complex:
125
-
126
- ```
127
- ⚠ Complexity detected:
128
- - Multiple files need changes
129
- - Found related issues that need fixing
130
- - Discovered missing test coverage
131
-
132
- Escaping to structured workflow...
133
- ```
134
-
135
- **Action:**
136
-
137
- 1. Revert uncommitted changes: `git checkout -- .`
138
- 2. Create proper bead: `/create $ARGUMENTS`
139
- 3. Continue with full workflow
140
-
141
- **Don't force a complex change through quick-build.**
142
-
143
- ---
144
-
145
- ## Time Budget
146
-
147
- | Task Type | Max Time | Example |
148
- | -------------- | -------- | ---------------------------- |
149
- | Typo/text fix | 5 min | Fix spelling in button label |
150
- | Config change | 10 min | Update timeout value |
151
- | Simple bug fix | 15 min | Fix null check |
152
- | Style fix | 10 min | Fix CSS alignment |
153
- | Doc update | 15 min | Update README section |
154
-
155
- **If approaching 30 minutes: STOP and escalate to /create.**
156
-
157
- ---
158
-
159
- ## Output
160
-
161
- ```
162
- Quick Build Complete
163
- ━━━━━━━━━━━━━━━━━━━━
164
-
165
- Task: [description]
166
- File: [path]
167
- Time: [X minutes]
168
-
169
- Changes:
170
- - [summary of change]
171
-
172
- Verification:
173
- ✓ Type check passed
174
- ✓ Tests passed (3 specs)
175
- ✓ Lint passed
176
-
177
- Commit: [sha] "fix: [message]"
178
-
179
- Done. No bead created (trivial task).
180
- ```
181
-
182
- ---
183
-
184
- ## Rollback
185
-
186
- If the quick fix causes issues:
187
-
188
- ```bash
189
- # Revert the commit
190
- git revert HEAD --no-edit
191
-
192
- # Or reset to before
193
- git reset --hard HEAD~1
194
- ```
195
-
196
- ---
197
-
198
- ## Examples
199
-
200
- ```bash
201
- # Fix a typo
202
- /quick-build fix typo in login button text
203
-
204
- # Update a constant
205
- /quick-build change MAX_RETRIES from 3 to 5
206
-
207
- # Fix null check
208
- /quick-build add null check in getUserName function
209
-
210
- # CSS fix
211
- /quick-build fix button alignment in header
212
-
213
- # Skip tests for doc-only change
214
- /quick-build update README installation instructions --no-test
215
- ```
216
-
217
- ---
218
-
219
- ## Anti-Patterns
220
-
221
- | Don't | Why | Do Instead |
222
- | --------------------------- | ------------------ | --------------------- |
223
- | Quick-build multiple files | Scope creep | Use `/create` |
224
- | Skip tests for code changes | Risk of regression | Always verify |
225
- | Fix "one more thing" | Scope creep | Separate quick-build |
226
- | Force complex through | Technical debt | Escalate to `/create` |
227
- | Quick-build without reading | May miss context | Read file first |
228
-
229
- ---
230
-
231
- ## Related Commands
232
-
233
- | Need | Command |
234
- | --------------- | --------------------------- |
235
- | Structured task | `/create` then `/implement` |
236
- | Just exploring | Read files directly |
237
- | Multiple fixes | `/create` with sub-tasks |
238
- | Need planning | `/new-feature` |
@@ -1,41 +0,0 @@
1
- ---
2
- description: Start Ralph Wiggum autonomous loop for task completion
3
- argument-hint: "<task> [--prd <file>]"
4
- agent: build
5
- ---
6
-
7
- # Ralph Wiggum Loop
8
-
9
- First, load the ralph skill for complete instructions:
10
-
11
- ```typescript
12
- skill({ name: "ralph" });
13
- ```
14
-
15
- ## Task
16
-
17
- $ARGUMENTS
18
-
19
- ## Quick Start
20
-
21
- 1. **Load the skill** (above) to get full workflow instructions
22
- 2. **Detect environment**: Check lock files to determine package manager
23
- 3. **Create progress.txt**: Track completed tasks and notes
24
- 4. **Start iterating**: Follow the loop pattern from the skill
25
-
26
- ## The Loop (Summary)
27
-
28
- ```
29
- Read PRD → Pick task → Implement ONE feature → Validate → Commit → Update progress → Repeat
30
- ```
31
-
32
- Exit when ALL tasks complete by outputting:
33
-
34
- ```
35
- <promise>COMPLETE</promise>
36
- ```
37
-
38
- ## See Also
39
-
40
- - Full instructions: `skill({ name: "ralph" })`
41
- - Skill location: `.opencode/skill/ralph/SKILL.md`
@@ -1,148 +0,0 @@
1
- ---
2
- description: Research and implement in one workflow
3
- argument-hint: "<bead-id> [--quick] [--tdd]"
4
- agent: build
5
- ---
6
-
7
- # Research & Implement: $ARGUMENTS
8
-
9
- End-to-end workflow: research → plan → implement → verify.
10
-
11
- Use this for features with unknowns. For simple changes, use `/fix` or `/implement` directly.
12
-
13
- ## Phase 1: Context
14
-
15
- !`bd show $ARGUMENTS`
16
- !`cat .beads/artifacts/$ARGUMENTS/spec.md`
17
-
18
- If no spec exists: "Run `/create $ARGUMENTS` first."
19
-
20
- ## Phase 2: Research
21
-
22
- Define what you need to learn:
23
-
24
- ```
25
- Questions:
26
- 1. [Key question]
27
- 2. [Key question]
28
- 3. [Key question]
29
- ```
30
-
31
- Research using:
32
-
33
- ```typescript
34
- // Codebase patterns
35
- ast - grep({ pattern: "<pattern>" });
36
- grep({ pattern: "<pattern>", include: "*.ts" });
37
-
38
- // External docs
39
- context7_resolve_library_id({ libraryName: "<lib>", query: "<question>" });
40
-
41
- // Real examples
42
- codesearch({ query: "<pattern>", tokensNum: 5000 });
43
- ```
44
-
45
- Synthesize:
46
-
47
- ```
48
- Findings:
49
- • [Key insight 1]
50
- • [Key insight 2]
51
-
52
- Recommended approach: [summary]
53
- ```
54
-
55
- Save to `.beads/artifacts/$ARGUMENTS/research.md`.
56
-
57
- ## Phase 3: Plan
58
-
59
- Create implementation plan:
60
-
61
- ```markdown
62
- # Plan: $ARGUMENTS
63
-
64
- ## Approach
65
-
66
- [1-2 sentences]
67
-
68
- ## Steps
69
-
70
- 1. [Step] - verify: `[command]`
71
- 2. [Step] - verify: `[command]`
72
- 3. [Step] - verify: `[command]`
73
-
74
- ## Files
75
-
76
- - `src/foo.ts` - [change]
77
- - `src/bar.ts` - [change]
78
- ```
79
-
80
- Save to `.beads/artifacts/$ARGUMENTS/plan.md`.
81
-
82
- ## Phase 4: Implement
83
-
84
- Mark in progress:
85
-
86
- ```bash
87
- bd update $ARGUMENTS --status in_progress
88
- ```
89
-
90
- If `--tdd` flag:
91
-
92
- ```
93
- For each component:
94
- 1. RED: Write failing test
95
- 2. GREEN: Write minimal code to pass
96
- 3. REFACTOR: Clean up
97
- ```
98
-
99
- Otherwise, implement step by step from plan. Checkpoint after significant progress:
100
-
101
- ```bash
102
- git commit -m "WIP: $ARGUMENTS - [step]"
103
- ```
104
-
105
- ## Phase 5: Verify
106
-
107
- Run all gates:
108
-
109
- ```bash
110
- npm test
111
- npm run type-check
112
- npm run lint
113
- ```
114
-
115
- Verify against research requirements and plan steps.
116
-
117
- ## Phase 6: Complete
118
-
119
- ```bash
120
- git add -A
121
- git commit -m "$ARGUMENTS: [summary]"
122
- ```
123
-
124
- ```bash
125
- bd sync
126
- ```
127
-
128
- ```
129
- Done: $ARGUMENTS
130
-
131
- Research: .beads/artifacts/$ARGUMENTS/research.md
132
- Plan: .beads/artifacts/$ARGUMENTS/plan.md
133
- Changes: [files]
134
- Tests: Pass
135
-
136
- Next: /finish $ARGUMENTS
137
- ```
138
-
139
- ## Quick Mode (--quick)
140
-
141
- For smaller tasks:
142
-
143
- 1. Minimal research (5 min max)
144
- 2. No formal plan document
145
- 3. Direct implementation
146
- 4. Verify and commit
147
-
148
- Time budget: 30 minutes. If exceeding, convert to full workflow.