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:
OpenCode Test
2025-12-28 19:59:58 -08:00
parent 73512e92a6
commit fa049a1374
7 changed files with 651 additions and 0 deletions

111
commands/pa.md Normal file
View 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 |