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

3.5 KiB

Raw Blame History

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)

{
  "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

{
  "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

{
  "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.

3.5 KiB Raw Blame History