opencodekit 0.16.0 → 0.16.1

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 (119) hide show
  1. package/dist/index.js +1 -1
  2. package/dist/template/.opencode/AGENTS.md +64 -3
  3. package/dist/template/.opencode/command/create.md +34 -0
  4. package/dist/template/.opencode/command/design.md +35 -0
  5. package/dist/template/.opencode/command/handoff.md +15 -0
  6. package/dist/template/.opencode/command/init.md +40 -47
  7. package/dist/template/.opencode/command/plan.md +1 -0
  8. package/dist/template/.opencode/command/pr.md +15 -0
  9. package/dist/template/.opencode/command/research.md +3 -0
  10. package/dist/template/.opencode/command/resume.md +1 -0
  11. package/dist/template/.opencode/command/review-codebase.md +30 -0
  12. package/dist/template/.opencode/command/ship.md +43 -0
  13. package/dist/template/.opencode/command/start.md +1 -0
  14. package/dist/template/.opencode/command/status.md +24 -1
  15. package/dist/template/.opencode/command/ui-review.md +31 -0
  16. package/dist/template/.opencode/command/verify.md +35 -7
  17. package/dist/template/.opencode/memory/project/tech-stack.md +25 -22
  18. package/dist/template/.opencode/memory.db +0 -0
  19. package/dist/template/.opencode/memory.db-shm +0 -0
  20. package/dist/template/.opencode/memory.db-wal +0 -0
  21. package/dist/template/.opencode/opencode.json +817 -916
  22. package/dist/template/.opencode/package.json +1 -0
  23. package/dist/template/.opencode/plans/1770006237537-mighty-otter.md +418 -0
  24. package/dist/template/.opencode/plans/1770006913647-glowing-forest.md +170 -0
  25. package/dist/template/.opencode/plans/1770013678126-witty-planet.md +278 -0
  26. package/dist/template/.opencode/plugin/lib/memory-db.ts +828 -0
  27. package/dist/template/.opencode/plugin/memory.ts +38 -1
  28. package/dist/template/.opencode/skill/index-knowledge/SKILL.md +76 -31
  29. package/dist/template/.opencode/skill/memory-system/SKILL.md +110 -55
  30. package/dist/template/.opencode/tool/memory-get.ts +143 -0
  31. package/dist/template/.opencode/tool/memory-maintain.ts +167 -0
  32. package/dist/template/.opencode/tool/memory-migrate.ts +319 -0
  33. package/dist/template/.opencode/tool/memory-read.ts +17 -46
  34. package/dist/template/.opencode/tool/memory-search.ts +131 -28
  35. package/dist/template/.opencode/tool/memory-timeline.ts +105 -0
  36. package/dist/template/.opencode/tool/memory-update.ts +21 -26
  37. package/dist/template/.opencode/tool/observation.ts +112 -100
  38. package/dist/template/.opencode/tsconfig.json +19 -19
  39. package/package.json +1 -1
  40. package/dist/template/.opencode/memory/_templates/README.md +0 -73
  41. package/dist/template/.opencode/memory/_templates/observation.md +0 -39
  42. package/dist/template/.opencode/memory/_templates/prompt-engineering.md +0 -333
  43. package/dist/template/.opencode/memory/observations/2026-01-22-decision-agents-md-prompt-engineering-improvement.md +0 -29
  44. package/dist/template/.opencode/memory/observations/2026-01-25-decision-agent-roles-build-orchestrates-general-e.md +0 -14
  45. package/dist/template/.opencode/memory/observations/2026-01-25-decision-simplified-swarm-helper-tool-to-fix-type.md +0 -20
  46. package/dist/template/.opencode/memory/observations/2026-01-25-decision-use-beads-as-swarm-board-source-of-truth.md +0 -14
  47. package/dist/template/.opencode/memory/observations/2026-01-25-learning-user-wants-real-swarm-coordination-guida.md +0 -15
  48. package/dist/template/.opencode/memory/observations/2026-01-28-decision-created-deep-research-skill-for-thorough.md +0 -29
  49. package/dist/template/.opencode/memory/observations/2026-01-28-decision-gh-grep-mcp-wrapper-vs-native-grep-searc.md +0 -21
  50. package/dist/template/.opencode/memory/observations/2026-01-28-decision-oracle-tool-optimal-usage-patterns.md +0 -32
  51. package/dist/template/.opencode/memory/observations/2026-01-28-learning-ampcode-deep-mode-research-integration-w.md +0 -42
  52. package/dist/template/.opencode/memory/observations/2026-01-28-pattern-research-delegation-pattern-explore-for-.md +0 -32
  53. package/dist/template/.opencode/memory/observations/2026-01-29-decision-copilot-auth-plugin-rate-limit-handling.md +0 -27
  54. package/dist/template/.opencode/memory/observations/2026-01-29-decision-spec-driven-approach-for-opencodekit.md +0 -21
  55. package/dist/template/.opencode/memory/observations/2026-01-29-learning-karpathy-llm-coding-insights-dec-2025.md +0 -44
  56. package/dist/template/.opencode/memory/observations/2026-01-30-decision-github-copilot-claude-routing-keep-disab.md +0 -32
  57. package/dist/template/.opencode/memory/observations/2026-01-30-discovery-context-management-research-critical-gap.md +0 -14
  58. package/dist/template/.opencode/memory/observations/2026-01-30-discovery-kimi-k2-5-agent-swarm-architecture-patte.md +0 -45
  59. package/dist/template/.opencode/memory/observations/2026-01-30-pattern-swarm-tools-architecture.md +0 -28
  60. package/dist/template/.opencode/memory/observations/2026-01-31-decision-copilot-auth-plugin-updated-with-baseurl.md +0 -63
  61. package/dist/template/.opencode/memory/observations/2026-01-31-decision-created-dedicated-worker-agent-for-swarm.md +0 -20
  62. package/dist/template/.opencode/memory/observations/2026-01-31-decision-rollback-to-v1-1-47-for-copilot-claude-r.md +0 -21
  63. package/dist/template/.opencode/memory/observations/2026-01-31-decision-simplified-swarm-to-task-tool-pattern.md +0 -44
  64. package/dist/template/.opencode/memory/observations/2026-01-31-decision-swarm-architecture-task-tool-over-tmux.md +0 -33
  65. package/dist/template/.opencode/memory/observations/2026-01-31-decision-worker-skills-defined-for-swarm-delegati.md +0 -30
  66. package/dist/template/.opencode/memory/observations/2026-01-31-learning-gpt-reasoning-config-for-github-copilot.md +0 -51
  67. package/dist/template/.opencode/memory/observations/2026-01-31-learning-opencode-copilot-auth-comparison-finding.md +0 -61
  68. package/dist/template/.opencode/memory/observations/2026-01-31-learning-opencode-copilot-reasoning-architecture-.md +0 -66
  69. package/dist/template/.opencode/memory/observations/2026-01-31-learning-opencode-custom-tools-api.md +0 -48
  70. package/dist/template/.opencode/memory/observations/2026-01-31-learning-opencode-v1-1-48-skills-as-slash-command.md +0 -21
  71. package/dist/template/.opencode/memory/observations/2026-01-31-learning-swarm-system-simplified-removed-mailbox-.md +0 -30
  72. package/dist/template/.opencode/memory/observations/2026-01-31-learning-v1-1-48-native-copilot-reasoning-via-pr-.md +0 -45
  73. package/dist/template/.opencode/memory/observations/2026-01-31-warning-cannot-add-custom-config-to-opencode-jso.md +0 -18
  74. package/dist/template/.opencode/memory/observations/2026-01-31-warning-copilot-claude-v1-endpoint-returns-404-c.md +0 -48
  75. package/dist/template/.opencode/memory/observations/2026-01-31-warning-opencode-v1-1-48-claude-thinking-block-s.md +0 -51
  76. package/dist/template/.opencode/memory/observations/2026-02-01-decision-add-skills-vs-commands-to-global-agents-.md +0 -15
  77. package/dist/template/.opencode/memory/observations/2026-02-01-decision-build-agent-auto-loads-skills-contextual.md +0 -31
  78. package/dist/template/.opencode/memory/observations/2026-02-01-decision-fixed-agent-configuration-for-opencodeki.md +0 -25
  79. package/dist/template/.opencode/memory/observations/2026-02-01-decision-focused-agents-md-upgrade-for-opencode-k.md +0 -14
  80. package/dist/template/.opencode/memory/observations/2026-02-01-decision-implement-tier-1-permission-upgrades.md +0 -15
  81. package/dist/template/.opencode/memory/observations/2026-02-01-decision-instructions-config-explicit-paths-not-w.md +0 -40
  82. package/dist/template/.opencode/memory/observations/2026-02-01-decision-merged-context-into-memory-project-singl.md +0 -42
  83. package/dist/template/.opencode/memory/observations/2026-02-01-decision-oracle-tool-should-use-review-agent-not-.md +0 -14
  84. package/dist/template/.opencode/memory/observations/2026-02-01-decision-plan-agent-auto-loads-skills-contextuall.md +0 -31
  85. package/dist/template/.opencode/memory/observations/2026-02-01-decision-plan-phased-oracle-command-merge-into-ne.md +0 -14
  86. package/dist/template/.opencode/memory/observations/2026-02-01-decision-prd-workflow-uses-prd-and-prd-task-skill.md +0 -23
  87. package/dist/template/.opencode/memory/observations/2026-02-01-decision-prefer-review-agent-via-opencode-cli-ove.md +0 -14
  88. package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-add-ship-command-with.md +0 -14
  89. package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-and-add-ship-command-.md +0 -14
  90. package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-oracle-tool-and-add-ship-command.md +0 -14
  91. package/dist/template/.opencode/memory/observations/2026-02-01-decision-remove-skills-vs-commands-section-from-a.md +0 -14
  92. package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-oracle-tool-with-ship-command-fl.md +0 -14
  93. package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-oracle-with-ship-command-workflo.md +0 -14
  94. package/dist/template/.opencode/memory/observations/2026-02-01-decision-replace-proxypal-oracle-with-cli-review-.md +0 -14
  95. package/dist/template/.opencode/memory/observations/2026-02-01-decision-simplified-dist-template-only-tech-stack.md +0 -50
  96. package/dist/template/.opencode/memory/observations/2026-02-01-decision-simplified-templates-only-tech-stack-md.md +0 -26
  97. package/dist/template/.opencode/memory/observations/2026-02-01-decision-subagents-load-minimal-skills-stay-lean.md +0 -29
  98. package/dist/template/.opencode/memory/observations/2026-02-01-decision-user-approved-permission-upgrades-in-ope.md +0 -15
  99. package/dist/template/.opencode/memory/observations/2026-02-01-discovery-verify-command-already-implemented.md +0 -28
  100. package/dist/template/.opencode/memory/observations/2026-02-01-feature-openspec-phase-b-complete-template-upgra.md +0 -43
  101. package/dist/template/.opencode/memory/observations/2026-02-01-learning-build-agent-should-use-dynamic-lsp-not-f.md +0 -14
  102. package/dist/template/.opencode/memory/observations/2026-02-01-learning-kimi-k2-5-model-requires-temperature-1-0.md +0 -22
  103. package/dist/template/.opencode/memory/observations/2026-02-01-learning-opencode-context-injection-already-imple.md +0 -27
  104. package/dist/template/.opencode/memory/observations/2026-02-01-learning-opencode-context-injection-uses-instruct.md +0 -35
  105. package/dist/template/.opencode/memory/observations/2026-02-01-learning-update-build-agent-prompt-to-use-context.md +0 -14
  106. package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-using-opencode-expert-.md +0 -14
  107. package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-with-opencode-expert-g.md +0 -14
  108. package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-with-opencode-expert-r.md +0 -14
  109. package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-prefers-copilot-gpt-5-2-codex-mediu.md +0 -14
  110. package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-wants-general-agent-prompt-contextu.md +0 -15
  111. package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-wants-general-agent-prompt-reviewed.md +0 -15
  112. package/dist/template/.opencode/memory/project/architecture.md +0 -60
  113. package/dist/template/.opencode/memory/project/command-rules.md +0 -122
  114. package/dist/template/.opencode/memory/project/commands.md +0 -72
  115. package/dist/template/.opencode/memory/project/conventions.md +0 -68
  116. package/dist/template/.opencode/memory/project/gotchas.md +0 -41
  117. /package/dist/template/.opencode/memory/_templates/{project/tech-stack.md → tech-stack.md} +0 -0
  118. /package/dist/template/.opencode/memory/{user.example.md → _templates/user.md} +0 -0
  119. /package/dist/template/.opencode/memory/{user.md → project/user.md} +0 -0
