Files

OpenCode Test fa049a1374 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>

2025-12-28 19:59:58 -08:00

2.6 KiB

Raw Blame History

name, description, aliases, invokes

name

description

aliases

invokes

Personal assistant entrypoint for routing and context-aware requests

assistant

ask

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):

Request override: --context <level>
Session override: session-context.json
Persistent default: personal-assistant-preferences.json
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

2.6 KiB Raw Blame History