clawker: Skill for Claude Code

store-editor

Package contract and editor checklist: internal/storeui/AGENTS.md. This skill holds the full architecture, data flow, test patterns, and gotchas.

Architecture Overview

Store UI is the system for building interactive TUI editors for any storage.Store[T] instance. It has four layers:

Command layer (cmd/settings/edit, cmd/project/edit)
  → Domain adapter (config/storeui/settings, config/storeui/project)
    → Orchestration (internal/storeui)
      → Presentation (internal/tui — FieldBrowserModel, ListEditorModel, TextareaEditorModel)
      → Persistence (internal/storage — Store[T])

Import boundary: storeui does NOT import bubbletea or bubbles. All presentation is delegated to internal/tui via generic types (BrowserField, BrowserConfig, etc.). The edit.go file maps storeui.FieldKind → tui.BrowserFieldKind to keep the abstraction boundary clean.

How to Build a New Store UI

Step 1: Domain Adapter

Create a package under internal/config/storeui/<domain>/ that exports:

// Overrides customizes reflected fields for interactive editing. Takes a
// config.Config only when the override set is config-derived (the project
// adapter needs it; the settings adapter does not).
func Overrides() []storeui.Override

// LayerTargets builds save destinations from the store's own write targets.
func LayerTargets(store *storage.Store[T]) ([]storeui.LayerTarget, error)

// Edit is the convenience entry point wiring overrides + targets.
func Edit(ios *iostreams.IOStreams, store *storage.Store[T]) (storeui.Result, error)

Override patterns:

• Set Hidden: true to remove fields the user shouldn't see (complex nested types like map[string]string, []struct)
• Use prefix-based hiding: hiding path "build.instructions" also hides "build.instructions.env", "build.instructions.root_run", etc.
• Set ReadOnly for fields managed by other systems (e.g., host_proxy.* ports)
• Set Kind + Options for constrained fields (e.g., workspace.default_mode → KindSelect with ["bind", "snapshot"])
• Set Label and Description for human-friendly display text
• Set Order to control sort position within tabs (lower = first)