bunqueue-dev

Guide bunqueue contributors through architecture-aligned development and test-driven bug fixing.

528|17|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/egeominotti/bunqueue --skill bunqueue-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bunqueue-dev
Source: https://github.com/egeominotti/bunqueue/tree/main/.claude/skills/bunqueue-dev
Command: npx skills add https://github.com/egeominotti/bunqueue --skill bunqueue-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents slow, inconsistent development on bunqueue by codifying architecture knowledge, code conventions, and a repeatable contribution workflow that starts with mandatory tests.

Core Features & Use Cases

  • Architecture reference: Explains bunqueue’s sharded priority queue design, persistence strategy (SQLite WAL), and transport modes (TCP/HTTP), so contributors can reason about changes safely.
  • Workflow engine guidance: Documents the workflow layer responsibilities and file roles under src/client/workflow for correct feature development.
  • Contribution guardrails: Enforces code style rules (e.g., max lines per file), lock hierarchy expectations, and a mandatory test-before-commit process to reduce regressions.
  • Bug fixing protocol: Requires writing a reproducing test before fixing, then proving the fix with a passing test.

Quick Start

Ask an AI to summarize the bunqueue development workflow and generate a commit-ready plan that includes the required test commands and the bug-fixing steps for a described issue.

Frequently Asked Questions about bunqueue-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix bugs in a workflow engine without causing regressions?

To fix workflow engine bugs without regressions, write a reproducing test first, then apply the fix and prove it with a passing test. This bug-fixing protocol ensures regression-free contributions to queue sharding and transport modes.

What is the architecture of a sharded priority queue using SQLite WAL?

A sharded priority queue using SQLite WAL distributes priority queue operations across shards for concurrency, using Write-Ahead Logging for persistence and supporting TCP or HTTP transport modes for safe architecture-aligned changes.

How to contribute to a queue workflow engine while following code conventions?

To contribute to a queue workflow engine, follow code convention constraints like max lines per file and lock hierarchy expectations, then run mandated testing commands before commit to ensure regression-free contributions.

Does bunqueue support TCP and HTTP integration testing suites?

Yes, bunqueue supports both TCP and HTTP integration testing suites. Contributors must run these mandated test commands before committing changes to maintain regression-free workflow engine implementation and sharded queue architecture.

What's the best way to implement features in a queue's workflow layer?

The best way to implement workflow layer features is to follow documented file roles under the client workflow directory, respecting lock hierarchy expectations and running test-driven validations before commit for architecture-aligned changes.

When do I need a test-driven protocol for queue bug fixing?

You need a test-driven protocol for queue bug fixing whenever you modify sharded priority queue logic or transport modes, requiring a reproducing test before the fix and a passing test after to prevent regressions.