codenomad-architecture-guide

What problem does it solve?

It reduces time wasted searching through the CodeNomad monorepo by showing exactly where cross-area logic lives and how OpenCode SDK V2 is integrated.

Core Features & Use Cases

• Architecture & package navigation: Maps the monorepo into the six functional areas (UserInterface, ServerBackend, DesktopClient, SpeechAndAudio, BuildAndPackaging, CloudflareDeployment) and links them to key entry points for quick orientation.
• Cross-package dependency tracing: Guides debugging across UI ↔ server boundaries by pointing to conventions, mirrored types, and end-to-end feature traces.
• OpenCode SDK V2 integration patterns: Helps you follow the required SDK usage approach (client lifecycle, worktree-based routing, requestData error handling) and avoid common schema pitfalls.
• Implementation guardrails: Highlights anti-patterns (i18n misuse, SSE handling issues, metadata schema violations for assistant parts) and provides checklist-driven impact validation.

Quick Start

Use the codenomad-architecture-guide skill when you are about to implement a new UI feature that requires server changes, so you can trace the full end-to-end flow, then locate the exact route/store/client integration points before writing code.