Checkpoint

AGENTS.md

@@ -0,0 +1,43 @@
+# AGENTS
+
+This document provides context for AI agents working on this codebase.
+
+## Project Overview
+
+HAMView is an online Amateur Radio digital protocol live viewer. It features:
+- Displaying online radio receivers in near real-time
+- Streaming of popular Amateur Radio protocols such as APRS, MeshCore, etc.
+- A live packet stream for each of the protocols
+- Packet inspection
+
+## Tech Stack
+
+Used technologies:
+- **Framework**: Go with echo 4
+- **Logging**: logrus
+- **Code Editor**: Visual Studio Code
+- **Backend**: Xorm on PostgreSQL with PostGIS extensions
+- **Broker**: Mosquitto broker
+- **Testing**: use `go test -v`
+
+## Testing Requirements
+
+**Always run tests before completing a task.**
+
+Run `go test -v` and `golangci-lint run`.
+
+## Coding Guidelines
+
+### General
+- Use builtins from Go, echo and the libraries from `go.mod` where possible
+- Follow existing code patterns in the code base
+- Don't add new imports unless necessary
+
+### Styling
+- Use Go builtins where appropriate
+- Order imports with `goimports`
+
+## Protected files
+
+Never add secrets to code, unless a secret is used as a test vector. In that case, ask
+for confirmation before adding or changing.