DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

kolezka /

kolezka/claude-agents-def

Topic repository only

Claude Code plugin with role subagents for orchestrated engineering work

★ 0 Stars0 Forks1 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@ad3780ce

agents-def

Claude Code plugin with nine role subagents and an orchestrator skill for orchestrated engineering work.

Agent Model Writes Use for
explorer claude-haiku-5-5 no finding files, symbols, call sites, related tests
codebase-researcher claude-sonnet-5-5 no tracing a subsystem across modules
architect inherit no unresolved boundaries, contracts, migrations
implementer inherit yes a settled, well-scoped change
debugger inherit yes, when authorized wrong behavior with an unclear cause
test-engineer claude-sonnet-5-5 yes focused and regression tests
reviewer inherit no independent review of a named diff
security-reviewer inherit no defensive review of trust boundaries
verifier inherit no checking acceptance criteria after a change

Plugin agents are namespaced, so call them as agents-def:explorer and so on. The model passed to the Agent tool overrides the pinned model.

Run python3 tests/test-models.py to check agent model selectors. The fixture is an approved synthetic subset, not a snapshot of all picker choices.

"Writes: no" is a prompt contract, not a sandbox. Those agents have Bash, and plugin agents cannot carry hooks or permissionMode to enforce it.

orchestrator skill

skills/orchestrator tells the main session to act as coordinator: split the work, hand it to subagents, and keep only decisions and verification in the main context. Run it with /agents-def:orchestrator, or let Claude load it when the task fits its description.

Install

From the kolezka marketplace:

/plugin marketplace add kolezka/marketplace
/plugin install agents-def@kolezka

Or standalone from this repo:

/plugin marketplace add kolezka/claude-agents-def
/plugin install agents-def@agents-def

After installing, remove the old user-level copies from ~/.claude/agents, otherwise each role shows up twice (explorer and agents-def:explorer).

DeepSeek Harness (DSH)

dsh/ is a DSH adapter for the same plugin tree. It imports the published claude-plugin-dsh runtime, pinned to exactly 0.2.1 in dsh/package.json and dsh/bun.lock. The Claude Code install above does not use it.

Install the adapter's dependency first, before you add the plugin to DSH. DSH does not install it for you:

cd dsh && bun install --frozen-lockfile

From the plugin root, bun install --cwd dsh --frozen-lockfile does the same. Then point DSH at dsh/, for example as a file: dependency. To check what the adapter registers, without changing anything:

bun x claude-plugin-dsh@0.2.1 inspect .

Each role, including extras/general-purpose.md, becomes a skill named agents-def-agent-<role>, next to the orchestrator skill. DSH does not enforce the agent definitions: model pins are dropped, and the tool allowlist is only an instruction in the brief, not a permission limit. The Writes: no contract above is a prompt in DSH too.

To move to a newer runtime, change the exact version in dsh/package.json, run bun install in dsh/, and commit both files. Do not run the runtime's sync or scaffold commands on this adapter: as of 0.2.1 they write a vendored claude-compat.js copy, and this adapter imports the package instead.

Run node --test tests/dsh-adapter.test.mjs to check the adapter. It needs bun and network access to the npm registry, copies the plugin to a temp directory, installs from the lockfile there and loads the adapter.

general-purpose

extras/general-purpose.md is not part of the plugin. Its job is to replace the built-in general-purpose agent, and only a user or project agent with that exact name can do that. A plugin copy would be a second agent named agents-def:general-purpose. Link it into ~/.claude/agents instead:

ln -sf "$PWD/extras/general-purpose.md" ~/.claude/agents/general-purpose.md
—/ 5

No ratings yet

Manifest verification required

Commit ad3780ce5e9d

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout