@elyracode/subagents

Subagent delegation for Elyra -- scout, review, plan, implement, and get second opinions with focused child agents.

Install

elyra install npm:@elyracode/subagents

Agents

| Agent | Use when you want... | |-------|---------------------| | scout | Fast codebase recon: files, structure, data flow, risks | | reviewer | Code review: correctness, tests, edge cases, security, simplicity | | planner | Implementation plan: concrete steps with file paths | | worker | Implementation: edits files, validates, follows the plan | | oracle | Second opinion: challenges assumptions, catches drift | | researcher | External research: docs, specs, recent changes | | delegate | General-purpose child agent for ad-hoc tasks |

Usage

Natural language

Use reviewer to review this diff.
Ask oracle for a second opinion on my plan.
Use scout to understand the auth flow.
Run parallel reviewers: one for correctness, one for tests, one for complexity.
Have worker implement this plan, then run reviewer to check it.

Commands

/run scout analyze the authentication flow
/run reviewer review the changes in the last commit
/run oracle challenge my current approach
/parallel reviewer 'check correctness' -> reviewer 'check tests' -> reviewer 'check complexity'
/build-feature add a wallet system with balance tracking
/ui-review build a registration form with validation
/deep-review the authentication system
/agents

Workflows

| Workflow | Command | Steps | |----------|---------|-------| | Build Feature | /build-feature | scout -> planner -> oracle -> worker -> reviewer -> worker (fix) | | UI Review | /ui-review | worker (build) -> reviewer (screenshot + visual QA) -> worker (fix) -> reviewer (verify) | | Deep Review | /deep-review | reviewer (correctness) -> reviewer (tests) -> reviewer (security) -> oracle (synthesis) | | Git Review | /git-review | review git diff for correctness, security, tests, code debt, design consistency |

Git Integration

Manual review before push

/git-review

Reviews your staged and unstaged changes with a go/no-go verdict.

Automatic pre-push hook

/setup-git-hook

Installs a .git/hooks/pre-push hook that runs Elyra review automatically before every push. If issues are found, the push is blocked. Skip with git push --no-verify.

Recommended workflow

scout -> planner -> worker -> reviewer -> worker (fixes)

How it works

1. You ask for delegation (naturally or via commands)
2. Elyra selects the right agent and gives it focused instructions
3. The agent executes the task with appropriate tool access
4. Read-only agents (scout, reviewer, planner, oracle) cannot edit files
5. Results are brought back for synthesis

Each agent is narrow and focused -- one task, one perspective. This produces better results than asking one agent to do everything.