john/claude-engineering-plugin
1
0
Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity

docs: ADR 0001-0003 — OpenCode commands, config merge, permissions default

Browse Source 
Why: Architectural decisions recorded during planning phase.
See docs/plans/feature_opencode-commands_as_md_and_config_merge.md for full context.
This commit is contained in:
Adrian
2026-02-20 13:13:36 -05:00
parent 174cd4cff4
commit d83c1a29c3
4 changed files with 66 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/decisions/0001-opencode-command-output-format.md Normal file
View File

@@ -0,0 +1,21 @@
# ADR 0001: OpenCode commands written as .md files, not in opencode.json
## Status
Accepted
## Date
2026-02-20
## Context
OpenCode supports two equivalent formats for custom commands. Writing to opencode.json requires overwriting or merging the user's config file. Writing .md files is additive and non-destructive.
## Decision
The OpenCode target always emits commands as individual .md files in the commands/ subdirectory. The command key is never written to opencode.json by this tool.
## Consequences
- Positive: Installs are non-destructive. Commands are visible as individual files, easy to inspect. Consistent with agents/skills handling.
- Negative: Users inspecting opencode.json won't see plugin commands; they must look in commands/.
- Neutral: Requires OpenCode >= the version with command file support (confirmed stable).
## Plan Reference
Originated from: docs/plans/feature_opencode-commands_as_md_and_config_merge.md