maintain-cross-platform

# Maintain Cross-Platform Architecture **Purpose:** Comprehensive knowledge of AgentSys's cross-platform infrastructure for release preparation, validation, and maintenance. **Scope:** LOCAL skill for this repository only. Contains specific file locations, transformation rules, and automation patterns for maintaining Claude Code + OpenCode + Codex CLI compatibility. ## Critical Rules 1. **3 platforms MUST work** - Claude Code, OpenCode, Codex CLI. No exceptions. 2. **Validation before every push** - Pre-push hook runs 6 validators automatically. 3. **All version fields must align** - 11 files total (package.json + 10 plugin.json files). 4. **Documentation must be accurate** - Counts, paths, and platform references validated by CI. 5. **Update this skill** - If you find misalignments or automation opportunities, update this file. --- ## Platform Differences (The Complete Matrix) ### Configuration | Aspect | Claude Code | OpenCode | Codex CLI | |--------|-------------|----------|-----------| | **Config format** | JSON | JSON/JSONC | TOML | | **Config location** | `~/.claude/settings.json` | `~/.config/opencode/opencode.json` | `~/.codex/config.toml` | | **State directory** | `.claude/` | `.opencode/` | `.codex/` | | **Command prefix** | `/` | `/` | `$` | | **Project instructions** | `CLAUDE.md` | `AGENTS.md` (reads CLAUDE.md) | `AGENTS.md` | ### Component Locations | Component | Claude Code | OpenCode | Codex CLI | |-----------|-------------|----------|-----------| | ...