Add, change, or remove a Chatto background job type, or change the policy, handler, or payload of one. Use before you enqueue new work on the JOBS queue in cli/internal/core, and when a job type shows as Unknown on the Jobs page.
96%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Chatto runs durable background work on the shared job queue in pkg/jobs.
Chatto owns the job types, policies, handlers, payloads, and the Jobs page.
Read ADR-123 and
FDR-056 first. Read
pkg/jobs/AGENTS.md only when you change the
shared module itself.
A job type touches the server, the public API, the frontend, every complete
translation catalog, and the architecture documentation. CI checks only the
server and frontend lists against
testdata/jobs/types.json. Use the
checklist below for the other parts.
snake_case.email_jobs.go.attempt_failed category and the job retries. Return
*jobs.Failure to record a specific category, and set Permanent to stop
automatic retries for work that cannot succeed. A category is a fixed
token, never external error text.jobs.UnlimitedAttempts only for work that must finish, such as cleanup
and key deletion. Set ExpiresAt when late work is useless.jobTypes() in
jobs.go. This creates its JOBS
consumer and its worker diagnostics row.runJobs, or in the
runtime that owns the transport, as EmailJobs.Run does.testdata/jobs/types.json.knownJobTypeLabel in
apps/frontend/src/routes/chat/[serverId]/manage/server/jobs/jobPresentation.ts.
Add admin.jobs.<type> to apps/frontend/messages/en-GB/admin.json and
to every complete catalog. Follow the i18n rules in
apps/frontend/AGENTS.md.Job.type in
jobs.proto. Run
mise codegen-proto.docs/architecture/subjects-and-events.md,docs/architecture/nats-resources.md,docs/architecture/durable-effects.md, and
docs/architecture/runtime-state.md when the job keeps runtime state.
Use the
chatto-architecture-inventory
skill for the architecture files.mise x -- go test ./cli/internal/core -run 'Job' -count=1
mise x -- pnpm --filter chatto-frontend exec vitest --run \
src/routes/chat/[serverId]/manage/server/jobs/
mise license-checkchattocorp/chatto
da08d92
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.