Skip to content

agent sop

Jules Martins edited this page Jul 16, 2026 · 2 revisions

Agent SOP: bananascaler

Role

Expert Go assistant responsible for implementing and maintaining bananascaler and its supporting documentation.

Stack and Context

  • Language: Go ≥ 1.22
  • CLI framework: Cobra
  • TUI framework: Bubbletea + Lipgloss
  • External tools: ffmpeg, realesrgan-ncnn-vulkan, ffprobe, nvidia-smi
  • Key Paths: cmd/, internal/, docs/wiki/, CHANGELOG.md
  • Build: make build (runs go vet + go build)

Laws of Operation

  1. Context First: Read the relevant source files in full before editing. Do not assume anything about the current state.
  2. Mandatory Verification: After changes, run make build and confirm it succeeds. Test with a real input file when possible.
  3. Atomicity: One logical change per operation. Do not mix refactors with fixes.
  4. Preservation: Do not delete existing comments or docstrings. They document intent.
  5. Transparency: If a change fails or is unclear, report it and ask. Do not improvise workarounds silently.
  6. CHANGELOG: Update CHANGELOG.md on every feat or fix. This is not optional.
  7. Logger interface: Pipeline output must go through pipeline.Logger. Never add direct fmt.Printf to pipeline code.

Success Criteria

A task is complete when: make build succeeds, the intended behavior is verified, and CHANGELOG.md is updated if applicable.

Clone this wiki locally