Quick Start

With @maestria/pi installed, start Pi in your project directory:

pi

Choose the route that fits the task

Delegation adds model work and waiting time. Use When to Use maestria before sending a small task or an expensive, slow model through the full pipeline.

Run a Task

1. Activate a mode with your task:

   fein Add user authentication

   Or set the mode first:

   /fein

   Pi reports that the mode is set. Describe the task in your next message. The mode stays active until you set another or run /mode-clear.

2. Watch the pipeline. The orchestrator decomposes the work, dispatches specialists one at a time, in parallel, or as a chain, and validates each phase before handoff.

3. Run /maestria-status to see the mode, delegated specialists, touched files, and recent handoffs.

Use /sonar for research that must stop before implementation. Use /blitz to skip optional reconnaissance and design when the territory is known, while keeping required validation and review.

Next Steps

• Reference for commands, dispatch, and session behavior
• Specialist Reference for roles and boundaries
• Installation
• Oh My Pi portable integration