Project planning, wave execution, VCS integration, quality gates. Replaces manual session prompts with /plan, /session, /go, /close
Installation
Install directly from the Claude Code plugin marketplace.
götzendorfer.at# Add as a Claude Code plugin
claude plugin add github:Kanevry/session-orchestratorFeatures
Work flows through 5 typed waves: Discovery, Core Implementation, Polish & Integration, Quality & Testing, Finalization. Each wave has a defined purpose and agent count that scales by session type.
A dedicated session-reviewer agent checks implementation correctness, test coverage, TypeScript health, and OWASP security basics between waves.
Auto-detects GitLab or GitHub from your git remote. Full lifecycle support: issue management, MR/PR tracking, pipeline/workflow status, label taxonomy.
When configured with a Pencil design file, the wave executor screenshots design frames and compares them with the actual implementation.
Checks configured service endpoints and scans cross-repo critical issues at session start. Know your ecosystem state before you start working.
/close verifies every planned item with evidence, runs a full quality gate, creates carryover issues for unfinished work, commits cleanly.
Sessions survive context resets via STATE.md and session memory files. Resume exactly where you left off with full plan and progress tracking.
Built-in maxTurns limits and spiral detection prevent runaway agent loops. Automatic intervention when execution patterns indicate trouble.
Confidence-based intelligence system learns from historical session data (sessions.jsonl). Past outcomes inform future wave sizing and agent allocation.
Complexity scoring dynamically adjusts agent count and wave structure. More resources for complex tasks, leaner execution for simple ones.
Modular quality probes adapted to your tech stack. Finds issues across typecheck, tests, lint, security, and architecture before they reach production.
PreToolUse hooks enforce scope boundaries and command validation. Agents stay within their assigned scope — no unauthorized file access or command execution.
/plan new|feature|retro — full PRD generation with researched Q&A, repo scaffolding for new projects, compact feature specs, and data-driven retrospectives.
Commands
| Command | Purpose |
|---|---|
/session [type] | Start session (housekeeping, feature, deep) |
/go | Approve plan, begin wave execution |
/close | End session with verification |
/discovery [scope] | Run systematic quality probes |
/plan [new|feature|retro] | Structured planning, PRD generation, retrospectives |
Session Types
Git cleanup, SSOT refresh, CI checks, branch merges
1-2 agents, serial
Frontend/backend feature work
4-6 agents per wave
Complex backend, security, DB, refactoring
Up to 10-18 agents per wave
What's Inside
9
Skills
session-start, session-plan, wave-executor, session-end, ecosystem-health, gitlab-ops, quality-gates, discovery, plan
5
Commands
/session, /go, /close, /discovery, /plan
1
Agent
session-reviewer (inter-wave quality gate)
2
Hooks
scope enforcement, command validation