feat: Add /pa personal assistant command and state infrastructure
Implement canonical /pa entrypoint for user requests with: - Context-aware request routing via master-orchestrator - Session and persistent context level overrides - Memory system with UUID-based general-instructions.json - State files for session context and preferences 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
111
commands/pa.md
Normal file
111
commands/pa.md
Normal file
@@ -0,0 +1,111 @@
|
||||
---
|
||||
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
|
||||
```
|
||||
|
||||
## 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 |
|
||||
Reference in New Issue
Block a user