ScuttleBot

init: scaffold boilerplate and architecture docs

lmata 2026-03-31 04:09 trunk
Commit 6d0d615b17620370f16f843d7a8ad795b86bd0fb29472aa506545767dda6a77b
+5
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -0,0 +1,5 @@
1
+# Agents — scuttlebot
2
+
3
+Primary conventions doc: [`bootstrap.md`](bootstrap.md`](memory.md)
4
+
5
+Read bot
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -0,0 +1,5 @@
 
 
 
 
 
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -0,0 +1,5 @@
1 # Agents — scuttlebot
2
3 Primary conventions doc: [`bootstrap.md`](bootstrap.md`](memory.md)
4
5 Read bot
+17
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -0,0 +1,17 @@
1
+# Claude — scuttlebot
2
+
3
+Primary conventions doc: [`bootstrap.md`](bootstrap.md)
4
+Context seed: [`memory before writing any code.
5
+
6
+---
7
+
8
+## Project-specific notes
9
+
10
+- Language: Go 1.22+
11
+- Transport: IRC — all agent coordination flows through Ergo IRC channels and messages
12
+- HTTP API: `internal/api/` — Bearer token auth, JSON, serves the web UI at `/ui/`
13
+- Admin auth: `internal/auth/` — bcrypt-hashed accounts, login at `POST /login`
14
+- Bot manager: `internal/bots/manager/` — starts/stops system bots based on policy changes
15
+- Human observable by design: everything an agent does is visible in IRC
16
+- Test runner: `go test ./...`
17
+- Formatter: `g
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -0,0 +1,17 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -0,0 +1,17 @@
1 # Claude — scuttlebot
2
3 Primary conventions doc: [`bootstrap.md`](bootstrap.md)
4 Context seed: [`memory before writing any code.
5
6 ---
7
8 ## Project-specific notes
9
10 - Language: Go 1.22+
11 - Transport: IRC — all agent coordination flows through Ergo IRC channels and messages
12 - HTTP API: `internal/api/` — Bearer token auth, JSON, serves the web UI at `/ui/`
13 - Admin auth: `internal/auth/` — bcrypt-hashed accounts, login at `POST /login`
14 - Bot manager: `internal/bots/manager/` — starts/stops system bots based on policy changes
15 - Human observable by design: everything an agent does is visible in IRC
16 - Test runner: `go test ./...`
17 - Formatter: `g
+5
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -0,0 +1,5 @@
1
+# Gemini — scuttlebot
2
+
3
+Primary conventions doc: [`bootstrap.md`](bootstrap.md`](memory.md)
4
+
5
+Read bot
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -0,0 +1,5 @@
 
 
 
 
 
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -0,0 +1,5 @@
1 # Gemini — scuttlebot
2
3 Primary conventions doc: [`bootstrap.md`](bootstrap.md`](memory.md)
4
5 Read bot
--- a/bootstrap.md
+++ b/bootstrap.md
@@ -0,0 +1,6 @@
1
+# s# CLI/REPL binary
2
+internaregistry/ bots/t-in bots (scribe, scroll, herinternal/config/ ## Go# wire format (mes # operator UI — sfuture: python, ruby, rust cl# docker cgo.mod
3
+go.sum
4
+```
5
+
6
+Single Go module for everything under `cmd/`, `internal/`, `pkg/`. `apps/web/
--- a/bootstrap.md
+++ b/bootstrap.md
@@ -0,0 +1,6 @@
 
 
 
 
 
 
--- a/bootstrap.md
+++ b/bootstrap.md
@@ -0,0 +1,6 @@
1 # s# CLI/REPL binary
2 internaregistry/ bots/t-in bots (scribe, scroll, herinternal/config/ ## Go# wire format (mes # operator UI — sfuture: python, ruby, rust cl# docker cgo.mod
3 go.sum
4 ```
5
6 Single Go module for everything under `cmd/`, `internal/`, `pkg/`. `apps/web/
+19
--- a/calliope.md
+++ b/calliope.md
@@ -0,0 +1,19 @@
1
+# Calliope — scuttlebot
2
+<!-- Agent shim for https://github.com/calliopeai/calliope-cli -->
3
+
4
+Primary conventions doc: [`bootstrap.md`](bootstrap.md)
5
+Context seed: [`memory before writing any code.
6
+
7
+---
8
+
9
+## Project-specific notes
10
+
11
+- Language: Go 1.22+
12
+- Transport: IRC — all agent coordination flows through Ergo IRC channels and messages
13
+- HTTP API: `internal/api/` — Bearer token auth, JSON, serves the web UI at `/ui/`
14
+- No ORM, no database — state persisted as YAML/JSON files
15
+- Human observable by design: everything an agent does is visible in IRC
16
+- Test runner: `go test ./...`
17
+- Formatter: `gofmt` (enforced)
18
+- Linter: `golangci-lint run`
19
+- Dev helper: `./run.sh` (start / stop / restart / token / log / te
--- a/calliope.md
+++ b/calliope.md
@@ -0,0 +1,19 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
--- a/calliope.md
+++ b/calliope.md
@@ -0,0 +1,19 @@
1 # Calliope — scuttlebot
2 <!-- Agent shim for https://github.com/calliopeai/calliope-cli -->
3
4 Primary conventions doc: [`bootstrap.md`](bootstrap.md)
5 Context seed: [`memory before writing any code.
6
7 ---
8
9 ## Project-specific notes
10
11 - Language: Go 1.22+
12 - Transport: IRC — all agent coordination flows through Ergo IRC channels and messages
13 - HTTP API: `internal/api/` — Bearer token auth, JSON, serves the web UI at `/ui/`
14 - No ORM, no database — state persisted as YAML/JSON files
15 - Human observable by design: everything an agent does is visible in IRC
16 - Test runner: `go test ./...`
17 - Formatter: `gofmt` (enforced)
18 - Linter: `golangci-lint run`
19 - Dev helper: `./run.sh` (start / stop / restart / token / log / te

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button