Files
claude-code/commands/pa.md
OpenCode Test 431e10b449 Implement programmer agent system and consolidate agent infrastructure
Programmer Agent System:
- Add programmer-orchestrator (Opus) for workflow coordination
- Add code-planner (Sonnet) for design and planning
- Add code-implementer (Sonnet) for writing code
- Add code-reviewer (Sonnet) for quality review
- Add /programmer command and project registration skill
- Add state files for preferences and project context

Agent Infrastructure:
- Add master-orchestrator and linux-sysadmin agents
- Restructure skills to use SKILL.md subdirectory format
- Convert workflows from markdown to YAML format
- Add commands for k8s and sysadmin domains
- Add shared state files (model-policy, autonomy-levels, system-instructions)
- Add PA memory system (decisions, preferences, projects, facts)

Cleanup:
- Remove deprecated markdown skills and workflows
- Remove crontab example (moved to workflows)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-29 13:23:42 -08:00

2.8 KiB

name, description, aliases, invokes
name description aliases invokes
pa 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

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