CLAUDE.md

taskq is a small Python async job queue system for reliable work processing.

Architecture decisions

This project records architecture decisions as ADRs in docs/adr/ (index: docs/adr/README.md).

When your task involves making an architecture-level choice, or changing/replacing an approach this codebase already uses (job execution, persistence, notifications, delivery strategy) → first run /os-adr:find to check whether a recorded decision already covers it.
Mechanical rule: before your first edit to any existing source or config file, run /os-adr:find on the paths you are about to touch — one cheap, deterministic CLI call. This applies to additions too: a new method or module can bypass a decided constraint just as easily as a rewrite can.
When you make such a choice → record it with /os-adr:create.
If an Accepted ADR covers the approach you are changing, you are reversing a recorded decision. A task that reverses a recorded decision is not complete until the superseding ADR is created (/os-adr:create with supersedes) — implementing the change and stopping leaves docs/adr/ asserting the opposite of what the code does. Create the superseding ADR (or explicitly propose it to the user) before you consider the task done.