Skip to content

AGENTS.md

Latest commit

 

History

History
15 lines (11 loc) · 935 Bytes

AGENTS.md

File metadata and controls

15 lines (11 loc) · 935 Bytes
Raw

AGENTS.md

Go Project Layout

  • The repository MUST stay a single Go module rooted at the repository top level.
  • Each utility MUST be implemented as a separate command under cmd/<tool-name>.
  • Shared code MAY be extracted only into small, domain-specific packages under internal/.
  • Catch-all packages such as util, common, or misc are FORBIDDEN.
  • INSTEAD: keep code local to the command until real reuse appears, then extract focused packages such as rollout, codexstate, appserver, manifest, or atomicfile.

TUI Framework

  • Interactive terminal interfaces in this repository MUST use github.com/charmbracelet/bubbletea as the UI framework.
  • Primary UI implementations based on other Go TUI frameworks are FORBIDDEN.
  • INSTEAD: build interactive terminal UIs on top of Bubble Tea and add companion Charm libraries only when the command needs them, such as bubbles, lipgloss, glamour, or huh.