aha-orch v1.1.0

Capability orchestration framework skill package for AI agents.

What is aha-orch

aha-orch is an agent-facing, runtime-neutral framework for the consuming AI agent. It defines how the agent detects available capability surfaces, converges them into a task-lifecycle capability route, uses capabilities with transparency, and re-orchestrates when a capability gap appears.

It is a decision contract, not an operator guide or SOP. The consuming agent applies the framework across native runtime capability, enhancement layers, skills, MCP surfaces, commands, and subagent/worktree collaboration patterns.

Version 1.1.0 makes the primary session the decision maker and final integrator, adds a bounded delegation matrix for search, reading, research, testing, review, and writes, and requires mutually exclusive writer write_sets. Delegation is a default preference for non-trivial separable units, not mandatory fan-out; the shared contract preserves direct-work exceptions and confirmation gates.

Four Skill Packages

Skill	Purpose	Runtime
aha-orch-xx	Runtime-agnostic complete skill	Any
aha-codex-omx	Codex CLI + oh-my-codex (OMX) optimized	Codex with oh-my-codex
aha-opencode-omo	OpenCode + oh-my-openagent (OMO) optimized	OpenCode with oh-my-openagent
aha-claudecode-omc	Claude Code + oh-my-claudecode (OMC) optimized	Claude Code with oh-my-claudecode

Each skill package contains the shared framework document (references/capability-orchestration.md) plus runtime-specific implementation guidance.

Contract Check

Run the dependency-free public-contract check after changing a skill package:

python3 scripts/check_v11_contract.py

It checks synchronized shared references, v1.1.0 metadata, YAML front matter, and required delegation-boundary language. It validates documentation structure, not runtime availability or task-outcome improvement.

Installation

Option 1: skills.sh

# Install all 4 skills
npx skills add its-how/aha-orch

# Or install a specific skill
npx skills add its-how/aha-orch --skill aha-codex-omx
npx skills add its-how/aha-orch --skill aha-opencode-omo
npx skills add its-how/aha-orch --skill aha-orch-xx
npx skills add its-how/aha-orch --skill aha-claudecode-omc

Option 2: ClawHub

clawhub install aha-codex-omx
clawhub install aha-opencode-omo
clawhub install aha-orch-xx
clawhub install aha-claudecode-omc

Option 3: Manual copy

Copy the desired skill directory into your runtime's skills path:

• Codex: copy aha-codex-omx/ to ~/.codex/skills/ or .agents/skills/
• OpenCode: copy aha-opencode-omo/ to ~/.config/opencode/skills/ or .agents/skills/
• Claude Code: copy aha-claudecode-omc/ to ~/.claude/skills/ or .agents/skills/
• Other runtimes: copy aha-orch-xx/ to the appropriate skills path for your runtime

Framework Document

See references/capability-orchestration.md in any skill directory for the full framework.

License

MIT-0. See LICENSE.