# Quick Start

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

## Start a Session

Open a new Pi session in any project directory:

```bash
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

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:

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

## 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?

- Read the [Installation Guide](/pi/getting-started/installation/) for setup options.
- Learn about the [specialist subagents](/core/agents/) and their roles.