clawbot
60c0d4b5e3
check / check (push) Failing after 7s
The shared files are fetched from sneak/prompts dd4027b, with this repository's own entries after the shared content in .gitignore, .editorconfig and .dockerignore. Lint and tests are Dockerfile phases (golangci-lint v2.14.0, Debian Go 1.24.13) that the build stage depends on, and the Makefile targets call the script/ entrypoints. make fmt also formats Markdown with prettier. Fixes for the new lint findings: the auth cookie is always Secure, an IRC connection's relay goroutine stops when the connection closes, and repeated strings are constants. Model: opus-5-5
56 lines
2.0 KiB
Markdown
56 lines
2.0 KiB
Markdown
# AGENTS.md — Rules for AI Agents
|
|
|
|
## Before Every Commit
|
|
|
|
1. **Format**: `make fmt`
|
|
2. **Check**: `make check` — the tests and the linter, which run in Docker, and
|
|
the format check: all passing, zero issues
|
|
|
|
Never run `go test`, `golangci-lint` or `gofmt` directly; use the `make`
|
|
targets.
|
|
|
|
No commit lands on main with lint errors, test failures, or formatting issues.
|
|
|
|
## Code Style
|
|
|
|
- Follow CONVENTIONS.md exactly — it defines the architecture
|
|
- All exported types, functions, methods, and vars must have doc comments
|
|
- All packages must have a package doc comment
|
|
- JSON tags use camelCase (not snake_case)
|
|
- No magic numbers — use named constants
|
|
- No inline error handling (`if err := ...; err != nil`) — use plain assignment
|
|
- Blank line before every `return` statement
|
|
- Blank line separating embedded fields from regular fields in structs
|
|
- Blank imports must have a justification comment
|
|
|
|
## Git Workflow
|
|
|
|
- **Never commit directly to main** — all changes go on feature branches
|
|
- Merge to main only when ready and passing all checks
|
|
- PR titles: `Description (closes #N)` when closing an issue
|
|
- One logical change per commit
|
|
- Commit messages: imperative mood, concise
|
|
|
|
## Architecture
|
|
|
|
- Dependency injection via Uber fx — all components are fx providers
|
|
- `internal/` for all application packages — one package per concern
|
|
- Handlers return `http.HandlerFunc` using the closure pattern
|
|
- Request/response structs defined inside handler closures
|
|
- Models embed `models.Base` for database access to relation methods
|
|
- Database migrations in `internal/db/schema/` — embedded via `go:embed`
|
|
- SQLite by default (pure Go driver: modernc.org/sqlite)
|
|
|
|
## Testing
|
|
|
|
- Table-driven tests preferred
|
|
- Use `testing.T` helpers, not assertion libraries
|
|
- Test files live next to the code they test
|
|
- `_test.go` suffix, same package for white-box testing
|
|
|
|
## Dependencies
|
|
|
|
- Required libraries are listed in CONVENTIONS.md §1
|
|
- No new dependencies without justification
|
|
- Pure Go preferred (no CGO)
|