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>
2.8 KiB
2.8 KiB
name, description, aliases, invokes
| name | description | aliases | invokes | ||
|---|---|---|---|---|---|
| pa | Personal assistant entrypoint for routing and context-aware requests |
|
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):
- 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 gatheringminimal- Light contextmoderate- 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 |