---
name: pa
description: Personal assistant entrypoint for routing and context-aware requests
aliases: [assistant, ask]
invokes: agent:personal-assistant
---

# /pa Command

Personal assistant entrypoint for routing requests and managing context.

## Usage

```
/pa <request>              # Natural language request
/pa -- <request>           # -- ends flag parsing, rest is literal
```

## Flags

### Context Override (Request-Level)

Override context gathering for a single request:

```
/pa --context none -- <request>
/pa --context minimal -- <request>
/pa --context moderate -- <request>
/pa --context comprehensive -- <request>
```

### Session Override (Ephemeral)

Set context level for the current session:

```
/pa --set-context none|minimal|moderate|comprehensive
/pa --clear-context
```

### Persistent Default (Requires Confirmation)

Set default context level permanently:

```
/pa --set-default-context none|minimal|moderate|comprehensive
```

### Memory Management

PA writes directly to general-instructions.json:

```
/pa --remember -- "<instruction>"
/pa --list-mem              # Show active memory items
/pa --list-mem --all        # Include deprecated items
/pa --forget <uuid>         # Mark item as deprecated
```

### Introspection

```
/pa --show-config           # Show current configuration
/pa --help                  # Show this help
```

### Knowledge Base

```
/pa --fact "<description>"          # Add fact (PA determines category)
/pa --fact <cat>.<key>=<value>      # Add structured fact
/pa --list-facts                    # Show all KB contents
/pa --list-facts <category>         # Show specific category
```

## Context Levels

Context precedence (highest to lowest):
1. Request override: `--context <level>`
2. Session override: `session-context.json`
3. Persistent default: `personal-assistant-preferences.json`
4. Hard default: `moderate`

Level definitions (PA interprets flexibly per request type):
- `none` - Skip context gathering
- `minimal` - Light context
- `moderate` - Balanced (default)
- `comprehensive` - Deep context scan

## Routing Behavior

PA routes requests through master-orchestrator:

```
User -> /pa <request>
         |
    Personal Assistant (classify, gather context)
         |
    Master Orchestrator (coordinate, enforce)
         |
    Domain Agent (execute)
         |
    Results bubble up
```

## Coexistence with Direct Commands

Both patterns are valid:
- `/pa deploy my-app` - PA classifies and routes
- `/deploy my-app` - Directly invokes deploy workflow

Direct commands are power-user shortcuts; `/pa` is the conversational interface.

## State Files

| File | Purpose |
|------|---------|
| `state/personal-assistant/session-context.json` | Session context override |
| `state/personal-assistant/general-instructions.json` | User memory |
| `state/personal-assistant-preferences.json` | Persistent preferences |