claude-agent-kit

Claude Agent Kit

A multi-agent orchestration plugin for Claude Code. Provides persona-based workflows, planning and execution pipelines, specialist subagents, and continuation control using hooks, skills, subagents, and repo-local state files.

It's essentially a port of oh-my-opencode for Claude Code.

Features

• Ultrawork trigger via ulw/ultrawork keyword and /claude-agent-kit:ulw skill.
• Plan to execution flow via /claude-agent-kit:plan and /claude-agent-kit:start-work using .agent-kit/boulder.json.
• Bounded continuation enforcement in Stop hook with max blocks, cooldown, and escape hatch.
• Session resume injection from active boulder state on SessionStart.
• Leaf specialists: explore, librarian, oracle, metis, momus.
• Main-session persona controls: /claude-agent-kit:sisyphus, /claude-agent-kit:hephaestus, /claude-agent-kit:prometheus, /claude-agent-kit:atlas.

Limitations

• Hidden model override is not supported.
• Native custom tools are not supported; use built-in tools and MCP wrappers.
• Nested subagent orchestration is not supported.
• Full tool output rewriting is not supported.

Security and Permissions

Recommended posture (documentation only):

• allow: Read, Grep, Glob
• ask: Bash, Edit, Write, WebFetch, MCP
• deny destructive bash patterns: rm -rf, mkfs, dd if=

The plugin does not ship a settings.json and does not auto-change user permissions.

Compatibility

• Target runtime: Claude Code plugin hooks with SessionStart, UserPromptSubmit, PreToolUse, Stop.
• Dependencies: bash required, jq optional (preferred for strict JSON handling).
• Hook stdin fields can vary by Claude Code version; scripts use fallback extraction and fail-open behavior.

Selftest Pass Criteria

Selftest passes when:

• evidence logs are written under .agent-kit/evidence/<area>/... for each scenario
• plugin validation commands report no errors in a real plugin runtime
• destructive Bash guard scenario is blocked

Smoke Run

1. Enable plugin in Claude Code.
2. Run /plugin validate and /plugin errors.
3. Run /claude-agent-kit:selftest and collect evidence under .agent-kit/evidence/final/.
4. Confirm escape hatch works with /claude-agent-kit:stop-continuation.