Skip to content
Maestria

Quick Start

Now that you have @maestria/pi installed, here’s how to start your first session.

Start a Session

Section titled “Start a Session”

Open a new Pi session in any project directory:

Terminal window
pi

Once the session starts, the @maestria/pi extension activates automatically and Pi’s resource loader injects its methodology skills into the system prompt.

Pick a Workflow Mode

Section titled “Pick a Workflow Mode”

The extension provides three workflow mode commands. Use them to tell the agent how to handle your request:

  • /fein - Full pipeline: reconnaissance → design → implementation → review. Use for production-grade changes.
  • /sonar - Research only: reconnaissance → design → STOP. No implementation. Use for discovery and feasibility.
  • /blitz - Fast implementation: skip recon and review. Use for quick fixes in known territory.

You can invoke a mode with or without a task description:

Terminal window
/fein Add user authentication
# or
/fein
Mode set to fein. Describe what you'd like to work on.

Your First Task

Section titled “Your First Task”

Try @maestria/pi with a simple request:

  1. Start a Pi session.
  2. Type /fein followed by your task.
  3. The extension activates the spec-driven orchestration pipeline:
    • The orchestrator receives your request and breaks it into phases.
    • Specialists (@adventurer, @architect, @builder, @reviewer) execute each phase.
    • Phase gates validate completion before the next stage begins.
  4. Review the session tree output to see how each specialist contributed.

What’s Next?

Section titled “What’s Next?”