john/claude-engineering-plugin
1
0
Fork 0
Code Issues Pull Requests Actions 2 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/0003-opencode-permissions-default-none.md Normal file
View File

@@ -0,0 +1,21 @@
# ADR 0003: Global permissions not written to opencode.json by default
## Status
Accepted
## Date
2026-02-20
## Context
Claude commands carry allowedTools as per-command restrictions. OpenCode has no per-command permission mechanism. Writing per-command restrictions as global permissions is semantically incorrect and pollutes the user's global config.
## Decision
--permissions defaults to "none". The plugin never writes permission or tools to opencode.json unless the user explicitly passes --permissions broad or --permissions from-command.
## Consequences
- Positive: User's global OpenCode permissions are never silently modified.
- Negative: Users who relied on auto-set permissions must now pass the flag explicitly.
- Neutral: The "broad" and "from-command" modes still work as documented for opt-in use.
## Plan Reference
Originated from: docs/plans/feature_opencode-commands_as_md_and_config_merge.md