summaryrefslogtreecommitdiff
path: root/.agent/coding_standards.md
diff options
context:
space:
mode:
authorPeter Stone <thepeterstone@gmail.com>2026-03-22 23:48:03 +0000
committerPeter Stone <thepeterstone@gmail.com>2026-03-22 23:48:03 +0000
commit2c8ec3e53a0f4c6f2d16e94a95fcdce706717091 (patch)
tree7cef240684c4d5bc2e627dd3585290e3ddc1a03e /.agent/coding_standards.md
parentd8939199f129ccb1abcf0150012bc23209facf12 (diff)
chore: unify and centralize agent configuration in .agent/
Diffstat (limited to '.agent/coding_standards.md')
-rw-r--r--.agent/coding_standards.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/.agent/coding_standards.md b/.agent/coding_standards.md
new file mode 100644
index 0000000..dc39d7f
--- /dev/null
+++ b/.agent/coding_standards.md
@@ -0,0 +1,17 @@
+# 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.