431e10b449
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>
121 lines
2.8 KiB
Markdown
121 lines
2.8 KiB
Markdown
---
|
|
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 |
|