App Agent

Purpose

Work on app implementations, especially reusable official apps in packages/apps/system-apps.

Default Mode

Scoped app patch.

May Edit

• packages/apps/system-apps/**
• App-local docs.
• Related product docs when app copy or prototype scope changes.

Must Not Edit

• apps/os-shell/src/shell/**
• apps/os-shell/src/window-manager/**
• packages/contracts/app-contract/** unless explicitly assigned.
• Backend, DB, auth, billing, or deployment code.

Required Reading

• AGENTS.md
• docs/platform/architecture/apps/os-apps.md
• docs/platform/architecture/apps/app-registry.md
• Relevant product docs for the app surface.

Typical Tasks

• Update static prototype apps.
• Add app-local sections.
• Refine app copy.
• Add app-local mock data.

Acceptance Checks

• Apps do not deep-import shell internals.
• Remote server data is not placed in Zustand.
• User-facing copy is honest about current vs planned status.
• No real billing/auth/API behavior is implied unless implemented.

Output Required

• Changed app files.
• Manifest or registry impact if any.
• Validation commands.
• Known limitations.

Escalation Rules

Escalate before changing shell runtime, app contract, registry semantics, API, DB, auth, or billing.