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.
- package/dist/index.js +5 -7
- package/dist/template/.opencode/AGENTS.md +21 -20
- package/dist/template/.opencode/agent/build.md +88 -7
- package/dist/template/.opencode/agent/explore.md +1 -1
- package/dist/template/.opencode/agent/general.md +54 -4
- package/dist/template/.opencode/agent/looker.md +1 -1
- package/dist/template/.opencode/agent/painter.md +1 -1
- package/dist/template/.opencode/agent/plan.md +52 -0
- package/dist/template/.opencode/agent/review.md +1 -1
- package/dist/template/.opencode/agent/scout.md +3 -3
- package/dist/template/.opencode/agent/vision.md +1 -1
- package/dist/template/.opencode/command/create.md +201 -95
- package/dist/template/.opencode/command/design.md +5 -7
- package/dist/template/.opencode/command/handoff.md +7 -0
- package/dist/template/.opencode/command/init.md +25 -47
- package/dist/template/.opencode/command/plan.md +35 -16
- package/dist/template/.opencode/command/resume.md +7 -18
- package/dist/template/.opencode/command/ship.md +156 -0
- package/dist/template/.opencode/command/start.md +315 -28
- package/dist/template/.opencode/command/ui-review.md +5 -7
- package/dist/template/.opencode/command/verify.md +279 -0
- package/dist/template/.opencode/memory/_templates/README.md +57 -19
- package/dist/template/.opencode/memory/_templates/prd.md +29 -0
- package/dist/template/.opencode/memory/_templates/project/tech-stack.md +50 -0
- package/dist/template/.opencode/memory/_templates/proposal.md +38 -0
- package/dist/template/.opencode/memory/_templates/spec.md +66 -0
- package/dist/template/.opencode/memory/_templates/tasks.md +198 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-add-skills-vs-commands-to-global-agents-.md +15 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-build-agent-auto-loads-skills-contextual.md +31 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-fixed-agent-configuration-for-opencodeki.md +25 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-focused-agents-md-upgrade-for-opencode-k.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-implement-tier-1-permission-upgrades.md +15 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-instructions-config-explicit-paths-not-w.md +40 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-merged-context-into-memory-project-singl.md +42 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-oracle-tool-should-use-review-agent-not-.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-plan-agent-auto-loads-skills-contextuall.md +31 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-plan-phased-oracle-command-merge-into-ne.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-prd-workflow-uses-prd-and-prd-task-skill.md +23 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-prefer-review-agent-via-opencode-cli-ove.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-add-ship-command-with.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-and-add-ship-command-.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-and-add-ship-command.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-skills-vs-commands-section-from-a.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-oracle-tool-with-ship-command-fl.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-oracle-with-ship-command-workflo.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-proxypal-oracle-with-cli-review-.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-simplified-dist-template-only-tech-stack.md +50 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-simplified-templates-only-tech-stack-md.md +26 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-subagents-load-minimal-skills-stay-lean.md +29 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-decision-user-approved-permission-upgrades-in-ope.md +15 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-discovery-verify-command-already-implemented.md +28 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-feature-openspec-phase-b-complete-template-upgra.md +43 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-learning-build-agent-should-use-dynamic-lsp-not-f.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-learning-kimi-k2-5-model-requires-temperature-1-0.md +22 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-learning-opencode-context-injection-already-imple.md +27 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-learning-opencode-context-injection-uses-instruct.md +35 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-learning-update-build-agent-prompt-to-use-context.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-using-opencode-expert-.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-with-opencode-expert-g.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-with-opencode-expert-r.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-prefers-copilot-gpt-5-2-codex-mediu.md +14 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-wants-general-agent-prompt-contextu.md +15 -0
- package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-wants-general-agent-prompt-reviewed.md +15 -0
- package/dist/template/.opencode/memory/project/command-rules.md +122 -0
- package/dist/template/.opencode/memory/project/tech-stack.md +50 -0
- package/dist/template/.opencode/memory/research/ccpm-analysis.md +334 -0
- package/dist/template/.opencode/memory/research/openspec-analysis.md +226 -0
- package/dist/template/.opencode/opencode.json +916 -803
- package/dist/template/.opencode/skill/tool-priority/SKILL.md +2 -2
- package/package.json +1 -1
- package/dist/template/.opencode/command/accessibility-check.md +0 -331
- package/dist/template/.opencode/command/agent-browser.md +0 -21
- package/dist/template/.opencode/command/analyze-mockup.md +0 -423
- package/dist/template/.opencode/command/analyze-project.md +0 -295
- package/dist/template/.opencode/command/brainstorm.md +0 -373
- package/dist/template/.opencode/command/cloudflare.md +0 -70
- package/dist/template/.opencode/command/commit.md +0 -245
- package/dist/template/.opencode/command/complete-next-task.md +0 -77
- package/dist/template/.opencode/command/design-audit.md +0 -480
- package/dist/template/.opencode/command/edit-image.md +0 -242
- package/dist/template/.opencode/command/finish.md +0 -255
- package/dist/template/.opencode/command/fix-ci.md +0 -109
- package/dist/template/.opencode/command/fix-types.md +0 -104
- package/dist/template/.opencode/command/fix-ui.md +0 -117
- package/dist/template/.opencode/command/fix.md +0 -168
- package/dist/template/.opencode/command/frontend-design.md +0 -21
- package/dist/template/.opencode/command/generate-diagram.md +0 -349
- package/dist/template/.opencode/command/generate-icon.md +0 -283
- package/dist/template/.opencode/command/generate-image.md +0 -246
- package/dist/template/.opencode/command/generate-pattern.md +0 -247
- package/dist/template/.opencode/command/generate-storyboard.md +0 -250
- package/dist/template/.opencode/command/implement.md +0 -609
- package/dist/template/.opencode/command/import-plan.md +0 -406
- package/dist/template/.opencode/command/index-knowledge.md +0 -25
- package/dist/template/.opencode/command/integration-test.md +0 -424
- package/dist/template/.opencode/command/issue.md +0 -102
- package/dist/template/.opencode/command/new-feature.md +0 -651
- package/dist/template/.opencode/command/opensrc.md +0 -58
- package/dist/template/.opencode/command/quick-build.md +0 -238
- package/dist/template/.opencode/command/ralph.md +0 -41
- package/dist/template/.opencode/command/research-and-implement.md +0 -148
- package/dist/template/.opencode/command/research-ui.md +0 -466
- package/dist/template/.opencode/command/restore-image.md +0 -424
- package/dist/template/.opencode/command/revert-feature.md +0 -386
- package/dist/template/.opencode/command/skill-create.md +0 -517
- package/dist/template/.opencode/command/skill-optimize.md +0 -556
- package/dist/template/.opencode/command/summarize.md +0 -412
- package/dist/template/.opencode/command/triage.md +0 -398
- package/dist/template/.opencode/memory/_templates/project/architecture.md +0 -60
- package/dist/template/.opencode/memory/_templates/project/commands.md +0 -72
- package/dist/template/.opencode/memory/_templates/project/conventions.md +0 -68
- package/dist/template/.opencode/memory/_templates/project/gotchas.md +0 -41
- package/dist/template/.opencode/skill/notebooklm/SKILL.md +0 -272
- package/dist/template/.opencode/skill/notebooklm/references/setup.md +0 -353
- package/dist/template/.opencode/tool/notebooklm.ts +0 -488
- 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.
|