Ottonomous 🚌💨

Claude Code skills for every stage of product development: spec writing, task prioritization, testing, code review, and documentation.

Add marketplace

/plugin marketplace add brsbl/ottonomous

Install plugin

/plugin install ottonomous@brsbl-ottonomous

Dependencies

• Claude Code (CLI)
• Node.js 18+
• Git

Philosophy

Subagents for Context Isolation

Use subagents to isolate concerns and prevent context pollution:

• Context isolation: Each subagent gets only what it needs, nothing more. Orchestrator agent delegates to and manages subagent
• Specialization: Different expertise per agent (frontend-developer vs backend-architect, senior-code-reviewer vs architect-reviewer, test-writer, etc)

Skill/Subagent Separation

Skills and subagents have distinct responsibilities:

• Skills define what to hand off (file list, diff command, scope, context) and are instructions for the Orchestrator agent
• Subagents define how to process what's handed off (criteria, detection rules, output format)

This keeps subagents self-contained and reusable while skills orchestrate the workflow.

Swarm Orchestration

Skills coordinate multiple subagents working in parallel using run_in_background: true:

Coordination patterns:

• Fan-out/Fan-in — Spawn N agents, wait for all, synthesize results. Used by /review.
• Batches — Complete batch N before starting N+1 (for dependent work). Used by /review fix.
• Pipeline — Sequential handoff between specialists. Used by /otto.

Scaling: 1-4 items = 1 agent, 5-10 = 2-3 agents, 11+ = 3-5 agents. Group by directory or component type.

Iterative Review for Verification

Every phase has explicit verification:

• Planning: spec → spec review → user approval
• Implementation: code → code review → fix → commit
• Verification criteria: Each step defines "Done when..."
• Prioritized findings: P0-P2 across all skills (P0 = critical, P1 = important, P2 = minor)

Recommended Workflow

/spec                     # define requirements via interview
  │
  ▼
/task                     # break spec into sessions & tasks
  │
  ▼
┌───────────────────┐
│                   │
▼                   │
/next batch         │     # implement sessions of tasks in parallel then stage results
│                   │
▼                   │
/test write staged  │     # generate tests, then lint/typecheck/run all
│                   │
▼                   │
/review staged      │     # multi-agent code review
│                   │
▼                   │
/review fix staged  │     # fix P0-P2 issues
│                   │
▼                   │
commit ─────────────┘     # loop if more sessions/tasks
  │
  ▼
/summary                  # generate semantic overview of changes, opened in browser
  │
  ▼
 PR

Use /clear between steps to reset context.

Skills

Specification & Planning

Implementation

Testing

Scope: staged, branch (default)

Code Review

Scope: staged, branch (default)

Documentation

Scope: staged, branch (default)

Automation

Utilities

For browser or UI automation, use /test browser, /test electron, or the host environment's available browser automation tool directly.

Architecture

.otto/                       # Workflow artifacts (git-ignored)
├── specs/                   # Specification documents (.md)
├── tasks/                   # Sessions and tasks (.json)
├── reviews/                 # Review fix plans (.json)
├── summaries/               # Generated HTML summaries
└── otto/
    └── sessions/            # Otto session state (state.json)

skills/                      # Skill implementations (SKILL.md + support files)
├── spec/
│   └── agents/
│       └── technical-product-manager.md  # Spec validation (completeness, feasibility)
├── task/
│   └── agents/
│       └── principal-engineer.md         # Task decomposition review
├── next/
│   └── agents/                    # Implementation agents
│       ├── frontend-developer.md
│       └── backend-architect.md
├── review/
│   └── agents/                    # Code review agents
│       ├── architect-reviewer.md         # Architectural issues
│       ├── senior-code-reviewer.md       # Implementation issues
│       └── false-positive-validator.md   # Validates and filters review findings
├── test/
│   └── agents/
│       └── test-writer.md         # Test generation
├── summary/
│   └── scripts/md-to-html.js
└── ...

Feedback

Found a bug or have a feature request? Open an issue.

License

MIT