tui.md

 1# TUIs
 2
 3This file captures Amolith-specific TUI setup choices only. Load `golang-tui`
 4after this file for Bubble Tea, Lip Gloss, Bubbles, Elm Architecture, layout,
 5keymap, terminal-compatibility, testing, and performance details.
 6
 7TUIs are still command-line binaries. Read `cli.md` alongside this file for
 8Cobra/Fang setup, command ergonomics, completions, and version-policy guidance.
 9
10## Amolith-specific deltas
11
12- Use the Charm v2 stack through `golang-tui` unless the project has already
13  made a different good choice.
14- Do not copy Taskfile examples from `golang-tui`; translate useful commands
15  into `mise.toml` and keep the baseline tasks from `mise.md`.
16- Keep the CLI surface consistent with `cli.md`: stdlib for tiny tools,
17  Cobra/Fang for user-facing commands, and one project-owned version policy when
18  exact versions matter.
19- Use the regular race-enabled Go test task from `mise.md`. Add snapshot/golden
20  update tasks only when the project actually has snapshot tests.
21- Terminal apps should use the same pure-Go static release-build shape as CLIs
22  when their dependencies allow it. Drop static-only flags for terminal
23  integrations that require CGO or native libraries.
24
25If `golang-tui` and this skill conflict, keep `golang-tui` for library/API
26details and keep this skill for Amolith-specific tooling, task-runner,
27packaging, CLI, and release-build policy.