What problem does it solve?
maestro-dev turns adding new maestroCLI capabilities from an unclear, error-prone effort into a reliable workflow with consistent architecture, wiring, and testing conventions.
Core Features & Use Cases
- Hexagonal architecture guidance: Keeps changes aligned across CLI commands, MCP server tools, use-cases, ports, and adapters using a fixed execution order.
- Port-first development: Defines or extends TypeScript port interfaces to describe required inputs/outputs while staying framework-agnostic.
- Adapter + use-case implementation: Implements adapters against concrete backends and moves business logic into pure use-cases for testability.
- Command and MCP tool wiring: Adds thin CLI/MCP surfaces that delegate to shared use-case logic and return consistent results.
- Error handling and state safety: Standardizes actionable MaestroError hints and explicit state transition validation to prevent invalid operations.
- Test and verification workflow: Establishes unit and integration test placement and mandates build/test verification before proceeding.
Quick Start
Use maestro-dev when implementing a new maestro feature, and follow the sequence: define the needed port, implement the adapter, wire a use-case, add the CLI command and MCP tool, then create focused tests and run build and tests.
