engineering-conventions

What problem does it solve?

Unplanned modifications to opencode-swarm's core code often cause silent, hard-to-diagnose production regressions like plugin startup failures, unkillable subprocesses, or CI validation mismatches that do not appear during local testing. This Skill eliminates that risk by loading the full set of mandatory engineering invariants before any work on high-risk code paths begins.

Core Features & Use Cases

• Invariant Summaries: Distills the 12 non-negotiable engineering rules from the repo's AGENTS.md, with explicit focus on the 4 highest-risk invariants that have caused the most recent production regressions.
• Targeted Guidance: Provides deep-dive instructions for high-risk areas including init-path import safety, subprocess execution guardrails, test mock isolation, sandbox environment overrides, skill mirror contract compliance, and tool version parity between local and CI environments.
• Use Case: Any developer working on opencode-swarm's plugin entry point, subprocess utilities, test infrastructure, build configuration, or sandbox execution paths loads this Skill first to ensure all changes comply with mandatory safety and portability rules.

Quick Start

Load the engineering-conventions skill before making any changes to opencode-swarm's core source, plugin initialization, subprocess utilities, test setup, or build configuration to ensure compliance with mandatory engineering invariants and avoid preventable production regressions.