bazinga-db-workflow

mehdic's avatarfrom mehdic

Task groups and development planning. Use when managing task groups, development plans, or success criteria.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026⬇️1downloads

When & Why to Use This Skill

The bazinga-db-workflow skill is a specialized project management tool designed for structured development environments. It enables Claude to create, manage, and track complex task groups, development plans, and success criteria, ensuring systematic progress monitoring and quality control throughout the software development lifecycle.

Use Cases

  • Task Group Organization: Defining and updating structured task groups with specific specializations, complexity levels, and security sensitivity for large-scale engineering projects.
  • Development Roadmap Planning: Saving and retrieving comprehensive development plans that include multi-phase roadmaps, time estimates, and dependency tracking.
  • Success Criteria Management: Establishing clear, measurable benchmarks for project completion and tracking their status (e.g., 'All tests pass', 'Security audit cleared') to ensure high-quality deliverables.
  • Progress Tracking and Iteration: Monitoring the real-time status of development phases and managing the feedback loop between developers and technical leads to resolve blocking issues.
namebazinga-db-workflow
descriptionTask groups and development planning. Use when managing task groups, development plans, or success criteria.
version2.0.0
allowed-tools[Bash, Read]

BAZINGA-DB Workflow Skill

You are the bazinga-db-workflow skill. You manage task groups, development plans, and success criteria tracking.

When to Invoke This Skill

Invoke when:

  • Creating or updating task groups
  • Saving or retrieving development plans
  • Managing success criteria
  • Tracking plan progress

Do NOT invoke when:

  • Managing sessions or state → Use bazinga-db-core
  • Logging interactions or reasoning → Use bazinga-db-agents
  • Managing context packages → Use bazinga-db-context

Script Location

Path: .claude/skills/bazinga-db/scripts/bazinga_db.py

All commands use this script with --quiet flag:

python3 .claude/skills/bazinga-db/scripts/bazinga_db.py --quiet <command> [args...]

Commands

create-task-group

python3 .claude/skills/bazinga-db/scripts/bazinga_db.py --quiet create-task-group \
  "<group_id>" "<session_id>" "<description>" \
  [--specializations '<json_array>'] [--item_count N] [--initial_tier "<tier>"] \
  [--component-path "<path>"] [--complexity N] [--security_sensitive 0|1]

Parameters:

  • group_id: Short identifier (e.g., AUTH, CALC)
  • session_id: Parent session ID
  • description: Human-readable description
  • --specializations: JSON array of specialization paths
  • --initial_tier: "Developer" or "Senior Software Engineer"
  • --complexity: 1-10 scale

Returns: Created task group object.

update-task-group

CRITICAL: Argument order is <group_id> <session_id> (NOT session first)

python3 .claude/skills/bazinga-db/scripts/bazinga_db.py --quiet update-task-group \
  "<group_id>" "<session_id>" [--status "<status>"] [--assigned_to "<agent_id>"] \
  [--specializations '<json_array>'] [--item_count N] [--initial_tier "<tier>"] \
  [--component-path "<path>"] [--qa_attempts N] [--tl_review_attempts N] \
  [--security_sensitive 0|1] [--complexity N] \
  [--review_iteration N] [--no_progress_count N] [--blocking_issues_count N]

Valid status values: pending, in_progress, completed, failed, approved_pending_merge, merging

Review iteration fields (v16):

  • review_iteration: Current iteration in TL→Dev feedback loop (starts at 1)
  • no_progress_count: Consecutive iterations with 0 issues fixed (escalation at 2)
  • blocking_issues_count: Current unresolved CRITICAL/HIGH issues

Example:

python3 .../bazinga_db.py --quiet update-task-group "CALC" "bazinga_xxx" --status "in_progress"

get-task-groups

python3 .claude/skills/bazinga-db/scripts/bazinga_db.py --quiet get-task-groups \
  "<session_id>" [status]

Returns: Array of task groups for the session, optionally filtered by status.

save-development-plan

python3 .claude/skills/bazinga-db/scripts/bazinga_db.py --quiet save-development-plan \
  "<session_id>" '<json_plan>'

Saves PM's development plan with phases, estimates, and dependencies.

Example:

python3 .../bazinga_db.py --quiet save-development-plan "bazinga_xxx" \
  '{"phases": [{"name": "Core", "tasks": [...]}], "estimated_groups": 3}'

get-development-plan

python3 .claude/skills/bazinga-db/scripts/bazinga_db.py --quiet get-development-plan "<session_id>"

Returns: Latest development plan for the session.

update-plan-progress

python3 .claude/skills/bazinga-db/scripts/bazinga_db.py --quiet update-plan-progress \
  "<session_id>" "<phase_name>" "<status>" [progress_percent]

Updates phase status within the development plan.

Valid status values: pending, in_progress, completed, blocked

save-success-criteria

python3 .claude/skills/bazinga-db/scripts/bazinga_db.py --quiet save-success-criteria \
  "<session_id>" '<json_criteria_array>'

Format:

[
  {"criterion": "All tests pass", "status": "pending", "priority": 1},
  {"criterion": "Code review approved", "status": "pending", "priority": 2}
]

get-success-criteria

python3 .claude/skills/bazinga-db/scripts/bazinga_db.py --quiet get-success-criteria "<session_id>"

Returns: Array of success criteria with current status.

update-success-criterion

python3 .claude/skills/bazinga-db/scripts/bazinga_db.py --quiet update-success-criterion \
  "<session_id>" "<criterion_text>" "<status>" [notes]

Valid status values: pending, met, failed, blocked

Output Format

Return ONLY raw JSON output. No formatting, markdown, or commentary.

Error Handling

  • Missing task group: Returns {"error": "Task group not found: <id>"}
  • Invalid status: Returns {"error": "Invalid status: <status>"}
  • Argument order error: Check <group_id> comes before <session_id>

References

  • Full schema: .claude/skills/bazinga-db/references/schema.md
  • All commands: .claude/skills/bazinga-db/references/command_examples.md
  • CLI help: python3 .../bazinga_db.py help