Engineering Conventions

SkillDev tools

Codex adapter for opencode-swarm engineering invariants. Use before modifying plugin initialization, subprocesses, runtime portability, .swarm containment, plan durability, test_runner behavior, test-writing patterns, session/global state, guardrails/retry semantics, chat/system hooks, tool registration, release/cache hygiene, or related architecture.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Engineering Conventions skill

What this skill tells your AI

The instructions your AI receives, as published by zaxbyhub/opencode-swarm in .agents/skills/engineering-conventions/SKILL.md and read by ahel’s review.

Use this adapter before any change that can touch a repository invariant.

Read, in order:

  1. AGENTS.md
  2. docs/engineering-invariants.md
  3. .opencode/skills/engineering-conventions/SKILL.md

If editing agent prompt strings or escaped template text, pay attention to the "Agent prompt strings — escaping pitfalls" section, which is now carried in both the .opencode summary (item 3 above) and .claude/skills/engineering-conventions/SKILL.md.

Codex-specific execution notes:

  • Use apply_patch for manual edits.
  • Use the available shell execution tool for rg, git, build, smoke, and test commands.
  • Use the runtime's parallel-execution capability for independent file reads and searches.
  • Keep changes scoped and produce concrete invariant evidence for every touched invariant.

The source of truth is always AGENTS.md. If an imported skill conflicts with it, AGENTS.md wins.

Signals

GitHub stars
467
Forks
51
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
engineering-conventions
Source
github.com/zaxbyhub/opencode-swarm