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>

docs/state-schemas.md

@@ -0,0 +1,135 @@
+# State File Schemas
+
+This document defines the JSON schemas for all state files in `~/.claude/state/`.
+
+## Personal Assistant State
+
+### session-context.json
+
+Path: `~/.claude/state/personal-assistant/session-context.json`
+Writer: user/CLI
+Purpose: Session-level context override (ephemeral)
+
+```json
+{
+  "version": "1.0",
+  "current_context_level": "minimal" | "moderate" | "comprehensive" | "none" | null,
+  "set_at": "ISO8601 timestamp" | null,
+  "set_by": "user" | null
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `version` | string | Schema version |
+| `current_context_level` | string\|null | Active context level, null if unset |
+| `set_at` | string\|null | When the override was set |
+| `set_by` | string\|null | Who set it (always "user") |
+
+### general-instructions.json
+
+Path: `~/.claude/state/personal-assistant/general-instructions.json`
+Writer: personal-assistant
+Purpose: User memory/instructions optimized for agent consumption
+
+```json
+{
+  "version": "1.0",
+  "description": "User instructions optimized for agent consumption",
+  "items": [
+    {
+      "id": "uuid",
+      "text": "Instruction text",
+      "scope": "global",
+      "tags": ["tag1", "tag2"],
+      "created": "ISO8601 timestamp",
+      "status": "active" | "deprecated"
+    }
+  ]
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `version` | string | Schema version |
+| `description` | string | File description |
+| `items` | array | List of instruction items |
+| `items[].id` | string | UUID for the item |
+| `items[].text` | string | The instruction text |
+| `items[].scope` | string | Scope of instruction (e.g., "global") |
+| `items[].tags` | array | Optional categorization tags |
+| `items[].created` | string | ISO8601 creation timestamp |
+| `items[].status` | string | "active" or "deprecated" (soft delete) |
+
+Notes:
+- Items are append-only; use `status: "deprecated"` for soft delete
+- PA generates UUIDs for new items
+- Never remove items from the array
+
+### personal-assistant-preferences.json
+
+Path: `~/.claude/state/personal-assistant-preferences.json`
+Writer: master-orchestrator
+Purpose: Persistent PA configuration
+
+```json
+{
+  "version": "1.0",
+  "description": "Persistent PA configuration",
+  "context_gathering": {
+    "default_level": "moderate"
+  }
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `version` | string | Schema version |
+| `description` | string | File description |
+| `context_gathering.default_level` | string | Default context level |
+
+Valid context levels: `none`, `minimal`, `moderate`, `comprehensive`
+
+## System State
+
+### system-instructions.json
+
+Path: `~/.claude/state/system-instructions.json`
+Writer: master-orchestrator
+Purpose: Central process definitions
+
+See `system-instructions.json` for current schema.
+
+### future-considerations.json
+
+Path: `~/.claude/state/future-considerations.json`
+Writer: master-orchestrator
+Purpose: Deferred features and decisions
+
+See `future-considerations.json` for current schema.
+
+### model-policy.json
+
+Path: `~/.claude/state/model-policy.json`
+Writer: master-orchestrator
+Purpose: Model selection rules
+
+See `model-policy.json` for current schema.
+
+### autonomy-levels.json
+
+Path: `~/.claude/state/autonomy-levels.json`
+Writer: master-orchestrator
+Purpose: Autonomy level definitions
+
+See `autonomy-levels.json` for current schema.
+
+## Sysadmin State
+
+### session-autonomy.json
+
+Path: `~/.claude/state/sysadmin/session-autonomy.json`
+Writer: user/CLI
+Purpose: Per-session autonomy overrides
+
+See `session-autonomy.json` for current schema.