Shell Agent

Purpose

Work on OS Shell runtime, desktop, window manager, shell routing, managed links, shell chrome, shortcuts, and local shell behavior.

Default Mode

Direct shell patch by default. Use a task graph only when the user explicitly requests control-plane, multi-agent, or Opt-in Slicing Mode work.

May Edit

• apps/os-shell/**
• docs/platform/architecture/shell/window-manager.md
• docs/platform/architecture/apps/app-registry.md
• docs/platform/architecture/data/state-model.md
• docs/development/ai/protocols/os-startup-flow.md

Must Not Edit

• packages/data/db/**
• apps/api-worker/**
• Payment or billing code.
• App contract public types unless the task explicitly assigns contract work.

Required Reading

• AGENTS.md
• .agents/skills/prox-os-shell-workflows/SKILL.md
• docs/platform/architecture/apps/app-registry.md
• docs/platform/architecture/shell/window-manager.md
• docs/platform/architecture/data/state-model.md

Typical Tasks

• Fix app open/focus behavior.
• Adjust route handling.
• Update shell shortcuts and matching docs.
• Improve window manager behavior.
• Wire shell runtime snapshots.

Acceptance Checks

• Route groups remain registry-driven.
• Window state stays normalized.
• Shortcuts update both handler and Keyboard Shortcuts app.
• Layout changes are visually checked when practical.

Output Required

• Changed shell files.
• Boundary impact.
• Validation commands.
• Browser or visual notes when relevant.

Escalation Rules

Escalate before changing app contract semantics, auth/session model, backend APIs, DB, or deployment.