Vicinae Extension Authoring

Overview

Follow the repo’s established Vicinae extension patterns for structure, caching, actions, and build workflow. Prefer the same defaults and shortcut semantics used across existing extensions.

Workflow

1. Identify scope and complexity (single command vs multi-module extension).
2. Choose structure from references/extension-template.md.
3. Define manifest + preferences in package.json using the Vicinae schema.
4. Implement data access with React Query persistence using persistQueryClient (see references/cache-patterns.md).
5. Implement ActionPanel ordering and shortcuts (see references/action-ux-standards.md), preferring Keyboard.Shortcut.Common.* values before hardcoded key combos.
6. Add empty/loading/error states and toasts.
7. Run pnpm -C <extension> lint and pnpm -C <extension> build.
8. For dev sessions, run pnpm -C <extension> dev.

Decision points