diff options
| author | Peter Stone <thepeterstone@gmail.com> | 2026-02-08 21:35:45 -1000 |
|---|---|---|
| committer | Peter Stone <thepeterstone@gmail.com> | 2026-02-08 21:35:45 -1000 |
| commit | 2e2b2187b957e9af78797a67ec5c6874615fae02 (patch) | |
| tree | 1181dbb7e43f5d30cb025fa4d50fd4e7a2c893b3 /docs/adr | |
Initial project: task model, executor, API server, CLI, storage, reporter
Claudomator automation toolkit for Claude Code with:
- Task model with YAML parsing, validation, state machine (49 tests, 0 races)
- SQLite storage for tasks and executions
- Executor pool with bounded concurrency, timeout, cancellation
- REST API + WebSocket for mobile PWA integration
- Webhook/multi-notifier system
- CLI: init, run, serve, list, status commands
- Console, JSON, HTML reporters with cost tracking
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Diffstat (limited to 'docs/adr')
| -rw-r--r-- | docs/adr/001-language-and-architecture.md | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/docs/adr/001-language-and-architecture.md b/docs/adr/001-language-and-architecture.md new file mode 100644 index 0000000..99022f1 --- /dev/null +++ b/docs/adr/001-language-and-architecture.md @@ -0,0 +1,32 @@ +# ADR-001: Go with Server + Mobile PWA Architecture + +## Status +Accepted + +## Context +Claudomator needs to capture tasks, dispatch them to Claude Code, and report results. +The primary human interface is a mobile device requiring push notifications and frictionless input. + +## Decision +- **Language**: Go for the backend (CLI + API server) +- **Architecture**: Pipeline with bounded executor pool (goroutines) +- **API**: REST + WebSocket for real-time updates +- **Storage**: SQLite + filesystem (logs, artifacts) +- **Task format**: YAML definitions +- **Mobile**: PWA with Web Push notifications (future phase) + +## Rationale +- Go: single binary, excellent process management (`os/exec`), natural concurrency +- SQLite: zero-dependency, embeddable, queryable metadata +- WebSocket: real-time progress streaming to mobile clients +- REST: simple task creation from any HTTP client (mobile, curl, CI) + +## Alternatives Considered +- **TypeScript/Node.js**: Claude Code SDK exists, but runtime dependency hurts distribution +- **Python**: Good async, but packaging/distribution is painful for CLI tools +- **Rust**: Overkill for this problem domain; slower iteration speed + +## Consequences +- CGo dependency via `go-sqlite3` (requires C compiler for builds) +- Mobile PWA to be built as a separate frontend phase +- Claude Code invoked via CLI flags (`-p`, `--output-format stream-json`), not SDK |