@@ -1,18 +0,0 @@
1
- ---
2
- type: warning
3
- created: 2026-01-31T13:04:00.635Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["opencode.json", "config", "schema", "tmux", "custom-config", "validation"]
8
- ---
9
-
10
- # ⚠️ Cannot add custom config to opencode.json
11
-
12
- 🟢 **Confidence:** high
13
-
14
- opencode.json has a strict JSON schema (https://opencode.ai/config.json). You CANNOT add arbitrary config sections like "tmux". The schema only allows specific keys like: agent, autoupdate, compaction, experimental, formatter, instructions, keybinds, mcp, model, permission, plugin, provider, share, small_model, tools, tui, watcher.
15
-
16
- Custom tool configuration must be handled within the tool itself (via environment variables, separate config file, or hardcoded defaults) - NOT in opencode.json.
17
-
18
- The user already commented out the invalid tmux section at lines 785-790.
@@ -1,48 +0,0 @@
1
- ---
2
- type: warning
3
- created: 2026-01-31T05:19:40.401Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["copilot", "claude", "routing", "v1", "404", "not-found", "anthropic", "messages-api", "limitation"]
8
- files: ["api.githubcopilot.com"]
9
- ---
10
-
11
- # ⚠️ Copilot Claude /v1 Endpoint Returns 404 - Confirmed
12
-
13
- 🟢 **Confidence:** high
14
-
15
- ## Confirmed: GitHub Copilot Does NOT Support Claude /v1 Endpoint
16
-
17
- ### Test Result
18
- Re-enabling Claude routing with `/v1` endpoint causes 404 "Not Found" errors.
19
-
20
- ### Root Cause
21
- GitHub Copilot API (`api.githubcopilot.com`) only exposes:
22
- - `/v1/chat/completions` - OpenAI-compatible endpoint
23
-
24
- It does NOT expose:
25
- - `/v1/messages` - Anthropic's native Messages API (required for extended thinking)
26
-
27
- ### Conclusion
28
- **Extended thinking/reasoning is NOT available for Claude through GitHub Copilot.**
29
-
30
- The Copilot API acts as a proxy that:
31
- 1. Accepts OpenAI-format requests
32
- 2. Translates them internally to Claude
33
- 3. Returns OpenAI-format responses
34
-
35
- This translation layer strips thinking blocks and doesn't support the `thinking` parameter.
36
-
37
- ### Final Configuration
38
- All Claude models must use `@ai-sdk/github-copilot` SDK, NOT `@ai-sdk/anthropic`.
39
-
40
- ```typescript
41
- // This is the ONLY working configuration
42
- model.api.npm = "@ai-sdk/github-copilot";
43
- ```
44
-
45
- ### Workaround for Reasoning
46
- To get Claude reasoning, users must:
47
- 1. Use direct Anthropic API with separate API key
48
- 2. Or use a provider that exposes native Anthropic Messages API (Vertex AI, AWS Bedrock)
@@ -1,51 +0,0 @@
1
- ---
2
- type: warning
3
- created: 2026-01-31T17:14:16.151Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["opencode", "copilot", "claude", "thinking-block", "signature", "reasoning", "v1.1.48", "bug", "sdk", "backup"]
8
- ---
9
-
10
- # ⚠️ OpenCode v1.1.48+ Claude Thinking Block Signature Bug
11
-
12
- 🟢 **Confidence:** high
13
-
14
- ## Problem
15
- When upgrading OpenCode from v1.1.48 to dev branch, Claude models via GitHub Copilot fail with:
16
- `messages.1.content.0: Invalid 'signature' in 'thinking' block`
17
-
18
- ## Root Cause
19
- - OpenCode v1.1.48+ native `@ai-sdk/github-copilot` SDK validates thinking block signatures
20
- - Switching models mid-session causes signature validation failures
21
- - Thinking blocks from one model (GLM 4.7, MiniMax, etc.) have incompatible signatures with Claude
22
- - GitHub issue #6418, fix in draft PR #8958
23
-
24
- ## Working Configuration (Pre-upgrade)
25
- Location: `backup/sdk/` contains custom copilot SDK that bypassed signature validation
26
- - `backup/sdk/copilot/` - Custom @ai-sdk/github-copilot implementation
27
- - `~/.config/opencode/plugin/copilot-auth.ts` - Auth plugin with disabled custom reasoning (664 lines)
28
- - `~/.config/opencode/opencode.json` - Model configurations
29
-
30
- ## Key Files in Backup SDK
31
- ```
32
- backup/sdk/copilot/
33
- ├── chat/
34
- │ ├── convert-to-openai-compatible-chat-messages.ts
35
- │ ├── get-response-metadata.ts
36
- │ ├── map-openai-compatible-finish-reason.ts
37
- │ ├── openai-compatible-api-types.ts
38
- │ ├── openai-compatible-chat-language-model.ts
39
- │ ├── openai-compatible-chat-options.ts
40
- │ ├── openai-compatible-metadata-extractor.ts
41
- │ └── openai-compatible-prepare-tools.ts
42
- ├── copilot-provider.ts
43
- ├── index.ts
44
- └── openai-compatible-error.ts
45
- ```
46
-
47
- ## Workarounds
48
- 1. Don't switch to Claude mid-session from models with thinking blocks
49
- 2. Start fresh sessions when using Claude with extended thinking
50
- 3. Wait for PR #8958 to be merged
51
- 4. Restore custom SDK from backup (breaks native reasoning handling)
@@ -1,15 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T11:37:16.161Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["AGENTS.md", "skills vs commands", "global rules"]
8
- files: [".opencode/AGENTS.md"]
9
- ---
10
-
11
- # 🎯 Add Skills vs Commands to global AGENTS rules
12
-
13
- 🟢 **Confidence:** high
14
-
15
- User requested adding the 'Skills vs Commands' guidance to the global rules file .opencode/AGENTS.md.
@@ -1,31 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T16:02:30.722Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["skills", "auto-loading", "build-agent", "context", "prd", "swarm", "debugging", "testing", "frontend"]
8
- ---
9
-
10
- # 🎯 Build agent auto-loads skills contextually
11
-
12
- 🟢 **Confidence:** high
13
-
14
- Build agent loads skills based on context, NOT all at once:
15
-
16
- **Always load:**
17
- - beads (task tracking)
18
- - verification-before-completion (never skip)
19
-
20
- **Conditional loading:**
21
- - prd-task: when prd.md exists
22
- - prd: when feature needs PRD creation
23
- - swarm-coordination: when 3+ parallel tasks
24
- - systematic-debugging: for bug fixes
25
- - test-driven-development: for test work
26
- - frontend-design: for UI/component work
27
- - using-git-worktrees: for epics or --worktree flag
28
- - requesting-code-review: before claiming done
29
- - finishing-a-development-branch: when completing feature
30
-
31
- This prevents skill overload and keeps context focused.
@@ -1,25 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T05:06:14.307Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["opencode", "agents", "configuration", "temperature", "steps", "scout", "build", "plan"]
8
- ---
9
-
10
- # 🎯 Fixed agent configuration for OpenCodeKit
11
-
12
- 🟢 **Confidence:** high
13
-
14
- Applied comprehensive fixes to .opencode/agent/ configuration:
15
-
16
- 1. **scout.md**: Changed temperature from 0.3 to 1.0 (required for kimi-k2.5-free thinking mode), changed maxSteps to steps
17
- 2. **explore.md**: Changed maxSteps to steps
18
- 3. **review.md**: Changed maxSteps to steps
19
- 4. **vision.md**: Changed maxSteps to steps
20
- 5. **looker.md**: Changed maxSteps to steps
21
- 6. **painter.md**: Changed maxSteps to steps
22
- 7. **build.md**: Added steps: 50 and color: "#4CAF50" (green)
23
- 8. **plan.md**: Added steps: 50 and color: "#2196F3" (blue)
24
-
25
- All agents now use modern `steps` syntax instead of deprecated `maxSteps`. Scout agent temperature fixed to work with kimi-k2.5-free model. Primary agents have visual colors for UI distinction.
@@ -1,14 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T10:28:34.941Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["AGENTS.md", "opencode-expert", "configuration", "best practices", "kit users"]
8
- ---
9
-
10
- # 🎯 Focused AGENTS.md upgrade for OpenCode kit users
11
-
12
- 🟢 **Confidence:** high
13
-
14
- User requested a focused upgrade to AGENTS.md using opencode-expert guidance to add OpenCode configuration best practices and doc references for kit users.
@@ -1,15 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T09:32:47.846Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["opencode.json", "permissions", "tier1", "git safety", "npm publish", "db reset", "secrets"]
8
- files: [".opencode/opencode.json"]
9
- ---
10
-
11
- # 🎯 Implement Tier 1 permission upgrades
12
-
13
- 🟢 **Confidence:** high
14
-
15
- User requested implementing best-practice Tier 1 permission upgrades in .opencode/opencode.json (git safety, npm publish guard, db reset guard, extra secret patterns). Proceed with bead creation and updates before edits.
@@ -1,40 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T14:09:52.652Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["opencode.json", "instructions", "context-injection", "tech-stack"]
8
- files: ["opencode.json", ".opencode/memory/user.md", ".opencode/memory/project/tech-stack.md"]
9
- ---
10
-
11
- # 🎯 Instructions[] config: Explicit paths, not wildcards
12
-
13
- 🟢 **Confidence:** high
14
-
15
- ## Final Instructions Configuration
16
-
17
- Updated `opencode.json` instructions to be explicit rather than using wildcards:
18
-
19
- ```json
20
- "instructions": [
21
- ".opencode/memory/user.md",
22
- ".opencode/memory/project/tech-stack.md"
23
- ]
24
- ```
25
-
26
- ## Rationale
27
-
28
- 1. **Explicit over implicit** - Wildcards (`*.md`) would pick up any future files, explicit paths are clearer
29
- 2. **Single file approach** - Only tech-stack.md exists in project/ now
30
- 3. **AI learns organically** - Observations are captured via `observation` tool, searched via `memory-search`
31
- 4. **Observations NOT auto-injected** - Would bloat context; they're searchable instead
32
-
33
- ## Full Context Injection Chain
34
-
35
- | File | Purpose | Injection |
36
- | --------------------------------------- | -------------------------- | --------- |
37
- | `.opencode/memory/user.md` | User preferences | Auto |
38
- | `.opencode/memory/project/tech-stack.md`| Tech stack & constraints | Auto |
39
- | `.opencode/memory/observations/*.md` | AI learnings | Searchable|
40
- | `.beads/artifacts/<id>/*` | Bead-specific context | Manual |
@@ -1,42 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T14:02:05.967Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["context-injection", "memory", "project-config", "tech-stack", "opencode"]
8
- files: [".opencode/context/project.md", ".opencode/memory/project/tech-stack.md", "opencode.json", ".opencode/memory/_templates/README.md", "dist/template/.opencode/memory/project/tech-stack.md"]
9
- ---
10
-
11
- # 🎯 Merged context/ into memory/project/ - Single Source of Truth
12
-
13
- 🟢 **Confidence:** high
14
-
15
- ## Decision
16
-
17
- Merged `.opencode/context/project.md` into `.opencode/memory/project/tech-stack.md` to avoid duplication.
18
-
19
- ## Rationale
20
-
21
- - **Before**: Two places for project context (context/project.md + memory/project/*.md)
22
- - **After**: Single location (memory/project/*.md) with tech-stack.md as the new summary file
23
- - **Why**: Instructions[] already loads memory/project/*.md, so tech-stack.md gets auto-injected
24
-
25
- ## Structure After Change
26
-
27
- ```
28
- .opencode/memory/project/
29
- ├── tech-stack.md [NEW] - Framework, DB, styling, constraints (auto-injected)
30
- ├── architecture.md - Modules, directory structure, data flow
31
- ├── commands.md - Build, test, lint, deploy commands
32
- ├── conventions.md - Code style, naming, commit messages
33
- └── gotchas.md - Known issues, edge cases, troubleshooting
34
- ```
35
-
36
- ## Files Changed
37
-
38
- - Created: `.opencode/memory/project/tech-stack.md`
39
- - Deleted: `.opencode/context/` folder
40
- - Updated: `opencode.json` instructions[] (reverted to original)
41
- - Updated: `.opencode/memory/_templates/README.md`
42
- - Updated: `dist/template/.opencode/memory/project/tech-stack.md`
@@ -1,14 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T10:51:20.528Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["oracle tool", "review agent", "opencode CLI", "Task tool", "proxypal replacement"]
8
- ---
9
-
10
- # 🎯 Oracle tool should use review agent (not ProxyPal)
11
-
12
- 🟢 **Confidence:** high
13
-
14
- User wants the oracle tool to be replaced so it calls the OpenCode review agent instead of ProxyPal. They initially mentioned CLI opencode run and later asked for Task tool usage; need clarification because Task tool isn’t available inside oracle tool runtime.
@@ -1,31 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T16:08:24.231Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["skills", "auto-loading", "plan-agent", "context", "prd", "brainstorming", "writing-plans", "swarm-coordination"]
8
- ---
9
-
10
- # 🎯 Plan agent auto-loads skills contextually
11
-
12
- 🟢 **Confidence:** high
13
-
14
- Plan agent now loads skills based on context, NOT all at once:
15
-
16
- **Always load:**
17
- - beads (task tracking)
18
- - brainstorming (refine ideas before implementation)
19
-
20
- **Conditional loading:**
21
- - prd: for feature/epic tasks needing PRD creation
22
- - writing-plans: for detailed implementation plans (features, refactors, migrations)
23
- - swarm-coordination: for multi-phase work (3+ phases)
24
- - deep-research: for research-heavy tasks
25
- - frontend-design: for UI/UX planning (guidelines only)
26
-
27
- **Key differences from build agent:**
28
- - Plan agent loads `brainstorming` (not verification-before-completion) as core
29
- - Plan agent loads `prd` and `writing-plans` for planning artifacts
30
- - Plan agent loads `swarm-coordination` for multi-phase orchestration
31
- - Build agent loads execution-focused skills (debugging, TDD, code review)
@@ -1,14 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T10:58:28.385Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["oracle tool", "review agent", "opencode commands", "implement", "finish", "new command"]
8
- ---
9
-
10
- # 🎯 Plan phased oracle + command merge into new command
11
-
12
- 🟢 **Confidence:** high
13
-
14
- User wants phased changes: update oracle tool to use review agent, then combine implement+finish into a new command (name TBD).
@@ -1,23 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T15:59:37.640Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["prd", "prd-task", "skills", "templates", "beads", "artifacts"]
8
- files: [".opencode/memory/_templates/prd.md"]
9
- ---
10
-
11
- # 🎯 PRD workflow uses prd and prd-task skills
12
-
13
- 🟢 **Confidence:** high
14
-
15
- When working with PRDs in /start command:
16
- 1. Load `prd` skill when creating new PRDs (defines WHAT to build)
17
- 2. Load `prd-task` skill when converting PRD to executable tasks
18
- 3. PRD files go to `.beads/artifacts/<bead-id>/prd.md`
19
- 4. Task JSON goes to `.beads/artifacts/<bead-id>/prd.json`
20
- 5. Progress tracking in `.beads/artifacts/<bead-id>/progress.txt`
21
-
22
- The template at `.opencode/memory/_templates/prd.md` is for reference only.
23
- Skills handle the actual workflow.
@@ -1,14 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T10:38:32.958Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["oracle tool", "review agent", "opencode cli", "proxypal replacement"]
8
- ---
9
-
10
- # 🎯 Prefer review agent via OpenCode CLI over ProxyPal oracle
11
-
12
- 🟢 **Confidence:** high
13
-
14
- User wants to replace the ProxyPal-backed oracle tool with invoking the OpenCode CLI review agent (per opencode CLI docs) instead of using ProxyPal.
@@ -1,14 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T11:06:11.110Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["oracle tool removal", "/ship command", "implement finish merge", "review agent", "Task tool"]
8
- ---
9
-
10
- # 🎯 Remove oracle tool; add /ship command with review after tests
11
-
12
- 🟢 **Confidence:** high
13
-
14
- User wants best-practice simplification: remove oracle tool entirely, and create a combined command /ship that merges implement+finish and triggers review (via Task subagent) after tests.
@@ -1,14 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T11:18:21.359Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["oracle removal", "ship command", "implement finish merge", "review agent", "Task tool"]
8
- ---
9
-
10
- # 🎯 Remove oracle tool and add /ship command with review after tests
11
-
12
- 🟢 **Confidence:** high
13
-
14
- User wants to remove the oracle tool entirely, delete /implement and /finish commands, and add a new /ship command that combines implement+finish and spawns the review agent via Task after tests.
@@ -1,14 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T11:11:24.824Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["oracle tool removal", "/ship command", "implement finish merge", "review agent", "Task tool"]
8
- ---
9
-
10
- # 🎯 Remove oracle tool and add /ship command
11
-
12
- 🟢 **Confidence:** high
13
-
14
- User wants to remove the oracle tool and replace it with a single /ship command that combines implement+finish and spawns the review agent via Task after tests.
@@ -1,14 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T11:38:24.397Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["AGENTS.md", "skills vs commands", "documentation cleanup"]
8
- ---
9
-
10
- # 🎯 Remove Skills vs Commands section from AGENTS.md
11
-
12
- 🟢 **Confidence:** high
13
-
14
- User requested cleaning up the 'Skills vs Commands' section in project AGENTS.md. Proceed to remove that block.
@@ -1,14 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T11:17:19.834Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["oracle removal", "ship command", "implement finish merge", "review agent", "Task tool"]
8
- ---
9
-
10
- # 🎯 Replace oracle tool with /ship command flow
11
-
12
- 🟢 **Confidence:** high
13
-
14
- User decided to remove the oracle tool and instead use a single /ship command that combines implement+finish and spawns the review agent via Task after tests.
@@ -1,14 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T11:15:30.702Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["oracle removal", "ship command", "implement finish merge", "review agent", "Task tool"]
8
- ---
9
-
10
- # 🎯 Replace oracle with /ship command workflow
11
-
12
- 🟢 **Confidence:** high
13
-
14
- User wants to remove the oracle tool entirely and use a single /ship command that combines implement+finish, spawning the review agent via Task after tests. Also remove /implement and /finish commands.
@@ -1,14 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T10:50:28.823Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["oracle tool", "review agent", "opencode cli", "proxypal replacement"]
8
- ---
9
-
10
- # 🎯 Replace ProxyPal oracle with CLI review agent
11
-
12
- 🟢 **Confidence:** high
13
-
14
- User wants to replace the ProxyPal-backed oracle tool with invoking the OpenCode CLI review agent, using opencode run instead of proxypal.
@@ -1,50 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T14:05:54.668Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["templates", "memory", "project-config", "organic-learning", "observation"]
8
- files: ["tech-stack.md"]
9
- ---
10
-
11
- # 🎯 Simplified dist/template: Only tech-stack.md, AI learns organically
12
-
13
- 🟢 **Confidence:** high
14
-
15
- ## Decision
16
-
17
- Simplified dist/template to only include `tech-stack.md` - removed placeholder files that were just noise.
18
-
19
- ## Before (5 files)
20
- ```
21
- dist/template/.opencode/memory/project/
22
- ├── tech-stack.md - Summary for context injection
23
- ├── architecture.md - Empty placeholder with [...]
24
- ├── commands.md - Generic examples
25
- ├── conventions.md - Generic examples
26
- └── gotchas.md - Empty placeholder with [...]
27
- ```
28
-
29
- ## After (1 file)
30
- ```
31
- dist/template/.opencode/memory/project/
32
- └── tech-stack.md - Summary for context injection
33
- ```
34
-
35
- ## Rationale
36
-
37
- 1. **Empty templates are noise** - Placeholders like `[...]` don't help the AI
38
- 2. **AI can discover organically** - Commands from package.json, conventions from codebase
39
- 3. **Observation tool captures learnings** - Gotchas and patterns saved as they're discovered
40
- 4. **Single file = less maintenance** - One file to fill out when starting a project
41
-
42
- ## Key Insight
43
-
44
- The AI doesn't need pre-filled templates to learn about a project. It:
45
- - Reads package.json to discover commands
46
- - Reads existing code to learn conventions
47
- - Uses `observation` tool to capture gotchas when it hits them
48
- - Builds up knowledge in `.opencode/memory/observations/`
49
-
50
- This is more valuable than static placeholder files.
@@ -1,26 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T15:12:56.167Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["templates", "memory", "tech-stack", "init", "organic-learning", "observation"]
8
- files: ["user.md", "tech-stack.md"]
9
- ---
10
-
11
- # 🎯 Simplified templates: only tech-stack.md
12
-
13
- 🟢 **Confidence:** high
14
-
15
- Removed redundant template files from `.opencode/memory/_templates/project/`:
16
- - ❌ architecture.md (removed)
17
- - ❌ commands.md (removed)
18
- - ❌ conventions.md (removed)
19
- - ❌ gotchas.md (removed)
20
- - ✅ tech-stack.md (kept)
21
-
22
- Updated `/init` command to only create:
23
- - `user.md` - user preferences
24
- - `tech-stack.md` - for AI context injection
25
-
26
- Philosophy: AI discovers commands, architecture, conventions, and gotchas organically from the codebase and saves learnings via the `observation` tool. Static placeholder templates are noise.
@@ -1,29 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T16:04:17.552Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["general", "subagent", "skills", "lean", "minimal", "delegation-packet", "verification"]
8
- ---
9
-
10
- # 🎯 Subagents load minimal skills, stay lean
11
-
12
- 🟢 **Confidence:** high
13
-
14
- General subagent (and other subagents) follow different skill philosophy than build leader:
15
-
16
- **Subagents stay LEAN:**
17
- - NO beads skill (read-only, don't modify state)
18
- - NO swarm-coordination (leader handles swarm)
19
- - NO prd/prd-task (leader responsibility)
20
- - NO brainstorming (execute, don't design)
21
-
22
- **Subagents load MINIMAL:**
23
- - ALWAYS: verification-before-completion
24
- - IF bug fix: systematic-debugging
25
- - IF test task: test-driven-development
26
-
27
- **Trust delegation packets:** If present, follow strictly without loading override skills.
28
-
29
- This keeps subagents fast, focused, and prevents skill bloat.
@@ -1,15 +0,0 @@
1
- ---
2
- type: decision
3
- created: 2026-02-01T09:31:02.379Z
4
- confidence: high
5
- valid_until: null
6
- superseded_by: null
7
- concepts: ["opencode.json", "permissions", "best-practices", "security", "bead-protocol"]
8
- files: [".opencode/opencode.json"]
9
- ---
10
-
11
- # 🎯 User approved permission upgrades in opencode.json
12
-
13
- 🟢 **Confidence:** high
14
-
15
- User asked to implement the recommended best-practice permission upgrades for .opencode/opencode.json (Tier 1 security improvements like tighter git, secret patterns, and publish protections). Proceed only after creating/claiming a bead as per protocol.