monolith-job-development
Use when creating or extending asynchronous background jobs, including generator usage, queue registration, payload handling, and worker lifecycle.
Source facts
- Repository
- cggonzal/monolith
- Last source activity
- February 14, 2026 at 03:11
- Detected SKILL.md language
- English
- Stars
- 0
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- monolith-job-development
- description
- Use when creating or extending asynchronous background jobs, including generator usage, queue registration, payload handling, and worker lifecycle.
# Monolith Job Development
## Use this skill when
- Adding new async work to `app/jobs/`.
- Updating queue handlers or job scheduling behavior.
## Fast path
Run: `make generator job <Name>`
This typically:
- creates `app/jobs/<name>_job.go`
- creates matching test file
- adds job type constant in `app/models/job.go`
- registers handler in `app/jobs/job_queue.go`
## Runtime architecture
- Queue initialized via `jobs.InitJobQueue()` in `main.go`.
- Worker count controlled by `config.JOB_QUEUE_NUM_WORKERS`.
- Jobs are typed via `models.JobType*` enums and payload bytes.
## Implementation workflow
1. Define payload struct and marshal/unmarshal strategy.
2. Implement generated job handler body.
3. Register handler (generator usually does this).
4. Enqueue from controller/service as needed.
5. Add focused tests for decoding + handler behavior.
## Reliability tips
- Keep handlers idempotent where possible.
- Log failures with useful context.
- Treat malformed payloads as explicit errors.
View on GitHub