docs initial

.opencode/merged-instructions.md

@@ -0,0 +1,31 @@
+# OpenCode Merge Rules
+
+This file defines how OpenCode should combine the Coffee Project's Codex-era and Claude-era guidance.
+
+## Precedence
+
+1. `AGENTS.md` is the primary workflow, editing, and delegation policy.
+2. `.codex/agent-team.md` and `.codex/agent-skills.md` define team topology, role boundaries, and skill selection.
+3. `CLAUDE.md` and service-level `CLAUDE.md` files are supporting context for architecture, commands, conventions, and service gotchas only.
+
+## Migration Rules
+
+- Do not read from or rely on the `.claude/` directory.
+- Ignore stale `CLAUDE.md` text that points to `.claude/*` or assumes the assistant is literally Claude Code.
+- If a service-level `AGENTS.md` is missing or intentionally thin, fall back to the root `AGENTS.md` plus that service's `CLAUDE.md`.
+- `remotion_service/AGENTS.md` previously pointed to a missing `.codex/services/remotion.md` file. Treat `remotion_service/CLAUDE.md` as the active service guide until a dedicated Codex service guide exists.
+
+## Working Mode
+
+- Keep the repo's team-first behavior for non-trivial tasks.
+- Use the minimum viable delegation rather than mandatory full handoff.
+- Purely mechanical or clearly bounded tasks may be handled directly.
+- Keep user-facing UI text in Russian.
+
+## MCP Ownership
+
+- The repo-local `opencode.jsonc` file is the primary OpenCode MCP roster for this workspace.
+- Shared MCP binaries may live under `~/.config/opencode/vendor/`, but this repo should enable only the servers it actually wants to use.
+- Do not infer repo MCPs from `~/.claude.json`.
+- Prefer `context7` for library and framework documentation.
+- Use `web-search` for broader web research when docs or local source inspection are not enough.