# Coding Standards

Technical standards for the **Claudomator** project.

## 1. Go (Backend)
- **CGo Dependency:** `go-sqlite3` requires a C compiler (`gcc`).
- **Concurrency:** Uses a bounded goroutine pool. Always test with `go test -race ./...`.
- **State Machine:** Follow `task.ValidTransition` for all state updates.
- **Sandboxing:** Task modifications happen in `/tmp/claudomator-sandbox-*`.

## 2. Testing
- **Reproduction:** Always create a failing test case for bugs.
- **Race Detector:** Mandatory for `internal/executor` and `internal/api/hub` changes.

## 3. Architecture
- **Single Binary:** Keep the binary self-contained using `go:embed` for web assets.
- **Durability:** Use SQLite with WAL mode.