Files
claude-engineering-plugin/docs/decisions/0003-opencode-permissions-default-none.md
Adrian d83c1a29c3 docs: ADR 0001-0003 — OpenCode commands, config merge, permissions default
Why: Architectural decisions recorded during planning phase.
See docs/plans/feature_opencode-commands_as_md_and_config_merge.md for full context.
2026-02-20 13:13:36 -05:00

21 lines
918 B
Markdown

# 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