sk-code-opencode

opencode Surface — System-Code Evidence

Domain evidence and shared workflow doctrine for OpenCode system code (the .opencode/ tree: skills, agents, commands, plugins, MCP servers, config, changelogs, and runtime bridge wiring). This surface owns the implement -> debug -> verify phases through the workflow references below, then slices evidence by the detected language so a TypeScript task never pulls the Python/shell/config guides.

Detection is two-step. First, the surface trigger is work under .opencode/ (including SKILL.md, descriptors, commands, agents, plugins, MCP servers, assets, scripts, and changelogs). Second, once the OpenCode surface is selected, file extensions and local markers select the language trio: .cjs/.mjs/.js -> JavaScript, .ts/.tsx/.mts/.d.ts -> TypeScript, .py plus argparse -> Python, .sh/.bash -> shell, .rs -> Rust, .json/.jsonc/.yaml/.yml plus graph-metadata or spec-folder -> config. For Rust, when no .rs file is present, local Cargo.toml/Cargo.lock markers select it after the OpenCode surface is established; napi-rs and wasm-bindgen vocabulary are additional intent signals, not cross-project surface detectors.

1. WHEN THE HUB BUNDLES THIS

• The task touches .opencode/ system code — a skill, agent, command, plugin, MCP server, or descriptor/config.
• The active workflow phase needs a language standard, a language-agnostic organization pattern, a hook contract, an alignment-verification procedure, or an authoring checklist.
• This surface owns edits, tests, and verification through the workflow references; hand off formal findings-first review to code-review and author-side quality gates to code-quality.

2. REFERENCE MAP

Language standards — after .opencode/ selects this surface, load the exact split resources for the detected language:

• TypeScript — references/typescript/style-guide/overview-strict-and-naming.md, references/typescript/style-guide/formatting-imports-and-coexistence.md, references/typescript/quality-standards/overview-and-type-system.md, references/typescript/quality-standards/tsdoc-errors-and-async.md, references/typescript/quality-standards/tsconfig-and-modules.md, references/typescript/quick-reference/template-naming-and-types.md, references/typescript/quick-reference/imports-errors-and-tsconfig.md
• Python — references/python/style-guide.md, references/python/quality-standards.md, references/python/quick-reference.md
• Shell — references/shell/style-guide/overview-structure-and-naming.md, references/shell/style-guide/variables-functions-and-output.md, references/shell/quality-standards/overview-and-priority-blockers.md, references/shell/quality-standards/validation-security-and-shellcheck.md, references/shell/quick-reference/template-variables-and-loops.md, references/shell/quick-reference/functions-strings-and-checklist.md
• Rust — references/rust/style-guide/overview-and-file-header.md, references/rust/style-guide/toolchain-and-project-structure.md, references/rust/style-guide/naming-conventions.md, references/rust/style-guide/formatting-and-imports.md, references/rust/style-guide/commenting-and-rustdoc.md, references/rust/style-guide/interop-model.md, references/rust/style-guide/interop-errors-and-parity.md, references/rust/quality-standards/overview-and-data-ownership.md, references/rust/quality-standards/modeling-collections-and-api.md, references/rust/quality-standards/docs-errors-and-async.md, references/rust/quality-standards/build-and-organization.md, references/rust/quality-standards/determinism-and-parity.md, references/rust/quick-reference/overview-and-boundary-template.md, references/rust/quick-reference/naming-ordering-and-signatures.md, references/rust/quick-reference/collections-imports-and-errors.md, references/rust/quick-reference/rustdoc-and-cargo.md, references/rust/quick-reference/determinism-parity-and-related.md
• Config (JSON/JSONC/YAML descriptors and route assets) — references/config/style-guide.md, references/config/quality-standards.md, references/config/quick-reference.md, assets/checklists/config-checklist.md
• JavaScript (CommonJS/ESM plugins) — references/javascript/style-guide.md, references/javascript/quality-standards/overview-modules-and-docs.md, references/javascript/quality-standards/security-testing-and-exemptions.md, references/javascript/quick-reference.md