tomevault-io Work Session
Orchestrate AI-assisted development with configurable human control, using ohno for task management via MCP.
When NOT to Use
- Planning work — Use
planningto create epics/stories/tasks before starting sessions - Quick one-off tasks — Use
/quickfor simple tasks that don't need the full subagent pipeline - Revising a plan — Use
plan-revisionto modify scope, dependencies, or task hierarchy - Running a spike — Use
spikefor time-boxed investigation before committing to implementation
Key Principles
- Fresh context per task via subagent dispatch (no context degradation)
- Configurable checkpoint control: supervised, semi-auto, auto, or unattended
- Smart worktree isolation by task type (feature/bug → worktree, chore/docs → in-place)
- Hooks handle lifecycle automatically (sync, commit, tests)
- ohno MCP provides session continuity across conversations
Quick Start Checklist
- Initialize ohno:
npx @stevestomp/ohno-cli init - Get session context: MCP
get_session_context() - Get next task: MCP
get_next_task() - Dispatch subagent for implementation
- Review results at checkpoints (based on mode)
Operating Modes
| Mode | Task Complete | Story Complete | Epic Complete |
|---|---|---|---|
| supervised | PAUSE | PAUSE | PAUSE |
| semi-auto | log | PAUSE | PAUSE |
| auto | skip | log | PAUSE |
| unattended | skip | skip | skip |
References
| Reference | Description |
|---|---|
| subagent-dispatch.md | Coordinator vs implementer roles, dispatch mechanics |
| session-protocol.md | Session start/end checklists, MCP workflow |
| checkpoint-types.md | PAUSE, REVIEW, NOTIFY checkpoint patterns |
| skill-routing.md | Task type to skill mapping |
| operating-modes.md | Supervised, semi-auto, auto, unattended details |
| worktree-management.md | Setup, completion, merge/PR workflows |
| parallel-execution.md | Parallel Execution: benefits, tradeoffs, dependency handling |
| hook-integration.md | Work loop with hooks, mode-specific behavior |
| ohno-integration.md | MCP tools and CLI commands reference |
| error-recovery.md | Build failures, blocked tasks |
| anti-patterns.md | Common mistakes and fixes |
| bug-fix-pipeline.md | Agent pipeline for /fix --thorough and /hotfix commands |
| pre-flight-checks.md | Checks run before unattended/headless sessions |
Converted and distributed by TomeVault — claim your Tome and manage your conversions.