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_id>" "<status>" [progress_percent]

Updates phase status within the development plan.

Parameters:

• phase_id

  : Either a phase number (integer) or phase name (string)

• progress_percent

  : Optional progress percentage (0-100)

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