solid-jobs-skills CLAUDE.md

solid-jobs-skills

An AI job-search command center for the SOLID.Jobs public API. A Go binary (sjctl) does the deterministic work — fetching offers, caching, tracking, stats — and Claude skills add the judgment layer (search-from-language, offer evaluation, digests).

Architecture

cmd/sjctl              CLI (cobra) — thin wrapper, no business logic
internal/api           SOLID.Jobs API client (typed models, campaign param, 429 backoff)
internal/store         SQLite store — typed wrappers over the generated queries
internal/store/schema.sql   table definitions (sqlc source + runtime DDL)
internal/store/query.sql    all SQL queries (sqlc source)
internal/store/sqlcgen      GENERATED by sqlc — do not edit by hand
internal/jobs          Service layer — ALL business logic lives here
internal/stats         Salary/market aggregation
.claude/skills         jobs-search, jobs-create-profile, jobs-evaluate, jobs-track, jobs-digest, jobs-interview, jobs-market
config/                profile.md template
data/                  solidjobs.db (gitignored)

Dependency rule: cmd/sjctl and any future dashboard depend on internal/jobs, never the reverse. Put logic in the service layer, not in commands. SQLite is the single source of truth for offers, profiles, tracker, evaluations, interview preps and watches.

SQL rule: no SQL is inlined in Go. All queries live in internal/store/query.sql and the schema in internal/store/schema.sql; sqlc compiles them into the typed sqlcgen package. The store package wraps those generated methods. To change the database layer: edit the .sql files, run sqlc generate, then update the wrappers in internal/store/*.go.

Build & run

sqlc generate                     # regenerate internal/store/sqlcgen after editing *.sql
go build -o sjctl ./cmd/sjctl     # build the binary (sjctl.exe on Windows)
go test ./...                      # run tests
./sjctl search -d IT --term golang --remote --json